当前位置： API文档

wms.stockout.Sales.queryHistoryWithDetail（历史销售出库单查询）

¥标准

1.接口说明

1.1 接口描述：获取ERP历史销售出库单信息
1.2 适用版本：客户端 V1.4.1.3及以上版本
1.3 增量获取：支持
1.4 时间跨度：start_time和end_time最大跨度为60分钟。

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

    3.3 业务请求参数

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

params

Map<String, Object>
Y

查询参数

分页

pager

pager
Y

分页

params

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

start_time

String

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

status_type

Int

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

1.已取消

2.在企业版状态中对应status=55(已确认),这里为 待分配~延时发货

0.已发货

仓库编码

warehouse_no

String

40n

仓库编码

出库单编号

stockout_no

String20n出库单编号
店铺编号shop_nosString255n多个店铺编号使用英文逗号分隔
销售订单号src_order_noString40n系统订单号

pager

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

page_size

Int

4n

分页大小（单量较大的卖家，page_size建议200以下）

页号

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

11y出库单ID
出库单号order_noString40y
出库单号

系统订单编号

src_order_no

String

40y系统订单编号

仓库编号

warehouse_no

String

40y仓库编号

仓库名称

warehouse_name

String

64
y仓库名称
发货时间

consign_time

String

40
y发货时间，例如：2020-01-28 16:12:01
源单据类别

order_type

Int

4
y

源单据类别:

1销售订单

2调拨出库

3采购退货出库

4盘亏出库

5生产出库

6现款销售出库

7其他出库

货品数量goods_countDecimal(19,4)
y货品数量
物流单编号logistics_noString50
y物流单编号
收件人姓名receiver_nameString100
y收件人姓名（仅自有平台及线下平台返回，其他平台均不返回）
国家receiver_countryInt11y国家
省份IDreceiver_provinceInt11y省份ID
城市IDreceiver_cityInt11y城市ID
地区IDreceiver_districtInt11y地区ID
地址receiver_addressString256y地址，不包含省市区（仅自有平台及线下平台返回，其他平台均不返回）
收件人手机receiver_mobileString40
y收件人手机（仅自有平台及线下平台返回，其他平台均不返回）
收件人电话receiver_telnoString100
y收件人电话（仅自有平台及线下平台返回，其他平台均不返回）
收件人邮编receiver_zipString20
y收件人邮编
省市区receiver_areaString128
y省市区空格分隔
出库单备注remarkString255
y出库单备注
称重结果weightDecimal(19,4)
y称重结果（实际称重重量kg）
截停原因block_reasonInt11y

截停原因:

0正常

1申请退款

2已退款

4地址被修改

8发票被修改

16物流被修改

32仓库变化

64备注修改

128更换货品

256取消退款

物流方式logistics_typeInt6y物流方式
物流编号logistics_codeString40
y物流编号
物流公司名称logistics_nameString40
y物流公司名称
异常原因bad_reasonInt4y异常原因:  

0正常

1无库存记录

2地址发生变化

4发票变化

8仓库变化

16备注变化

32平台更换货品

64退款

大头笔receiver_dtbString128y大头笔
退款状态refund_statusInt4y

退款状态:

0无退款

1申请退款

2部分退款

3全部退款

销售类型trade_typeInt4y

销售类型:

1网店销售

2线下零售

3售后换货

4批发业务

业务员编号salesman_noString40y业务员编号
业务员姓名fullnameString40y业务姓名
订单状态trade_statusInt4y

订单状态:  

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_noString40y订单编号
原始单号src_trade_noString255y原始单号(如果有多个，以","分隔且以增序排列,不重复,过长将被裁剪)
客户网名
nick_nameString100y客户网名（仅自有平台及线下平台返回，其他平台均不返回）
客户编码customer_noString40y客户编码
客户姓名customer_nameString100y客户姓名（仅自有平台及线下平台返回，其他平台均不返回）
下单时间trade_timeString40y下单时间（毫秒级时间戳，例如：1631861379000）
支付时间pay_timeString40y支付时间（毫秒级时间戳，例如：1631861379000）
标记名称flag_nameString32y标记名称
邮费post_amountDecimal(19,4)
y邮费
证件类别is_card_typeInt4
y证件类别
证件号码id_cardString40y证件号码（仅自有平台及线下平台返回，其他平台均不返回）
店铺名称shop_nameString128y店铺名称
店铺编号shop_noString20
y店铺编号
店铺备注shop_remarkString255y店铺备注
出库单状态statusInt4y

出库单状态:  

5已取消

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

48 未确认 

50待审核

51 缺货无法发货

54 获取面单号

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

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

65待人工处理  

75待拣货,创建批次之后

77 拣货中,PDA拣货后

79 已拣货

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

95已发货

110已完成

发票类型invoice_typeInt4
y

发票类型:

0不需要

1普通发票

2增值税发票

发票IDinvoice_idInt11
y

发票id:

目前只设0-1，

1表示已开发票

货到付款金额cod_amountDecimal(19,4)
y货到付款金额
发货条件delivery_termInt4y

发货条件:

1款到发货

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

3分期付款

平台IDplatform_idInt11y平台ID（请点击平台代码表查看对应关系）
订单IDtrade_idInt11y订单ID
审核员编号employee_noString40y审核员编号
优惠金额discountDecimal(19,4)
y优惠金额
税额taxDecimal(19,4)
y税额
税率tax_rateDecimal(19,4)
y税率
币种currencyString20y币种
建单时间createdString40y建单时间（毫秒级时间戳，例如：1631861379000）
出库单建单时间stock_check_timeString40y出库单建单时间（毫秒级时间戳，例如：1631861379000）
打印备注print_remarkString255y打印备注
买家留言buyer_messageString255y买家留言
客服备注cs_remarkString255y客服备注
发票标题invoice_titleString255y发票标题
发票内容invoice_contentString255y发票内容
称重预估邮资
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

String40y最后修改时间，例如：2020-01-28 16:12:01
订单标签

trade_label

String11
y订单标签
订单来源

trade_from

Int4y

订单来源：

1、API抓单

2、手工建单

3、导入

4、复制订单

5、接口推送

6、补发订单

7、PDA选货开单

店铺平台IDshop_platform_idint
y店铺平台类型ID
店铺IDshop_idint
y店铺id
查询的记录数seq_noint
y返回分页页数*一页条数 +1
物流idlogistics_idint
y物流id
仓库idwarehouse_idint
y仓库id
销售出库单详情details_listList<Map<String, Object>>
y销售出库单详情
物流单列表logistics_listList<Map<String, Object>>
y物流单详情

logistics_list

名称字段类型长度
必须描述
物流单id

rec_id

Int
11y

销售出库单详情id

出库单id

stockout_id

Int

11
y

出库单id

物流单号

logistics_no

String

40
y

物流单号

估算重量

calc_weight

Decimal(19,4)
y估算重量
称重重量
weightDecimal(19,4)
y称重重量
包装
package_name
String
40y包装
物流名称
logistics_nameString40y物流公司名称（查看路径：旺店通客户端设置--基本设置--物流）
物流IDlogistics_idInteger6y物流ID 
估算邮资postageBigDecimal19,4y估算邮资
备注remarkString256y备注
长lengthBigDecimal19,4y长
宽widthBigDecimal19,4y宽
高heightBigDecimal19,4y高
体积volumeBigDecimal19,4y长*宽*高


details_list

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

rec_id

Int

11y销售出库单详情的id
订单明细id

src_order_detail_id

Int

11y订单明细id
出库单id

stockout_id

Int

11y出库单id
规格id

spec_id

Int

11y规格id
商家编码spec_noString40Y商家编码
货品数量

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

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

goods_name

String

255
y货品名称
货品编号

goods_no

String

40
y货品编号
规格名称

spec_name

String

100
y规格名称
规格码

spec_code

String

40
y规格码
成本价

cost_price

Decimal(19,4)


y

成本价:

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

总重量

weight

Decimal(19,4)

11y总重量
货品id

goods_id

Int

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

prop1

String

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

prop2

String

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

prop3

String

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

prop4

String

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

prop5

String

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

prop6

String

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

Int

6y平台ID
退款状态

refund_status

Int

4y

退款状态:

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

50y主条码
单位名称

unit_name

String

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

sale_order_id

Int

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

gift_type

Int

11y

是否是赠品:

0非赠品

1自动赠送

2手工赠送

4周期购赠送

8平台赠送

原始子单号

src_oid

String

40y原始子单号
原始单号

src_tid

String

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

from_mask

Int

11
y

订单内部来源:

1手机

2聚划算

货品类型

goods_type


Int

4
y

货品类型:

1销售商品

2原材料

3包装

4周转材料

5虚拟商品

6固定资产

0其它

货品自定义属性1

good_prop1

String

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

good_prop2

String

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

good_prop3

String

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

good_prop4

String

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

good_prop5

String

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

good_prop6

String

255y货品自定义属性6
批次号

batch_no

String

20
y批次号
有效期expire_dateString20y有效期

5.请求示例

json
[{"start_time":"2018-10-05 14:21:41","end_time":"2018-10-20 14:21:41"}]
PHP
<?php
include 'wdtsdk.php';
 
$client = new WdtErpClient("url", "wdtapi3", "appkey", "secret")
$pars = array
(
    'start_time' => '2020-06-15 10:05:36',
    'end_time' => '2020-06-17 11:05:36'
);
$pager = new Pager(50, 0, true);
$data = $client->pageCall("wms.stockout.Sales.queryHistoryWithDetail", $pager,  $pars);//分页方法
$php_json = json_encode($data);
echo $php_json;
 
?>
JAVA
C#

6.响应示例

   6.1 正常响应示例 

JSON
{
    "status": 0,
    "data": {
        "total_count": 1,
        "order": [
            {
                "post_amount": 10.0000,
                "fenxiao_nick": "",
                "trade_time": 1598233470000,
                "error_info": "",
                "bad_reason": 0,
                "discount": 0.0000,
                "picker_name": "系统用户",
                "trade_id": 595978,
                "trade_label": "",
                "receiver_country": 0,
                "refund_status": 0,
                "receiver_province": 330000,
                "buyer_message": "",
                "logistics_code": "momo1",
                "shop_platform_id": 127,
                "shop_id": 290,
                "warehouse_name": "wdtapi3-test",
                "nick_name": "QQP",
                "id_card_type": 0,
                "status": 110,
                "package_fee": 0,
                "src_trade_no": "121111111",
                "post_fee": 0.0000,
                "custom_type": 0,
                "sub_platform_id": 0,
                "goods_count": 2.0000,
                "stockout_id": 396275,
                "src_order_no": "ORDER202008240010",
                "invoice_content": "",
                "receiver_name": "QQP",
                "currency": "",
                "sendbill_template_id": 0,
                "picklist_no": "",
                "examiner_name": "系统用户",
                "logistics_type": 4,
                "trade_from": 4,
                "delivery_term": 1,
                "logistics_no": "134354646464646",
                "consigner_name": "aaa2",
                "receiver_district": 330109,
                "goods_total_amount": 30.0000,
                "receivable": 40.0000,
                "receiver_mobile": "12345678900",
                "stock_check_time": 1598233524000,
                "cs_remark": "",
                "receiver_address": "牛",
                "customer_name": "QQP",
                "printer_name": "系统用户",
                "customer_id": 649926,
                "warehouse_id": 311,
                "logistics_name": "陌陌-圆通",
                "details_list": [
                    {
                        "rec_id": 556013,
                        "stockout_id": 396275,
                        "spec_id": 203575,
                        "goods_count": 1.0000,
                        "goods_amount": 20.0000,
                        "paid": 0.0000,
                        "sell_price": 20.0000,
                        "remark": "",
                        "goods_name": "wttABCD",
                        "goods_no": "wttAABCD",
                        "spec_name": "wttAABCD",
                        "spec_code": "wttAABCD",
                        "spec_no": "wttAABCD",
                        "cost_price": 0.0000,
                        "weight": 0.0000,
                        "total_amount": 0.0000,
                        "goods_id": 54367,
                        "prop1": "",
                        "prop2": "",
                        "prop3": "",
                        "prop4": "",
                        "prop5": "",
                        "prop6": "",
                        "platform_id": 0,
                        "refund_status": 0,
                        "market_price": 20.0000,
                        "discount": 0.0000,
                        "share_amount": 20.0000,
                        "tax_rate": 0.0000,
                        "barcode": "wttAABCD",
                        "unit_name": "部",
                        "sale_order_id": 784940,
                        "gift_type": 0,
                        "src_oid": "AD202008240001",
                        "src_tid": "121111111",
                        "from_mask": 131072,
                        "goods_type": 1,
                        "batch_no": "",
                        "good_prop1": "P1",
                        "good_prop2": "P2",
                        "good_prop3": "P13",
                        "good_prop4": "P14",
                        "good_prop5": "P15",
                        "good_prop6": "P16",
                        "src_order_detail_id": 784940,
                        "suite_no": "",
                        "share_post_amount": 10.0000,
                        "brand_no": "BD202001030001",
                        "brand_name": "新建品牌3",
                        "src_order_type": 1,
                        "base_unit_id": 0,
                        "unit_id": 0,
                        "unit_ratio": 1.0000,
                        "is_package": false,
                        "num2": 0.0000,
                        "batch_id": 0,
                        "is_examined": 0,
                        "scan_type": 0,
                        "modified_date": "2020-08-24 09:45:23",
                        "created_date": "2020-08-24 09:45:23",
                        "share_price": 20.0000,
                    },
                    {
                        "rec_id": 556014,
                        "stockout_id": 396275,
                        "spec_id": 205266,
                        "goods_count": 1.0000,
                        "goods_amount": 10.0000,
                        "paid": 0.0000,
                        "sell_price": 10.0000,
                        "remark": "",
                        "goods_name": "认养一头牛250ml梦幻盖10入内衬",
                        "goods_no": "30500033",
                        "spec_name": "",
                        "spec_code": "",
                        "spec_no": "30500033",
                        "cost_price": 0.0000,
                        "weight": 0.0000,
                        "total_amount": 0.0000,
                        "goods_id": 55959,
                        "prop1": "",
                        "prop2": "",
                        "prop3": "",
                        "prop4": "",
                        "prop5": "",
                        "prop6": "",
                        "platform_id": 0,
                        "refund_status": 0,
                        "market_price": 10.0000,
                        "discount": 0.0000,
                        "share_amount": 10.0000,
                        "tax_rate": 0.0000,
                        "barcode": "30500033",
                        "unit_name": "个子",
                        "sale_order_id": 784941,
                        "gift_type": 0,
                        "src_oid": "AD202008240002",
                        "src_tid": "121111111",
                        "from_mask": 131072,
                        "goods_type": 1,
                        "batch_no": "",
                        "good_prop1": "",
                        "good_prop2": "",
                        "good_prop3": "",
                        "good_prop4": "",
                        "good_prop5": "",
                        "good_prop6": "",
                        "src_order_detail_id": 784941,
                        "suite_no": "",
                        "share_post_amount": 0.0000,
                        "brand_no": "BRAND",
                        "brand_name": "无",
                        "src_order_type": 1,
                        "base_unit_id": 0,
                        "unit_id": 0,
                        "unit_ratio": 1.0000,
                        "is_package": false,
                        "num2": 0.0000,
                        "batch_id": 0,
                        "is_examined": 0,
                        "scan_type": 0,
                        "modified_date": "2020-08-24 09:45:23",
                        "created_date": "2020-08-24 09:45:23",
                        "share_price": 10.0000,
        
                "consign_time": "2020-08-24 09:46:15",
                "warehouse_type": 1,
                "receiver_dtb": "杭州市 萧山区",
                "operator_id": 502,
                "print_remark": "",
                "employee_no": "wtt",
                "tax_rate": 0.0000,
                "shop_remark": "ljcs",
                "outer_no": "",
                "invoice_id": 0,
                "modified": "2020-08-24 09:46:14",
                "order_type": 1,
                "shop_no": "wdtapi3-test",
                "picklist_seq": 0,
                "seq_no": 1,
                "receiver_area": "浙江省 杭州市 萧山区",
                "customer_no": "KH202007270002",
                "created": 1598233487000,
                "weight": 0.0000,
                "block_reason": 0,
                "tax": 0.0000,
                "shop_name": "wdtapi3-test",
                "pay_time": 1598233470000,
                "goods_total_cost": 0.0000,
                "trade_no": "ORDER202008240010",
                "consign_status": 0,
                "order_no": "CKDH202008242",
                "receiver_city": 330100,
                "invoice_title": "",
                "goods_type_count": 2,
                "id_card": "",
                "remark": "",
                "calc_post_cost": 0.0000,
                "cod_amount": 0.0000,
                "flag_name": "无",
                "logistics_id": 207,
                "warehouse_no": "wdtapi3-test",
                "receiver_telno": "",
                "receiver_zip": "",
                "trade_status": 110,
                "invoice_type": 0,
                "new_trade_label": "0",
                "batch_no": "",
                "packager_name": "系统用户",
                "salesman_no": "wtt",
                "platform_id": 0,
                "paid": 0.0000,
                "trade_type": 2,
                "logistics_print_status": 2,
                "fullname": "aaa1",
                "logistics_list": [
                    {
                        "rec_id": 10074105,
                        "stockout_id": 396275,
                        "logistics_id": 207,
                        "logistics_no": "134354646464646",
                        "calc_weight": 0.0000,
                        "weight": 0.0000,
                        "postage": 0.0000,
                        "remark": "",
                        "length": 0.0000,
                        "width": 0.0000,
                        "height": 0.0000,
                        "package_name": "未知",
                        "logistics_name": "陌陌-圆通",
                        "volume": "0.000000000000"
                    }
                ]
            }
        ]
    }
}

   6.2 异常响应示例

JSON

{"status":100,"message":"您的查询时间过宽,查询时间不能大于30天"}






常用工具