当前位置: API文档
wms.GoodsPack.upload(箱码创建)
1.接口说明
1.1 接口描述:创建箱码信息 |
1.2 适用版本:客户端 V1.5.2.5及以上版本 |
1.3 增量获取: |
1.4 时间跨度: |
1.5 注意事项: |
2.调用场景
2.1举例说明:SAP、线下ERP、SRM、SCM等系统对接 |
3.请求参数说明
3.1 请求地址
环境 | HTTP地址 |
---|---|
测试环境 | http://47.92.239.46/openapi |
正式环境 | http://wdt.wangdian.cn/openapi |
3.2 公共请求参数
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
卖家账号 | sid | String | Y | 卖家账号, 由旺店通分配 | |
接口账号 | key | String | Y | 由旺店通分配appkey, 在发送的数据中对应 key 字段,获取方式点击这里 | |
盐 | salt | String | Y | 由旺店通分配appsecret,是由两部分构成, 冒号前面的部分是secret, 冒号后面的部分是salt. 例如一个appsecret是testsecret:testsalt, 那么secret为testsecret, salt为testsalt. | |
接口名称 | method | String | Y | 调用的接口名称 | |
版本号 | v | String | Y | 1.0 | |
秒级时间戳 | timestamp | int | Y | 秒级时间戳, 当前时间戳减去 2012-01-01 00:00:00(1325347200), 时间与服务器时间差120s内即合法。 | |
签名 | sign | String | Y | 签名 | |
分页大小 | page_size | int | N | 分页大小,分页查询必传 | |
分页编号 | page_no | int | N | 分页编号,分页查询必传,标准接口page_no从0开始 | |
是否计算查询结果的总条数 | calc_total | int | N | 是否计算查询结果的总条数, 需要计算则1, 否则填0 |
3.3 业务请求参数
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
业务请求参数 | params | Map<String, Object> | Y | 业务请求参数 |
params
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
仓库编号 | warehouse_no | String | Y | 仓库编号 | |
商家编码 | src_spec_no | String | Y | 商家编码 | |
数量 | num | BigDecimal(19,4) | Y | 数量 | |
状态 | status | byte | Y | 状态 0:未入库 2:已入库 | |
箱码 | pack_barcode | String | N | 箱码(不传值则自动生成) | |
批次号 | batch_no | String | N | 批次号 | |
有效期 | expire_date | String | N | 有效期 |
4.响应参数
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
状态码 | status | Int | Y | 返回0为正常 | |
错误信息 | message | String | Y | 无错误信息不返回 | |
响应信息 | data | Map<String, Object> | Y | 响应信息 |
5.请求示例
| [ { "num": 1, "src_spec_no": "lzx0612-3", "status": 0, "warehouse_no": "1001" } ] |
| <?php header("Content-Type: text/html; charset=UTF-8"); date_default_timezone_set("Asia/Shanghai"); $client = new WdtErpClient("url", "wdtapi3", "appkey", "secret") $param = new stdClass(); $param->warehouse_no = '1001'; $param->src_spec_no = 'lzx0612-3'; $param->num = 1; $param->status = 0; $data = $client->call("wms.GoodsPack.upload", $param); ?> |
6.响应示例
6.1正常响应示例
| { "data": "Z202406170016", "status": 0 } |
6.2异常响应示例
| { "message": "状态错误", "status": 100 } |