API文档

stockout_order_query_trade.php（查询销售出库单）

1.接口说明

1.1 接口描述：获取旺店通ERP销售订单的出库单信息

1.2 适用版本：客户端 V2.4.6.6及以上版本

1.3 增量获取：

①默认按照销售出库单的发货时间增量获取数据，请求时输入start_time和end_time作为时间跨度的筛选条件。

②当is_by_modified值为0时：当不传status时，请求参数的开始时间和结束时间对应“发货时间”，返回状态>=95的销售出库单；当传status的值大于等于95时，请求参数的开始时间和结束时间对应“发货时间”，返回status值对应的出库单；当传status的值小于95时，请求参数的开始时间和结束时间对应“修改时间（modified）”，返回出status值对应的出库单。

③不传is_by_modified默认为0，当is_by_modified为1时，按照最后修改时间进行返回。

1.4 时间跨度：时间跨度：start_time和end_time最大跨度为30天（测试环境时间跨度start_time和end_time最大跨度为60分钟），开始时间和结束时间取值范围为闭区间取值，例如2018-11-01 00:00:00至2018-11-30 23:59:59，建议根据获取数据量的多少适当减小时间跨度。

1.5 注意事项：

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

②销售订单出库单号如果驳回后再次进行审核，会发生变化，规则见本接口文档最底部

2.调用场景

2.1 财务系统、SAP、数据分析等系统的对接

3.请求参数说明

3.1 请求地址

环境	HTTP地址
测试环境	https://sandbox.wangdian.cn/openapi2/stockout_order_query_trade.php
正式环境	https://api.wangdian.cn/openapi2/stockout_order_query_trade.php

查询历史销售出库单地址：

环境	HTTP地址
测试环境	https://sandbox.wangdian.cn/openapi2/his_stockout_order_query_trade.php
正式环境	https://api.wangdian.cn/openapi2/his_stockout_order_query_trade.php

3.2 公共请求参数

名称	字段	类型	必须	描述
卖家账号	sid	String	是	购买ERP时由旺店通分配给ERP购买方，请从ERP购买方获取。
接口账号	appkey	String	是	本开放平台“自助对接”功能模块内自助申请，获取方式点击这里
时间戳	timestamp	int	是	北京时间1970-01-01 08:00:00起至现在的总秒数，10位int值,旺店通企业版API服务端允许请求最大时间误差为5min，date.timezone = Asia/Shanghai。
签名	sign	String	是	API输入参数签名结果，签名算法介绍单击这里

3.3 业务请求参数

名称	字段	类型	长度	必须	描述
状态	status	tinyint	4	否	5已取消，55已审核，95已发货，105 部分打款，110已完成，113：异常发货
开始时间	start_time	datetime		是	增量获取数据，start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss
结束时间	end_time	datetime		是	增量获取数据，end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss
系统订单编号	src_order_no	varchar	40	否	可以单独按照系统单号查询，不传其他参数
原始单号	src_tid	varchar	40	否	可以单独按照原始单号查询，不传其他参数
出库单号	stockout_no	varchar	40	否	可以单独按照出库单号查询，不传其他参数
分页大小	page_size	int		否	每页返回的数据条数，输入值范围1~100，不传本参数，输入值默认为40，使用举例单击这里
页号	page_no	int		否	页号默认从0开始
时间查询条件	is_by_modified	int		否	定义是否用最后修改时间来查询，当指定状态status字段后，传0按照原销售出库单接口规则返回，传1按照出库单的最后修改时间进行返回，默认为0
店铺编号	shop_no	varchar	40	否	代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置），用于获取指定店铺单据数据信息
店铺编号（批量）	shop_nos	varchar		否	批量指定店铺获取（多个店铺编号之间用英文逗号隔开，最多指定20个店铺）
仓库编号	warehouse_no	varchar	40	否	代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置），用于获取指定仓库单据数据信息(不支持一次推送多个仓库编号)
货位节点校验	is_no_position	int		否	货位节点校验：0：返回position_list节点数据 1：不返回position_list节点数据，默认为0
是否仅获取库存记录	fetch_stock_only	int			是否仅获取库存记录不传或者传0代表否 1：是

4.响应参数

4.1 公共响应参数

名称	字段	类型	长度	必须	描述
错误码	code	int	11	是	状态码:0表示成功,其他表示失败
错误描述	message	varchar	255	是	错误描述
数据条数	total_count	int	10	否	符合条件的数据条数，用来分页当page_no = 0时返回
出库单节点	stockout_list	data[]		否	响应参数的1级数据节点，包含当前页的订单出库单及其明细的数据节点,节点下数据字段详见下述“stockout_list”和" goods_list"

4.2 业务响应参数

stockout_list

名称	字段	类型	长度	必须	描述
出库单主键id	stockout_id	int	11	是	出库单主键id
出库单号	order_no	varchar	40	是	出库单号,唯一单号
源单号	src_order_no	varchar	40	是	源单号，旺店通系统单号（多默认为JY开头）
仓库编号	warehouse_no	varchar	40	是	仓库编号
发货时间	consign_time	datetime	时间	是	销售出库单发货时间时间格式：yyyy-MM-dd HH:mm:ss
出库单类型	order_type	tinyint	4	是	出库单类型
订单状态	trade_status	tinyint	4	是	订单状态 5已取消 10待付款 12待尾款 13待选仓 15等未付16延时审核 19预订单前处理 20前处理(赠品，合并，拆分)21委外前处理22抢单前处理 25预订单 27待抢单 30待客审 35待财审 40待递交仓库 45递交仓库中 50已递交仓库 53未确认 55已确认 90发货中 95已发货 105部分打款 110已完成 113异常发货
出库单类型名称	order_type_name	varchar	40	是	固定名称“销售出库”
订单类型	trade_type	tinyint	1	是	1网店销售 2线下零售 3售后换货 4批发业务 5保修换新 6保修完成 7订单补发 8供销补发 9 供销展架下单 101自定义类型1 102自定义类型2 103自定义类型3 104自定义类型4 105自定义类型5 106自定义类型6 107自定义类型7 108自定义类型8
出库子类型	subtype	varchar	256	是	出库子类型
数量	goods_count	decimal	(19,4)	是	货品数量
货品总售价	goods_total_amount	decimal	(19,4)	是	货品总售价
货品总成本	goods_total_cost	decimal	(19,4)	是	货品总成本
邮资成本	post_fee	decimal	(19,4)	是	邮资成本
物流单号	logistics_no	varchar	40	是	物流单号
包装费	package_fee	decimal	(19,4)	是	包装费
收件人	receiver_name	varchar	100	是	收件人
国家	receiver_country	smallint	6	是	国家
省份	receiver_province	varchar	40	是	省份
城市	receiver_city	varchar	40	是	城市
地区	receiver_district	varchar	60	是	地区
应收金额	receivable	decimal	(19,4)	是	应收金额
详细地址	receiver_address	varchar	256	是	详细地址
收件人移动电话	receiver_mobile	varchar	40	是	收件人移动电话
收件人固定电话	receiver_telno	varchar	100	是	收件人固定电话
邮编	receiver_zip	varchar	20	是	邮编
大头笔	receiver_dtb	varchar	128	是	大头笔
实际重量	weight	decimal	(19,4)	是	ERP系统称重功能记录的重量，如果没有使用称重功能默认使用货品档案维护的预估重量
物流公司类型	logistics_type	varchar	11	是	响应值为ERP定义的ID数值，数值对应的物流公司类型名称单击这里
物流公司编号	logistics_code	varchar	60	是	代表物流所有属性的唯一编码，用于物流区分，ERP内支持自定义（ERP物流界面设置）
物流公司名称	logistics_name	varchar	40	是	物流公司名称
打印备注	print_remark	varchar	255	是	打印备注
已付金额	paid	decimal	(19,4)	是	已付金额
退款状态	refund_status	tinyint	4	是	退款状态：退款状态 0无退款 1申请退款 2部分退款 3全部退款
业务员编号	salesman_no	varchar	40	是	业务员编号
业务员名称	salesman_name	varchar	40	是	业务员名称
业务员名称	fullname	varchar	40	是	业务员名称
仓库名称	warehouse_name	varchar	40	是	仓库名称
创建时间	created	datetime	时间	是	递交时间时间格式：yyyy-MM-dd HH:mm:ss
备注	remark	varchar	255	是	备注
出库原因	stockout_reason	varchar	32	是	出库原因
外部单号	outer_no	varchar	40	是	外部单号
订单编号	trade_no	varchar	40	是	系统订单编号，默认单号为JY开头，ERP内支持自定义（设置路径：设置——编码设置）
原始单号	src_trade_no	varchar	255	是	商城或电商平台的订单编号,合并订单的多个订单编号有逗号隔开
网名	nick_name	varchar	100	是	网名
客户名称	customer_name	varchar	100	是	客户名称（客户真实姓名，取自receiver_name）
客户编号	customer_no	varchar	40	是	客户编号
下单时间	trade_time	datetime	时间	是	下单时间时间格式：yyyy-MM-dd HH:mm:ss
付款时间	pay_time	datetime	时间	是	付款时间时间格式：yyyy-MM-dd HH:mm:ss
出库单状态	status	tinyint	4	是	出库单状态 5 已取消 48未确认 50待审核 52待推送 53同步失败 54获取面单号 55已审核 95 已发货 100 已签收 105部分打款 110已完成 113 异常发货 115回传失败 120回传成功
店铺名称	shop_name	varchar	128	是	店铺名称
店铺编号	shop_no	varchar	20	是	代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置）
买家留言	buyer_message	varchar	1024	是	买家留言
客服备注	cs_remark	varchar	1024	是	客服备注
订单标记	flag_name	varchar	32	是	订单标记
邮费	post_amount	decimal	(19,4)	是	从平台获取的销售订单的邮费
截停原因	block_reason	int	11	是	截停原因：1申请退款2已退款4地址被修改8发票被修改16物流被修改32仓库变化64备注修改128更换货品256添加货品512放弃抢单1024其他 2048 拦截赠品 4096 拦截天猫换货 8192 买家留言变更 16384 该换货订单存在退货/退款
发票类别	invoice_type	tinyint	4	是	发票类别0 不需要，1普通发票，2普通增值税发票，3专用增值税发票
发票抬头	invoice_title	varchar	255	是	发票抬头
发票内容	invoice_content	varchar	255	是	发票内容
发票ID	invoice_id	int	11	是	发票ID，目前只设0-1，1表示已开发票
发货条件	delivery_term	tinyint	4	是	发货条件 1款到发货 2货到付款(包含部分货到付款) 3分期付款 4挂账单
分销类别	fenxiao_type	tinyint	4	是	0 非分销订单 1 转供销 2 代销 3经销
分销商信息	fenxiao_nick	varchar	40	是	分销商信息，不同平台单据分销商会存在不同格式情况，具体以返回信息为准
货到付款金额	cod_amount	decimal	(19,4)	是	货到付款金额
证件类别	id_card_type	tinyint	1	是	1 身份证
收件人地址	receiver_area	varchar	128	是	省市区空格分隔
店铺备注	shop_remark	varchar	255	是	店铺备注
最后修改时间	modified	datetime	时间	是	最后修改时间时间格式：yyyy-MM-dd HH:mm:ss
平台id	platform_id	smallint	6	是	平台id 响应值为代表平台的ID数字，ID对应的平台名称单击这里
订单表主键	trade_id	int	11	是	订单表主键
审单员	checker_name	varchar	40	是	审单员
审单员编号	employee_no	varchar	40	是	审单员编号
打包员编号	packager_no	varchar	40	是	打包员编号
充值账号	shipment_box	varchar	255	是	充值账号
打包员	packager_name	varchar	40	是	打包员
检视员编码	watcher_no	varchar	40	是	检视员编码
检视员名称	watcher_name	varchar	40	是	检视员名称
拣货员编号	picker_no	varchar	40	是	拣货员编号
拣货员	picker_name	varchar	40	是	拣货员
打单员编号	printer_no	varchar	40	是	打单员编号
打单员	printer_name	varchar	40	是	打单员
验货员编号	examiner_no	varchar	40	是	验货员编号
验货员	examiner_name	varchar	40	是	验货员
出库单号	stockout_no	varchar	40	是	出库单号
源单据类别	src_order_type	varchar	40	是	源单据类别，1 销售订单
处理状态	wms_status	varchar	4	是	处理状态 0 待处理 1 推送失败 2 推送成功 3 接口取消成功系统驳回失败 4 服务器正在处理 5 WMS返回发货信息 6 异步标记,推送申请成功'
接口处理错误信息	error_info	varchar	255	是	接口处理错误信息
仓库类别	warehouse_type	tinyint	4	是	仓库类别（0不限 1普通仓库 2自动流传外部 3京东仓储 4科捷 5百世物流 6SKU360 7通天晓 8中联网仓 9顺丰仓储 10网仓2号 11奇门仓储 12旺店通仓储 13心怡仓储 14力威仓储 15京东沧海 16云集仓储 17POS 18虎符 20外部链路型 22抖店云仓 126分销委外仓 127其它）
出库仓库id	warehouse_id	smallint	6	是	出库的仓库id
客户id	customer_id	varchar	11	是	客户id
冻结原因	freeze_reason	smallint	6	是	冻结原因
是否分配	is_allocated	tinyint	1	是	是否分配stockout_order_detail_position
出库状态	consign_status	varchar	11	是	出库状态 1验货，2称重，4出库，8物流同步，16分拣，32档口, 64拣货，128供销回传成功，256供销回传失败，1073741824原始单已完成
电子面单状态	ebill_status	tinyint	4	是	电子面单,获取状态（0 还未获取单号或获取单号和打印信息完毕；1 手动获取物流单号中；100-105 获取打印数据中）
制单人	operator_id	varchar	11	是	制单人
货品种类数量	goods_type_count	smallint	6	是	货品种类数量
主单实际应收	actual_receivable	decimal	(19,4)	是	主单实际应收
MD5字符串值	md5_str	varchar	40	是	MD5字符串值,用于单据排序
	raw_goods_count	decimal	(19,4)	是	内置字段
其他出库自定义子类别	custom_type	smallint	6	是	其他出库自定义子类别0，1，2，3，4
区域	receiver_ring	varchar	20	是	区域
配送时间	to_deliver_time	varchar	20	是	配送时间，如周末
配送中心	pre_charge_time	varchar	20	是	配送时间
物流公司ID	logistics_id	smallint	6	是	物流公司ID
未知成本销售总额	unknown_goods_amount	decimal	(19,4)	是	未知成本销售总额
预估邮费成本	calc_post_cost	decimal	(19,4)	是	预估邮费成本
邮费成本	post_cost	decimal	(19,4)	是	邮费成本
预估重量	calc_weight	decimal	(19,4)	是	预估重量
快递重量	post_weight	decimal	(19,4)	是	快递给的重量
包装id	package_id	varchar	11	是	包装id
包装成本	package_cost	decimal	(19,4)	是	包装成本
是否包含发票	has_invoice	tinyint	1	是	是否包含发票
打单员	printer_id	varchar	11	是	打单员
拣货出错次数	pick_error_count	varchar	4	是	拣货出错次数
拣货员id	picker_id	varchar	11	是	拣货操作员ID
分拣员id	sorter_id	varchar	11	是	包裹分拣员id
验货员id	examiner_id	varchar	11	是	验货操作员id
发货人id	consigner_id	varchar	11	是	发货人id
打包员id	packager_id	varchar	11	是	打包id
打包积分	pack_score	varchar	11	是	打包积分
拣货积分	pick_score	varchar	11	是	拣货积分
签出员工id	checkouter_id	varchar	11	是	签出员工id
监视员id	watcher_id	varchar	11	是	监视员
分拣单编号	picklist_no	varchar	40	是	分拣单编号
分拣序号	picklist_seq	smallint	6	是	订单在分拣单中序号
发票打印状态	invoice_print_status	tinyint	4	是	发票打印状态
颜色	flag_id	smallint	6	是	颜色
物流单模板id	logistics_template_id	smallint	6	是	物流单模板id
发货单模板id	sendbill_template_id	smallint	6	是	发货单模板id
货位分配方式	pos_allocate_mode	tinyint	1	是	货位分配方式：0系统自动分配, 1手动指定货位分配 2手动指定有效期批次货位 3其它出库优化使用出库货位 4按批次出库
便签条数	note_count	smallint	6	是	便签条数
其他出库原因	reason_id	varchar	11	是	其他出库原因
锁定策略id	lock_id	varchar	11	是	锁定策略id
保留	reserve	varchar	40	是	保留
源单据id	src_order_id	int	11	是	订单表主键
大头笔	stockout_receiver_dtb	varchar	128	是	大头笔
收件人的省份	receiver_province_code	int	11	是	收件人的省份,按照城市代码表中对应城市代码进行返回
收件人的城市	receiver_city_code	int	11	是	收件人的城市,按照城市代码表中对应城市代码进行返回
收件人的地区	receiver_district_code	int	11	是	收件人的地区,按照城市代码表中对应城市代码进行返回
打印批次	batch_no	varchar	40	是	打印批次
优惠金额	discount	decimal	(19,4)	是	优惠金额
原始单号	src_tids	varchar	255	是	原始单号，平台订单号
税额	tax	decimal	(19,4)	是	税额
税率	tax_rate	decimal	(19,4)	是	税率
币种	currency	varchar	20	是	币种
证件号码	id_card	varchar	40	是	证件号码
出库单审核时间	stock_check_time	datetime	时间	是	出库单审核时间时间格式：yyyy-MM-dd HH:mm:ss
异常状态	bad_reason	int	11	是	需要通过异或的方式判断，异常订单(bit位)，1无库存记录 2地址发生变化 4发票变化 8仓库变化16备注变化32平台更换货品64退款…512抢单异常
打印批次	print_batch_no	varchar	20	是	ERP中的单据的打印批次信息，如需该字段，请升级至2.4.0.8版本及以上
发货单打印状态	sendbill_print_status	tinyint	4	是	0未打印 1打印中 2已打印 3无需打印
物流单打印状态	logistics_print_status	tinyint	4	是	0未打印 1打印中 2已打印 3无需打印
分拣单打印状态	picklist_print_status	tinyint	4	是	0未打印 1打印中 2已打印 3无需打印
制单人名称	operator_name	varchar	40	是	制单人名称
分销原始单号	fenxiao_tid	varchar	255	是	分销原始单号
分销商编号	fenxiao_nick_no	varchar	255	是	分销商编号
货品列表节点	details_list	data[]		是	货品列表节点
物流列表节点	logistics_list	data[]		是	物流列表节点

logistics_list

名称	字段	类型	长度	必须	描述
主键	rec_id	int	11	是	多物流单号主键
操作人主键	operator_id	int	11	是	操作人主键
订单主键	trade_id	int	11	是	订单主键
物流单号	logistics_no	varchar	40	是	物流单号
物流公司主键	logistics_id	int	11	是	物流公司主键
重量	weight	decimal	19,4	是	重量
多物流打印状态	print_status	tinyint	4	是	多物流单打印状态，0未打印，1打印中，2已打印
是否为主子单	is_master	tinyint	1	是	是否为主子单 0为否
邮资	post_cost	decimal	19,4	是	邮资
最后修改时间	modified	datetime	19	是	最后修改时间,时间格式：yyyy-MM-dd HH:mm:ss
创建时间	created	datetime		是	创建时间,时间格式：yyyy-MM-dd HH:mm:ss
货品信息节点	goods_info	data[]		是	货品信息节点（仅子母单返回）

goods_info

名称	字段	类型	长度	必须	描述
商家编码	spec_no	varchar	11	是	商家编码
数量	num	decimal	19,4	是	数量

details_list

名称	字段	类型	长度	必须	描述
出库明细主键	rec_id	int	11	是	出库明细主键
出库单主键id	stockout_id	int	11	是	出库单主键id
商家编码	spec_no	varchar	40	是	代表单品(sku)所有属性的编码，SKU概念介绍,单击这里
销售价	sell_price	decimal	(19,4)	是	销售价,最终交易价格,扣除优惠
数量	goods_count	decimal	(19,4)	是	货品数量
组合装数量	suite_num	decimal	(19,4)	是	组合装数量
品牌编号	brand_no	varchar	50	是	品牌编号
品牌名称	brand_name	varchar	64	是	品牌名称
货品类型	goods_type	tinyint	1	是	货品类型： 1销售商品 2原材料 3包装 4周转材料5虚拟商品6固定资产7:保修配件 8:虚拟代发货品 0其它
是否是赠品	gift_type	tinyint	1	是	是否是赠品 0非赠品 1自动赠送 2手工赠送 3回购自动送赠品 4前N有礼送赠品 5平台赠送 6天猫优仓赠品
货品名称	goods_name	varchar	255	是	货品名称
货品编号	goods_no	varchar	40	是	代表货品(spu)所有属性的编号，SPU概念介绍,单击这里
平台货品id	api_goods_id	varchar	40	是	平台货品id
平台规格id	api_spec_id	varchar	40	是	平台规格id
规格名称	spec_name	varchar	100	是	规格名称
规格码	spec_code	varchar	40	是	规格码
来源组合装编码	suite_no	varchar	40	是	来源组合装编码
成本价	cost_price	decimal	(19,4)	是	成本价
总货款	total_amount	decimal	(19,4)	是	总货款,sell_price * goods_count=total_amount
货品id	goods_id	int	11	是	货品id
商品主键	spec_id	int	11	是	商品主键
估重	weight	decimal	(19,4)	是	估重
备注	remark	varchar	1024	是	备注
已支付金额	paid	decimal	(19,4)	是	已支付金额
退款状态	refund_status	tinyint	4	是	退款状态： 0无退款，1取消退款，2已申请退款，3等待退货，4等待收货，5退款成功
零售价	market_price	decimal	(19,4)	是	零售价
分销价	fenxiao_amount	decimal	(19,4)	是	分销价
总折扣金额	discount	decimal	(19,4)	是	总折扣金额
分摊后合计应收	share_amount	decimal	(19,4)	是	分摊后合计应收
税率	tax_rate	decimal	(8,4)	是	税率
条码	barcode	varchar	50	是	条码
基本单位	unit_name	varchar	20	是	基本单位
订单详情表主键	sale_order_id	int	11	是	订单详情表主键
邮费分摊	share_post	decimal	(19,4)	是	邮费分摊
原始子订单号	src_oid	varchar	40	是	原始子订单号
子单原始单号	src_tid	varchar	40	是	子单原始单号
单据内部来源	from_mask	int	11	是	订单内部来源1手机，2聚划算，4服务子订单，8家装，16二次付款，32开具电子发票，128指定批次，2048当日达，4096次日达，8192预计时效，262144天猫直送/唯品仓中仓，524288‘3PL时效/jitx’，2097152区域零售，4194304预售单，8388608周期购，16777216 同城购(淘宝)，268435456 物流升级，536870912 抖店抽奖订单，1073741824 抖音btas/淘宝珠宝鉴定
源单据类别	src_order_type	tinyint	4	是	源单据类别以主单为准
充值账号	shipment_box	varchar	255	是	充值账号
sales_trade_order表的主键	src_order_detail_id	varchar	11	是	sales_trade_order表的主键
基本单位	base_unit_id	smallint	6	是	基本单位
平台标签	from_mask_ext	varchar	20	是	平台标签 1集运订单(京东) 2小时达(淘宝) 4小时达平台运力(淘宝) 8以旧换新 16国补订单
辅助单位	unit_id	smallint	6	是	辅助单位
单位换算	unit_ratio	decimal	(19,4)	是	单位换算
货品数量	num	decimal	(19,4)	是	货品数量
辅助数量	num2	decimal	(19,4)	是	辅助数量
最终价格	price	decimal	(19,4)	是	最终价格，share_price删掉，取代share_price
指定出库批次	batch_id	varchar	11	是	指定出库批次
是否验货	is_examined	tinyint	1	是	是否验货，用于挂起，已标记为验货的不需要再验货
是否包装	is_package	tinyint	1	是	是否包装
是否允许0成本	is_zero_cost	tinyint	1	是	是否允许0成本
扫描方式	scan_type	tinyint	1	是	0未验货,1扫描验货,2手工验货,3快速验货,4无需验货
创建时间	created	datetime		是	审核创单时间，时间格式：yyyy-MM-dd HH:mm:ss
最后修改时间	modified	datetime		是	最后修改时间，时间格式：yyyy-MM-dd HH:mm:ss
子单实际已付金额	actual_paid	decimal	(19,4)	是	子单实际已付金额
平台id	platform_id	smallint	6	是	平台id 响应值为代表平台的ID数字，ID对应的平台名称单击这里
出库货位id	position_id	int	11	是	出库货位id
货品档案自定义属性1	good_prop1	varchar	255	是	货品档案自定义属性1
货品档案自定义属性2	good_prop2	varchar	255	是	货品档案自定义属性2
货品档案自定义属性3	good_prop3	varchar	255	是	货品档案自定义属性3
货品档案自定义属性4	good_prop4	varchar	255	是	货品档案自定义属性4
货品档案自定义属性5	good_prop5	varchar	255	是	货品档案自定义属性5
货品档案自定义属性6	good_prop6	varchar	255	是	货品档案自定义属性6
单品列表自定义属性1	prop1	varchar	255	是	单品列表自定义属性1
单品列表自定义属性2	prop2	varchar	255	是	单品列表自定义属性2
单品列表自定义属性3	prop3	varchar	255	是	单品列表自定义属性3
单品列表自定义属性4	prop4	varchar	255	是	单品列表自定义属性4
单品列表自定义属性5	prop5	varchar	255	是	单品列表自定义属性5
单品列表自定义属性6	prop6	varchar	255	是	单品列表自定义属性6
批次号	batch_no	varchar	20	是	批次号（订单指定出库批次，如需实际扣减库存出库批次信息请查看positon_list节点）
批次备注	batch_remark	varchar	255	是	批次备注
有效期	expire_date	datetime		是	有效期，时间格式：yyyy-MM-dd HH:mm:ss
货位节点列表	position_list	data[]		是	货位节点列表

position_list

名称	字段	类型	长度	必须	描述
货位ID	position_id	int	11	是	货位ID
货位编号	position_no	varchar	40	是	货位编号
批次备注	batch_remark	varchar	255	是	批次备注
出库单主键id	stockout_id	int	11	是	出库单主键id
出库单明细id	stockout_order_detail_id	int	11	是	出库单明细id
货位主键id	rec_id	int	11	是	货位主键id
入库单明细id	stockin_detail_id	int	11	是	入库单明细id
货品数量	num	decimal	19,4	是	货品数量
入库单号明细id	stock_spec_detail_id	bigint	20	是	入库单号明细id
批次id	batch_id	int	11	是	批次id
批次号	batch_no	varchar	20	是	批次号
生产日期	production_date	datetime	时间	是	生产日期，时间格式：yyyy-MM-dd HH:mm:ss
最后更新时间	modified	datetime	时间	是	最后更新时间
成本价	cost_price	decimal	(19,4)	是	成本价
货位出库数量	position_goods_count	decimal	(19,4)	是	货位出库数量
有效期	expire_date	datetime	时间	是	有效期，时间格式：yyyy-MM-dd HH:mm:ss

5.请求示例

PHP	<?php require_once("../WdtClient.php"); $c = new WdtClient; $c->sid = ''; $c->appkey = ''; $c->appsecret = ''; $c->gatewayUrl = 'http://sandbox.wangdian.cn/openapi2/stockout_order_query_trade.php'; $c->putApiParam('status', 55); $c->putApiParam('start_time', '2017-04-01 00:00:00'); $c->putApiParam('end_time', '2017-4-12 23:59:59'); $c->putApiParam('page_no', '0'); $c->putApiParam('page_size', '1'); $c->putApiParam('is_by_modified', 1); $json = $c->wdtOpenApi(); var_dump($json); ?>
JAVA	package com.wangdian.api.trade; import java.io.IOException; import java.util.HashMap; import java.util.Map; import com.wangdian.api.WdtClient; public class StockoutOrderQueryTrade { public static void main(String[] args) { // TODO Auto-generated method stub WdtClient client = new WdtClient("传入sid", "传入appkey", "传入appsecret", "传入url"); //测试环境sid、appkey、密钥请到旺店通开放平台-自助对接-申请测试环境内查看，测试环境url=https://sandbox.wangdian.cn/openapi2/ //调用正式环境时请将sid、appkey、appsecret切换为实际参数，参数在旺店通开放平台-自助对接-应用管理内应用状态为已上线的应用中查看，调用正式环境注意切换正式环境url=https://api.wangdian.cn/openapi2/ Map<String, String> params = new HashMap<String, String>(); params.put("shop_no", "ghs2test"); params.put("start_time", "2018-12-01 00:00:00"); params.put("end_time", "2018-12-01 00:00:00"); try { String response = client.execute("stockout_order_query_trade.php", params); System.out.println(response); } catch (IOException e) { // TODO Auto-generated catch block e.printStackTrace(); } } }
C#	using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Threading.Tasks; using WdtSdk; namespace StockoutOrderQueryTrade { class StockoutOrderQueryTrade { static void Main(string[] args) { WdtClient client = new WdtClient(); client.sid = ""; client.appkey = ""; client.appsecret = ""; client.gatewayUrl = "http://sandbox.wangdian.cn/openapi2/stockout_order_query_trade.php"; client.putParams("start_time", "2018-10-24 12:30:00"); client.putParams("end_time", "2018-10-24 13:10:00"); string result = client.wdtOpenapi(); Console.WriteLine(result); Console.ReadKey(); } } }
python	import WdtClient t = WdtClient.WdtClient('appkey', 'appsecret', 'sid', 'http://sandbox.wangdian.cn/openapi2/') params = {} params.update({"start_time": '2021-08-27 13:47:40'}) params.update({"end_time": '2021-08-27 13:47:48'}) params.update({"page_size": '30'}) params.update({"page_no": '0'}) response = t.execute("stockout_order_query_trade.php", params) print(response)

6.响应示例

6.1 正常响应示例

JSON

{
    "code": 0,
    "message": "succeed",
    "total_count": 1,
    "stockout_list": [{
        "stockout_id": "9255",
        "order_no": "CK2019051801",
        "src_order_no": "JY201905180001",
        "warehouse_no": "xyp2test",
        "consign_time": "2019-05-18 00:35:55",
        "status": "110",
        "order_type": "1",
        "goods_count": "2.0000",
        "goods_total_amount": "198.0000",
        "goods_total_cost": "0.0000",
        "post_fee": "0.0000",
        "logistics_no": "123456789011",
        "package_fee": "0.0000",
        "receivable":"",
        "receiver_name": "小鹏",
        "receiver_country": "0",
        "receiver_province": "上海",
        "receiver_city": "上海市",
        "receiver_district": "虹口区",
        "receiver_address": "龙茗路9号",
        "receiver_mobile": "13456554333",
        "receiver_telno": "01000860086",
        "receiver_zip": "10089",
        "remark": "",
        "weight": "0.0000",
        "stockout_reason": "",
        "subtype": "",
        "outer_no": "",
        "operator_name": "admin",
        "logistics_type": "8",
        "logistics_code": "SF001",
        "logistics_name": "顺丰快递",
        "bad_reason": "0",
        "receiver_dtb": "上海市 虹口区",
        "print_remark": "",
        "paid": "198.0000",
        "refund_status": "0",
        "trade_type": "2",
        "salesman_no": "admin",
        "fullname": "admin",
        "salesman_name": "admin",
        "trade_status": "110",
        "warehouse_name": "小鹏测试仓库",
        "block_reason": "0",
        "print_batch_no": "",
        "trade_no": "JY201905180001",
        "src_trade_no": "115580935277840368-1",
        "nick_name": "ffasdasd",
        "customer_no": "KH201905170008",
        "customer_name": "h",
        "trade_time": "2019-05-18 00:25:17",
        "pay_time": "2019-05-18 00:25:17",
        "flag_name": "VIP",
        "post_amount": "0.0000",
        "id_card_type": "0",
        "id_card": "",
        "receiver_area": "上海 上海市 虹口区",
        "shop_name": "小鹏测试店铺",
        "shop_no": "xyp2test",
        "shop_remark": "勿更改本店铺内容",
        "modified": "2019-05-18 00:35:55",
        "buyer_message": "请发顺丰",
        "cs_remark": "发顺丰快递",
        "invoice_type": "0",
        "invoice_title": "",
        "invoice_content": "",
        "invoice_id": "0",
        "cod_amount": "0.0000",
        "delivery_term": "1",
        "fenxiao_type": "0",
        "fenxiao_nick": "",
        "platform_id": "0",
        "trade_id": "168498",
        "employee_no": "admin",
        "checker_name": "admin",
        "discount": "0.0000",
        "src_tids": "115580935277840368-1",
        "tax": "0.0000",
        "tax_rate": "0.0000",
        "currency": "",
        "created": "2019-05-18 00:30:59",
        "stock_check_time": "2019-05-18 00:34:22",
        "packager_no": "SYSTEM",
        "packager_name": "系统",
        "picker_no": "SYSTEM",
        "picker_name": "系统",
        "printer_no": "SYSTEM",
        "printer_name": "系统",
        "examiner_no": "SYSTEM",
        "examiner_name": "系统",
        "order_type_name": "销售订单",
        "receiver_province_code": "310000",
        "receiver_city_code": "310100",
        "receiver_district_code": "310109",
        "details_list": [{
            "rec_id": "17745",
            "stockout_id": "9255",
            "spec_no": "WDTPDA-BLACK006",
            "goods_count": "2.0000",
            "total_amount": "198.0000",
            "paid": "198.0000",
            "sell_price": "99.0000",
            "remark": "",
            "goods_name": "旺店通手持终端",
            "goods_no": "WDTPDA",
            "brand_no": "BD201811230002",
            "brand_name": "旺店通",
            "spec_name": "旺店通手持终端黑色006型",
            "spec_code": "BLACK006",
            "cost_price": "0.0000",
            "weight": "0.0000",
            "goods_id": "1",
            "spec_id": "1",
            "prop1": "",
            "prop2": "",
            "prop3": "",
            "prop4": "",
            "prop5": "",
            "prop6": "",
            "platform_id": "0",
            "refund_status": "0",
            "market_price": "99.0000",
            "discount": "0.0000",
            "share_amount": "198.0000",
            "tax_rate": "0.0000",
            "barcode": "WDTPDA-BLACK006",
            "unit_name": null,
            "sale_order_id": "294491",
            "share_post": "0.0000",
            "gift_type": "0",
            "src_oid": "AD201905180001",
            "src_tid": "115580935277840368-1",
            "from_mask": "131072",
            "goods_type": "1",
            "batch_no": "",
            "suite_no": "",
            "good_prop1": "",
            "good_prop2": "",
            "good_prop3": "",
            "good_prop4": "",
            "good_prop5": "",
            "good_prop6": ""
        }]
    }]
}

6.2 异常响应示例

JSON	{ "code": 2102, "message": "start_time和end_time为空或不是有效的时间格式[0000-00-00 00:00:00] " }

7. 销售出库单驳回审核规则

1.销售出库单在驳回审核之后，单据状态会变更为已取消状态；

2.在订单审核界面再次审核单据之后，销售出库单会再次变更为已审核，且对应销售出库单号会发生改变（在原基础单号后增加-1，例如“原始单号A-1”再次驳回后审核为“原始单号A-2”)。