当前位置： API文档

wms.outer.OuterTransfer.createByApi（外仓快速调拨）

¥标准

1.接口说明

1.1 接口描述：推送调拨单给ERP
1.2 适用版本：客户端 V1.5.8.6及以上版本
1.3 增量获取：
1.4 时间跨度：

1.5注意事项：【权限校验】：仓库权限
(1)使用外仓明细调拨的情况下，仓库需要开启外仓库存明细配置
(2)使用mode=3/4调拨方案的情况下，需要联系旺店通实施开通增值配置

2.调用场景

2.1 举例说明：财务系统、SAP、线下ERP、数据分析等系统的对接

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境http://47.92.239.46/openapi
正式环境http://wdt.wangdian.cn/openapi

    3.2 公共请求参数

名称字段类型长度
必须描述
卖家账号sidString
Y卖家账号, 由旺店通分配
接口账号keyString
Y由旺店通分配appkey, 在发送的数据中对应 key 字段,获取方式点击这里
盐saltString
Y由旺店通分配appsecret，是由两部分构成, 冒号前面的部分是secret, 冒号后面的部分是salt. 例如一个appsecret是testsecret:testsalt, 那么secret为testsecret, salt为testsalt.
接口名称methodString
Y调用的接口名称
版本号vString
Y1.0
秒级时间戳timestampint
Y秒级时间戳, 当前时间戳减去 2012-01-01 00:00:00(1325347200), 时间与服务器时间差120s内即合法。
签名signString
Y签名

    3.3 业务请求参数

名称字段类型长度必须描述

业务请求参数

params

Map<String, Object>


Y

ye

明细信息

detail_list

List<Map<String, Object>>


Y

明细信息

params

名称字段类型长度必须描述

创建模式

create_modeInt

N

0：保存

1：提交

2：快速审核

默认0

调出仓库

from_warehouse_no

String

40

Y

调出仓库

调入仓库

to_warehouse_no

String

40

Y

调入仓库

执行wms借调单编辑中状态

wms_edit

Int


N

0：否
1：是

默认0

调拨方案modeInt
Y

1：外仓单品调拨（出+入）

2：外仓明细调拨（出+入）

3：外仓单品调拨（出+入+接口）

4：外仓明细调拨（出+入+接口）

备注

remark

String


N

备注

detail_list

名称字段类型长度必须描述
商家编码

spec_no

String


Y

商家编码

调拨数量

num

Decimal(19,4)


Y

调拨数量

批次号

batch_no

String


N

批次号  mode=2/4有效

有效期

expire_date

String


N

有效期  mode=2/4有效

是否残次品
defectInt1

N

是否残次品
0：否

1：是

备注
remarkString

N

备注

4.响应参数

名称字段类型长度必须描述

状态码

status

Int


Y

返回0为正常

错误信息

message

String


Y

无错误信息不返回

结果信息

data

Map<String, String>


Y

结果信息

data

名称字段类型长度必须描述

调拨单号

transfer_no

String


Y

创建成功后返回调拨单号

5.请求示例

json格式请求报文

[
    {
        "mode": "2",
        "wms_edit": "1",
        "create_mode": "2",
        "remark": "testMainRemark",
        "from_warehouse_no": "daj-wms-wdt",
        "to_warehouse_no": "lz-002"
    },
    [
        {
            "defect": "0",
            "num": "10",
            "remark": "testDetailRemark",
            "spec_no": "daj1"
        }
    ]
]

php 请求示例


JAVA
C#

6.响应示例

   6.1 正常响应示例 

JSON

{"status":0,"data":{"transfer_no":"TF38580"}}

   6.2 异常响应示例

JSON

{"status":100,"message":"源仓库不存在"}




常用工具