API接口目录

政企业务

政企商品API
政企价格API
政企库存API
政企订单API
政企物流API
政企发票API
政企售后API
政企其他API
政企易企购API
政企抽检API
异常码自查工具
suning.govbus.getinvoiceinfobymarkid.query 批次号查询发票信息(新)
¥免费

根据markid查询发票信息,按照发票维度返回数据,如需使用,需先找苏宁技术人员进行评估

公共参数
请求参数
名称 类型 是否必须 示例值 描述
markIdStringY1655387905424客户侧批次号
响应参数
名称 类型 示例值 描述
batchInvoiceStateString1批次订单是否已全部开票 0未全部开票 1全部开票
invoiceListString
invoiceStateString32.已开票未寄出 3.已开票已寄出
invoiceidString123发票号码
invoiceCodeString123发票代码
invoiceDateString2018-12-18发票日期
invoiceNakedAmountString38.000000不含税金额
invoiceAmountString138.000000价税合计
invoiceTypeString1发票类型 1.增票 2.普票(平推普票)3.电子发票
invoiceSignString1发票标识 -1-红票 1-蓝票
taxPayerNoString1212312312312312312纳税人识别号
invoiceUrlStringhttps://einvoicelink.51fapiao.cn/FPF/actions/ce3e90b1c4e192ca电子发票Url (红票退货后会冲红)
wonDigitalTicketStringY是否数电发票 Y/N-是/否
xmlUrlStringxml数电发票xml链接
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <queryGetinvoiceinfobymarkid>
      <markId>1655387905424</markId>
    </queryGetinvoiceinfobymarkid>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryGetinvoiceinfobymarkid": {
        "markId": "1655387905424"
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_body>
    <queryGetinvoiceinfobymarkid>
      <invoiceList>
        <wonDigitalTicket>Y</wonDigitalTicket>
        <invoiceSign>1</invoiceSign>
        <invoiceUrl>https://einvoicelink.51fapiao.cn/FPF/actions/ce3e90b1c4e192ca</invoiceUrl>
        <taxPayerNo>1212312312312312312</taxPayerNo>
        <invoiceState>3</invoiceState>
        <invoiceType>1</invoiceType>
        <invoiceAmount>138.000000</invoiceAmount>
        <invoiceid>123</invoiceid>
        <invoiceDate>2018-12-18</invoiceDate>
        <invoiceCode>123</invoiceCode>
        <invoiceNakedAmount>38.000000</invoiceNakedAmount>
        <xmlUrl>xml</xmlUrl>
      </invoiceList>
      <batchInvoiceState>1</batchInvoiceState>
    </queryGetinvoiceinfobymarkid>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "queryGetinvoiceinfobymarkid": {
        "invoiceList": [
          {
            "wonDigitalTicket": "Y",
            "invoiceSign": "1",
            "invoiceUrl": "https://einvoicelink.51fapiao.cn/FPF/actions/ce3e90b1c4e192ca",
            "taxPayerNo": "1212312312312312312",
            "invoiceState": "3",
            "invoiceType": "1",
            "invoiceAmount": "138.000000",
            "invoiceid": "123",
            "invoiceDate": "2018-12-18",
            "invoiceCode": "123",
            "invoiceNakedAmount": "38.000000",
            "xmlUrl": "xml"
          }
        ],
        "batchInvoiceState": "1"
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.govbus.querygetinvoiceinfobymarkid.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.govbus.querygetinvoiceinfobymarkid.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.govbus.getinvoiceinfobymarkid.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.govbus.getinvoiceinfobymarkid.invalid-biz:100 输入报文格式错误 检查输入报文
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.gcapi 服务不可用 请联系苏宁技术人员
biz.govbus.getinvoiceinfobymarkid.invalid-biz:101 入参校验失败 检查输入参数
biz.govbus.getinvoiceinfobymarkid.invalid-biz:102 会员编号错误 检查账号
biz.govbus.getinvoiceinfobymarkid.invalid-biz:103 订单信息不存在 请检查输入参数
biz.govbus.getinvoiceinfobymarkid.invalid-biz:104 查询的发票信息不存在 请检查输入参数
biz.govbus.getinvoiceinfobymarkid.invalid-biz:105 markId不存在 请检查输入参数
公共异常码
API工具
FAQ