采购

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

网址:

//api.meituohu.com/v2/purchases

方法):

获取,发布,放置,删除

回应格式:

JSON,XML

描述:

这些方法使您可以检索/创建/更新/删除购买。单个资源由购买号标识。因此/ purchases / 10将返回编号为10的购买。GET / purchases将返回分页的购买清单。网址中的{number}将替换为要购买的唯一编号。

参量

名称类型描述
数字唯一的购买标识符。在创建购买时,如果为此字段传递了一个值,则使用此编号创建购买(如果该购买对用户而言是唯一的)
发行日期日期购买的签发日期,例如JSON格式:[JSONDATE],XML格式:[XMLDATE]
截止日期日期购买的付款日期,例如JSON格式:[JSONDATE],XML格式:[XMLDATE]
缴纳日期日期购买付款日期例如JSON格式:[JSONDATE],XML格式:[XMLDATE]
增值税额数字增值税总额
净额数字不含增值税的金额
支付总额数字以本国货币支付的总金额
状态指示购买的付款状态。付款状态可以是未付款,已付款,多付款,逾期或不适用。 NA表示购买金额为零。
总金额数字总金额
货币总金额数字本币总额
货币目的货币相关信息,例如代码,名称,汇率
LineItems采集订单项集合
付款行采集收集所有已付款
SupplierId数字分配给供应商的唯一数据库ID
供应商代码为其创建采购的供应商的代码
供应商参考供应商参考
供应商名称供应商名称
逾期数字购买付款逾期的天数
项目编号数字采购项目编号
固定链接可以共享的购买文档的永久URL。
AdditionalFieldValue如果为用户设置了附加字段的值
上一个号码数字先前的购买编号
下一个号码数字下次购买编号
PurchaseInECMemberState布尔型指示供应商是否在EC成员国注册的增值税的标志。
是否扣除布尔型此购买是否有资格获得预扣税减免。
库存管理适用布尔型指示库存管理是否适用于购买的标志。这是只读字段,仅在单个GET的情况下返回。
文件计数数字文件数
订单项收集参数
数字该字段有两个用途:
1.它唯一地标识一个订单项。
2.它代表排序顺序,即项目可以以与行号相同的顺序(升序)显示在行项列表中。
注意 :尽管行号唯一地标识了一行,但是当更改排序顺序时,行号可能会更改。另外,对于新订单项,应将其设置为0。
描述此订单项的说明
数量数字订单项单位
数字报价货币汇率
货币汇率数字订单项的本币汇率。
增值税级别数字应用于采购行的增值税税率。该字段是只读的。
VATExempt数字免税值
增值税额数字购买的增值税金额
首页CurrencyVATAmount数字购买行的增值税金额(以本国货币表示)。
名义代码购买行分配给的名义代码
产品代码数字产品的唯一代码
产品名称产品名称
项目编号数字分配给采购行的项目编号
项目名分配给采购行的项目名称。
名义名称分配给采购行的名义名称。
付款行收集参数
ID 数字创建的付款行的唯一ID
帐户ID数字付款分配到的银行帐户ID
日期日期交易日期。例如JSON格式:[JSONDATE],XML格式:[XMLDATE]
注意交易说明
方法数字付款方式编号
数字已付金额
固定链接可以共享的购买付款凭证的永久URL。
BulkId数字批量付款ID
批量付款编号数字批量付款号码
固定链接数字永久链接以打印购买付款
银行TransactionId数字银行交易编号

GET操作

返回分页的购买清单。获取购买清单–

网址: / purchases?page = {page}&perpage={perpage}&sortby={sortby}&order={order}&filterby={filterby}&projectnumber = {projectnumber}&Suppliercode = {suppliercode}

返回分页的采购清单(按采购编号升序排列)。

获取采购清单的示例响应


{
    "Data": [{
        "货币": {
            "Code": "GBP",
            "DisplaySymbolOnRight": false,
            "ExchangeRate": 1.0000,
            "名称": "British Pounds",
            "Symbol": "£"
        },
        "截止日期": "2008-12-27 12:00:00",
        "总金额": 14.9800,
        "ID ": 600504,
        "发行日期": "2008-11-27 12:00:00",
        "LineItems": null,
        "净额": 17.2300,
        "数": 3,
        "逾期": 0,
        "缴纳日期": "2007-11-27 12:00:00",
        "付款行": null,
        "固定链接": null,
        "状态": "多付的",
        "供应商代码": "FOOD01",
        "SupplierId": 104897,
        "供应商名称": "Food Essentials",
        "供应商参考": "FOOD001",
        "支付总额": 17.2300,
        "增值税额": 2.2500,
        "文件计数": 2 
    }, {
        "货币": {
            "Code": "GBP",
            "DisplaySymbolOnRight": false,
            "ExchangeRate": 1.0000,
            "名称": "British Pounds",
            "Symbol": "£"
        },
        "截止日期": "2008-12-27 12:00:00",
        "总金额": 114.9800,
        "ID ": 600534,
        "发行日期": "2008-11-27 12:00:00",
        "LineItems": null,
        "净额": 114.9800,
        "数": 4,
        "逾期": 0,
        "缴纳日期": null,
        "付款行": null,
        "固定链接": null,
        "状态": "逾期",
        "供应商代码": "FOOD01",
        "SupplierId": 104897,
        "供应商名称": "Food Essentials",
        "供应商参考": "FOOD001",
        "支付总额": 14.9800,
        "增值税额": 0.0000,
        "文件计数": 0
    }, {
        "货币": {
            "Code": "GBP",
            "DisplaySymbolOnRight": false,
            "ExchangeRate": 0.0000,
            "名称": "British Pounds",
            "Symbol": "£"
        },
        "截止日期": "2008-12-27 12:00:00",
        "总金额": 14.9800,
        "ID ": 675537,
        "发行日期": "2008-11-27 12:00:00",
        "LineItems": null,
        "净额": 14.9800,
        "数": 5,
        "逾期": 0,
        "缴纳日期": null,
        "付款行": null,
        "固定链接": null,
        "状态": "逾期",
        "供应商代码": "FOOD01",
        "SupplierId": 104897,
        "供应商名称": "Food Essentials",
        "供应商参考": "FOOD001",
        "支付总额": 44.9800,
        "增值税额": 0.0000,
        "文件计数": 1
    }],
    "MetaData": {
        "FirstPageUrl": "https:\/\/api.kashflow.com\/v2\/purchases?page=1&perpage=3&sortby=Number&order=Asc",
        "LastPageUrl": "https:\/\/api.kashflow.com\/v2\/purchases?page=109&perpage=3&sortby=Number&order=Asc",
        "NextPageUrl": "https:\/\/api.kashflow.com\/v2\/purchases?page=2&perpage=3&sortby=Number&order=Asc",
        "PreviousPageUrl": null,
        "TotalRecords": 325
    }
}

请求参数

名称描述
页码
每页要获取的记录数
排序方式需要对其进行排序的列的索引。此参数的可接受值为:
1.
2. 供应商参考
3. 供应商名称
4. 购买日期
5. 付款截止日期
6. 总金额
7. 净额
8. 状态
9. 缴纳日期
订购排序方向可以是 升序 上升或 描述 下降。
过滤该列表可以按购买状态过滤。将此参数设置为“All”或为空或从URL中排除(如果要检索所有购买)。此参数的可接受值为:
1. 所有
2. 未付
3. 逾期
4. 多付的
5. 已付费
6. 这个月
7. 上个月
项目编号检索特定项目的采购。设置为0或为空或从URL中排除以排除此过滤器
供应商代码检索特定供应商的采购。如果您不希望按供应商代码过滤发票清单,则无需指定它

要获得具有所有详细信息的特定购买–
网址: /购买/ {number}

购买GET的示例响应


{
    "AdditionalFieldValue": "123",
    "货币": {
        "Code": "AUD",
        "DisplaySymbolOnRight": false,
        "ExchangeRate": 2.0000,
        "名称": "Australian Dollars",
        "Symbol": "$"
    },
    "截止日期": "2014-01-10 12:00:00",
    "总金额": 195.080000,
    "货币总金额": 97.5400,
    "ID ": 17356452,
    "是否扣除": true,
    "发行日期": "2014-01-10 12:00:00",
    "文件计数": 2,
    "LineItems": [{
        "描述": "product description",
        "货币汇率": 7.50,
        "首页CurrencyVATAmount": 3.04,
        "名义代码": 5000,
        "数": 1,
        "产品代码": "Test121",
        "产品名称": "Material",
        "数量": 3.0000,
        "率": 15.00,
        "TaxCode": null,
        "增值税额": 6.08,
        "VATExempt": false,
        "增值税级别": 13.5000,
        "名义名称": "Materials Purchased",
        "项目名": "Test5",
        "项目编号": 2,
        "StockInfo": {
            "库存数量": 22,
            "已收到": false,
            "库存收货": null,
            "类型": "Product"
        }
    }, {
        "描述": "line item 2",
        "货币汇率": 6.00,
        "首页CurrencyVATAmount": 12.00,
        "名义代码": 7403,
        "数": 2,
        "产品代码": "",
        "产品名称": "",
        "数量": 10.0000,
        "率": 12.00,
        "TaxCode": null,
        "增值税额": 24.00,
        "VATExempt": false,
        "增值税级别": 20.0000,
        "名义名称": "Entertainment",
        "项目名": "TEst",
        "项目编号": 1,
        "StockInfo": null
    }],
    "净额": 165.000000,
    "下一个号码": 0,
    "数": 2344375,
    "逾期": 0,
    "缴纳日期": null,
    "付款行": [],
    "固定链接": "\/v2\/documents\/purchaseorder\/3e196af3-7c11-46f1-b145-e3c8212b4d30",
    "上一个号码": 2344374,
    "PurchaseInECMemberState": false,
    "状态": "未付",
    "库存管理适用": false,
    "供应商代码": "08C",
    "SupplierId": 433398,
    "供应商名称": "Honda 供应商",
    "供应商参考": "wieu231",
    "支付总额": 0.0000,
    "增值税额": 30.08
}

开机自检操作

使用以下URL使用给定的购买数据创建新的购买记录–

网址: /购买/

采购请求过帐的示例请求

可以仅使用其标题详细信息(即没有订单项和付款行)或仅未付款状态的订单项创建购买。您需要将标签留空,没有子标签。可以使用多个采购行项目来创建采购,并且可以与付款行相同。


{
    "货币": {
        "Code": "GBP",
        "DisplaySymbolOnRight": false,
        "ExchangeRate": 1,
        "名称": "British Pounds",
        "Symbol": "£"
    },
    "截止日期": "2013-12-27 12:00:00",
    "发行日期": "2013-11-27 12:00:00",
    "LineItems": [{
        "描述": "Purchase line description",
        "货币汇率": 10.99,
        "首页CurrencyVATAmount": 0.00,
        "名义代码": 8205,
        "产品代码": "",
        "产品名称": "",
        "数量": 1.0000,
        "率": 10.99,
        "TaxCode": null,
        "增值税额": 0.00,
        "VATExempt": false,
        "增值税级别": 0.0000,
        "名义名称": "BT Bill",
        "项目名": "卡什流API",
        "项目编号": 1
    }],
    "付款行": [{
        "帐户ID": 16437,
        "量": 10.99,
        "日期": "2013-11-27 12:00:00",
        "方法": 56752,
        "注意": "Card Payment"
    }]
    "AdditionalFieldValue": "PRM08989",
    "供应商代码": "FOOD01",
    "供应商参考": "FOOD001"
}

网址: /购买清单/

请求批量采购的示例请求

Multiple purchases can be created using this api. 所有 the details of each purchases can be specified in same way as when using single post of purchase.
指定时“BankTransactionId”在付款项目中,相应的交易将转换为付款项目,并为新创建的购买创建相应的行项目。此后,以下银行交易也将被删除。
只有一个“BankTransactionId”可以在每次购买的多个付款项目中指定。即使失败/错误请求,API也会返回HTTP 200状态。可以通过详细信息分别查看每个购买的状态。如果“BankTransactionId”如果未指定,则API将以与购买后相同的方式工作。


[
 {
   "供应商代码": "XYZ01",
   "发行日期": "2014-09-29",
   "截止日期": "2014-09-30"
 },
 {
   "供应商代码": "XYZ01",
   "发行日期": "2014-09-30",
   "截止日期": "2014-09-30",
   "付款行": [{"银行TransactionId": 31413499, "方法": 48}]
 }
]

PUT操作

使用以下URL使用给定的购买数据更新现有购买记录-

网址: / purchases / {number}

采购请求示例

要更新购买,您需要提供完整的购买数据,与该购买的GET响应相同。然后,您更新所需的数据字段,或者如果您想向现有购买添加订单项或付款行。
要创建新的订单项或付款,该项目或付款号应设置为0。
如果现有订单项未在PUT请求正文中传递,则将删除这些订单项。


{
    "AdditionalFieldValue": "123",
    "货币": {
        "Code": "AUD",
        "DisplaySymbolOnRight": false,
        "ExchangeRate": 2.0000,
        "名称": "Australian Dollars",
        "Symbol": "$"
    },
    "截止日期": "2014-01-10 12:00:00",
    "总金额": 195.080000,
    "货币总金额": 97.5400,
    "ID ": 17356452,
    "是否扣除": true,
    "发行日期": "2014-01-10 12:00:00",
    "LineItems": [{
        "描述": "product description",
        "货币汇率": 7.50,
        "首页CurrencyVATAmount": 3.04,
        "名义代码": 5000,
        "数": 1,
        "产品代码": "Test121",
        "产品名称": "Material",
        "数量": 3.0000,
        "率": 15.00,
        "TaxCode": null,
        "增值税额": 6.08,
        "VATExempt": false,
        "增值税级别": 13.5000,
        "名义名称": "Materials Purchased",
        "项目名": "Test5",
        "项目编号": 2,
        "StockInfo": {
            "库存数量": 22,
            "已收到": true,
            "库存收货": null,
            "类型": "Product"
        }
    }, {
        "描述": "line item 2",
        "货币汇率": 6.00,
        "首页CurrencyVATAmount": 12.00,
        "名义代码": 7403,
        "数": 2,
        "产品代码": "",
        "产品名称": "",
        "数量": 10.0000,
        "率": 12.00,
        "TaxCode": null,
        "增值税额": 24.00,
        "VATExempt": false,
        "增值税级别": 20.0000,
        "名义名称": "Entertainment",
        "项目名": "TEst",
        "项目编号": 1,
        "StockInfo": null
    }],
    "净额": 165.000000,
    "下一个号码": 0,
    "数": 2344375,
    "逾期": 0,
    "缴纳日期": null,
    "付款行": [],
    "固定链接": "\/v2\/documents\/purchaseorder\/3e196af3-7c11-46f1-b145-e3c8212b4d30",
    "上一个号码": 2344374,
    "PurchaseInECMemberState": false,
    "状态": "未付",
    "库存管理适用": false,
    "供应商代码": "08C",
    "SupplierId": 433398,
    "供应商名称": "Honda 供应商",
    "供应商参考": "wieu231",
    "支付总额": 0.0000,
    "增值税额": 30.08
}

删除操作

使用网址中提供的号码删除购买的商品。

网址: / purchases / {number}

库存管理
库存管理 在Purchases API中受支持。每个订单项都包含一个“ StockInfo”对象,该对象提供与库存有关的信息。


"StockInfo": {
  "适用于": "Product",
  "名称": "Test",
  "库存数量": 60,
  "已收到": true,
  "库存收货": "2013-12-12 12:00:00"
}

名称类型描述
库存数量数字库存数量
已收到布尔型是否收到库存。如果在PUT API中将其设置为True,则库存将标记为已收到。接收到的状态将在GET API中返回。
库存收货日期这是只读字段。它指示收到库存的日期,例如JSON格式:[JSONDATE],XML格式:[XMLDATE]
名称将应用库存更改的名义或产品名称。
适用于指示库存管理适用于名义产品还是产品。可能的值为“标称”或“产品”

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