API接口目录

平台业务

商品API
价格API
库存API
销售准备API
交易API
退货退款API(新)
财务API
店铺API
物流API
促销API
分销API
发票API
招商API
换货API
互动营销API
退货退款API
客服API
平台营销API
风控API
会员通API
账房API
财务记账API
异常码自查工具
suning.custom.storage.query 易购C店电子发票开票结果查询
¥免费

易购上的C店订单开完票后,C店商户可调用此接口查询开票接口,该接口只查易购上的C店订单

公共参数
请求参数
名称 类型 是否必须 示例值 描述
storageStringN
billNoStringY取单号的值(订单维度),例如:32281421244业务单号
billTypeStringY01:OMS单号 02:OMS行号 03:B2C单号 04:B2C行号 返回报文时,返回对应行号业务单号类型
saleTaxNoStringN91320106773973920L销方税号
saleOrgStringY举例:70066253商户编码
响应参数
名称 类型 示例值 描述
returnCodeString0000查询成功与否标识,0000-成功,9999-失败
returnMsgString调用失败查询成功与否描述,如查询失败,查询成功与否标识返回9999时,返回报错信息
retrunInvString
saleOrgString70066253商户编码
saleTaxNoString111122223333444455销方税号
orderNoString123456业务单号,根据业务单号类型billType返回 billType为01时,返回OMS单号 billType为03时,返回B2C单号
orderItemString
orderItemIdString12345678订单行号
invItemsString
invoiceFlagString04发票标识,订单开具发票的类型标识 枚举值:01-增值税专用发票,02-增值税普通发票,04-电子发票
invoiceTypeString1发票类型,1-蓝票、-1-红票
invoiceCodeString032001700211发票代码
invoiceNumString88093702发票号码
invoiceAmountString100开票金额
invoiceNoTaxAmountString90不含税金额
invoiceDateString2019-11-11开票日期,格式:YYYY-MM-DD
invoiceSecurityCodeString59888 37763 38108 76652发票校验码
oldInvoiceCodeString032001700211原发票代码,发票类型为:-1时,且发票类型是04电子发票时,传值
oldInvoiceNumString88093701原发票号码,发票类型为:-1时,且发票类型是04电子发票时,传值
logisticsOrderIdString1111111111物流单号,纸质发票存在物流单号
logisticsCompString苏宁物流公司,纸质发票存在物流公司
invoiceStatusString2发票开具状态,0-无发票 2-正常
invoicePdfUrlStringwww.suning.com发票PDF路径,发票文件url地址
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <queryStorage>
      <storage>
        <saleTaxNo>91320106773973920L</saleTaxNo>
        <billType>01:OMS单号 02:OMS行号 03:B2C单号 04:B2C行号 返回报文时,返回对应行号</billType>
        <billNo>取单号的值(订单维度),例如:32281421244</billNo>
        <saleOrg>举例:70066253</saleOrg>
      </storage>
    </queryStorage>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryStorage": {
        "storage": [
          {
            "saleTaxNo": "91320106773973920L",
            "billType": "01:OMS单号 02:OMS行号 03:B2C单号 04:B2C行号 返回报文时,返回对应行号",
            "billNo": "取单号的值(订单维度),例如:32281421244",
            "saleOrg": "举例:70066253"
          }
        ]
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_body>
    <queryStorage>
      <returnCode>0000</returnCode>
      <returnMsg>调用失败</returnMsg>
      <retrunInv>
        <saleTaxNo>111122223333444455</saleTaxNo>
        <orderNo>123456</orderNo>
        <orderItem>
          <invItems>
            <invoiceFlag>04</invoiceFlag>
            <logisticsOrderId>1111111111</logisticsOrderId>
            <oldInvoiceCode>032001700211</oldInvoiceCode>
            <invoiceAmount>100</invoiceAmount>
            <logisticsComp>苏宁</logisticsComp>
            <invoiceDate>2019-11-11</invoiceDate>
            <invoiceCode>032001700211</invoiceCode>
            <invoiceNum>88093702</invoiceNum>
            <invoicePdfUrl>www.suning.com</invoicePdfUrl>
            <invoiceNoTaxAmount>90</invoiceNoTaxAmount>
            <invoiceSecurityCode>59888 37763 38108 76652</invoiceSecurityCode>
            <invoiceType>1</invoiceType>
            <invoiceStatus>2</invoiceStatus>
            <oldInvoiceNum>88093701</oldInvoiceNum>
          </invItems>
          <orderItemId>12345678</orderItemId>
        </orderItem>
        <saleOrg>70066253</saleOrg>
      </retrunInv>
    </queryStorage>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "queryStorage": {
        "returnCode": "0000",
        "returnMsg": "调用失败",
        "retrunInv": [
          {
            "saleTaxNo": "111122223333444455",
            "orderNo": "123456",
            "orderItem": [
              {
                "invItems": [
                  {
                    "invoiceFlag": "04",
                    "logisticsOrderId": "1111111111",
                    "oldInvoiceCode": "032001700211",
                    "invoiceAmount": "100",
                    "logisticsComp": "苏宁",
                    "invoiceDate": "2019-11-11",
                    "invoiceCode": "032001700211",
                    "invoiceNum": "88093702",
                    "invoicePdfUrl": "www.suning.com",
                    "invoiceNoTaxAmount": "90",
                    "invoiceSecurityCode": "59888 37763 38108 76652",
                    "invoiceType": "1",
                    "invoiceStatus": "2",
                    "oldInvoiceNum": "88093701"
                  }
                ],
                "orderItemId": "12345678"
              }
            ],
            "saleOrg": "70066253"
          }
        ]
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.custom.querystorage.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.custom.querystorage.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.iips 服务不可用 请联系苏宁技术人员
公共异常码
API工具
FAQ