5.1.03回调接口-按单回调（单据对应的所有发票开票完毕后一起回调（包含开票成功和开票失败），不支持合并又拆分的场景）

POST/：忽略该接口前缀，此为对接发票云方提供的回调地址（对接方必须按照成功响应示例报文返回 json ）

一个开票申请单如果拆分开具了N张发票，在发票开具完毕后，只全部回调一次，开票成功失败的都会返回
（业务编号 businessSystemCode 以 3std1 开头，就会开启这种方式的回调）

请求参数

interfaceCode

string

必需

业务编码，开票回调是INVOICE.OPEN，作废回调是INVOICE.CANCEL，红冲回调是INVOICE.RED

returnCode

string

必需

0成功，9999失败，按单回调无法根据此状态码判断，会存在部分开具成功，部分失败的情况，根据是否存在发票代码号码判断

returnMsg

string

必需

开票失败原因，成功返回success

data

array [object {51}]

必需

需要把data里面的base64字符串解密

abolishReason

string

作废原因

必需

batch

string

批次号

必需

billNo

string

单据编号

必需

buyerAddressAndTel

string

必需

购买方地址和电话，GBK编码100字节，开专票时若未传入则用名称匹配系统维护的地址电话【长度：100】

buyerBankAndAccount

string

必需

购买方银行和账号，GBK编码100字节，开专票时若未传入则用名称匹配系统维护的银行和账号【长度：100】

buyerName

string

购买方名称

必需

buyerProperty

number

必需

购买方性质，0-企业，1-个人

buyerRecipientMail

string

电子发票收票邮箱

必需

buyerRecipientPhone

string

电子发票收票手机号

必需

buyerTaxpayerId

string

购买方税号

必需

canceler

string

作废人

必需

deduction

number

必需

差额征税差额【长度：(14,2)】

deviceNo

string

设备编号

必需

drawer

string

必需

开票人【长度：10】

payee

string

必需

收款人【长度：10】

reviewer

string

必需

复核人【长度：10】

includeTaxAmount

number

价税合计

必需

totalAmount

number

合计金额

必需

totalTaxAmount

number

合计税额

必需

includeTaxFlag

number

必需

含税标识，0-不含税，1-含税【长度：1】

inventoryMark

string

必需

清单标志，0-非清单发票，1-清单发票【长度：1】

invoiceCode

string

发票代码

必需

invoiceNum

string

发票号码

必需

invoiceStatus

string

必需

发票状态 0-正常 2-待开 3-红冲 6-作废

invoiceDate

string

开票日期

必需

invoiceDetail

array [object {18}]

发票明细

可选

invoiceFileUrl

string

必需

板式文件下载地址，航信百旺税盘开普通电票为PDF文件，开电子专票为ofd文件，ukey开电票都是ofd文件，数电票为ofd文件

invoiceImageUrl

string

必需

PDF转图片预览地址

invoicePdfFileUrl

string

必需

数电票pdf地址，星瀚版本5.0.022支持

invoiceXmlFileUrl

string

必需

数电票xml地址，星瀚版本5.0.022支持

invoiceProperty

number

必需

开票类型，0蓝票，1红票【长度：1】

invoiceType

enum<string>

必需

发票种类， 028-增值税电子专用发票， 004-增值税纸质专用发票， 026-增值税电子普通发票， 007-增值税纸质普通发票【长度：4】

枚举值:

02802600400702508xdp10xdp

orderNo

string

发票流水号

必需

originalInvoiceCode

string

可选

原蓝票发票代码，开红票必传【长度：12】

originalInvoiceNumber

string

可选

原蓝票发票号码，开红票必传【长度：8】

originalInvoiceStatus

string

可选

原蓝票状态，红冲、回调时存在，红冲回调为3、作废回调为6

originalIssueTime

string

可选

原蓝票开票时间，红冲、回调时存在，格式为"yyyyMMdd"

printFlag

string

必需

纸票打印标识，0-未打印 1-已打印

redInfoBillNo

string

必需

红字信息表编号，专用发票红冲必传【长度：16】

remark

string

必需

备注，GBK编码230字节【长度：230】

sellerAddressAndTel

string

销方地址和电话

必需

sellerBankAndAccount

string

销方银行和账号

必需

sellerName

string

销方名称

必需

sellerTaxpayerId

string

销方税号

必需

serialNo

string

必需

序列号【拆分合并后重新生成的编号】

systemSource

string

系统来源

必需

taxedType

number

必需

征税方式，0-普通 2-差额

terminalNo

string

终端号码

必需

checkCode

string

校验码

必需

skm

string

密码区

必需

issueErrorMessage

string

开票失败原因

必需

bizControl

object

必需

issueBizType

string

企业业务管控编码

必需

bizType

string

业务类型编码

必需

monthSurplusLimit

number

月剩余额度

必需

daySurplusLimit

number

每日剩余额

必需

isWarning

boolean

必需

是否已超过月预警阈值

{
  "interfaceCode": "string",
  "returnCode": "string",
  "returnMsg": "string",
  "data": [
    {
      "abolishReason": "string",
      "batch": "string",
      "billNo": "string",
      "buyerAddressAndTel": "string",
      "buyerBankAndAccount": "string",
      "buyerName": "string",
      "buyerProperty": 0,
      "buyerRecipientMail": "string",
      "buyerRecipientPhone": "string",
      "buyerTaxpayerId": "string",
      "canceler": "string",
      "deduction": 0,
      "deviceNo": "string",
      "drawer": "string",
      "payee": "string",
      "reviewer": "string",
      "includeTaxAmount": 0,
      "totalAmount": 0,
      "totalTaxAmount": 0,
      "includeTaxFlag": 0,
      "inventoryMark": "string",
      "invoiceCode": "string",
      "invoiceNum": "string",
      "invoiceStatus": "string",
      "invoiceDate": "string",
      "invoiceDetail": [
        {
          "amount": 0,
          "billSourceId": "string",
          "goodsName": "string",
          "includeTaxAmount": 0,
          "includeTaxPrice": "string",
          "lineProperty": 0,
          "price": "string",
          "privilegeContent": "string",
          "privilegeFlag": 0,
          "quantity": "string",
          "revenueCode": "string",
          "revenueName": "string",
          "seq": 0,
          "specification": "string",
          "taxAmount": 0,
          "taxRate": "string",
          "units": "string",
          "zeroTaxRateFlag": "string"
        }
      ],
      "invoiceFileUrl": "string",
      "invoiceImageUrl": "string",
      "invoicePdfFileUrl": "string",
      "invoiceXmlFileUrl": "string",
      "invoiceProperty": 0,
      "invoiceType": "028",
      "orderNo": "string",
      "originalInvoiceCode": "string",
      "originalInvoiceNumber": "string",
      "originalInvoiceStatus": "string",
      "originalIssueTime": "string",
      "printFlag": "string",
      "redInfoBillNo": "string",
      "remark": "string",
      "sellerAddressAndTel": "string",
      "sellerBankAndAccount": "string",
      "sellerName": "string",
      "sellerTaxpayerId": "string",
      "serialNo": "string",
      "systemSource": "string",
      "taxedType": 0,
      "terminalNo": "string",
      "checkCode": "string",
      "skm": "string",
      "issueErrorMessage": "string"
    }
  ],
  "bizControl": {
    "issueBizType": "string",
    "bizType": "string",
    "monthSurplusLimit": 0,
    "daySurplusLimit": 0,
    "isWarning": true
  }
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

message

string

必需

errorCode

string

必需

success

boolean

成功响应

必需

未设置

最后修改时间： 10 个月前