易仓创建/编辑采购单V3.0API接口文档
创建/编辑采购单V3.0
接口地址:syncPurchaseOrders
请求方法: POST
加工厂: {"operation":{"method":"none"}}
接口请求参数
序号 | 字段 | 名称 | 类型 | 默认值 | 描述 | 是否必要 |
---|---|---|---|---|---|---|
1 | supplier_ba_id | 支付方式ID | int | 支付方式ID(当供应商收款方式为银行卡时,可选填),接口getSupplierInfo查询 Response.data.paymentAccountList.spmId | 否 | |
2 | operation_type | 运营方式 | int | 运营方式:1代运营,2自运营 | 是 | |
3 | is_1688 | 是否是1688采购单 | int | 是否是1688采购单,0:否1:是。注:1688采购单只能是待确认状态 | 否 | |
4 | account_type | 结算方式 | int | 结算方式:1:货到付款2:款到发货3:账期 | 是 | |
5 | warehouse_id | 采购仓库ID | int | 采购仓库ID | 是 | |
6 | suppiler_id | 供应商ID | int | 供应商ID | 是 | |
7 | po_code | 采购单号 | string | 采购单号,采购单操作类型为1(编辑)时,必填 | 否 | |
8 | bk_id | 支付银行 | int | 支付银行(当支付方式银行卡时,可选填) ,提供接口getPaymentAccount查询 | 否 | |
9 | date_eta | 预计到货时间 | date | 预计到货时间 格式:YYYY-MM-DD | 否 | |
10 | supplier_bk_id | 收款银行 | int | 收款银行(当供应商收款方式为银行卡时,可选填),接口getSupplierInfo查询 | 否 | |
11 | transaction_no | 支付单号 | int | 支付单号 | 否 | |
12 | pro_code | 申购单号(分销系统用) | string | 申购单号(分销系统用) | 否 | |
13 | po_status | 单据状态 | int | 1:待确认,2:待审核,3:已审核 默认值:待确认解释:待确认:即新建采购单时候的初始状态;待审核:提交确认了采购单,等待审核;已审核:即审核通过,变更为采购在途;注意:采购单操作类型为1(编辑)时,状态只支持 1(待确认) | 否 | |
14 | action_type | 采购单操作类型 | int | 采购单操作类型 ADD:创建;EDIT:编辑;默认 ADD | 是 | |
15 | date_create | 创建时间 | date | 创建时间,默认当前时间格式:YYYY-MM-DD | 否 | |
16 | receiver | 收件人ID | int | 收件人ID | 否 | |
17 | supplier_pay_type | 供应商收款方式: | int | 供应商收款方式:1现金2在线(支付宝)3银行卡 | 是 | |
18 | single_net_number | 网采单号 | object | 网采单号(可填多个,当是否网采为1时可选填),格式:["101508120001","101508120001"] | 否 | |
19 | currency_code | 币种 | string | 币种 | 是 | |
20 | po_is_net | 是否网采, | int | 是否网采,0否,1是,默认0 | 否 | |
21 | pay_ship_amount | 运费 | int | 运费 | 否 | |
22 | pts_oprater | 跟单员ID | int | 跟单员ID | 是 | |
23 | po_type | 补货方式 | int | 补货方式:0缺货入库,1警报入库,2特采入库,3正常入库,4样品采购入库,5备货采购,6试销采购,7返修入库 ,注意:如果在系统有维护补货方式则使用系统维护的对应关系 | 是 | |
24 | account_proportion | 预付比例(结算方式为款到发货时可选填) | int | 预付比例(结算方式为款到发货时可选填) | 否 | |
25 | ba_id | 支付银行卡账号 | int | 支付银行卡账号(当支付方式为银行卡时,可选填),提供接口getPaymentAccount查询 | 否 | |
26 | alipay_supplier_account | 供应商支付宝账户 | string | 供应商支付宝账户(当供应商收款方式为在线时,可选填) ,接口getSupplierInfo查询 | 否 | |
27 | tracking_no | 跟踪单号 | string | 跟踪单号 | 否 | |
28 | alipay_account | 支付宝账户 | string | 支付宝账户(当支付方式为在线时,可选填) ,提供接口getPaymentAccount查询 | 否 | |
29 | po_is_has_tax | 采购是否含税 | string | 采购是否含税 | 否 | |
30 | date_expected | 预计出厂时间格式 | string | 预计出厂时间格式:YYYY-MM-DD | 否 | |
31 | product_list | 采购产品明细 | object | 采购产品明细,具体见下表 | 否 | |
31.1 | product_sku | 产品代码 | string | 产品代码 | 是 | |
31.2 | qty_free | 赠品数量 | string | 赠品数量 | 否 | |
31.3 | qty_expected | 产品数量 | int | 产品数量 | 是 | |
31.4 | pop_reference_unit_price | 采购参考价 | int | 采购参考价 | 否 | |
31.5 | is_free | 是否赠品 | int | 是否赠品,0:否 1:是 | 否 | |
31.6 | note | 备注 | string | 备注 | 否 | |
31.7 | pop_external_number | 外部单号 | int | 外部单号 | 否 | |
31.8 | currency_code | 币种 | string | 币种 | 是 | |
31.9 | is_qc | 是否质检 | int | 是否质检, 0:否、1:是 | 否 | |
31.10 | reason | 下单原因 | string | 下单原因 | 否 | |
31.11 | unit_price | 单价 | int | 单价 该值需大于0,is_free字段传1后,该值会默认为0,但传值仍需大于0 | 是 | |
31.12 | po_tax_rate | 税率 | int | 税率 | 否 | |
32 | is_rebate_tax | 是否退税 | int | 是否退税 0:否 1:是 | 否 | |
33 | to_warehouse_id | 中转仓库ID | string | 中转仓库ID | 否 | |
34 | ref_no | 参考号 | string | 参考号 | 否 | |
35 | pay_type | 支付方式: | int | 支付方式:1现金2在线(支付宝)3银行卡 | 是 | |
36 | organization_id | 组织机构Id | string | 组织机构Id | 否 | |
37 | shipping_method_id_head | 供应商运输方式: | int | 供应商运输方式:1自提,2快递,3物流,4送货 | 是 | |
38 | operator_purchase | 采购员ID | int | 采购员ID | 是 |
接口响应参数
序号 | 字段 | 名称 | 类型 | 默认值 | 描述 | 是否必要 |
---|
易仓的接口:创建/编辑采购单V3.0(syncPurchaseOrders),由轻易云数据集成平台API资产管理模块整理收纳,并且根据易仓版本更新同步实时更新。API资产管理平台支持API的市场推广和商业化,帮助企业发掘API的商业价值,拓展新的收入来源和业务模式。