通过此接口可单笔获取销售订单
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
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授权方式为必填参数 |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
orderItemId | String | Y | 00000208117601 | 订单行号 |
supplierCode | String | Y | 10001373 | 供应商编码 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
activityTypes | String | ||
activityName | String | 闪拍 | 活动类型名称 |
activityType | String | 08 | 活动类型(01: 满减 02:赠品 03:返券 04:渠道专享订单 05:免费试用订单 06:付邮试用订单 07:预定订单 08:秒杀订单 09:S码活动订单 10:大聚惠订单 11:名品特卖订单 12:闪拍订单 13:纸质球票订单 14:电子球票订单 20:预售 21:大聚惠-促销价 22:套餐) |
applicant | String | 01 | 发起方:01-商户;02-平台 |
address | String | 南京市江宁区经济开发平安路8号 | 顾客送货地址。市、县/区、镇/街道、详细地址 |
cityName | String | 南京市 | 收件人地址(市)中文 |
couponTotalMoney | String | 20.00 | 优惠券总金额 |
customerName | String | 张三 | 顾客姓名 |
detailAddress | String | 苏宁大道1号 | 详细地址 |
distChannel | String | 50 | 分销渠道 |
districtName | String | 雨花台区 | 收件人地址(区)中文 |
hopeArrivalTime | String | 20130101090325 | 交货时间 |
invoiceConent | String | 食品、日用品、办公用品 | 发票内容 |
invoiceHead | String | 江苏苏宁易购电子商务有限公司 | 发票抬头 |
invoiceType | String | 01-增值税发票 02-普通发票 | 发票类型 |
memberOrgName | String | 江苏苏宁软件技术有限公司 | 会员单位名称 |
mobilePhone | String | 13957582227 | 移动电话 |
needInvoiceFlag | String | Y/N | 是否需要发票 |
orderId | String | 111111 | B2C订单号 |
orderItemId | String | 00000208117601 | 订单行号 |
payAmount | String | 20.00 | 应付金额 |
payItems | String | ||
bankTypeCode | String | 9031 | 银行种类编码 |
bankTypeName | String | 储值卡(券) | 银行种类名称 |
parentPayCode | String | 50 | 支付方式上级编码 |
payAmount | String | 20.00 | 支付方式分摊金额 |
payCode | String | 5002 | 支付方式编码 |
alipayPayNo | String | 00120485973301 | 外部支付流水号 |
payId | String | 00120485973301 | 支付单号 |
applicant | String | 01 | 发起方:01-商户;02-平台 |
platform | String | A | 平台来源。苏宁:A ,天猫:B, 抖音:C, 拼多多:D ,快手:E, 淘特:F ,视频号:G ,百度小店:BD, 小红书:H, |
posId | String | 11111 | POS单号 |
price | String | 50.20 | 销售价。最后交易价 |
prmtBillTotalAmt | String | 25.00 | 优惠单总金额 |
productCode | String | 101030069 | 商品编码 |
productName | String | 保健品王 | 商品名称 |
provinceName | String | 江苏省 | 收件人地址(省)中文 |
remark | String | 顾客的销售订单备注 | 订单备注 |
remarkcolorflag | String | 1:红色,2:黄色,3:绿色,4:蓝色,5:紫色; | 商家备注旗帜 |
saleOrg | String | 5016 | 销售组织 |
saleQty | String | 20 | 销售数量 |
saleTime | String | 2013-11-29 23:06:10 | 订单销售日期时间。年月日小时分钟 |
shipCondition | String | 01 | 装运条件 |
status | String | 20 | 订单状态。订单待发货10、订单不能满足20、订单延迟发货30、厂家已发货40、厂家确认顾客已收货45、顾客已收货50、单证已寄票60、顾客已收票70 |
supplierCmmdtyCode | String | 123123123 | 商家商品编码 |
supplierCode | String | 10001373 | 供应商编码 |
supplierremark | String | 轻拿轻放 | 商家备注内容 |
taxIfSend | String | Y/N | 发票是否需要邮寄 |
taxPayerAddress | String | 北京市顺义区全境顺鑫朗郡小区北京市顺义区杨镇顺鑫朗郡小区4号楼1单元402室 | 增值税发票收件人地址 |
taxPayerMobileNum | String | 18551601553 | 增值税发票收件人手机 |
taxPayerName | String | 张小书 | 增值税发票收件人姓名 |
taxPayerPhoneNum | String | 043262731056 | 增值税发票收件人电话 |
telephone | String | 13957582227 | 电话 |
totalAmount | String | 2400.00 | 行项目销售额 |
transportFee | String | 5.00 | 运费 |
zipCode | String | 210000 | 邮政编码 |
townName | String | 鼓楼街道 | 镇街道 |
wareCode | String | Z01 | 供应商填写的仓库编码 |
returnorderflag | String | 1 | 退货标识 0:非退货; 1:退货 |
returnStatus | String | 80 | 退货状态 |
exchangeGoodsFlag | String | 1 | 换货标识:无换货(0),换货中(1),换货完成(2) |
expressInfos | String | ||
deliverytype | String | 1 | 发货方式 |
expressno | String | 00101316800801 | 物流单号 |
expressCompanyCode | String | D01 | 快递公司编码 |
expresscompanyName | String | 德邦 | 快递公司名称 |
deliAmount | String | 1 | 发货数量, 仅在多运单下有效, 非多运单取saleqty. |
activeTime | String | 2022-01-07 | 生效时间 |
disableTime | String | 2022-01-17 | 失效时间 |
isGift | String | 0 | 是否赠品标识 1--是0--否 |
receiptDate | String | 2018-01-01 10:00:00 | 确认收货时间 |
isShowPrice | String | 1 | 是否展示价格,0-不展示,1-展示 |
distributorName | String | xxx | 分销商名称 |
factoryIWDFlag | String | 1 | 苏宁仓配:1-是 0-否 |
pickDate | String | 2020-11-18 12:00:00 | 承诺发货日期 |
purchasePrice | String | 12 | 采购价 |
isOtherDelivery | String | 1 | 其他商家发货标识0否1是 |
sid | String | BBDF4B492FA1878D7A73C25F5EE4DA22D425C50DDD181E50CE3D8234C4B27DD8A65CB... | address+customerName+detailAddress+telephone加密字段,解密后格式为:{address:南京市江宁区经济开发平安路8号,customerName:张哈哈,detailAddress:江苏省南京市玄武区玄武湖1号,telephone:66996699} |
userName | String | 123123@163.com | 买家帐号 |
serialNumFlag | String | 1 | 是否需要回传序列号 1是 |
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否 | 虚拟号标识 |
referencePrice | String | 1 | 供应商维护的销售价 |
cscPrice | String | 1 | 直降、大聚惠的购物车结算价格 |
voucherList | String | ||
voucherId | String | 1 | 优惠单号 |
allocatedAmount | String | 1 | 分摊金额 |
hwgDeclareFlag | String | 未申报,申报成功 | 申报状态 |
hwgMergePayNo | String | 111111 | 合并支付单号(申报后) |
hwgOrderTotalAmount | String | 1 | 合单维度:订单总金额 |
hwgTotalCount | String | 1 | 合单维度:总件数 |
hwgPayAmount | String | 1 | 合单维度:支付金额 |
hwgPayTaxAmount | String | 1 | 合单维度:支付税款 |
hwgFreight | String | 1 | 合单维度:支付运费 |
hwgCouponTotalMoney | String | 1 | 合单维度:优惠金额 |
oldChangeNewFlag | String | 1 | 0-以旧换新家电两步式订单且旧机已回收完成,1代表以旧换新家电两步式订单且旧机未回收完成。为空表示非以旧换新家电两步式订单 |
outCode | String | 200111111111 | 外部订单号 |
outItemCode | String | 20011111111101 | 外部订单行号 |
<sn_request> <sn_body> <getSaleOrder> <orderItemId>00000208117601</orderItemId> <supplierCode>10001373</supplierCode> </getSaleOrder> </sn_body> </sn_request>
{ "sn_request": { "sn_body": { "getSaleOrder": { "orderItemId": "00000208117601", "supplierCode": "10001373" } } } }
<sn_responseContent> <sn_body> <getSaleOrder> <zipCode>210000</zipCode> <distChannel>50</distChannel> <hwgPayerDocumentNumber>110110200001010002</hwgPayerDocumentNumber> <orderId>111111</orderId> <voucherList> <allocatedAmount>1</allocatedAmount> <voucherId>1</voucherId> </voucherList> <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>12</purchasePrice> <payItems> <payAmount>20.00</payAmount> <bankTypeCode>9031</bankTypeCode> <bankTypeName>储值卡(券)</bankTypeName> <alipayPayNo>00120485973301</alipayPayNo> <payId>00120485973301</payId> <payCode>5002</payCode> <parentPayCode>50</parentPayCode> <applicant>01</applicant> </payItems> <productName>保健品王</productName> <saleOrg>5016</saleOrg> <hwgTotalCount>1</hwgTotalCount> <activityTypes> <activityName>闪拍</activityName> <activityType>08</activityType> <applicant>01</applicant> </activityTypes> <hwgFreight>1</hwgFreight> <hwgCountryCode>中国</hwgCountryCode> <payAmount>20.00</payAmount> <price>50.20</price> <invoiceType>01-增值税发票 02-普通发票</invoiceType> <hopeArrivalTime>20130101090325</hopeArrivalTime> <hwgPayerDocumentType>01</hwgPayerDocumentType> <cscPrice>1</cscPrice> <memberOrgName>江苏苏宁软件技术有限公司</memberOrgName> <taxPayerMobileNum>18551601553</taxPayerMobileNum> <supplierCmmdtyCode>123123123</supplierCmmdtyCode> <townName>鼓楼街道</townName> <exchangeGoodsFlag>1</exchangeGoodsFlag> <needInvoiceFlag>Y/N</needInvoiceFlag> <serialNum>969670000000000</serialNum> <outCode>200111111111</outCode> <activeTime>2022-01-07</activeTime> <receiptDate>2018-01-01 10:00:00</receiptDate> <telephone>13957582227</telephone> <wareCode>Z01</wareCode> <customerName>张三</customerName> <prmtBillTotalAmt>25.00</prmtBillTotalAmt> <shipCondition>01</shipCondition> <outItemCode>20011111111101</outItemCode> <totalAmount>2400.00</totalAmount> <supplierremark>轻拿轻放</supplierremark> <invoiceHead>江苏苏宁易购电子商务有限公司</invoiceHead> <isShowPrice>1</isShowPrice> <mobilePhone>13957582227</mobilePhone> <hwgMergePayNo>111111</hwgMergePayNo> <serialNumFlag>1</serialNumFlag> <provinceName>江苏省</provinceName> <remarkcolorflag>1:红色,2:黄色,3:绿色,4:蓝色,5:紫色;</remarkcolorflag> <hwgDeclareFlag>未申报,申报成功</hwgDeclareFlag> <status>20</status> <invoiceConent>食品、日用品、办公用品</invoiceConent> <isOtherDelivery>1</isOtherDelivery> <hwgDistType>03</hwgDistType> <transportFee>5.00</transportFee> <taxIfSend>Y/N</taxIfSend> <remark>顾客的销售订单备注</remark> <taxPayerName>张小书</taxPayerName> <hwgRpayAmount>88.0</hwgRpayAmount> <supplierCode>10001373</supplierCode> <virtualNumMark>Y是,N否</virtualNumMark> <platform>A</platform> <taxPayerPhoneNum>043262731056</taxPayerPhoneNum> <sid>BBDF4B492FA1878D7A73C25F5EE4DA22D425C50DDD181E50CE3D8234C4B27DD8A65CB...</sid> <hwgRfreight>2</hwgRfreight> <distributorName>xxx</distributorName> <posId>11111</posId> <saleTime>2013-11-29 23:06:10</saleTime> <referencePrice>1</referencePrice> <cityName>南京市</cityName> <hwgPayTaxAmount>1</hwgPayTaxAmount> <returnorderflag>1</returnorderflag> <isGift>0</isGift> <oldChangeNewFlag>1</oldChangeNewFlag> <address>南京市江宁区经济开发平安路8号</address> <districtName>雨花台区</districtName> <hwgPayAmount>1</hwgPayAmount> <orderItemId>00000208117601</orderItemId> <hwgOrderTotalAmount>1</hwgOrderTotalAmount> <hwgRcouponTotalMoney>3</hwgRcouponTotalMoney> <expressInfos> <expressno>00101316800801</expressno> <expresscompanyName>德邦</expresscompanyName> <expressCompanyCode>D01</expressCompanyCode> <deliAmount>1</deliAmount> <deliverytype>1</deliverytype> </expressInfos> <hwgRpayTaxAmount>1</hwgRpayTaxAmount> <userName>123123@163.com</userName> <couponTotalMoney>20.00</couponTotalMoney> <taxPayerAddress>北京市顺义区全境顺鑫朗郡小区北京市顺义区杨镇顺鑫朗郡小区4号楼1单元402室</taxPayerAddress> <productCode>101030069</productCode> <hwgPackageOrderId>4863317887330092865</hwgPackageOrderId> <hwgCustomsMode>01</hwgCustomsMode> <detailAddress>苏宁大道1号</detailAddress> <hwgPayerName>张三</hwgPayerName> <saleQty>20</saleQty> <hwgPayOrderId>18741998</hwgPayOrderId> <disableTime>2022-01-17</disableTime> </getSaleOrder> </sn_body> </sn_responseContent>
{ "sn_responseContent": { "sn_body": { "getSaleOrder": [ { "zipCode": "210000", "distChannel": "50", "hwgPayerDocumentNumber": "110110200001010002", "orderId": "111111", "voucherList": [ { "allocatedAmount": "1", "voucherId": "1" } ], "hwgStatus": "1", "returnStatus": "80", "hwgCouponTotalMoney": "1", "pickDate": "2020-11-18 12:00:00", "hwgRtotalAmount": "82.78", "factoryIWDFlag": "1", "purchasePrice": "12", "payItems": [ { "payAmount": "20.00", "bankTypeCode": "9031", "bankTypeName": "储值卡(券)", "alipayPayNo": "00120485973301", "payId": "00120485973301", "payCode": "5002", "parentPayCode": "50", "applicant": "01" } ], "productName": "保健品王", "saleOrg": "5016", "hwgTotalCount": "1", "activityTypes": [ { "activityName": "闪拍", "activityType": "08", "applicant": "01" } ], "hwgFreight": "1", "hwgCountryCode": "中国", "payAmount": "20.00", "price": "50.20", "invoiceType": "01-增值税发票 02-普通发票", "hopeArrivalTime": "20130101090325", "hwgPayerDocumentType": "01", "cscPrice": "1", "memberOrgName": "江苏苏宁软件技术有限公司", "taxPayerMobileNum": "18551601553", "supplierCmmdtyCode": "123123123", "townName": "鼓楼街道", "exchangeGoodsFlag": "1", "needInvoiceFlag": "Y/N", "serialNum": "969670000000000", "outCode": "200111111111", "activeTime": "2022-01-07", "receiptDate": "2018-01-01 10:00:00", "telephone": "13957582227", "wareCode": "Z01", "customerName": "张三", "prmtBillTotalAmt": "25.00", "shipCondition": "01", "outItemCode": "20011111111101", "totalAmount": "2400.00", "supplierremark": "轻拿轻放", "invoiceHead": "江苏苏宁易购电子商务有限公司", "isShowPrice": "1", "mobilePhone": "13957582227", "hwgMergePayNo": "111111", "serialNumFlag": "1", "provinceName": "江苏省", "remarkcolorflag": "1:红色,2:黄色,3:绿色,4:蓝色,5:紫色;", "hwgDeclareFlag": "未申报,申报成功", "status": "20", "invoiceConent": "食品、日用品、办公用品", "isOtherDelivery": "1", "hwgDistType": "03", "transportFee": "5.00", "taxIfSend": "Y/N", "remark": "顾客的销售订单备注", "taxPayerName": "张小书", "hwgRpayAmount": "88.0", "supplierCode": "10001373", "virtualNumMark": "Y是,N否", "platform": "A", "taxPayerPhoneNum": "043262731056", "sid": "BBDF4B492FA1878D7A73C25F5EE4DA22D425C50DDD181E50CE3D8234C4B27DD8A65CB...", "hwgRfreight": "2", "distributorName": "xxx", "posId": "11111", "saleTime": "2013-11-29 23:06:10", "referencePrice": "1", "cityName": "南京市", "hwgPayTaxAmount": "1", "returnorderflag": "1", "isGift": "0", "oldChangeNewFlag": "1", "address": "南京市江宁区经济开发平安路8号", "districtName": "雨花台区", "hwgPayAmount": "1", "orderItemId": "00000208117601", "hwgOrderTotalAmount": "1", "hwgRcouponTotalMoney": "3", "expressInfos": [ { "expressno": "00101316800801", "expresscompanyName": "德邦", "expressCompanyCode": "D01", "deliAmount": "1", "deliverytype": "1" } ], "hwgRpayTaxAmount": "1", "userName": "123123@163.com", "couponTotalMoney": "20.00", "taxPayerAddress": "北京市顺义区全境顺鑫朗郡小区北京市顺义区杨镇顺鑫朗郡小区4号楼1单元402室", "productCode": "101030069", "hwgPackageOrderId": "4863317887330092865", "hwgCustomsMode": "01", "detailAddress": "苏宁大道1号", "hwgPayerName": "张三", "saleQty": "20", "hwgPayOrderId": "18741998", "disableTime": "2022-01-17" } ] } } }
异常码 | 错误描述 | 解决方案 |
---|---|---|
biz.selfmarket.getsaleorder.missing-parameter:* | 参数必填 | 请检查此参数的值,*号表示参数字段名 |
biz.handler.data-get:no-result | 查询没结果 | 请检查查询参数 |
isp.sys.service.unavailable.somp | 服务不可用 | 请联系苏宁技术人员 |
biz.selfmarket.getsaleorder.invalid-biz:100 | 供应商编码不合法 | 请输入供应商编码 |
biz.selfmarket.getsaleorder.invalid-biz:101 | OMS订单行号不能为空 | 请输入OMS订单行号 |
biz.selfmarket.getsaleorder.invalid-biz:102 | OMS订单行号不合法 | 请输入14位数字 |
异常码 | 错误描述 | 解决方案 |
---|---|---|
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:通过此接口可单笔获取销售订单