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

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

请求参数

Body 参数application/json

interfaceCode

string

必需

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

returnCode

string

必需

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

returnMsg

string

必需

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

data

array [object {51}]

必需

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

abolishReason

string

作废原因

必需

<= 50 字符

batch

string

批次号

必需

<= 50 字符

billNo

string

单据编号

必需

<= 50 字符

buyerAddressAndTel

string

必需

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

buyerBankAndAccount

string

必需

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

buyerName

string

购买方名称

必需

<= 50 字符

buyerProperty

number

必需

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

buyerRecipientMail

string

电子发票收票邮箱

必需

<= 300 字符

buyerRecipientPhone

string

电子发票收票手机号

必需

<= 80 字符

buyerTaxpayerId

string

购买方税号

必需

<= 20 字符

canceler

string

作废人

必需

<= 10 字符

deduction

number

必需

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

deviceNo

string

设备编号

必需

<= 50 字符

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

发票代码

必需

<= 15 字符

invoiceNum

string

发票号码

必需

<= 50 字符

invoiceStatus

string

必需

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

invoiceDate

string

开票日期

必需

invoiceDetail

array [object {18}]

发票明细

可选

invoiceFileUrl

string

必需

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

<= 200 字符

invoiceImageUrl

string

必需

PDF转图片预览地址

<= 200 字符

invoicePdfFileUrl

string

必需

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

<= 200 字符

invoiceXmlFileUrl

string

必需

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

<= 200 字符

invoiceProperty

number

必需

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

invoiceType

enum<string>

必需

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

枚举值:

02802600400702508xdp10xdp

orderNo

string

发票流水号

必需

<= 50 字符

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

销方地址和电话

必需

<= 100 字符

sellerBankAndAccount

string

销方银行和账号

必需

<= 100 字符

sellerName

string

销方名称

必需

<= 100 字符

sellerTaxpayerId

string

销方税号

必需

<= 20 字符

serialNo

string

必需

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

<= 50 字符

systemSource

string

系统来源

必需

<= 50 字符

taxedType

number

必需

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

terminalNo

string

终端号码

必需

<= 50 字符

checkCode

string

校验码

必需

<= 50 字符

skm

string

密码区

必需

<= 500 字符

issueErrorMessage

string

开票失败原因

必需

<= 50 字符

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
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://cosmic-sandbox.piaozone.com/jdpjykjyxgs/：忽略该接口前缀，此为对接发票云方提供的回调地址（对接方必须按照成功响应示例报文返回 json ）' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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
    }
}'

application/json

Body

message

string

必需

errorCode

string

必需

success

boolean

成功响应

必需

示例

{
  "message": "string",
  "errorCode": "string",
  "success": true
}

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

请求参数

示例代码

返回响应