通过此接口可批量获取销售订单
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
appMethod | String | Y | suning.custom.category.query | 方法名 |
appRequestTime | String | Y | 2012-04-25 20:23:30 | 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2012-04-25 20:23:30。API服务端允许客户端请求时间误差为10分钟。 |
format | String | N | XML | 默认xml,可指定格式为xml,json |
appKey | String | Y | b0c332a133c102765f39de********** | 分配给应用的访问令牌 |
versionNo | String | Y | v1.2 | API的版本,目前为v1.2版本 |
signInfo | String | Y | 460d7ff15b073e463125b4********** | appSecret,appMethod ,appRequestTime, appKey, versionNo, 请求报文base64加密后的数据顺序MD5(32位小写),其中appSecret为appKey对应的密钥 |
access_token | String | N | a1c5c62b08df3a3cbf7efd********** | 采用OAuth授权方式为必填参数 |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
endTime | String | Y | 2013-11-30 23:06:10 | 交易创建结束时间。查询交易创建结束时间。格式: yyyy-MM-dd HH:mm:ss |
pageNo | String | N | 1 | 页码。当前页码,1到99999之间,当前页码或者每页数量其中一个不填则当前页码默认1,每页数量默认为10 |
pageSize | String | N | 10 | 每页条数。每页数量,1到100之间,当前页码或者每页数量其中一个不填则当前页码默认1,每页数量默认为10 |
startTime | String | Y | 2013-11-29 23:06:10 | 交易创建起始时间。查询交易创建开始时间。格式: yyyy-MM-dd HH:mm:ss |
state | String | N | 20 | 订单状态。订单待发货10、订单不能满足20、订单延迟发货30、厂家已发货40、厂家确认顾客已收货45、顾客已收货50、单证已寄票60、顾客已收票70 |
supplierCode | String | Y | 10000020 | 供应商编码。 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
address | String | 南京市江宁区经济开发平安路8号 | 顾客送货地址。市、县/区、镇/街道、详细地址 |
customerName | String | 张三 | 顾客姓名。 |
memberOrgName | String | 江苏苏宁软件技术有限公司 | 会员单位名称 |
mobilePhone | String | 13957582227 | 移动电话。 |
orderId | String | 11111 | B2C订单号。 |
orderItemId | String | 00000208117601 | 订单行号。 |
platform | String | A | 平台来源。苏宁:A ,天猫:B, 抖音:C, 拼多多:D, 快手:E, 淘特:F ,视频号:G ,百度小店:BD, 小红书:H, |
posId | String | 11111 | POS单号。 |
price | String | 50.20 | 销售价。最后交易价 |
productCode | String | 101030069 | 商品编码。 |
productName | String | 保健品王 | 商品名称。 |
refundFee | String | 2.00 | 退款金额 |
remark | String | 顾客的销售订单备注 | 订单备注 |
remarkcolorflag | String | 1:红色,2:黄色,3:绿色,4:蓝色,5:紫色; | 商家备注旗帜 |
saleQty | String | 20 | 销售数量。 |
saleTime | String | 2013-11-29 23:06:10 | 订单销售日期时间。年月日小时分钟。 |
shipCondition | String | 01 | 装运条件。 |
status | String | 30 | 订单状态。支付关闭0、未支付5、订单待发货10、订单不能满足20、订单延迟发货30、厂家已发货40、厂家确认顾客已收货45、顾客已收货50、单证已寄票60、顾客已收票70、订单已关闭75 |
supplierCmmdtyCode | String | 123456789 | 商家商品编码 |
supplierCode | String | 100024789 | 供应商编码。 |
supplierremark | String | 轻拿轻放 | 商家备注内容 |
telephone | String | 13957582227 | 电话。 |
wareCode | String | Z01 | 供应商填写的仓库编码 |
returnorderflag | String | 1 | 退货标识 0:非退货; 1:退货 |
returnStatus | String | 80 | 退货状态 |
exchangeGoodsFlag | String | 1 | 换货标识:无换货(0),换货中(1),换货完成(2) |
returnFlag | String | 1 | 退货标识 0:非退货; 1:退货 |
gyaoBatchNum | String | 18010221 | 国药批次号 |
gyaoSpecificat | String | 10粒*6板/盒 | 国药规格 |
gyaoManufact | String | 上海东海制药股份有限公司 | 国药厂商 |
gyaoTermValidity | String | 2020/12 | 国药有效期 |
storeCode | String | 0001 | 门店代码 |
isShowPrice | String | 1 | 是否展示价格,0-不展示,1-展示 |
factoryIWDFlag | String | 1 | 苏宁仓配:1-是 0-否 |
pickDate | String | 2020-11-18 12:00:00 | 承诺发货日期 |
purchasePrice | String | 13 | 采购价 |
isOtherDelivery | String | 1 | 其他商家发货标识0否1是 |
distributorName | String | xxx | 分销商名称 |
oldChangeNewFlag | String | 1 | 0-以旧换新家电两步式订单且旧机已回收完成,1代表以旧换新家电两步式订单且旧机未回收完成。为空表示非以旧换新家电两步式订单 |
sid | String | BBDF4B492FA1878D7A73C25F5EE4DA22D425C50DDD181E50CE3D8234C4B27DD8A65CB... | address+customerName+mobilePhone+telephone加密字段,解密后格式为:{address:南京市江宁区经济开发平安路8号,customerName:张哈哈,mobilePhone:15805190183,telephone:66996699} |
userName | String | 123123@163.com | 买家账号 |
detailAddress | String | 苏宁大道1号 | 详细地址 |
serialNumFlag | String | 1 | 是否回传序列号标识:0否,1 SN码 2 IMEI码 |
serialNum | String | 969670000000000 | 序列号 |
hwgPackageOrderId | String | 4863317887330092865 | 合并订单号 |
hwgPayOrderId | String | 18741998 | 合并支付单号 |
hwgPayerName | String | 张三 | 支付人姓名 |
hwgPayerDocumentType | String | 01 | 支付人证件类型,默认01 |
hwgPayerDocumentNumber | String | 110110200001010002 | 支付人证件号码 |
hwgDistType | String | 03 | 发货方式,01直邮 02商家自有保税区 03苏宁保税区 |
hwgCustomsMode | String | 01 | 通关模式:01保税仓 02海外直邮 03个人申报 04邮关 |
hwgRtotalAmount | String | 82.78 | 行成交总价 |
hwgRpayAmount | String | 88.0 | 行支付金额 |
hwgRpayTaxAmount | String | 1 | 行支付税款 |
hwgRfreight | String | 2 | 行支付运费 |
hwgRcouponTotalMoney | String | 3 | 行优惠金额 |
hwgCountryCode | String | 中国 | 产销国 |
hwgStatus | String | 1 | 事件状态:抖音海外购事件当前状态,同步成功后状态更新,同步失败不更新 |
virtualNumMark | String | Y是,N否 | 虚拟号标识 |
actSettlementPrice | String | 12 | 活动结算价.该字段积分商城订单才有值,非积分商城订单无值 |
referencePrice | String | 1 | 供应商维护的销售价 |
cscPrice | String | 1 | 直降、大聚惠的购物车结算价格 |
hwgDeclareFlag | String | 未申报,申报成功 | 申报状态 |
hwgMergePayNo | String | 1 | 合并支付单号(申报后) |
hwgOrderTotalAmount | String | 1 | 合单维度:订单总金额 |
hwgTotalCount | String | 1 | 合单维度:总件数 |
hwgPayAmount | String | 1 | 合单维度:支付金额 |
hwgPayTaxAmount | String | 1 | 合单维度:支付税款 |
hwgFreight | String | 1 | 合单维度:支付运费 |
hwgCouponTotalMoney | String | 1 | 合单维度:优惠金额 |
isCardOrder | String | 1 | 1:号卡订单,号卡收货人姓名与号卡收货人证件号需要解密sid字段,获取consignee与idNumber |
cardExamine | String | 0 | 0表示待审核,1表示审核通过,2表示审核不通过,号卡订单必须审核通过的情况下才能进行发货 |
consignee | String | 张** | 号卡收货人名称,需要解密sid字段获取 |
idNumber | String | 34**************** | 号卡收货人身份证信息,需要解密sid字段 |
provinceName | String | 江苏省 | 收件人地址(省)中文 |
cityName | String | 南京市 | 收件人地址(市)中文 |
districtName | String | 玄武区 | 收件人地址(区)中文 |
townName | String | 鼓楼区 | 街道镇 |
zpOrderFlag | String | 0 | 0-支票支付订单且支票已到账,1支票支付订单且支票未到账,为空表示非支票支付订单(非0情况下不可发货) |
outCode | String | 200111111111 | 外部订单号 |
outItemCode | String | 20011111111101 | 外部订单行号 |
yjhOrderFlag | String | 0 | 云交惠订单是否可发货标识:0-门店已开单,1门店暂未开单,暂时无需发货(非0情况下不可发货) |
deliverMemo | String | 请发顺丰 | 顾客送货备注 |
orderTypeMulti | String | XA005,XA006 | XA006:苏宁有货S2B模式,XA005:零售云订单苏宁有货S2B2C模式中的S2B订单,XA004:苏宁有货API渠道销售,XA024:零售云订单,XA030:江苏消费补贴,XA031:北京消费补贴 |
encryptInfo | String | ||
encryptCustomerName | String | ABCDE | 加密的收货人名称 |
encryptDetailAddress | String | ABCDE | 加密的详细地址 |
encryptMobilePhone | String | ABCDE | 加密的手机号码 |
<sn_request> <sn_body> <querySaleOrder> <pageNo>1</pageNo> <pageSize>10</pageSize> <startTime>2013-11-29 23:06:10</startTime> <endTime>2013-11-30 23:06:10</endTime> <state>20</state> <supplierCode>10000020</supplierCode> </querySaleOrder> </sn_body> </sn_request>
{ "sn_request": { "sn_body": { "querySaleOrder": { "pageNo": "1", "pageSize": "10", "startTime": "2013-11-29 23:06:10", "endTime": "2013-11-30 23:06:10", "state": "20", "supplierCode": "10000020" } } } }
<sn_responseContent> <sn_head> <totalSize>1</totalSize> <pageTotal>1</pageTotal> <pageNo>1</pageNo> <returnMessage>biz.handler.data-get:success</returnMessage> </sn_head> <sn_body> <querySaleOrder> <refundFee>2.00</refundFee> <hwgPayerDocumentNumber>110110200001010002</hwgPayerDocumentNumber> <orderId>11111</orderId> <hwgStatus>1</hwgStatus> <returnStatus>80</returnStatus> <hwgCouponTotalMoney>1</hwgCouponTotalMoney> <pickDate>2020-11-18 12:00:00</pickDate> <hwgRtotalAmount>82.78</hwgRtotalAmount> <factoryIWDFlag>1</factoryIWDFlag> <purchasePrice>13</purchasePrice> <productName>保健品王</productName> <hwgTotalCount>1</hwgTotalCount> <hwgFreight>1</hwgFreight> <returnFlag>1</returnFlag> <hwgCountryCode>中国</hwgCountryCode> <deliverMemo>请发顺丰</deliverMemo> <price>50.20</price> <gyaoSpecificat>10粒*6板/盒</gyaoSpecificat> <hwgPayerDocumentType>01</hwgPayerDocumentType> <cscPrice>1</cscPrice> <memberOrgName>江苏苏宁软件技术有限公司</memberOrgName> <cardExamine>0</cardExamine> <supplierCmmdtyCode>123456789</supplierCmmdtyCode> <townName>鼓楼区</townName> <exchangeGoodsFlag>1</exchangeGoodsFlag> <serialNum>969670000000000</serialNum> <consignee>张**</consignee> <outCode>200111111111</outCode> <telephone>13957582227</telephone> <wareCode>Z01</wareCode> <isCardOrder>1</isCardOrder> <customerName>张三</customerName> <shipCondition>01</shipCondition> <outItemCode>20011111111101</outItemCode> <yjhOrderFlag>0</yjhOrderFlag> <orderTypeMulti>XA005,XA006</orderTypeMulti> <supplierremark>轻拿轻放</supplierremark> <isShowPrice>1</isShowPrice> <mobilePhone>13957582227</mobilePhone> <hwgMergePayNo>1</hwgMergePayNo> <serialNumFlag>1</serialNumFlag> <provinceName>江苏省</provinceName> <remarkcolorflag>1:红色,2:黄色,3:绿色,4:蓝色,5:紫色;</remarkcolorflag> <hwgDeclareFlag>未申报,申报成功</hwgDeclareFlag> <status>30</status> <storeCode>0001</storeCode> <gyaoTermValidity>2020/12</gyaoTermValidity> <isOtherDelivery>1</isOtherDelivery> <hwgDistType>03</hwgDistType> <remark>顾客的销售订单备注</remark> <hwgRpayAmount>88.0</hwgRpayAmount> <supplierCode>100024789</supplierCode> <virtualNumMark>Y是,N否</virtualNumMark> <idNumber>34****************</idNumber> <platform>A</platform> <sid>BBDF4B492FA1878D7A73C25F5EE4DA22D425C50DDD181E50CE3D8234C4B27DD8A65CB...</sid> <encryptInfo> <encryptCustomerName>ABCDE</encryptCustomerName> <encryptMobilePhone>ABCDE</encryptMobilePhone> <encryptDetailAddress>ABCDE</encryptDetailAddress> </encryptInfo> <hwgRfreight>2</hwgRfreight> <distributorName>xxx</distributorName> <posId>11111</posId> <saleTime>2013-11-29 23:06:10</saleTime> <referencePrice>1</referencePrice> <actSettlementPrice>12</actSettlementPrice> <cityName>南京市</cityName> <hwgPayTaxAmount>1</hwgPayTaxAmount> <returnorderflag>1</returnorderflag> <gyaoManufact>上海东海制药股份有限公司</gyaoManufact> <oldChangeNewFlag>1</oldChangeNewFlag> <gyaoBatchNum>18010221</gyaoBatchNum> <address>南京市江宁区经济开发平安路8号</address> <hwgPayAmount>1</hwgPayAmount> <districtName>玄武区</districtName> <orderItemId>00000208117601</orderItemId> <hwgOrderTotalAmount>1</hwgOrderTotalAmount> <hwgRcouponTotalMoney>3</hwgRcouponTotalMoney> <hwgRpayTaxAmount>1</hwgRpayTaxAmount> <userName>123123@163.com</userName> <productCode>101030069</productCode> <hwgPackageOrderId>4863317887330092865</hwgPackageOrderId> <hwgCustomsMode>01</hwgCustomsMode> <zpOrderFlag>0</zpOrderFlag> <detailAddress>苏宁大道1号</detailAddress> <hwgPayerName>张三</hwgPayerName> <saleQty>20</saleQty> <hwgPayOrderId>18741998</hwgPayOrderId> </querySaleOrder> </sn_body> </sn_responseContent>
{ "sn_responseContent": { "sn_head": { "totalSize": "1", "pageTotal": "1", "pageNo": "1", "returnMessage": "biz.handler.data-get:success" }, "sn_body": { "querySaleOrder": [ { "refundFee": "2.00", "hwgPayerDocumentNumber": "110110200001010002", "orderId": "11111", "hwgStatus": "1", "returnStatus": "80", "hwgCouponTotalMoney": "1", "pickDate": "2020-11-18 12:00:00", "hwgRtotalAmount": "82.78", "factoryIWDFlag": "1", "purchasePrice": "13", "productName": "保健品王", "hwgTotalCount": "1", "hwgFreight": "1", "returnFlag": "1", "hwgCountryCode": "中国", "deliverMemo": "请发顺丰", "price": "50.20", "gyaoSpecificat": "10粒*6板/盒", "hwgPayerDocumentType": "01", "cscPrice": "1", "memberOrgName": "江苏苏宁软件技术有限公司", "cardExamine": "0", "supplierCmmdtyCode": "123456789", "townName": "鼓楼区", "exchangeGoodsFlag": "1", "serialNum": "969670000000000", "consignee": "张**", "outCode": "200111111111", "telephone": "13957582227", "wareCode": "Z01", "isCardOrder": "1", "customerName": "张三", "shipCondition": "01", "outItemCode": "20011111111101", "yjhOrderFlag": "0", "orderTypeMulti": "XA005,XA006", "supplierremark": "轻拿轻放", "isShowPrice": "1", "mobilePhone": "13957582227", "hwgMergePayNo": "1", "serialNumFlag": "1", "provinceName": "江苏省", "remarkcolorflag": "1:红色,2:黄色,3:绿色,4:蓝色,5:紫色;", "hwgDeclareFlag": "未申报,申报成功", "status": "30", "storeCode": "0001", "gyaoTermValidity": "2020/12", "isOtherDelivery": "1", "hwgDistType": "03", "remark": "顾客的销售订单备注", "hwgRpayAmount": "88.0", "supplierCode": "100024789", "virtualNumMark": "Y是,N否", "idNumber": "34****************", "platform": "A", "sid": "BBDF4B492FA1878D7A73C25F5EE4DA22D425C50DDD181E50CE3D8234C4B27DD8A65CB...", "encryptInfo": { "encryptCustomerName": "ABCDE", "encryptMobilePhone": "ABCDE", "encryptDetailAddress": "ABCDE" }, "hwgRfreight": "2", "distributorName": "xxx", "posId": "11111", "saleTime": "2013-11-29 23:06:10", "referencePrice": "1", "actSettlementPrice": "12", "cityName": "南京市", "hwgPayTaxAmount": "1", "returnorderflag": "1", "gyaoManufact": "上海东海制药股份有限公司", "oldChangeNewFlag": "1", "gyaoBatchNum": "18010221", "address": "南京市江宁区经济开发平安路8号", "hwgPayAmount": "1", "districtName": "玄武区", "orderItemId": "00000208117601", "hwgOrderTotalAmount": "1", "hwgRcouponTotalMoney": "3", "hwgRpayTaxAmount": "1", "userName": "123123@163.com", "productCode": "101030069", "hwgPackageOrderId": "4863317887330092865", "hwgCustomsMode": "01", "zpOrderFlag": "0", "detailAddress": "苏宁大道1号", "hwgPayerName": "张三", "saleQty": "20", "hwgPayOrderId": "18741998" } ] } } }
异常码 | 错误描述 | 解决方案 |
---|---|---|
biz.selfmarket.querysaleorder.missing-parameter:* | 参数必填 | 请检查此参数的值,*号表示参数字段名 |
biz.selfmarket.querysaleorder.format-error:* | 参数格式错误 | 请检查此参数的值,*号表示参数字段名 |
biz.selfmarket.querysaleorder.enumeration-error:* | 参数的可选值错误 | 请检查此参数的值,*号表示参数字段名 |
biz.handler.data-get:no-result | 查询没结果 | 请检查查询参数 |
isp.sys.service.unavailable.somp | 服务不可用 | 请联系苏宁技术人员 |
biz.selfmarket.querysaleorder.invalid-biz:100 | 供应商编码不合法 | 请输入供应商编码 |
biz.selfmarket.querysaleorder.invalid-biz:101 | 开始时间不能为空 | 请输入开始时间 |
biz.selfmarket.querysaleorder.invalid-biz:102 | 截止时间不能为空 | 请输入截止时间 |
biz.selfmarket.querysaleorder.invalid-biz:103 | 退货状态不合法 | 退货待处理80、厂家待鉴定100、同意退货110、不同意退货120、同意退款130、拒绝退款135、同意退款票140、厂家已寄票160 |
biz.selfmarket.querysaleorder.invalid-biz:104 | 订单状态输入有误 | 订单状态。订单待发货10、订单不能满足20、订单延迟发货30、厂家已发货40、厂家确认顾客已收货45、顾客已收货50、单证已寄票60、顾客已收票70 |
biz.selfmarket.querysaleorder.invalid-biz:105 | 时间格式不正确 | 正确格式:yyyy-MM-dd HH:mm:ss |
biz.selfmarket.querysaleorder.invalid-biz:106 | 开始时间不能晚于结束时间 | 开始时间要早于截止时间 |
biz.selfmarket.querysaleorder.invalid-biz:107 | 时间间隔不能大于31天 | 开始时间结束时间间隔小于等于31天 |
异常码 | 错误描述 | 解决方案 |
---|---|---|
sys.check.user-permission:inexistence | 访问令牌不存在 | 更换访问令牌 |
sys.check.user-permission:overdue | 访问令牌已过期 | 请使用刷新令牌刷新 |
sys.check.api-permission:inexistence | Api方法不存在 | 请参考帮助中心 |
sys.check.api-permission:overdue | Api方法已过期 | 请参考帮助中心 |
sys.check.method-permission:authority | 无权操作此api | 确认是否有访问该方法权限 |
sys.auth.vendor-request:errory | 无权操作此供应商 | 请确认供应商编码是否正确 |
sys.controller.api-request:limit | Api请求受控 | 超过请求次数 |
sys.check.app-time:error | 请求参数错误api请求时间误差大 | 参考帮助中心 |
sys.check.request-params:error | 请求报文结构错误 | 参考帮助中心、日期格式等 |
sys.check.starttime-format:error | 请求开始时间错误 | 参考帮助中心、日期格式等 |
biz.handler.data-get:success | 业务数据查询成功 | 无 |
biz.handler.data-get:fail | 业务数据查询失败 | 检查请求条件 |
biz.handler.data-get:no-result | 业务数据结果为空 | 无 |
sys.check.pageno-format:error | pageNo格式错误,只允许1到99999之间的整数 | 检查pageNo输入是否有误 |
sys.check.pagesize-format:error | pageSize格式错误,只允许1到50之间的整数(订单相关是1到100) | 检查pageSize输入是否有误 |
sys.check.page-param:error | pageNo或者pageSize不在要求范围内,pageNo只允许1到99999之间的整数,pageSize只允许1到50之间的整数(订单相关是1到100) | 检查pageNo和pageSize输入是否有误 |
sys.check.miss-time:starttime | 不存在开始时间(节点) | 检查输入 |
sys.check.miss-time:endtime | 不存在结束时间(节点) | 检查输入 |
sys.check.starttime-value:null | 开始时间为空(值) | 检查输入 |
sys.check.endtime-value:null | 结束时间为空(值) | 检查输入 |
sys.check.starttime-format:error | 校验开始时间不合法,格式yyyy-MM-dd HH:mm:ss | 检查时间格式 |
sys.check.endtime-format:error | 校验结束时间不合法,格式yyyy-MM-dd HH:mm:ss | 检查时间格式 |
sys.check.query-time:error | 开始时间是否小于结束时间 | 检查开始和结束时间大小 |
sys.check.query-time:outofrange | 时间查询是否超出指定范围 | 检查时间范围 |
sys.check.app-sign:null | 签名信息为空 | 检查签名信息 |
sys.check.app-sign:error | 签名信息错误 | 检查签名信息 |
sys.check.missing-parameter:apiversion | API版本号未指定 | 检查API版本号 |
sys.check.missing-parameter:appRequestTime | 请求时间丢失 | 检查请求时间 |
sys.check.missing-nestElement:sn_body | 缺少sn_body节点 | 检查sn_body是否存在 |
sys.check.user-permission:inexistence | 用户key不存在 | 检查用户key是否存在 |
biz.handler.batch-handler:no-support | 非查询类API不支持批量操作 | 检查API类型 |
biz.handler.request-message:error | 查询类API输入多个业务节点 | 检查业务节点 |
sys.check.header-param:null | header参数为空 | 请检查header参数 |
sys.controller.api-access:limit | 访问限制 | 无 |
sys.controller.api-frequency:limit | 访问频率限制 | 无 |
sys.error.network:failure | 网络异常 | 无 |
sys.error.network-status:? | 响应失败 ?为状态码 | 无 |
sys.check.snunionid.length.is.not:48 | 混淆会员编码长度不是48位 | 使用转换器转换混淆会员编码规定要求混淆会员编码48位 |
Q:批量获取销售订单接口如何使用?
A:通过此接口可批量获取销售订单