当前位置: API文档

wms.stockout.Sales.queryWithDetail(销售出库单查询)

¥标准

1.接口说明

1.1 接口描:获取ERP销售出库单信息
1.2 适用版本:客户端 V1.2.5.2及以上版本
1.3 增量获取:支持
1.4 时间跨度:start_time和end_time最大跨度为30天。

1.5注意事项:为了达到保护用户隐私数据安全的目的本接口不返回淘系订单数据相关平台规则点击这里淘系数据获取办法点击这里

本接口中涉及到用户隐私的字段数据仅有自有平台订单返回。具体字段详情见下面表格;

字段描述字段名
买家昵称nick_name
收件人姓名receiver_name
收件地址receiver_address
收件人手机receiver_mobile
收件人固话
receiver_telno
客户姓名customer_name
证件号码id_card

2.调用场景

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

3.请求参数说明

   3.1 请求地址

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

  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
签名
分页大小page_sizeint
分页大小,分页查询必传
分页编号page_noint
分页编号,分页查询必传
是否计算查询结果的总条数calc_totalint
是否计算查询结果的总条数, 需要计算则1, 否则填0         

    3.3 业务请求参数

名称字段类型长度
必须描述
查询参数

params

Map<String, Object>
Y

查询参数

分页

pager

pager
Y

分页

params

名称字段类型长度
必须描述
开始时间

start_time

Date


y起始时间, status_type =1,2 按照出库单修改时间查询, status_type=3 按照发货时间查询
结束时间end_timeDate
y
结束时间
出库单状态

status_type

int

4y出库单状态: 默认值为3

1.已取消

2.在企业版状态中对应status=55(已确认),这里为 待分配~延时发货(此条件会返回延时发货状态的订单

3.已发货

出库单状态详细

status

String

4y

传status_type=3情况下,按照修改时间和status查询

出库单状态:  

5已取消

10待放回(拣货待放回), 小于该值的都是已取消的单子

48 未确认 

50待审核

51 缺货无法发货

52: 缺货待入库

53 WMS已接单

54 获取面单号

60 待分配,电子面单获取成功后

61 排队中,将出库单加入到队伍中

63:待补货

65待人工处理  

70:待发货

73 爆款锁定

75待拣货,创建批次之后

77 拣货中,PDA拣货后

79 已拣货

90延时发货, 到指定时间后会自动发货

95已发货

110已完成

113 异常发货

115 回传失败

120 回传成功

(此字段需要客户端1.2.5.2及以上版本支持!!)

仓库编码

warehouse_no

String

40n

仓库编码

出库单编号

stockout_no

String20n出库单编号
店铺编号shop_nosString
n多个店铺编号使用英文逗号分隔
销售订单号src_order_noString40n系统订单号
是否返回sn信息need_snbool
n是否返回sn信息
是否按照货位排序positionint
n等于0为否,不等于0为是,不填为否

pager

名称字段类型长度
必须描述
分页大小

page_size

int

4n

分页大小

页号

page_no

int4n从0开始

4.响应参数

   4.1 公共响应参数

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

status

int
y

状态码,0表示调用成功

错误信息

message

String


y

无错误信息不返回

出库单信息

data

Map<String, Object>


n

出库信息

data

响应参数说明示例值或者格式、具体含义、使用方法及注意事项(如隐私数据淘系平台不返回,其他平台正常返回

名称字段类型长度
必须描述
总数total_countint11n查询条件总单据数
单据数据orderList<Map<String, Object>>
y出库单相关数据

order

名称字段类型长度
必须描述
出库单ID

stockout_id

int


y出库单ID
出库单号order_noString
y
出库单号

系统订单编号

src_order_no

String

 y系统订单编号

仓库编号

warehouse_no

String


y仓库编号

仓库名称

warehouse_name

String


y仓库名称
出库时间

consign_time

String


y出库时间
源单据类别

order_type

int


y

源单据类别:

1销售订单

2调拨出库

3采购退货出库

4盘亏出库

5生产出库

6现款销售出库

7其他出库

货品数量goods_countdecimal(19,4)
y货品数量
物流单编号logistics_noString
y物流单编号
收件人姓名receiver_nameString
y收件人姓名
国家receiver_countryint
y国家
省份IDreceiver_provinceint
y省份ID
城市IDreceiver_cityint
y城市ID
地区IDreceiver_districtint
y地区ID
地址receiver_addressString
y地址,不包含省市区
收件人手机receiver_mobileString
y收件人手机
收件人电话receiver_telnoString
y收件人电话
收件人邮编receiver_zipString
y收件人邮编
省市区receiver_areaString
y省市区空格分隔
出库单备注remarkString
y出库单备注
重量weightdecimal(19,4)
y实际称得重量KG
截停原因block_reasonint
y

截停原因:

0正常

1申请退款

2已退款

4地址被修改

8发票被修改

16物流被修改

32仓库变化

64备注修改

128更换货品

256取消退款

物流方式logistics_typeint
y物流方式
物流编号logistics_codeString
y物流编号
物流公司名称logistics_nameString
y物流公司名称
异常原因bad_reasonint
y异常原因:  

0正常

1无库存记录

2地址发生变化

4发票变化

8仓库变化

16备注变化

32平台更换货品

64退款

大头笔receiver_dtbString
y大头笔
退款状态refund_statusint
y

退款状态:

0无退款

1申请退款

2部分退款

3全部退款

销售类型trade_typeint
y

销售类型:

1网店销售

2线下零售

3售后换货

4批发业务

审核员编号salesman_noString
y审核员编号
审核员姓名fullnameString
y审核姓名
订单状态trade_statusint
y

订单状态:  

4 线下退款

5已取消

6 待确认订单, 导入放入这个状态  待转预订单(待审核)

7待确认订单,导入时先放到这个状态(此状态不占用库存,可删除,离开这个状态就不能删除了)

10待付款

15等未付

16延时审核

19预订单前处理

20前处理(赠品,合并,拆分)

21委外前处理

23 异常预订单

24 换货预订单

26 待激活预订单

27待分配预

30待客审

35待财审

55已确认

95已发货

96 待录入计划成本,订单结算时有货品无计划成本

99 待过账

100已签收

101 已过账

105部分打款

110已完成

订单编号trade_noString
y订单编号
原始单号src_trade_noString
y原始单号(如果有多个,以","分隔且以增序排列,不重复,过长将被裁剪)
买家网名nick_nameString
y买家网名
客户编码customer_noString
y客户编码
客户名字customer_nameString
y客户名字
下单时间trade_timeString
y下单时间
支付时间pay_timedate
y支付时间
标记名称flag_nameString
y标记名称
邮费post_amountdecimal(19,4)
y邮费
证件类别is_card_typeint
y证件类别
证件号码is_cardString
y证件号码
店铺名称shop_nameString
y店铺名称
店铺编号shop_noString
y店铺编号
店铺备注shop_remarkString
y店铺备注
出库单状态statusint
y

出库单状态:  

5已取消

10待放回(拣货待放回), 小于该值的都是已取消的单子

48 未确认 

50待审核

51 缺货无法发货

52: 缺货待入库

53 WMS已接单

54 获取面单号

60 待分配,电子面单获取成功后

61 排队中,将出库单加入到队伍中

63:待补货

65待人工处理  

70:待发货

73 爆款锁定

75待拣货,创建批次之后

77 拣货中,PDA拣货后

79 已拣货

90延时发货, 到指定时间后会自动发货

95已发货

110已完成

113 异常发货

115 回传失败

120 回传成功

发票类别invoice_typeint
y

发票类别:

0不需要

1普通发票

2增值税发票

发票IDinvoice_idint
y

发票id:

目前只设0-1,

1表示已开发票

货到付款金额cod_amountdecimal(19,4)
y货到付款金额
发货条件delivery_termint
y

发货条件:

1款到发货

2货到付款(包含部分货到付款)

3分期付款

平台IDplatform_idint
y平台ID(请点击平台代码表查看对应关系
订单IDtrade_idint
y订单ID
业务员编号employee_noString
y业务员编号
优惠金额discountdecimal(19,4)
y优惠金额
税额taxdecimal(19,4)
y税额
税率tax_ratedecimal(19,4)
y税率
币种currencyString
y币种
建单时间createdtimestamp
y建单时间
出库单建单时间stock_check_timetimestamp
y出库单建单时间
打印备注print_remarkString
y打印备注
买家备注buyer_messageString
y买家备注
客服备注cs_remarkString
y客服备注
发票标题invoice_titleString
y发票标题
发票内容invoice_contentint
y发票内容
邮费成本post_feedecimal(19,4)
y

邮费成本:

(使用根据重量预估的邮费)

包装成本package_feedecimal(19,4)
y包装成本(使用包装的计划成本)
已付金额receivabledecimal(19,4)
y已付金额(使用应收金额)
总成本价goods_total_costdecimal(19,4)
y总成本价
总货款

goods_total_amount

decimal(19,4)
y总货款
最后修改时间

modified

String
y最后修改时间使用该字段需要客户端升级到1.2.3.6及以上版本!!)
订单标签

trade_label

String
y订单标签使用该字段需要客户端升级到1.2.3.9及以上版本!!)
订单来源

trade_from

int
y

订单来源:

1、API抓单

2、手工建单

3、导入

4、复制订单

5、接口推送

6、补发订单

7、PDA选货开单

使用该字段需要客户端升级到1.2.3.9及以上版本!!)
销售出库单详情details_listList<Map<String, Object>>
y销售出库单详情

details_list

名称字段类型长度
必须描述
销售出库单详情的id

rec_id

int


y销售出库单详情的id
出库单id

stockout_id

int


y出库单id
规格id

spec_id

int


y规格id
商家编码spec_noString
Y商家编码
货品数量

goods_count

decimal(19,4)


y货品数量:  如果按照货位分组就是总货品数量
总成本

total_amount

decimal(19,4)


y

总成本: 成本价*货品数量

已支付金额

paid

decimal(19,4)


y

已支付金额:

如果按照货位分组就是总的已经支付的金额

成交价

sell_price

decimal(19,4)


y成交价
出库单明细备注

remark

String


y出库单明细备注
货品名称

goods_name

String


y货品名称
货品编码

goods_no

String


y货品编码
规格名称

spec_name

String


y规格名称
规格码

spec_code

String


y规格码
成本价

cost_price

decimal(19,4)


y

成本价:

平均成本如果为空或者小于0,就是计划成本

总重量

weight

decimal(19,4)


y总重量
货品id

goods_id

int


y货品id
规格自定义属性1

prop1

String


y规格自定义属性1
规格自定义属性2

prop2

String


y规格自定义属性2
规格自定义属性3

prop3

String


y规格自定义属性3
规格自定义属性4

prop4

String


y规格自定义属性4
规格自定义属性5

prop5

String


y规格自定义属性5
规格自定义属性6

prop6

String


y规格自定义属性6
平台IDplatform_id

int


y平台ID
退款状态

refund_status

int


y

退款状态:

0无退款

1取消退款,

2已申请退款

3等待退货

4等待收货

5退款成功---(原始子订单关闭,这里也是退款状态)

销售单价

market_price

decimal(19,4)


y

销售单价:

手工新建时使用货品属性中的“零售价”

总折扣金额

discount

decimal(19,4)


y总折扣金额
分摊后合计应收share_amount

decimal(19,4)


y分摊后合计应收
税率

tax_rate

decimal(8,4)


y税率
主条码

barcode

String


y主条码
单位名称

unit_name

String


y单位名称
订单货品(子订单)id

sale_order_id

int


y订单货品(子订单)id
是否是赠品

gift_type

int


y

是否是赠品:

0非赠品

1自动赠送

2手工赠送

4周期购赠送

8平台赠送

原始子订单号

src_oid

String


y原始子订单号
原始订单号

src_tid

String


y原始订单号
订单内部来源

from_mask

int


y

订单内部来源:

1手机

2聚划算

货品类型

goods_type


int


y

货品类型:

1销售商品

2原材料

3包装

4周转材料

5虚拟商品

6固定资产

0其它

批次号

batch_no

String


y批次号
货品自定义属性1

good_prop1

String


y货品自定义属性1
货品自定义属性2

good_prop2

String


y货品自定义属性2
货品自定义属性3

good_prop3

String


y货品自定义属性3
货品自定义属性4

good_prop4

String


y货品自定义属性4
货品自定义属性5

good_prop5

String


y货品自定义属性5
货品自定义属性6

good_prop6

String


y货品自定义属性6
货位

position_id

int


y货位
货位

position_no

String


y货位
有效期

expire_date

String


y有效期
当前货位出库总货品数量

position_goods_count

decimal(19,4)


y当前货位出库总货品数量
sn_list

sn_list

String


y如果need_sn=false,返回空字符串;否则返回英文逗号拼接的sn

5.请求示例

json
[{
"start_time": "2019-12-11 00:00:00",
"end_time": "2019-12-31 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"); 
 
$params=new stdClass();
$params->start_time = '2019-12-11 00:00:00';
$params->end_time = '2019-12-31 00:00:00';
 
 
$pager = new Pager(2, 0, true);
$data = $client->pageCall("wms.stockout.Sales.queryWithDetail", $pager, $params);
 
?>
JAVA
C#

6.响应示例

   6.1 正常响应示例 

JSON
{
"status": 0,
"data": {
"total_count": 207,
"order": [{
"logistics_name": "刘子渲物流",
"details_list": [{
"rec_id": 22740,
"stockout_id": 8390,
"spec_id": 13,
"goods_count": 1.0000,
"total_amount": 10.0000,
"paid": 0.0000,
"sell_price": 10.0000,
"remark": "",
"goods_name": "盛洁的养乐多",
"goods_no": "111115",
"spec_name": "低糖",
"spec_code": "sjdyld",
"spec_no": "sjdyld",
"cost_price": 0.0000,
"weight": 1.0000,
"goods_id": 11,
"prop1": "",
"prop2": "",
"prop3": "",
"prop4": "",
"prop5": "",
"prop6": "",
"platform_id": 3,
"refund_status": 0,
"market_price": 10.0000,
"discount": 0.0000,
"share_amount": 10.0000,
"tax_rate": 0.0000,
"barcode": "sjdyld",
"unit_name": "个",
"sale_order_id": 63655,
"gift_type": 0,
"src_oid": "ed650989c8da",
"src_tid": "TID-IcdWOJAFTo",
"from_mask": 0,
"goods_type": 1,
"good_prop1": "",
"good_prop2": "",
"good_prop3": "",
"good_prop4": "",
"good_prop5": "",
"good_prop6": ""
}, {
"rec_id": 22741,
"stockout_id": 8390,
"spec_id": 666,
"goods_count": 5.0000,
"total_amount": 50.0000,
"paid": 0.0000,
"sell_price": 10.0000,
"remark": "",
"goods_name": "阿拉蕾",
"goods_no": "all",
"spec_name": "粉红色1",
"spec_code": "all4",
"spec_no": "all4",
"cost_price": 0.0000,
"weight": 5.0000,
"goods_id": 28,
"prop1": "",
"prop2": "",
"prop3": "",
"prop4": "",
"prop5": "",
"prop6": "",
"platform_id": 3,
"refund_status": 0,
"market_price": 10.0000,
"discount": 0.0000,
"share_amount": 50.0000,
"tax_rate": 0.0000,
"barcode": "all4",
"unit_name": "个",
"sale_order_id": 63654,
"gift_type": 0,
"src_oid": "11ece853b3f1",
"src_tid": "TID-IcdWOJAFTo",
"from_mask": 0,
"goods_type": 1,
"good_prop1": "1",
"good_prop2": "2",
"good_prop3": "3",
"good_prop4": "4",
"good_prop5": "5",
"good_prop6": "6"
}],
"consign_time": 1577699754000,
"post_amount": 10.0000,
"trade_time": 1577635814000,
"receiver_dtb": "北京市 海淀区",
"bad_reason": 0,
"employee_no": "lzx",
"discount": 0.0000,
"tax_rate": 0.0000,
"trade_id": 35064,
"shop_remark": "",
"invoice_id": 0,
"receiver_country": 0,
"order_type": 1,
"shop_no": "lzxJD",
"seq_no": 1,
"receiver_area": "北京 北京市 海淀区",
"customer_no": "KH201904250001",
"refund_status": 0,
"receiver_province": 110000,
"created": 1577698795000,
"weight": 6.0000,
"block_reason": 0,
"tax": 0.0000,
"logistics_code": "lzx",
"shop_name": "刘子渲京东店铺",
"pay_time": 1577635822000,
"warehouse_name": "刘子渲超级大仓",
"goods_total_cost": 0E-8,
"trade_no": "JY201912300048",
"id_card_type": 0,
"status": 110,
"order_no": "CK2019123042",
"src_trade_no": "TID-IcdWOJAFTo",
"post_fee": 0.0000,
"receiver_city": 110100,
"remark": "",
"goods_count": 6.0000,
"stockout_id": 8390,
"cod_amount": 0.0000,
"src_order_no": "JY201912300048",
"warehouse_no": "lzx",
"receiver_zip": "014500",
"trade_status": 96,
"invoice_type": 0,
"currency": "",
"logistics_type": 5,
"delivery_term": 1,
"logistics_no": "4567890-0987611111",
"receiver_district": 110108,
"goods_total_amount": 60.0000,
"receivable": 70.0000,
"stock_check_time": 1577699696000,
"platform_id": 3,
"trade_type": 1
}]
}
}

   6.2 异常响应示例

JSON

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





常用工具