API文档

wms.stockout.Sales.queryStockoutSalesSNBatchDetail（销售出库序列号明细查询）

¥标准

1.接口说明

1.1 接口描述：获取销售出库序列号明细数据

1.2 适用版本：客户端V1.5.5.2及以上版本

1.3 增量获取：支持

1.4 时间跨度：

1.5注意事项：

为了达到保护用户隐私数据安全的目的，本接口不返回淘系及系统供销平台订单数据，相关平台规则点击这里，淘系及系统供销平台数据获取办法点击这里。

本接口中涉及到用户隐私的字段数据仅有自有平台及线下平台订单返回

2.调用场景

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

3.请求参数说明

3.1 请求地址

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

3.2 公共请求参数

名称	字段	类型	必须	描述
卖家账号	sid	String	是	卖家账号, 由旺店通分配
接口账号	key	String	是	由旺店通分配appkey, 在发送的数据中对应 key 字段,获取方式点击这里
盐	salt	String	是	由旺店通分配appsecret，是由两部分构成, 冒号前面的部分是secret, 冒号后面的部分是salt. 例如一个appsecret是testsecret:testsalt, 那么secret为testsecret, salt为testsalt.
接口名称	method	String	是	调用的接口名称
版本号	v	String	是	1.0
秒级时间戳	timestamp	Int	是	秒级时间戳, 当前时间戳减去 2012-01-01 00:00:00(1325347200), 时间与服务器时间差120s内即合法。
签名	sign	String	是	签名
分页大小	page_size	Int	否	分页大小，分页查询必传
分页编号	page_no	Int	否	分页编号，分页查询必传，标准接口page_no从0开始
是否计算查询结果的总条数	calc_total	Int	否	是否计算查询结果的总条数, 需要计算则1, 否则填0

3.3 业务请求参数

名称	字段	类型	长度	必须	描述
查询参数	params	Map<String, Object>		Y	查询参数
分页	pager	pager		Y	分页

params

名称	字段	类型	必须	描述
发货开始时间	ft_from	String	n	开始时间格式2024-10-14 23:12:23
发货结束时间	ft_to	String	n	结束时间
规格码	spec_code	String	n	规格码
商家编码	spec_no	String	n	商家编码
序列号	sn	String	n	序列号
订单编号	src_order_no	String	n	订单编号
店铺	shop_no	String	n	店铺编号，多个用逗号隔开
仓库	warehouse_no	String	n	仓库
物流公司	logistics	String	n	物流公司编码
货品编号	goods_no	String	n	货品编号
货品名称	goods_name	String	n	货品名称
货品简称	short_name	String	n	货品简称
原始单号	src_tid	String	n	原始单号
物流单号	logistics_no	String	n	物流单号
客户网名	buyer_nick	String	n	客户网名
电话号码	phone_no	String	n	电话号码
收件人	receiver_name	String	n	收件人

pager

名称	字段	类型	长度	必须	描述
分页大小	page_size	Int	4	n	分页大小（单量较大的卖家，page_size建议200以下）
页号	page_no	Int	4	n	从0开始

4.响应参数

4.1 公共响应参数

名称	字段	类型	必须	描述
状态码	status	Int	y	状态码,0表示调用成功
错误信息	message	String	y	无错误信息不返回
单据信息	data	Map<String, Object>	n	单据信息

data

名称	字段	类型	长度	必须	描述
总数	total_count	Int	11	n	查询条件总单据数
单据数据	order_list	List<Map<String, Object>>		y	单据数据

order_list

名称	字段	类型	必须	描述
序列号	sn	String	y	序列号
序列号类型	sn_type	Int	y	0：未启用 1：强序列号 2：弱序列号
组合装名称	suite_name	String	y	组合装名称
平台货品名称	api_goods_name	String	y	平台货品名称
平台规格名称	api_spec_name	String	y	平台规格名称
客服备注	cs_remark	String	y	客服备注
买家留言	buyer_message	String		买家留言
sn码状态	sn_status	Int		sn码状态 0：已取消 10：初始录入 15：二次录入 20：已入库 30：已占用 40：已出库
供应商	provider_name	String		供应商
应收金额	receivable	String		应收金额
分摊后单价	share_price	String		分摊后单价
分摊后总价	total_amount	String		分摊后总价
商家编码	spec_no	String		商家编码
货品编号	goods_no	String		货品编号
货品名称	goods_name	String		货品名称
货品简称	short_name	String		货品简称
规格码	spec_code	String		规格码
规格名称	spec_name	String		规格名称
出库单编号	stockout_no	String		出库单编号
出库单状态	status	Int		出库单状态 5, 已取消 10, 待放回 48, 未确认 50, 待审核 51, 缺货 52, 缺货待入库 53, WMS已接单 54, 获取面单号 58, 档口锁定 60, 待分配 61, 排队中 63, 待补货 65, 待处理 70, 待发货 73, 爆款锁定 74, 预打包 75, 待拣货 77, 拣货中 79, 已拣货 90, 延时发货 110, 已完成
原始单号	src_tids	String		原始单号
原始子单号	src_oid	String		原始子单号
订单编号	src_order_no	String		订单编号
订单类型	trade_type	Int		0, 不核销 1, 占用中 2, 系统自动释放 3, 已核销 4, 已取消 5, JITX核销中 6, JITX已核销 10, 取消中
物流公司	logistics_name	String		物流公司
物流单号	logistics_no	String		物流单号
收件人	receiver_name	String		收件人
客户网名	buyer_nick	String		客户网名
省份	receiver_province	String		省份
城市	receiver_city	String		城市
地区	receiver_area	String		地区
地址	receiver_address	String		地址
邮资	post_amount	String		邮资
手机	receiver_mobile	String		手机
固话	receiver_telno	String		固话
发货时间	consign_time	String		发货时间
辅助序列号	second_sn	String		辅助序列号
重量	weight	String		重量
自定义属性1	prop1	String		自定义属性1
自定义属性2	prop2	String		自定义属性2
自定义属性3	prop3	String		自定义属性3
自定义属性4	prop4	String		自定义属性4
自定义金额1	custom_price1	String		自定义金额1
自定义金额2	custom_price2	String		自定义金额2
批次号	batch_no	String		批次号

5.请求示例

json	[{"sn":"240801sn4"}]
PHP
JAVA
C#

6.响应示例

6.1 正常响应示例

JSON

{
    "status": 0,
    "data": {
        "total_count": 1,
        "order_list": [
            {
                "logistics_name": "申通快递",
                "spec_code": "",
                "consign_time": "2024-08-01 19:42:43",
                "post_amount": 0,
                "sn_type": 2,
                "spec_no": "240801sn",
                "api_goods_name": "240801sn",
                "goods_name": "240801sn",
                "receiver_area": "天津 天津市 南开区",
                "receiver_province": 120000,
                "weight": 0,
                "shop_name": "wdtapi3-test",
                "src_tids": "20240801002",
                "shop_id": 290,
                "warehouse_name": "wdtapi3-test",
                "total_amount": 0,
                "provider_id": 0,
                "short_name": "",
                "status": 110,
                "second_sn": "",
                "receiver_city": 120100,
                "goods_no": "240801sn",
                "suite_name": "",
                "api_spec_name": "",
                "stockout_id": 673709,
                "src_order_no": "JY202408010143",
                "logistics_id": 369,
                "sn": "240801sn4",
                "provider_name": "无",
                "batch_no": "",
                "custom_price1": 0,
                "logistics_no": "451122525544",
                "custom_price2": 0,
                "stockout_no": "CK2024080175",
                "sn_status": 20,
                "receivable": 0,
                "rec_id": 3231,
                "prop4": "",
                "prop3": "",
                "prop2": "",
                "prop1": "",
                "trade_type": 2,
                "src_oid": "AD202408010049",
                "spec_name": "",
                "share_price": 0,
                "warehouse_id": 311
            }
        ]
    }
}

6.2 异常响应示例

JSON