purchase_order_push.php（创建采购单）
¥基础 ¥扩展 ¥定制
1.接口说明
| 1.1 接口描述：①新增创建采购单接口 |
| 1.2 适用版本：网页版 |
2.调用场景
3.请求参数说明
3.1 请求地址
| 环境 | HTTP地址 |
|---|
| 测试环境 | https://openapitest.huice.com/openapi/purchase_order_push.php |
| 正式环境 | https://openapi.huice.com/openapi/purchase_order_push.php |
3.2 公共请求参数
| 名称 | 字段 | 类型 | 长度
| 必须 | 描述 |
|---|
| 卖家账号 | sid | String |
| 是 | 购买ERP时由旺店通分配给ERP购买方，请从ERP购买方获取。 |
| 接口账号 | appkey | String |
| 是 | 本开放平台“自助对接”功能模块内自助申请，申请流程单击这里
|
| 时间戳 | timestamp | int |
| 是 | 北京时间1970-01-01 08:00:00起至现在的总秒数，10位int值,旺店通企业版API服务端允许请求最大时间误差为5min，date.timezone = Asia/Shanghai。 |
| 签名 | sign | String |
| 是 | API输入参数签名结果，签名算法介绍单击这里
|
3.3 业务请求参数
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
|---|
| 采购列表节点 | purchase_info | data |
| 是 | 请求参数的1级数据节点，包含采购单所有属性信息的数据节点，节点下数据字段详见下述“purchase_info” |
purchase_info
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
|---|
| 供应商编号 | provider_no | varchar | 20 | 是 | 供应商编号，ERP供应商档案必须存在此编号，否则推送失败 |
| 仓库编号 | warehouse_no | varchar | 40 | 是 | 代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置），用于创建指定仓库数据信息(不支持一次推送多个仓库编码) |
| API单号 | outer_no | varchar | 40 | 是 | API单号 |
| 自动审核 | is_check | tinyint | 1 | 否 | 是否自动审核，0 不审核，1 审核，默认不自动审核 |
| 采购姓名 | purchase_name | varchar | 40 | 否 | 采购员:姓名 |
| 预计到货日期 | expect_arrive_time | date |
| 否 | 采购单对应货品预计到达仓库时间，时间格式：YYYY-MM-DD |
| 运费 | post_fee | decimal | (19,4) | 否 | 邮资 |
| 备注 | remark | varchar | 255 | 否 | 采购单备注 |
| 采购明细节点 | details_list | data[] |
| 是 | 请求参数的2级数据节点，包含采购单所有货品明细信息的数据节点，节点下数据字段详见下述“details_list” |
details_list
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
|---|
| 商家编码（新） | spec_no | varchar | 40 | 是 | 代表单品(sku)所有属性的唯一编码，用于系统单品区分，SKU概念介绍单击这里 |
| 采购量 | num | decimal | (19,4) | 否 | 采购量 |
| 采购价格 | price | decimal | (19,4) | 是 | 采购价格,按采购单位，税前单价 |
| 折扣 | discount | decimal | (19,4) | 否 | 折扣字段，默认值为1，1代表原价，无折扣；假设需要折扣为一折时，可将字段值传为0.1，同理，折扣为5折时，传值0.5；折扣为八折时，传值0.8，以此类推 |
| 行备注 | remark | varchar | 255 | 否 | 采购货品明细备注 |
4.响应参数
4.1 公共响应参数
| 名称 | 字段 | 类型 | 长度
| 必须 | 描述 |
|---|
| 错误码 | code | int | 11 | 是 | 状态码:0表示成功,其他表示失败 |
| 错误描述 | message | varchar | 255 | 是 | 错误描述 |
个人资料
修改密码
退出