银行交易

这是我们崭新的REST API的文档页面-并不是要找到它。此API尚未准备好供公众使用。随着我们的成长,我们正在砍伐和改变很多。因此,如果您构建使用它的东西,那么很可能在以后的更新中中断。 不要说您没有被警告!

网址:

//api.meituohu.com/v2/bankaccounts/{accountId}/transactions

方法):

获取,发布,放置,删除

回应格式:

JSON,XML

描述:

这些方法允许检索事务列表,创建新事务,更新现有事务和删除事务。

参量

名称类型描述
帐户ID数字唯一的银行帐户标识符
BFSTransactionId数字 银行Feed交易ID
评论
客户代码 客户代码(如果是发票付款)
顾客ID数字 客户ID(如果是发票付款)
ID数字 交易编号
花费数字 Money paid in
MoneyOut数字 Money paid out
项目编号数字 唯一的项目标识符
已对帐数字 此交易是否已对帐
已对帐Id Reconciliation ID
资源编号数字  发票/采购数(如适用)
供应商代码数字 供应商代码(如果是采购付款)
日期日期 Date of transaction
交易号数字用户特定的唯一交易数
可变布尔型 交易是否豁免增值税
增值税额数字 交易中的增值税总额
VATP援助数字 截至目前已缴纳的增值税额
增值税数字 订单项的增值税率。对于PUT和POST请求,如果VATAble属性为true,则不能将其指定。该字段是只读的。
VATReturnId数字 如果已提交增值税申报表,则为增值税申报表ID
交易类型数字指定交易类型

0
–针对销售类型,购买类型或银行类型代码提出的交易
–供应商或客户未分配的预付款/预付款
–从目标银行账户转账

1
– Invoice Payment
–发票退款(贷方付款)

2
– Purchase Payment
–购买退款(贷记付款)

3
–发票批量付款

4
–购买批量付款

5
–日记帐行(借方或贷方)

6
–从另一个银行帐户转帐

GET操作

交易的GET返回给定银行帐户的银行交易清单。

网址: / bankaccounts / {accountId} / transactions?startDate = {startDate}&endDate={endDate}&page={page}&

每页 = {perpage}&sortcolumn = {sortcolumn}&order={order}&filterby={filterby}&includeBulk = {true / false}&searchtext = {searchText}

返回银行交易的分页列表(由TransactionDate降序排列)。
如果未指定startDate和endDate,则默认情况下将提取上个月的银行交易记录。
如果未指定页面和页面大小,则将显示包含10个银行交易的首页(如发票)。

银行交易清单获取示例响应


{  
   "Data":[  
      {  
         "帐户ID":18,
         "BFSTransactionId":null,
         "评论":"INV #45374: ",
         "客户代码":"000001",
         "顾客ID":16210401,
         "日期":null,
         "EditLink":"\/#invoices\/45374",
         "ID":36948882,
         "MoneyType":null,
         "花费":20700.0000,
         "PaidOut":0.0000,
         "Payee":null,
         "PaymentType":0,
         "项目编号":null,
         "已对帐":true,
         "已对帐Id":246,
         "资源编号":45374,
         "供应商代码":"",
         "SupplierId":null,
         "TransactionDate":"2013-01-09 12:00:00",
         "交易号":null,
         "交易类型":1,
         "类型":"Sale - 000001",
         "可变":true,
         "增值税额":4140.0000,
         "VATP援助":4140.0000,
         "增值税":20.0000,
         "VATReturnId":null
      },
      {  
         "帐户ID":18,
         "BFSTransactionId":null,
         "评论":"KF00044: ",
         "客户代码":"",
         "顾客ID":null,
         "日期":null,
         "EditLink":"\/#purchases\/44",
         "ID":22189152,
         "MoneyType":null,
         "花费":0.0000,
         "PaidOut":6480.0000,
         "Payee":null,
         "PaymentType":0,
         "项目编号":null,
         "已对帐":false,
         "已对帐Id":0,
         "资源编号":44,
         "供应商代码":"ASDA0",
         "SupplierId":3048713,
         "TransactionDate":"2013-01-11 12:00:00",
         "交易号":null,
         "交易类型":2,
         "类型":"Purchase - ASDA0",
         "可变":true,
         "增值税额":1296.0000,
         "VATP援助":1296.0000,
         "增值税":20.0000,
         "VATReturnId":null
      }
   ],
   "MetaData":{  
      "FirstPageUrl":"https:\/\/api.kashflow.com\/v2\/bankaccounts\/18\/transactions?startDate=20130101&endDate=20130131&page=1&sortcolumn=Date&order=Asc&filterby=All&includeBulk=True&includeJournals=True&includeMoneyTypeBankTransactions=True",
      "LastPageUrl":"https:\/\/api.kashflow.com\/v2\/bankaccounts\/18\/transactions?startDate=20130101&endDate=20130131&page=1&sortcolumn=Date&order=Asc&filterby=All&includeBulk=True&includeJournals=True&includeMoneyTypeBankTransactions=True",
      "NextPageUrl":null,
      "OpeningBalance":-100.3700,
      "PreviousPageUrl":null,
      "TotalRecords":8,
      "ClosingBalance": 29112.5200
   }
}

请求参数

名称描述
帐户ID银行账户的唯一标识符
开始日期开始日期在YYYYMMDD format (可选的)
结束日期结束日期,格式为YYYYMMDD(可选)
帐户ID银行账户的唯一标识符
页码(可选)
每页要获取的记录数(可选)
排序方式需要对其进行排序的列的名称。此参数的可接受值为:
1.日期
2.付费
3.支出
4. 交易类型此参数是可选的。默认为日期
订购排序方向可以是 升序 for ascending or 描述 下降。默认是 描述 (可选的)
过滤可以按交易频率类型过滤列表。如果要检索所有事务,请将此参数设置为“全部”或为空或从URL中排除。此参数的可接受值为:
1.全部
2.未分配
3.发票
4.购买
默认是 所有
includeBulk默认为true。不穿的时候传假’希望将成批发票/采购付款包括在结果中
searchText搜索关键词
includeFeedMatched默认为true。不穿的时候传假’希望所有已经匹配BankFeed的交易
includeJournals默认为true。不穿的时候传假’希望期刊进行银行交易
includeNominalCodeBankTransactions默认为true。不穿的时候传假’希望通过其他银行帐户进行银行交易。


获取具有所有详细信息的特定银行交易–

网址: / bankaccounts / {accountId} / transactions / {transactionId}

银行交易GET的示例响应


{  
   "帐户ID":18,
   "评论":"Advance payment recieved from Supplier",
   "客户代码":"",
   "日期":"2014-08-21 12:00:00",
   "EditLink":"",
   "ID":31417163,
   "MoneyType":2100,
   "花费":0.0000,
   "PaidOut":44.3300,
   "PaymentType":0,
   "ProjectNumber":0,
   "已对帐":true,
   "已对帐Id":34,
   "供应商代码":"KLAY01",
   "交易号":34,
   "交易类型":-1,
   "类型":"",
   "可变":true,
   "增值税额":7.3900,
   "VATP援助":0.0000,
   "增值税":20.0000,
   "VATReturnId":0
}

开机自检操作

使用以下URL使用给定的数据创建新的银行交易记录–

网址: / bankaccounts / {accountId} /交易

网址中的{accountId}将被要为其创建交易的银行帐户代替。
作为响应,返回新创建的银行交易。

银行交易的POST请求示例


{
    "帐户ID": 18,
    "评论": "Update Test",
    "客户代码": "",
    "日期": "2014-10-16 12:00:00",
    "ID": 31417166,
    "MoneyType": 2100,
    "花费": 0.0000,
    "PaidOut": 10.0000,
    "ProjectNumber": 0,
    "供应商代码": "ASDA0",
    "交易类型": -1,
    "可变": true,
    "增值税额": 2.0000,
    "VATP援助": 1.0000,
    "增值税": 3.0000,
    "VATReturnId": 1
}

响应 :201用新创建的银行交易创建

银行交易的POST响应示例


{
    "ID":17622,
    "帐户ID": 18,
    "评论": "Update Test",
    "客户代码": "",
    "日期": "2014-10-16 12:00:00",
    "ID": 31417166,
    "MoneyType": 2100,
    "花费": 0.0000,
    "PaidOut": 10.0000,
    "ProjectNumber": 0,
    "供应商代码": "ASDA0",
    "交易类型": -1,
    "可变": true,
    "增值税额": 2.0000,
    "VATP援助": 1.0000,
    "增值税": 3.0000,
    "VATReturnId": 1
}

PUT操作

使用以下URL更新使用给定数据指定的银行交易记录–

网址: / bankaccounts / {accountId} / transactions / {transactionid}

网址中的{accountId}将被要为其创建交易的银行帐户代替。
作为响应,返回新创建的银行交易。

网址中的{transactionid}将被交易ID替换以进行更新

请求银行交易的示例


{
    "ID" : 18927,
    "帐户ID": 18,
    "评论": "Update Test",
    "客户代码": "",
    "日期": "2014-10-16 12:00:00",
    "ID": 31417166,
    "MoneyType": 2100,
    "花费": 0.0000,
    "PaidOut": 10.0000,
    "ProjectNumber": 0,
    "供应商代码": "ASDA0",
    "交易类型": -1,
    "可变": true,
    "增值税额": 2.0000,
    "VATP援助": 1.0000,
    "增值税": 3.0000,
    "VATReturnId": 1
}

响应 :200 OK,更新了银行交易

银行交易的PUT回应范例


{
    "ID" : 18927,
    "帐户ID": 18,
    "评论": "Update Test",
    "客户代码": "",
    "日期": "2014-10-16 12:00:00",
    "ID": 31417166,
    "MoneyType": 2100,
    "花费": 0.0000,
    "PaidOut": 10.0000,
    "ProjectNumber": 0,
    "供应商代码": "ASDA0",
    "交易类型": -1,
    "可变": true,
    "增值税额": 2.0000,
    "VATP援助": 1.0000,
    "增值税": 3.0000,
    "VATReturnId": 1
}

删除操作

使用以下URL删除银行帐户的特定交易–

网址: / bankaccounts / {accountId} / transactions / {transactionid}

URL中的{accountId}将被要为其删除交易的银行帐户代替。
网址中的{transactionid}将被要删除的交易ID取代。
如果删除成功,Rest Api将返回204,如http响应代码中所示。

了解KashFlow如何与您的业务和书籍一起使用