当前位置: API文档

wms.outer.OuterOut.createOrder(外仓调整出库单创建)

¥标准

1.接口说明

1.1 接口描述:外仓调整出库单创建
1.2 适用版本:客户端 V1.4.5.8及以上版本
1.3 增量获取:
1.4 时间跨度:
1.5注意事项:【权限校验】:仓库权限

2.调用场景

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

3.请求参数说明

   3.1 请求地址

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

   3.2 公共请求参数

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

  3.3 业务请求参数

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

单据数据

order

Map<String, Object>


单据数据

单据明细

order_details

List<Map<String, Object>>


单据明细

是否审核

is_check

boolean


审核:true

不审核:false

order

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

仓库编号

warehouse_no

String

40

仓库编号

备注

remark

String

255

备注

外部单号

order_no

String

40

传入外部单号则使用外部单号作为系统内业务单号

源单类型

src_order_type

Int

4

0:调整出库,2:调拨出库,14:采购退货出库

源单号

src_order_no

String

40

源单类型为2和14需传源单号

出库原因

reason

String

64

出库原因

order_details

名称字段类型长度
必须描述
商家编码spec_no
String40
商家编码
数量numInt11数量
辅助单位

aux_unit_name

String20
辅助单位
备注
remarkString255备注
是否残次品defectboolean1
默认false
批次编号
batch_noString50

批次编号若不在会自动创建 (奇门自定义无此参数)

有效期
expire_dateString
有效期(奇门自定义无此参数)

4.响应参数

名称字段类型长度
必须描述
状态码statusInt

返回0为正常

错误信息message

String


无错误信息不返回
结果信息data


Map<String, Object>


结果信息

data

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

status

Int

0:表示操作全部成功

20:审核失败

返回信息

message

String


status = 0时,返回创建成功的单号;否则返回错误信息

5.请求示例

Json格式请求报文
[{"warehouse_no":"pos"},[{"spec_no":"DFAQT101","num":2}],false]
PHP

<?php
include 'wdtsdk.php';
 
$client = new WdtErpClient("url", "wdtapi3", "appkey", "secret")
 
$order = new stdClass();
$order->warehouse_no = 'pos';
 
$detail = new stdClass();
$detail->spec_no = 'DFAQT101';
$detail->num = 2;
$details = array($detail);
 
try {
    $response = $client->call("wms.outer.OuterOut.createOrder", $order, $details, false);
    echo json_encode($response);
}catch (exception $e)
{
    echo "exception info:".$e->getMessage();
}

JAVA
C#

6.响应示

   6.1 正常响应示例 

JSON

[{"warehouse_no":"pos"},[{"spec_no":"DFAQT101","num":2}],false]

   6.2 异常响应示例

JSON
{"status":100,"code":"right.required","message":"无该仓库权限"}




常用工具