当前位置: API文档

wms.stockother.In.push(其它入库业务单创建)

¥标准

1.接口说明

1.1 接口描述:其它入库业务单创建
1.2 适用版本:客户端 V1.3.3.9及以上版本
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>>


单据明细

order

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

仓库编号

warehouse_no

String

40

仓库编号

物流公司编号

logistics_code

String

60

ERP系统内自行维护的物流公司的编号

入库原因

reason

String

255

入库原因

标记名称

flag_name

String

32

标记名称

物流单号

logistics_no

String

40

物流单号

备注

remark

String

255

备注

其它入库业务单属性1

prop1

String


其他入库业务单属性1

其它入库业务单属性2

prop2

String


其他入库业务单属性2

其它入库业务单属性3

prop3

String


其他入库业务单属性3

其它入库业务单属性4

prop4

String


其他入库业务单属性4

其它入库业务单属性5

prop5

String


其他入库业务单属性5

其它入库业务单属性6

prop6

String


其他入库业务单属性6

外部单号

outer_no

String


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

是否审核

is_check

boolean

1

审核传入true,不传默认false,

传入false则创建的业务单为待审核状态

order_details

名称字段类型长度
必须描述
商家编码spec_no
String40
商家编码
数量numInt11数量
货位
position_no
String20
货位
批次
batch_noString40
批次
有效期
expire_dateString
40
有效期
是否残次品defectboolean1默认false
辅助单位aux_unit_nameString
基本单位取值:优先取单品,单品无则取货品基本单位,辅助单位需要和基本单位有匹配关系
备注remarkString255备注

4.响应参数

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

返回0为正常

错误信息message

String


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

Map<String, Object>


结果信息

data

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

status

Int

0:表示操作全部成功

20:审核失败

返回信息

message

String


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

5.请求示例

Json格式请求报文
[
    {
        "outer_no":"stockother_out02",
        "warehouse_no":"1002",
        "remark":"API TEST",
        "is_check":true
    },
    [
        {
            "spec_no":"PC_2018",
            "num":"200.0000",
            "defect":false,
            "batch_no":"11111",
            "expire_date":"2020-07- 01 00:00:00"
}]]
PHP

<?php
header("Content-Type: text/html; charset=UTF-8");
date_default_timezone_set("Asia/Shanghai");
require_once('wdtsdk.php');
  
$client = new WdtErpClient("url", "wdtapi3", "appkey", "secret"); 
$order = new stdClass();
$order->outer_no = "stockother_in03";
$order->warehouse_no = "1002";
$order->defect = 1;
$order->remark = "API TEST";
$order->is_check = true;
 
$specList = array();
$spec = new stdClass();
$spec->spec_no = "PC_2018";
$spec->remark ="PD TEST";
$spec->num ="200.0000";
$spec->defect = false;
$spec->batch_no = '11111';
$spec->expire_date = '2020-07-01 00:00:00';
//$spec->position_no = 'xcx';
 
array_push($specList, $spec);
 
// 审核失败的message, 前缀为check_fail
$data = $client->call("wms.stockother.In.push", $order, $specList);
 
?>

JAVA
C#

6.响应示

   6.1 正常响应示例 

JSON

{
    "status": 0,
    "data": {
        "message": "QR202206240004",
        "status": 0
    }
}

   6.2 异常响应示例

JSON
{"status":0,"data":{"message":"check_fail 状态不正确","status":0}}




常用工具