开放服务-API列表

热词搜索：

suning.retailer.btcorderdetails.get 零售云B2C订单详情查询接口

￥免费

零售云B2C订单详情查询接口

公共参数

名称	类型	是否必须	示例值	描述
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授权方式为必填参数

请求参数

名称	类型	是否必须	示例值	描述
appId	String	Y	111111	调用方唯一编码
orderCode	String	Y	P2019854512654	B2c订单号
channelCode	String	N	19451	零售商外部唯一标识
storeCode	String	N	59021	channelCode、storeCode(门店编码)必须填一个

响应参数

名称	类型	示例值	描述
respBean	String
orderCode	String	P307811348906097	订单号
merchantCode	String	080525	零售商编码
storeCode	String	59128	店铺编码
storeName	String	店铺名称	店铺名称
userCode	String	EMP1523935333427	销售员编码
cashierCode	String	EMP1523935333427	收银员编码
buyerCode	String	7000586928	顾客会员编码
buyerPhone	String	13800000000	顾客手机号
buyerName	String	小明	顾客姓名
payState	String	1	支付状态 -1：已取消/已删除，0：未支付/待退款，1：已支付/已退款
orderState	String	1	订单状态（1:待支付 2:待发货 3:已完成 4:待审核 5：待退款 6：退款中 7:已退款 -1:已取消）
orderAmount	String	826.00	订单总价
discountAmount	String	0.00	优惠金额
payAmount	String	826.00	应付金额
updateTime	String	2019-08-05 09:43:05	更新时间
paidAmount	String	826.00	实付金额
paidTime	String	2019-08-05 09:43:05	支付完成时间
orderTime	String	2019-08-05 09:30:44	下单时间
remark	String	备注	订单备注信息
createCode	String	EMP1523935333427	销售员编码
combinationFlag	String	0	是否包含套餐
orderFrom	String	1	订单来源
orderChannel	String	1	订单渠道
orderItems	String
orderItemCode	String	P30781134890609701	订单行号
cmmdtyCode	String	000000000120874428	商品编码
combinationCode	String	111111	套餐编码
cmmdtyName	String	一台洗衣机	商品名称
unitPrice	String	826.00	单价
sellPrice	String	826.00	实际单价
quantity	String	1	数量
totalPayAmount	String	826.00	实际应付金额
discountItemAmount	String	0.00	行优惠金额
returnNum	String	0	申请退货及已退总数量
purchaseOrderItemNo	String	00102399563601	采购订单行号
purchaseOrderNo	String	001023995636	采购订单号
purchasePrice	String	800.00	采购价格
returnState	String	0	退货状态（0：可退，1：处理中，-1：已退）
orderItemState	String	2	订单行状态（1:待支付 2:待发货 3:已完成 4:待审核 5：待退款 6：退款中 7:已退款 -1:已取消）
deliveryId	String	deliveryId	配送地址主键
orderType	String	1	订单类型（0：门店现货，1：平台预定）
combinationFlag	String	0	是否包含套餐
logisticsState	String	0	物流配送状态（0：未配送，1：正在配送，2：配送完成）
hopeArrivalTime	String	2019-08-06 18:00:00	期望送达时间
lanaFlag	String	0	使用蓝A标志（使用蓝A标志）
lanaDiscount	String	0.00	蓝A优惠金额
activityType	String	1	活动类型1:返利,2:高佣
goodsOrderItemCode	String	0000	阳光包对应的主商品订单行
imei	String	0000	串码
sunPackageFlag	String	1	延保标示：是否是保险商品（1：商品：2：保险）
orderDeliveryInfo	String
receiverName	String	张三	receiverName
receiverPhone	String	18000000000	receiverPhone
provinceCode	String	100	省编码
provinceName	String	江苏省	省名称
cityCode	String	025	城市编码
cityName	String	南京市	城市名称
districtCode	String	01	区编码
districtName	String	玄武区	区名称
townCode	String	99	镇编码
townName	String	全区	镇名称
buyerAddress	String	苏宁大道一号404	收货详细地址
orderPayDetails	String
payType	String	1	支付类型（1：现金支付、2：支付宝支付 3：易付宝支付、4：银联支付、5：微信支付、6：捷信支付）
payAmount	String	826.00	支付金额
payTime	String	2019-08-05 09:43:04.0	支付时间
payWay	String	0	交易方式
bankCard	String	000000000000000	银行卡号
payCode	String	CASH	支付编码
payOrderCode	String	CASH1908051000001	订单支付编码
payState	String	1	支付方式（0-未支付，1-支付成功，3-撤销成功，4-部分退货，5-全额退货，6-支付失败，8-状态未知）
orderCombinations	String
orderCode	String	000000000120874428	订单编码
combinationCode	String	111111	套餐编码
combinationName	String	套餐1	套餐名称
combinationQuantity	String	1	套餐数量

请求示例

XML示例
JSON示例

复制全部代码

                                
<sn_request>
  <sn_body>
    <getBtcorderdetails>
      <appId>111111</appId>
      <orderCode>P2019854512654</orderCode>
      <channelCode>19451</channelCode>
      <storeCode>59021</storeCode>
    </getBtcorderdetails>
  </sn_body>
</sn_request>

                                
{
  "sn_request": {
    "sn_body": {
      "getBtcorderdetails": {
        "appId": "111111",
        "orderCode": "P2019854512654",
        "channelCode": "19451",
        "storeCode": "59021"
      }
    }
  }
}

响应示例

XML示例
JSON示例

复制全部代码

                              
<sn_responseContent>
  <sn_body>
    <getBtcorderdetails>
      <respBean>
        <discountAmount>0.00</discountAmount>
        <remark>备注</remark>
        <payState>1</payState>
        <orderPayDetails>
          <payType>1</payType>
          <payAmount>826.00</payAmount>
          <bankCard>000000000000000</bankCard>
          <payTime>2019-08-05 09:43:04.0</payTime>
          <payWay>0</payWay>
          <payOrderCode>CASH1908051000001</payOrderCode>
          <payState>1</payState>
          <payCode>CASH</payCode>
        </orderPayDetails>
        <orderChannel>1</orderChannel>
        <orderItems>
          <returnState>0</returnState>
          <orderType>1</orderType>
          <purchaseOrderItemNo>00102399563601</purchaseOrderItemNo>
          <cmmdtyCode>000000000120874428</cmmdtyCode>
          <sellPrice>826.00</sellPrice>
          <purchasePrice>800.00</purchasePrice>
          <sunPackageFlag>1</sunPackageFlag>
          <discountItemAmount>0.00</discountItemAmount>
          <purchaseOrderNo>001023995636</purchaseOrderNo>
          <orderItemState>2</orderItemState>
          <deliveryId> deliveryId</deliveryId>
          <hopeArrivalTime>2019-08-06 18:00:00</hopeArrivalTime>
          <lanaFlag>0</lanaFlag>
          <goodsOrderItemCode>0000</goodsOrderItemCode>
          <unitPrice>826.00</unitPrice>
          <quantity>1</quantity>
          <cmmdtyName>一台洗衣机</cmmdtyName>
          <totalPayAmount>826.00</totalPayAmount>
          <logisticsState>0</logisticsState>
          <lanaDiscount>0.00</lanaDiscount>
          <combinationFlag>0</combinationFlag>
          <combinationCode>111111</combinationCode>
          <returnNum>0</returnNum>
          <orderItemCode>P30781134890609701</orderItemCode>
          <imei>0000</imei>
          <activityType>1</activityType>
        </orderItems>
        <userCode>EMP1523935333427</userCode>
        <orderState>1</orderState>
        <orderAmount>826.00</orderAmount>
        <payAmount>826.00</payAmount>
        <orderTime>2019-08-05 09:30:44</orderTime>
        <storeName>店铺名称</storeName>
        <createCode>EMP1523935333427</createCode>
        <orderCombinations>
          <combinationCode>111111</combinationCode>
          <combinationQuantity>1</combinationQuantity>
          <combinationName>套餐1</combinationName>
          <orderCode>000000000120874428</orderCode>
        </orderCombinations>
        <merchantCode>080525</merchantCode>
        <orderDeliveryInfo>
          <townName>全区</townName>
          <buyerAddress>苏宁大道一号404</buyerAddress>
          <receiverPhone>18000000000</receiverPhone>
          <districtCode>01</districtCode>
          <cityName>南京市</cityName>
          <districtName>玄武区</districtName>
          <townCode>99</townCode>
          <receiverName>张三</receiverName>
          <provinceCode>100</provinceCode>
          <cityCode>025</cityCode>
          <provinceName>江苏省</provinceName>
        </orderDeliveryInfo>
        <updateTime>2019-08-05 09:43:05</updateTime>
        <buyerName>小明</buyerName>
        <paidTime>2019-08-05 09:43:05</paidTime>
        <buyerCode>7000586928</buyerCode>
        <combinationFlag>0</combinationFlag>
        <buyerPhone>13800000000</buyerPhone>
        <orderCode>P307811348906097</orderCode>
        <orderFrom>1</orderFrom>
        <cashierCode>EMP1523935333427</cashierCode>
        <paidAmount>826.00</paidAmount>
        <storeCode>59128</storeCode>
      </respBean>
    </getBtcorderdetails>
  </sn_body>
</sn_responseContent>

                              
{
  "sn_responseContent": {
    "sn_body": {
      "getBtcorderdetails": {
        "respBean": {
          "discountAmount": "0.00",
          "remark": "备注",
          "payState": "1",
          "orderPayDetails": [
            {
              "payType": "1",
              "payAmount": "826.00",
              "bankCard": "000000000000000",
              "payTime": "2019-08-05 09:43:04.0",
              "payWay": "0",
              "payOrderCode": "CASH1908051000001",
              "payState": "1",
              "payCode": "CASH"
            }
          ],
          "orderChannel": "1",
          "orderItems": {
            "returnState": "0",
            "orderType": "1",
            "purchaseOrderItemNo": "00102399563601",
            "cmmdtyCode": "000000000120874428",
            "sellPrice": "826.00",
            "purchasePrice": "800.00",
            "sunPackageFlag": "1",
            "discountItemAmount": "0.00",
            "purchaseOrderNo": "001023995636",
            "orderItemState": "2",
            "deliveryId": " deliveryId",
            "hopeArrivalTime": "2019-08-06 18:00:00",
            "lanaFlag": "0",
            "goodsOrderItemCode": "0000",
            "unitPrice": "826.00",
            "quantity": "1",
            "cmmdtyName": "一台洗衣机",
            "totalPayAmount": "826.00",
            "logisticsState": "0",
            "lanaDiscount": "0.00",
            "combinationFlag": "0",
            "combinationCode": "111111",
            "returnNum": "0",
            "orderItemCode": "P30781134890609701",
            "imei": "0000",
            "activityType": "1"
          },
          "userCode": "EMP1523935333427",
          "orderState": "1",
          "orderAmount": "826.00",
          "payAmount": "826.00",
          "orderTime": "2019-08-05 09:30:44",
          "storeName": "店铺名称",
          "createCode": "EMP1523935333427",
          "orderCombinations": [
            {
              "combinationCode": "111111",
              "combinationQuantity": "1",
              "combinationName": "套餐1",
              "orderCode": "000000000120874428"
            }
          ],
          "merchantCode": "080525",
          "orderDeliveryInfo": {
            "townName": "全区",
            "buyerAddress": "苏宁大道一号404",
            "receiverPhone": "18000000000",
            "districtCode": "01",
            "cityName": "南京市",
            "districtName": "玄武区",
            "townCode": "99",
            "receiverName": "张三",
            "provinceCode": "100",
            "cityCode": "025",
            "provinceName": "江苏省"
          },
          "updateTime": "2019-08-05 09:43:05",
          "buyerName": "小明",
          "paidTime": "2019-08-05 09:43:05",
          "buyerCode": "7000586928",
          "combinationFlag": "0",
          "buyerPhone": "13800000000",
          "orderCode": "P307811348906097",
          "orderFrom": "1",
          "cashierCode": "EMP1523935333427",
          "paidAmount": "826.00",
          "storeCode": "59128"
        }
      }
    }
  }
}

异常示例

XML示例
JSON示例

复制全部代码


  
  	API异常码
  	异常码中文描述

{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}

业务异常码

异常码	错误描述	解决方案
isp.sys.service.unavailable.esser	服务不可用	请联系苏宁技术人员
biz.retailer.getbtcorderdetails.missing-parameter:*	参数必填	请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result	查询没结果	请检查查询参数
isp.sys.service.unavailable.srcdss	服务不可用	请联系苏宁技术人员
biz.retailer.getbtcorderdetails.invalid-biz:100	请求参数缺失	请检查查询参数
biz.retailer.getbtcorderdetails.invalid-biz:101	接口执行返回失败	请检查查询参数
biz.retailer.getbtcorderdetails.invalid-biz:102	查询结果为空	请检查查询参数
biz.retailer.getbtcorderdetails.invalid-biz:103	系统异常	请联系苏宁技术人员
biz.retailer.getbtcorderdetails.invalid-biz:105	无效的AppId请求	请检查查询参数
biz.retailer.getbtcorderdetails.invalid-biz:112	门店/渠道信息不存在	请检查查询参数

公共异常码

异常码	错误描述	解决方案
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位

API工具

API TOOLS 在线测试工具异常码查询工具 SDK调用示例 SDK下载

FAQ

零售云业务