5.1.03回调接口-按单回调（单据对应的所有发票开票完毕后一起回调（包含开票成功和开票失败），不支持合并又拆分的场景）
快速开始环境
https://cosmic-sandbox.piaozone.com/jdpjykjyxgs
快速开始环境
https://cosmic-sandbox.piaozone.com/jdpjykjyxgs
POST
/：忽略该接口前缀，此为对接发票云方提供的回调地址（对接方必须按照成功响应示例报文返回 json ）
（业务编码 businessSystemCode 以 3std1 开头，就会开启这种方式的回调）
请求参数
Header 参数
access_token
string
可选
默认值:
{{access_token}}
Body 参数application/json
interfaceCode
string
业务编码
returnCode
string
返回编码
returnMsg
string
返回信息
data
array [object {51}]
按单回调请求参数
batch
string
批次号
<= 50 字符
billNo
string
单据编号
<= 50 字符
invoiceProperty
number
开票类型
invoiceType
enum<string>
发票种类
枚举值:
02802600400702508xdp10xdp
buyerProperty
number
购买方性质
buyerName
string
购买方名称
<= 50 字符
buyerTaxpayerId
string
购买方税号
<= 20 字符
buyerAddressAndTel
string
购买方地址和电话
buyerBankAndAccount
string
购买方银行和账号
buyerRecipientMail
string
购买方邮箱
<= 300 字符
buyerRecipientPhone
string
购买方手机号
<= 80 字符
deduction
number
差额征税差额
includeTaxFlag
number
含税标识
totalTaxAmount
number
合计税额
totalAmount
number
合计金额
includeTaxAmount
number
价税合计
taxedType
number
征税方式
sellerName
string
销方名称
<= 100 字符
sellerTaxpayerId
string
销方税号
<= 20 字符
sellerAddressAndTel
string
销方地址和电话
<= 100 字符
sellerBankAndAccount
string
销方银行和账号
<= 100 字符
inventoryMark
string
清单标志
drawer
string
开票人
reviewer
string
复核人
payee
string
收款人
canceler
string
作废人
<= 10 字符
abolishReason
string
作废原因
<= 50 字符
deviceNo
string
设备编号
<= 50 字符
remark
string
备注
invoiceStatus
string
发票状态
invoiceCode
string
发票代码
<= 15 字符
invoiceNum
string
发票号码
<= 50 字符
invoiceDate
string
开票日期
invoiceDetail
array [object {18}]
发票明细
invoiceFileUrl
string
版式文件下载地址
<= 200 字符
invoiceImageUrl
string
PDF转图片预览地址
<= 200 字符
invoicePdfFileUrl
string
数电票PDF地址
<= 200 字符
invoiceXmlFileUrl
string
数电票XML地址
<= 200 字符
orderNo
string
发票流水号
<= 50 字符
issueErrorMessage
string
开票失败原因
<= 50 字符
originalInvoiceCode
string
原蓝票发票代码
originalInvoiceNumber
string
原 蓝票发票号码
originalInvoiceStatus
string
原蓝票状态
originalIssueTime
string
原蓝票开票时间
printFlag
string
纸票打印标识
redInfoBillNo
string
红字信息表编号
serialNo
string
序列号
<= 50 字符
systemSource
string
系统来源
<= 50 字符
terminalNo
string
终端号码
<= 50 字符
checkCode
string
校验码
<= 50 字符
skm
string
密码区
<= 500 字符
bizControl
object
必需
issueBizType
string
企业业务管控编码
bizType
string
业务类型编码
monthSurplusLimit
number
月剩余额度
daySurplusLimit
number
每日剩余额
isWarning
boolean
是否已超过月预警阈值
示例
{
"interfaceCode": "string",
"returnCode": "string",
"returnMsg": "string",
"data": [
{
"batch": "string",
"billNo": "string",
"invoiceProperty": 0,
"invoiceType": "028",
"buyerProperty": 0,
"buyerName": "string",
"buyerTaxpayerId": "string",
"buyerAddressAndTel": "string",
"buyerBankAndAccount": "string",
"buyerRecipientMail": "string",
"buyerRecipientPhone": "string",
"deduction": 0,
"includeTaxFlag": 0,
"totalTaxAmount": 0,
"totalAmount": 0,
"includeTaxAmount": 0,
"taxedType": 0,
"sellerName": "string",
"sellerTaxpayerId": "string",
"sellerAddressAndTel": "string",
"sellerBankAndAccount": "string",
"inventoryMark": "string",
"drawer": "string",
"reviewer": "string",
"payee": "string",
"canceler": "string",
"abolishReason": "string",
"deviceNo": "string",
"remark": "string",
"invoiceStatus": "string",
"invoiceCode": "string",
"invoiceNum": "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",
"orderNo": "string",
"issueErrorMessage": "string",
"originalInvoiceCode": "string",
"originalInvoiceNumber": "string",
"originalInvoiceStatus": "string",
"originalIssueTime": "string",
"printFlag": "string",
"redInfoBillNo": "string",
"serialNo": "string",
"systemSource": "string",
"terminalNo": "string",
"checkCode": "string",
"skm": "string"
}
],
"bizControl": {
"issueBizType": "string",
"bizType": "string",
"monthSurplusLimit": 0,
"daySurplusLimit": 0,
"isWarning": true
}
}示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://cosmic-sandbox.piaozone.com/jdpjykjyxgs/：忽略该接口前缀，此为对接发票云方提供的回调地址（对接方必须按照成功响应示例报文返回 json ）' \
--header 'access_token: {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"interfaceCode": "string",
"returnCode": "string",
"returnMsg": "string",
"data": [
{
"batch": "string",
"billNo": "string",
"invoiceProperty": 0,
"invoiceType": "028",
"buyerProperty": 0,
"buyerName": "string",
"buyerTaxpayerId": "string",
"buyerAddressAndTel": "string",
"buyerBankAndAccount": "string",
"buyerRecipientMail": "string",
"buyerRecipientPhone": "string",
"deduction": 0,
"includeTaxFlag": 0,
"totalTaxAmount": 0,
"totalAmount": 0,
"includeTaxAmount": 0,
"taxedType": 0,
"sellerName": "string",
"sellerTaxpayerId": "string",
"sellerAddressAndTel": "string",
"sellerBankAndAccount": "string",
"inventoryMark": "string",
"drawer": "string",
"reviewer": "string",
"payee": "string",
"canceler": "string",
"abolishReason": "string",
"deviceNo": "string",
"remark": "string",
"invoiceStatus": "string",
"invoiceCode": "string",
"invoiceNum": "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",
"orderNo": "string",
"issueErrorMessage": "string",
"originalInvoiceCode": "string",
"originalInvoiceNumber": "string",
"originalInvoiceStatus": "string",
"originalIssueTime": "string",
"printFlag": "string",
"redInfoBillNo": "string",
"serialNo": "string",
"systemSource": "string",
"terminalNo": "string",
"checkCode": "string",
"skm": "string"
}
],
"bizControl": {
"issueBizType": "string",
"bizType": "string",
"monthSurplusLimit": 0,
"daySurplusLimit": 0,
"isWarning": true
}
}'返回响应
🟢200成功
application/json
Body
message
string
描述信息
errorCode
string
错误代码
success
boolean
成功响应
示例
{
"message": "string",
"errorCode": "string",
"success": true
}修改于 2025-06-30 06:51:15