vip_wms_stockinout_order_push.php（创建委外出入库单）
¥基础
1.接口说明
| 1.1 接口描述：向旺店通推送委外出入库单据 |
| 1.2 适用版本： |
| 1.3注意事项： |
2.调用场景
| 2.1 举例说明：自有商城接入ERP、金蝶接入、用友接入、SAP接入等 |
3.请求参数说明
3.1 请求地址
| 环境 | HTTP地址 |
|---|
| 测试环境 | https://openapi.ali.huice.cc/openapi/vip_wms_stockinout_order_push.php |
| 正式环境 | https://openapi.huice.com/openapi/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，用于仓库区分，在旺店通ERP【仓库信息维护】界面查看 |
| 出入库类型 | stock_order_type | tinyint | 1 | 是 | 可选值：1(入库)；2（出库） |
| 物流单号 | logistics_no | varchar | 20 | 否 | 代表物流所有属性的唯一编码，用于物流区分，ERP内支持自定义（ERP物流界面设置） |
收件人姓名 | receiver_name | varchar | 40 | 否 | 收件人姓名 |
| 省 | province | varchar | 50 | 否
| 省份名称，直辖市注意输入值为“北京”不是“北京市”，“北京市”在city参数内输入 |
| 市 | city | varchar | 50 | 否
| 市名称 |
| 县(区) | district | varchar | 50 | 否
| 区县名称 |
| 详细地址 | address | varchar | 255 | 否 | 地址详情描述 ，例如 xx街道XX小区xx号楼xx单元401 |
| 手机号 | 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 | 是 | 委外出入库单号 |
5.请求示例
| PHP | <?php
require_once '../WdtClient.php';
$c = new WdtClient();
$c->sid = '';
$c->appkey = '';
$c->appsecret = '';
$c->gatewayUrl = 'https://openapi.ali.huice.cc/openapi/vip_wms_stockinout_order_push.php';
$c->putApiParam('api_outer_no', 'wms_20260413002');
$c->putApiParam('warehouse_id', '38');
$c->putApiParam('stock_order_type', 1);
$c->putApiParam('logistics_no', 'ZT20260413002');
$c->putApiParam('logistics_name', '中通快递1');
$goods_list = array(
array(
'sku_no' => '20251010-0085',
'num' => 14,
'remark' => '测试货品',
'price' => 111
)
);
$c->putApiParam('goods_list', json_encode($goods_list, JSON_UNESCAPED_UNICODE));
$json = $c->wdtOpenApi();
var_dump($json);
?> |
| JAVA |
|
| C# |
|
python
|
|
6.响应示例
6.1 正常响应示例
JSON
| {
"code": 0,
"message": "",
"outsource_no": "WK2604130002"
} |
6.2 异常响应示例
JSON
| {
"code": 21000006,
"message": "外部单号重复，请保证外部单号[api_outer_no]的唯一性"
} |
个人资料
修改密码
退出