退出
热词搜索：
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.invorder.receive 发票订单接收接口
￥免费

承接第三方开票业务，接收第三方发票订单,具备电子发票资质的企业用户通过此接口填写销方、购方、商品明细等信息发起开票请求。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
platformCodingStringY70069114商户编码
sysSourceStringN例如：ZY：自营系统来源
orderNumStringY32018091901订单号（每个企业唯一）
orderReturnNumStringN32018091901退货单号
orderTimeStringY2018-09-28 14:26:11订单时间
saleTaxNumStringY140301193302051282销货方税号
saleNameStringN南京苏宁软件技术有限公司销货方公司名称(50汉字，100字符)
saleAddressStringN南京市玄武区苏宁大道1号销货方公司地址
saleTelStringN025-66996699销货方电话
saleBankStringN中国银行销货方开户行
saleBankNumStringN622848039260099销货方开户行账号
clientNameStringN个人购货方名称，扫码开不传，其余必传(50汉字，100字符)
clientTaxNumStringN622848039260099购货方识别号，当购方类型为01时，必填(15,18,20位,长度15-20位)
clientAddressStringNxx市xx区购货方地址(40汉字,80字符)
clientTelStringN025-8888购货方固定电话
clientPhoneStringN18551620000购货方手机，非扫码开必传(11位)
clientEmailStringNxxx@163.com购货方邮箱（20位）
clientTypeStringN01购货方企业类型,01：企业 02：机关事业单位 03：个人 04：其它（非扫码开必传）
clientBankStringN中国银行购货方开户行（40汉字，开户行+帐号：50汉字，100字符）
clientBankNumStringN622848039260099购货方开户行账号（40位，开户行+帐号：50汉字，100字符）
ticketNameStringN张三开票人（8汉字）
payeeNameStringN李四收款人（8汉字）
reviwerNameStringN李五复核人（8汉字）
ticketTypeStringY1开票类型，1 蓝字发票、-1 红字发票
countMoneyStringY100合计开票金额
oldTicketCodeStringN150003528888原发票代码，开票类型为-1时必传
oldTicketNumStringN62786934原发票号码，开票类型为-1时必传
remarkStringNxx电子发票票面备注信息栏展示用（50汉字，100字符）
buySignStringN1收购标志,1：收购票（Y）代开标志为1时，不能填Y 2：非收购票：此字段为空 3：收购票扣除额必须为空 4：收购票税率必须为0
specialRedSignStringN0默认传0：正常冲红，红票必传
detialSignStringY0清单标志,0：普通电子发票 1：普通电子发票-清单 2：收购电子发票 3：收购电子发票-清单 4：成品油电子发票 默认0 大于8行 是否自动转清单票
extendFieldStringNxx扩展字段
cmmdtysStringN
goodSerialNumStringY0001明细行序号
goodIdStringN000101业务行号
goodsNameStringY空调商品名称（35汉字,70字符）
goodUnitStringN台项目单位(5汉字)
goodModelStringNP规格型号（20汉字，40字符）
goodNumStringY10项目数量
goodPriceStringY100.00项目单价
goodContainTaxSignStringY1含税标志，表示项目单价和项目金额是否含税。 0 表示都不含税，1 表示都含税。
goodDiscountStringN5商品折扣
goodsCodeStringN600012346商户自己的商品编码，用于获取商品税率、税收分类编码（商品编码不传则税分类编码和税率必传）
goodTaxCodeStringN654334商品税收分类编码，如商品编码不传，则必填
goodCountAmountStringY1000项目金额
goodRateStringN0.16税率，如商品编码未传，则必填
goodGovSignStringN0优惠政策标识，0：不使用，1：使用，默认传0
goodTaxAmountStringN160税额
goodZeroTaxSignStringN0零税率标识，0：出口零税率，1：免税，2：不征税，0%税率但不享受优惠政策或享受除上述三种优惠政策 3税率为非 0% 空
goodSpecialSignStringN不征税增值税特殊管理，当优惠政策标识为1时必填 当零税率标识为0时：出口零税率 当零税率标识为1时：免税 当零税率为2时：不征税
goodDeductionsStringN-10扣除额
receiveModeStringN0201-sop下发，02-api，03-h5扫描开，04-手工开票
howtoPrintStringN0开票方式，0实时开，1扫码开（该字段废弃，不传）
orderNumPwdStringN1B0A2C64C2A1A7FAB7DEBE25FED8B742扫码开必填，用于扫码开场景小票上订单二维码参数使用，由消费端生成，无规律，建议使用UUID
响应参数
名称 类型 示例值 描述
billNumberString2018090112984业务单号
fpqqlshString201809201151292543956发票请求流水号
respCodeString0000返回编码
respMsgString成功返回描述
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                
<sn_request>
  <sn_body>
    <receiveInvorder>
      <clientTaxNum>622848039260099</clientTaxNum>
      <orderReturnNum>32018091901</orderReturnNum>
      <clientName>个人</clientName>
      <saleBankNum>622848039260099</saleBankNum>
      <sysSource>例如：ZY：自营</sysSource>
      <saleTel>025-66996699</saleTel>
      <orderNum>32018091901</orderNum>
      <clientBank>中国银行</clientBank>
      <remark>xx</remark>
      <clientAddress>xx市xx区</clientAddress>
      <oldTicketCode>150003528888</oldTicketCode>
      <clientTel>025-8888</clientTel>
      <payeeName>李四</payeeName>
      <saleName>南京苏宁软件技术有限公司</saleName>
      <clientType>01</clientType>
      <orderTime>2018-09-28 14:26:11</orderTime>
      <oldTicketNum>62786934</oldTicketNum>
      <cmmdtys>
        <goodUnit>台</goodUnit>
        <goodRate>0.16</goodRate>
        <goodGovSign>0</goodGovSign>
        <goodDiscount>5</goodDiscount>
        <goodContainTaxSign>1</goodContainTaxSign>
        <goodId>000101</goodId>
        <goodPrice>100.00</goodPrice>
        <goodSerialNum>0001</goodSerialNum>
        <goodTaxAmount>160</goodTaxAmount>
        <goodTaxCode>654334</goodTaxCode>
        <goodZeroTaxSign>0</goodZeroTaxSign>
        <goodSpecialSign>不征税</goodSpecialSign>
        <goodDeductions>-10</goodDeductions>
        <goodModel>P</goodModel>
        <goodCountAmount>1000</goodCountAmount>
        <goodsCode>600012346</goodsCode>
        <goodsName>空调</goodsName>
        <goodNum>10</goodNum>
      </cmmdtys>
      <extendField>xx</extendField>
      <clientEmail>xxx@163.com</clientEmail>
      <howtoPrint>0</howtoPrint>
      <platformCoding>70069114</platformCoding>
      <saleTaxNum>140301193302051282</saleTaxNum>
      <clientBankNum>622848039260099</clientBankNum>
      <ticketType>1</ticketType>
      <reviwerName>李五</reviwerName>
      <clientPhone>18551620000</clientPhone>
      <orderNumPwd>1B0A2C64C2A1A7FAB7DEBE25FED8B742</orderNumPwd>
      <saleAddress>南京市玄武区苏宁大道1号</saleAddress>
      <buySign>1</buySign>
      <receiveMode>02</receiveMode>
      <detialSign>0</detialSign>
      <countMoney>100</countMoney>
      <specialRedSign>0</specialRedSign>
      <saleBank>中国银行</saleBank>
      <ticketName>张三</ticketName>
    </receiveInvorder>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "receiveInvorder": {
        "clientTaxNum": "622848039260099",
        "orderReturnNum": "32018091901",
        "clientName": "个人",
        "saleBankNum": "622848039260099",
        "sysSource": "例如：ZY：自营",
        "saleTel": "025-66996699",
        "orderNum": "32018091901",
        "clientBank": "中国银行",
        "remark": "xx",
        "clientAddress": "xx市xx区",
        "oldTicketCode": "150003528888",
        "clientTel": "025-8888",
        "payeeName": "李四",
        "saleName": "南京苏宁软件技术有限公司",
        "clientType": "01",
        "orderTime": "2018-09-28 14:26:11",
        "oldTicketNum": "62786934",
        "cmmdtys": [
          {
            "goodUnit": "台",
            "goodRate": "0.16",
            "goodGovSign": "0",
            "goodDiscount": "5",
            "goodContainTaxSign": "1",
            "goodId": "000101",
            "goodPrice": "100.00",
            "goodSerialNum": "0001",
            "goodTaxAmount": "160",
            "goodTaxCode": "654334",
            "goodZeroTaxSign": "0",
            "goodSpecialSign": "不征税",
            "goodDeductions": "-10",
            "goodModel": "P",
            "goodCountAmount": "1000",
            "goodsCode": "600012346",
            "goodsName": "空调",
            "goodNum": "10"
          }
        ],
        "extendField": "xx",
        "clientEmail": "xxx@163.com",
        "howtoPrint": "0",
        "platformCoding": "70069114",
        "saleTaxNum": "140301193302051282",
        "clientBankNum": "622848039260099",
        "ticketType": "1",
        "reviwerName": "李五",
        "clientPhone": "18551620000",
        "orderNumPwd": "1B0A2C64C2A1A7FAB7DEBE25FED8B742",
        "saleAddress": "南京市玄武区苏宁大道1号",
        "buySign": "1",
        "receiveMode": "02",
        "detialSign": "0",
        "countMoney": "100",
        "specialRedSign": "0",
        "saleBank": "中国银行",
        "ticketName": "张三"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              
<sn_responseContent>
  <sn_body>
    <receiveInvorder>
      <fpqqlsh>201809201151292543956</fpqqlsh>
      <respMsg>成功</respMsg>
      <billNumber>2018090112984</billNumber>
      <respCode>0000</respCode>
    </receiveInvorder>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "receiveInvorder": {
        "fpqqlsh": "201809201151292543956",
        "respMsg": "成功",
        "billNumber": "2018090112984",
        "respCode": "0000"
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.custom.receiveinvorder.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.custom.receiveinvorder.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.iips 服务不可用 请联系苏宁技术人员
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ