当前位置: API文档
purchase.PurchaseOrder.createOrder(采购单新建)
1.1 接口描述:推送采购单据给ERP |
1.2 适用版本:客户端 V1.2.5.6及以上版本 |
1.3 增量获取: |
1.4 时间跨度:start_time和end_time最大跨度为30天。 |
1.5注意事项:【权限校验】:供应商权限 |
2.1 举例说明:财务系统、SAP、线下ERP、数据分析等系统的对接 |
环境 | HTTP地址 |
---|---|
测试环境 | http://47.92.239.46/openapi |
正式环境 | http://wdt.wangdian.cn/openapi |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
卖家账号 | sid | String | 是 | 卖家账号, 由旺店通分配 | |
接口账号 | key | String | 是 | 由旺店通分配appkey, 在发送的数据中对应 key 字段 | |
盐 | salt | String | 是 | 由旺店通分配appsecret,是由两部分构成, 冒号前面的部分是secret, 冒号后面的部分是salt. 例如一个appsecret是testsecret:testsalt, 那么secret为testsecret, salt为testsalt. | |
接口名称 | method | String | 是 | 调用的接口名称 | |
版本号 | v | String | 是 | 1.0 | |
秒级时间戳 | timestamp | int | 是 | 秒级时间戳, 当前时间戳减去 2012-01-01 00:00:00(1325347200), 时间与服务器时间差120s内即合法。 | |
签名 | sign | String | 是 | 签名 | |
分页大小 | page_size | int | 否 | 分页大小,分页查询必传 | |
分页编号 | page_no | int | 否 | 分页编号,分页查询必传 | |
是否计算查询结果的总条数 | calc_total | int | 否 | 是否计算查询结果的总条数, 需要计算则1, 否则填0 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
新建参数 | params | Map<String, Object> | Y | 新建参数 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
采购单编号 | purchase_no | String | 20 | N | 采购单编号 |
供应商编号 | provider_no | String | 20 | Y | 供应商编号 |
收货仓编号 | receive_warehouse_nos | String | 40 | Y | 收货仓编号 |
预计入库仓库编号 | expect_warehouse_no | String | 40 | Y | 预计入库仓库编号 |
采购员 | purchaser_name | String | 40 | Y | 采购员 |
是否要审核 | is_check | bool | 1 | N | 不传默认为false |
引用的采购申请单编号 | apply_nos | String | 255 | N | 采购申请单编号,使用英文逗号隔开 |
收货地址 | receive_address | String | 255 | N | 收货地址 |
联系人 | contact | String | 40 | N | 联系人 |
电话 | telno | String | 32 | N | 电话 |
物流名称 | logistics_name | String | 64 | N | 物流名称,参考附录物流名称表 |
标记名称 | flag_name | String | 32 | N | 标记名称 |
预计到货时间 | expect_time | String | 19 | N | 预计到货时间 |
创建时间 | created | String | 19 | N | 不传或为空,则为当前时间 |
付款方式 | pay_type | Int | 4 | N | 1:现付 2:到付 |
运费支付方式 | postfee_pay_type | Int | 4 | N | 0 无 1 现付 2 到付 3 包邮 |
备注 | remark | String | 255 | N | 备注 |
邮费 | post_fee | Decimal(19,4) | N | 邮费 | |
其他费用 | other_fee | Decimal(19,4) | N | 其他费用 | |
采购单详情 | purchase_details | List<Map<String, Object>> | N | 采购单详情 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
商家编码 | spec_no | String | 40 | Y | 商家编码 |
采购数量 | num | Int | 11 | Y | 采购数量 |
采购单位 | purchase_unit_name | String | 20 | N | 采购单位 |
备注 | remark | String | 255 | N | 备注 |
自定义属性1 | prop1 | String | 255 | N | 自定义属性1 |
自定义属性2 | prop2 | String | 255 | N | 自定义属性2 |
税前单价 | price | Decimal(19,4) | N | 税前单价 | |
折扣 | discount | Decimal(19,4) | N | 折扣 | |
税率 | tax_rate | Decimal(19,4) | N | 税率 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
状态码 | status | Int | Y | 状态码为0,表示调用成功 | |
错误信息 | message | String | Y | 成功返回创建成功的采购单号,否则返回错误信息 | |
结果信息 | data | Map<String, Object> | Y | 结果信息 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
状态码 | status | Int | Y | 状态码为0,表示调用成功 | |
返回信息 | message | String | Y | 成功返回创建成功的采购单号,否则返回错误信息 |
JSON | { "status": 0, "data": { "message": "CG202003260001", "status": 0 } } |
JSON | { "status": 100, "message": "供应商不存在" } |