vip_wms_stockinout_order_push.php(创建委外出入库单)
¥基础
1.接口说明
1.1 接口描述:向旺店通推送委外出入库单据 |
1.2 适用版本: |
1.3注意事项: |
2.调用场景
2.1 举例说明:自有商城接入ERP、金蝶接入、用友接入、SAP接入等 |
3.请求参数说明
3.1 请求地址
环境 | HTTP地址 |
---|
测试环境 | http://sandbox.wangdian.cn/openapi2/vip_wms_stockinout_order_push.php |
正式环境 | http://api.wangdian.cn/openapi2/vip_wms_stockinout_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 业务请求参数
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|
客户端汉字字段名,无对应字段缩略写,详细在描述写 | 请求的参数字段 | 字段类型 | 建议长度,查询接口可适当放大,创建接口务必准确 | 填写是或否 | 请求参数说明示例值或者格式、具体含义、使用方法及注意事项 |
接口外部单号
| api_outer_no | varchar | 40 | 是 | 调用本接口时推送的唯一单据编号,避免重复推送数据 |
仓库id | warehouse_id | varchar | 40 | 是 | 代表仓库所有属性的唯一id,用于仓库区分 |
出入库类型 | stock_order_type | tinyint | 1 | 是 | 可选值:1(入库);2(出库) |
物流单号 | logistics_no | varchar | 20 | 否 | 代表物流所有属性的唯一编码,用于物流区分,ERP内支持自定义(ERP物流界面设置) |
收件人姓名 | receiver_name | varchar | 40 | 否 | 收件人姓名 |
手机号 | receiver_mobile | varchar | 40 | 否 | 手机号码 |
备注 | remark | varchar | 40 | 否 | 委外其他出入库单据备注 |
货品明细节点 | goods_list | data[ ] |
| 是 | 委外出入库单货品列表节点 |
goods_list
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|
商家编码 | sku_no | varchar | 40 | 是 | ERP内单品唯一编码(SKU),代表单品(SKU)所有属性,并且为库存量出入计算最小单元。SKU概念介绍,单击这里
注:推送的spec_no值在ERP货品档案必须存在,否则单据会创建失败。 |
出入库数量 | num | decimal | (19,4) | 是 | 出入库数量 |
价格 | price | decimal | (19,4) | 是 | 价格,默认为0 |
批次号 | batch_no | varchar | 20 | 否 | 指定批次号 |
备注 | remark | varchar | 255 | 否 | 货品明细备注 |
4.响应参数
4.1 公共响应参数
名称 | 字段 | 类型 | 长度
| 必须 | 描述 |
---|
错误码 | code | int | 11 | 是 | 状态码:0表示成功,其他表示失败 |
错误描述 | message | varchar | 255 | 是 | 错误描述 |
委外出入库单号 | outsource_no | varchar | 40 | 是 | 委外出入库单号 |