当前位置: API文档
setting.strategy.VirtualWarehouse.create(虚拟仓订单创建)
1.1 接口描述:创建虚拟仓订单给ERP |
1.2 适用版本:客户端 V1.3.8.3及以上版本 |
1.3 增量获取: |
1.4 时间跨度: |
1.5注意事项:权限校验:【虚拟仓权限】 |
2.1 举例说明:自研商城、SCM、SRM、财务系统、SAP等系统的对接 |
环境 | 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 | 是 | 签名 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
单据信息 | orderMap | Map<String, Object> | 是 | 单据信息 | |
明细信息 | detailList | List<Map<String, Object>> | 是 | 明细信息 |
orderMap
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
虚拟仓编号 | virtual_warehouse_no | String | 是 | 虚拟仓编号 | |
单据类型 | order_type | byte | 否 | 1:锁定分配,2:释放出库,3:虚拟仓间调拨,4:采购入库 | |
目标虚拟仓编号 | to_virtual_warehouse_no | String | 否 | order_type=3时必传 | |
是否预审核 | is_pre_check | Int | 否 | 仅在order_type=3时生效 1:预设审核, 0:不审核 | |
库存不足则不审核 | insufficient_stock_not_pre_check | Int | 否 | 仅在order_type=3时生效,默认0 1:审核, 0:不审核 | |
审核时间 | pre_time | String | 否 | 仅在order_type=3时生效, 格式: yyyy-MM-dd HH:mm, 时间要大于当前服务器时间2分钟以上 | |
备注 | remark | String | 否 | 默认为空 | |
是否审核单据 | is_check | Int | 否 | 1:审核, 0:不审核 默认0不审核 |
detailList
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
商家编码 | spec_no | String | 是 | 商家编码 | |
实体仓编号 | warehouse_no | String | 是 | 实体仓编号 | |
入库数量 | num | BigDecimal<19,4> | 否 | 入库数量,默认为1 | |
成本 | price | BigDecimal<19,4> | 否 | 成本,默认为0 | |
采购在途数量 | purchase_num | BigDecimal<19,4> | 否 | 采购在途数量,默认为0 | |
自定义数量 | factory_num | BigDecimal<19,4> | 否 | 自定义数量,默认为0 |
返回值为一个Map<String, Object>
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
状态码 | status | Int | 是 | 状态码,0表示正常 | |
错误信息 | message | String | 是 | 无错误信息不返回 | |
结果信息 | data | Map<String, Object> | 是 | 结果信息 |
data
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
返回信息 | message | String | 是 | 如果创建成功message内容为单号,否则为错误信息 | |
状态码 | status | Int | 是 | 0:操作全部成功 20:审核失败 |
JSON | { "status": 0, "data": { "message": "VO202203290031", "status": 0 } } |
JSON | { "status": 100, "message": "虚拟仓不存在:lzx" |