1. 采购单模块API
API URL
post {HTTP(S)地址}/api/{version}/purchase
1.1. 采购单查询接口
1.1.1. SERVICE_TYPE
QUERY_PURCHASE_ORDER_LIST
1.1.2. 请求参数
| 参数 | 是否必须 | 类型 | 示例 | |
|---|---|---|---|---|
| purchaseNumber | N | String | P210819125115 | 采购单号，最大50个字符 |
| customNumber | N | String | 210819125115 | 参考单号 |
| status | N | String | NEW | 采购单状态 |
| updateTimeFrom | N | String | 2021-08-31 | 更新时间（范围开始） |
| updateTimeTo | N | String | 2021-08-31 | 更新时间（范围结束） |
| page | Y | Number | 1 | 页码，默认1 |
| pageSize | Y | Number | 100 | 每页条数.不超过200条; |
1.1.3. 返回参数
| 参数 | 是否必须 | 类型 | 示例 | 备注 |
|---|---|---|---|---|
| errorCode | Y | String | “DATA_INPUT_ERROR” | 错误码](commons/errors.md#_错误码) |
| errorMsg | Y | String | “输入参数不对” | 业务错误信息 |
| state | Y | String | success | 请求结果 |
| total | Y | Number | 100 | 总条数 |
| result | Y | List | 详见PurchaseOrder |
PurchaseOrder（采购订单）
| 参数 | 是否必须 | 类型 | 示例 | 备注 |
|---|---|---|---|---|
| purchaseNumber | Y | String | P210819125115 | 采购单号 |
| asnNumber | Y | String | A210819125116 | 入库单号 |
| customNumber | Y | String | 自定义参考号 | 参考号 |
| warehouseName | Y | String | 采购仓 | 采购仓 |
| transferWarehouseName | Y | String | 中转仓 | 中转仓 |
| purchaseType | Y | String | TRANSFER | TRANSFER：海外仓采购 DIRECT：国内仓采购 |
| supplierName | Y | String | 供应商 | 供应商 |
| settlementType | Y | String | DELIVERY_ON_CASH | 结算方式 DELIVERY_ON_CASH：带款提货 FIXED_ACCOUNT_PERIOD：固定账期 DYNAMIC_ACCOUNT_PERIOD：动态账期 |
| prepayRate | Y | Decimal | 30 | 预付比例百分比 30表示30% |
| purchasePriceUnit | Y | String | CNY | 币种 |
| paymentType | Y | Enum | CASH | 支付方式 CASH：现金 TRANSFER：转账 |
| shippingCost | Y | Decimal | 1.0 | 运费 |
| transportMode | Y | Enum | SELF | 运输方式 SELF：自提 EXPRESS：快递 LOGISTICS：物流 DELIVERY：送货 |
| buyerTitle | Y | String | 张三 | 买方抬头 |
| companyName | Y | String | 张三有限公司 | 公司抬头 |
| transportParty | Y | String | SUPPLIER | 运输承担方 SUPPLIER：供应商 PURCHASER：采购方 |
| createTime | Y | String | 2021-08-01 00:00:00 | 创建时间 |
| updateTime | Y | String | 2021-08-01 00:00:00 | 更新时间 |
| orderTime | N | String | 2021-08-01 00:00:00 | 下单时间 |
| preReceiveTime | Y | String | 2021-08-02 00:00:00 | 预计到货日期 |
| status | Y | String | NEW | 采购单状态 |
| purchaseMode | Y | String | STANDARD | 采购模式 EASYWAY：简单模式 STANDARD：标准模式 |
| remark | Y | String | 这是一段备注 | 备注 |
| skuList | Y | List | 详见 PurchaseOrderSku |
PurchaseOrderSku 采购订单商品
| 参数 | 是否必须 | 类型 | 示例 | 备注 |
|---|---|---|---|---|
| sku | Y | String | SKU001 | 商品SKU |
| title | Y | String | This a good title | 商品名称 |
| purchasePrice | Y | Decimal | 998 | 采购价格 |
| purchaseQuantity | Y | Number | 1 | 采购数量 |
| packSpecification | Y | Number | 5 | 装箱率 |
| taxRate | Y | Decimal | 0.1 | 采购税率 |
1.2. 采购单创建接口
1.2.1. SERVICE_TYPE
CREATE_PURCHASE_ORDER
1.2.2. 请求参数
| 参数 | 是否必须 | 类型 | 示例 | 备注 |
|---|---|---|---|---|
| purchaseType | Y | String | DIRECT/TRANSFER | 采购类型，见枚举 |
| customNumber | N | String | Xxxx111 | 参考号 |
| warehouseName | Y | String | 采购仓名称 | 采购仓库名称 |
| transferWarehouseName | N | String | 中转仓库名称 | 中转仓库名称 |
| purchaserName | Y | String | 采购员名称 | 采购员名称 |
| purchaseDate | Y | String | 2022-01-01 | 创建时间 |
| preReceiveTime | N | String | 2022-01-01 | 预计到货时间 |
| purchasePriceUnit | Y | String | CNY | 币种，见枚举 |
| shippingCost | N | BigDecimal | 100.00 | 运费 |
| companyName | N | String | Xxx111 | 公司抬头 |
| buyerTitle | N | String | Xxx111 | 买方抬头 |
| transportParty | Y | String | SUPPLIER | 运输承担方，见枚举 |
| transportMode | Y | String | SELF | 运输方式，见枚举 |
| trackingNumber | N | String | Xxx111 | 跟踪号 |
| remark | N | String | Xxx111 | 备注 |
| supplierName | Y | String | 供应商名称 | 供应商名称 |
| paymentType | Y | String | CASH | 支付方式，见枚举 |
| settlementType | Y | String | DELIVERY_ON_CASH | 结算方式，见枚举 |
| prepayRate | N | BigDecimal | 15 | 预付比例 |
| effectiveNode | N | String | RECEIVE | 当选择的结算方式是非带货提款方式时，DELIVERY_ON_CASH 时，参数必传，见枚举 |
| accountPeriodList | N | String | [{"days":"1","percent":50},{"days":"2","percent":35}] | 当选择的结算方式是动态账期DYNAMIC_ACCOUNT_PERIOD时，参数必传。Percent+预付比例需要是100 |
| accountPeriodOpt | N | String | MONTHLY | 当选择的结算方式是固定账期FIXED_ACCOUNT_PERIOD 时，参数必传。 |
| billingDate | N | Long | 20 | 当选择的结算方式是固定账期FIXED_ACCOUNT_PERIOD 时，参数必传。范围1<=param<=31 |
| skuList | Y | List< PurchaseOrderSku> | 采购单sku | |
| purchaseExtVO | N | purchaseExtVO | 1688扩展字段，见purchaseExtVO |
PurchaseOrderSku(采购单商品列表)
| 参数 | 是否必须 | 类型 | 示例 | 备注 |
|---|---|---|---|---|
| sku | Y | String | S90 | 商品sku |
| purchasePrice | Y | BigDecimal | 100.00 | 商品采购价格 |
| purchasePriceUnit | Y | String | CNY | 采购价币种 |
| purchaseQuantity | Y | Long | 100 | 采购数量 |
| remark | N | String | This is remark! | 采购备注 |
| taxRate | Y | BigDecimal | 0 | 采购税率 |
purchaseExtVO(1688对象)
| 参数 | 是否必须 | 类型 | 示例 | 备注 |
|---|---|---|---|---|
| open1688AccountName | Y | String | 1688下单账号 | 1688下单账号 |
| open1688Address | Y | String | 1688 收货地址 | 1688 收货地址 |
| open1688BuyerMsg | N | String | 买家留言 | 买家留言 |
| open1688OrderType | Y | String | general | 1688订单类型，见枚举 |
| open1688TradeType | N | String | FXASSURE | 交易方式，见枚举 |