当前位置： API文档 > 库存类

wms.outer.OuterOut.createOrder（外仓调整出库单创建）

¥标准

1.接口说明

1.1 接口描述：外仓调整出库单创建
1.2 适用版本：客户端 V1.5.7.0及以上版本
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
否有效期
是否开启序列号
is_enable_snInt
否

0：不开启

1：开启
默认不开启

序列号列表
sn_listString
否

序列号列表，多个序列号用","分隔，

例如："xxx1,xxx2,xxx3"，开启序列号后序列号数量要与出库数量保持一致

4.响应参数

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

返回0为正常

错误信息message

String


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


Map<String, Object>


是结果信息

data

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

status

Int
是

0：表示操作全部成功

20：审核失败

返回信息

message

String


是

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

5.请求示例

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
<?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();
}



6.响应示例

   6.1 正常响应示例 

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

   6.2 异常响应示例

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




常用工具