2.1.02 数电票回调

快速开始环境

https://cosmic-sandbox.piaozone.com/jdpjykjyxgs

POST

/此为对接发票云方提供的回调地址（对接方必须按照成功响应示例报文返回 json ）

返回编码统一参考：《返回编码说明》
通过2.1.01数电蓝字发票开具、2.1.04数电票红冲接口开具数电发票后，通过本接口回调

请求参数

Header 参数

access_token

string

可选

默认值:

Body 参数application/json

returnMsg

string

回调信息

必需

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

returnCode

string

回调代码

必需

0-成功 9999-失败

interfaceCode

string

接口业务编码

必需

固定值，回调蓝票时：INVOICE.OPEN，回调红票时：INVOICE.RED

data

object

必需

需要把data的值进行解密

serialNo

string

外部流水号

必需

返回调用时传入的流水号

<= 50 字符

invoiceNum

string

发票号码

必需

<= 100 字符

invoiceProperty

enum<string>

开票类型

必需

<= 1 字符

枚举值:

invoiceDate

string

开票日期

必需

invoiceType

enum<string>

发票种类

必需

枚举值:

0102

includeTaxAmount

number

含税金额

必需

sellerName

string

销方名称

必需

【长度：不超过100】

<= 100 字符

sellerTaxpayerId

string

销方税号

必需

<= 20 字符

sellerBank

string

销方银行

可选

【销方银行+销方银行账号 GBK编码150字节】

<= 150 字符

sellerBankAccount

string

销方银账号

可选

【销方银行+销方银行账号 GBK编码150字节】

<= 150 字符

sellerAddress

string

销方地址

可选

【销方地址+销方电话 GBK编码120字节】

<= 120 字符

sellerTel

string

销方电话

可选

【销方地址+销方电话 GBK编码120字节】

<= 120 字符

naturalPersonFlag

string

自然人标识

可选

Y-是，N-否；默认根据购方纳税人识别号取反，有值时为N，无值时为Y

buyerName

string

购买方名称

必需

【长度：不超过100】

<= 100 字符

buyerTaxpayerId

string

购买方税号

可选

专票必填

<= 20 字符

buyerBank

string

购买方银行

可选

【购买方银行+购买方银行账号 150字节】

<= 150 字符

buyerBankAccount

string

购买方银行账号

可选

【购买方银行+购买方银行账号 150字节】

<= 150 字符

buyerAddress

string

购买方地址

可选

【购买方地址+购买方电话 120字节】

<= 120 字符

buyerTel

string

购买方电话

可选

【购买方地址+购买方电话 120字节】

<= 120 字符

specialType

enum<string>

特定要素类型代码

可选

空：非特定要素；01：成品油发票；02：稀土发票；03：建筑服务发票；04：货物运输服务发票；05：不动产销售服务发票；06：不动产租赁服务发票；07：代收车船税；08：通行费；09：旅客运输服务发票(待开发)；10：医疗服务（住院）发票；11：医疗服务（门诊）发票；12：自产农产品销售发票；13：拖拉机和联合收割机发票；14：机动车；15：二手车；16：农产品收购发票；17：光伏收购发票；18：卷烟发票

枚举值:

null01E0203040506070809101112131415021718

默认值:

null

buyerRecipientPhone

string

电子发票收票手机号

可选

<= 80 字符

buyerRecipientMail

string

电子发票收票邮箱

可选

<= 300 字符

remark

string

备注

可选

<= 450 字符

drawer

string

开票人

必需

<= 10 字符

deduction

number

差额征税差额

可选

【长度：(14,2)】,征税方式为【差额征税】时必填

deductionType

enum<string>

差额征税类型代码

可选

默认为空

枚举值:

空0102

purchaseType

enum<string>

收购发票类型代码

可选

枚举值:

空01

exportationType

enum<string>

出口业务适用政策代码

可选

枚举值:

空010203

vatTaxRefundType

enum<string>

增值税即征即退类型

可选

空：非增值税即征即退

枚举值:

010203040506070809101112

originalInvoiceNumber

string

原蓝票发票号码

可选

开红票必传【长度：20】

<= 20 字符

originalIssueTime

string

原蓝票开票日期

可选

开红字普票时，且发票云不存在该蓝票时必填

redInfoBillNo

string

红字确认单编号

可选

数电票红票、红冲必传【长度：16】

<= 16 字符

govRedConfirmBillUuid

string

红字确认单税局uuid

可选

（数电票红票必填）

redConfirmBillStatus

enum<string>

红字确认单状态

可选

发票云版本5.0.024支持

枚举值:

01020304050607080910

agentUser

string

经办人名称

可选

agentCardType

string

经办人证件类型

可选

agentCardNo

string

经办人证件号码

可选

agentCountry

string

经办人国籍(地区)

可选

agentTaxNo

string

经办人自然人纳税人识别号

可选

invoiceFileUrl

string

PDF文件URL

可选

xmlFileUrl

string

XML文件URL

可选

ofdFileUrl

string

OFD文件URL

可选

invoiceDetail

array [object {17}]

发票明细

必需

estateSaleInfo

object (不动产租赁)

不动产销售服务信息

可选

特定业务类型为05时必填

estateLeaseInfo

object (不动产租赁)

不动产经营租赁服务信息

可选

特定业务类型为06时必填

buildInfo

object (建筑服务)

建筑服务信息

可选

特定业务类型为03时必填

travelerList

array[array (旅客运输) {1}]

旅客运输信息

可选

特定业务为09时必填

示例

{
    "returnMsg": "string",
    "returnCode": "string",
    "interfaceCode": "string",
    "data": {
        "serialNo": "string",
        "invoiceNum": "string",
        "invoiceProperty": "0",
        "invoiceDate": "string",
        "invoiceType": "01",
        "includeTaxAmount": 0,
        "sellerName": "string",
        "sellerTaxpayerId": "string",
        "sellerBank": "string",
        "sellerBankAccount": "string",
        "sellerAddress": "string",
        "sellerTel": "string",
        "naturalPersonFlag": "string",
        "buyerName": "string",
        "buyerTaxpayerId": "string",
        "buyerBank": "string",
        "buyerBankAccount": "string",
        "buyerAddress": "string",
        "buyerTel": "string",
        "specialType": "null",
        "buyerRecipientPhone": "string",
        "buyerRecipientMail": "string",
        "remark": "string",
        "drawer": "string",
        "deduction": 0,
        "deductionType": "空",
        "purchaseType": "空",
        "exportationType": "空",
        "vatTaxRefundType": "01",
        "originalInvoiceNumber": "string",
        "originalIssueTime": "string",
        "redInfoBillNo": "string",
        "govRedConfirmBillUuid": "string",
        "redConfirmBillStatus": "01",
        "agentUser": "string",
        "agentCardType": "string",
        "agentCardNo": "string",
        "agentCountry": "string",
        "agentTaxNo": "string",
        "invoiceFileUrl": "string",
        "xmlFileUrl": "string",
        "ofdFileUrl": "string",
        "invoiceDetail": [
            {
                "seq": 0,
                "detailRowNo": 0,
                "lineProperty": "string",
                "billSourceId": "string",
                "goodsCode": "string",
                "goodsName": "string",
                "revenueCode": "string",
                "specification": "string",
                "units": "string",
                "quantity": 0,
                "price": 0,
                "amount": 0,
                "taxRate": "string",
                "taxAmount": 0,
                "discountAmount": 0,
                "discountRate": "string",
                "privilegeType": "01"
            }
        ],
        "estateSaleInfo": {
            "provinceAdress": "string",
            "cityAdreess": "string",
            "simpleAddress": "string",
            "detailAddress": "string",
            "crossCitySign": "0",
            "areaunit": "平方千米",
            "startLeaseDate": "2019-08-24",
            "endLeaseDate": "2019-08-24",
            "estateId": "string",
            "specialIndustryNumber": "string",
            "carBrandNo": "string"
        },
        "estateLeaseInfo": {
            "provinceAdress": "string",
            "cityAdreess": "string",
            "simpleAddress": "string",
            "detailAddress": "string",
            "crossCitySign": "0",
            "areaunit": "平方千米",
            "startLeaseDate": "2019-08-24",
            "endLeaseDate": "2019-08-24",
            "estateId": "string",
            "specialIndustryNumber": "string",
            "carBrandNo": "string"
        },
        "buildInfo": {
            "simpleAddress": "string",
            "detailAddress": "string",
            "crossCitySign": "0",
            "buildingName": "string",
            "landTaxNo": "string",
            "specialIndustryNumber": "string",
            "crossCityTaxVerifyNo": "string"
        },
        "travelerList": [
            [
                {
                    "traveler": "string",
                    "cardType": "100",
                    "cardNo": "string",
                    "travelDate": "2024-04-02",
                    "startPlace": "广东省深圳市宝安区",
                    "endPlace": "广东省东莞市南城区",
                    "transportType": "1",
                    "seatClass": "一等座"
                }
            ]
        ]
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://cosmic-sandbox.piaozone.com/jdpjykjyxgs/此为对接发票云方提供的回调地址（对接方必须按照成功响应示例报文返回 json ）' \
--header 'access_token: {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "returnMsg": "string",
    "returnCode": "string",
    "interfaceCode": "string",
    "data": {
        "serialNo": "string",
        "invoiceNum": "string",
        "invoiceProperty": "0",
        "invoiceDate": "string",
        "invoiceType": "01",
        "includeTaxAmount": 0,
        "sellerName": "string",
        "sellerTaxpayerId": "string",
        "sellerBank": "string",
        "sellerBankAccount": "string",
        "sellerAddress": "string",
        "sellerTel": "string",
        "naturalPersonFlag": "string",
        "buyerName": "string",
        "buyerTaxpayerId": "string",
        "buyerBank": "string",
        "buyerBankAccount": "string",
        "buyerAddress": "string",
        "buyerTel": "string",
        "specialType": "null",
        "buyerRecipientPhone": "string",
        "buyerRecipientMail": "string",
        "remark": "string",
        "drawer": "string",
        "deduction": 0,
        "deductionType": "空",
        "purchaseType": "空",
        "exportationType": "空",
        "vatTaxRefundType": "01",
        "originalInvoiceNumber": "string",
        "originalIssueTime": "string",
        "redInfoBillNo": "string",
        "govRedConfirmBillUuid": "string",
        "redConfirmBillStatus": "01",
        "agentUser": "string",
        "agentCardType": "string",
        "agentCardNo": "string",
        "agentCountry": "string",
        "agentTaxNo": "string",
        "invoiceFileUrl": "string",
        "xmlFileUrl": "string",
        "ofdFileUrl": "string",
        "invoiceDetail": [
            {
                "seq": 0,
                "detailRowNo": 0,
                "lineProperty": "string",
                "billSourceId": "string",
                "goodsCode": "string",
                "goodsName": "string",
                "revenueCode": "string",
                "specification": "string",
                "units": "string",
                "quantity": 0,
                "price": 0,
                "amount": 0,
                "taxRate": "string",
                "taxAmount": 0,
                "discountAmount": 0,
                "discountRate": "string",
                "privilegeType": "01"
            }
        ],
        "estateSaleInfo": {
            "provinceAdress": "string",
            "cityAdreess": "string",
            "simpleAddress": "string",
            "detailAddress": "string",
            "crossCitySign": "0",
            "areaunit": "平方千米",
            "startLeaseDate": "2019-08-24",
            "endLeaseDate": "2019-08-24",
            "estateId": "string",
            "specialIndustryNumber": "string",
            "carBrandNo": "string"
        },
        "estateLeaseInfo": {
            "provinceAdress": "string",
            "cityAdreess": "string",
            "simpleAddress": "string",
            "detailAddress": "string",
            "crossCitySign": "0",
            "areaunit": "平方千米",
            "startLeaseDate": "2019-08-24",
            "endLeaseDate": "2019-08-24",
            "estateId": "string",
            "specialIndustryNumber": "string",
            "carBrandNo": "string"
        },
        "buildInfo": {
            "simpleAddress": "string",
            "detailAddress": "string",
            "crossCitySign": "0",
            "buildingName": "string",
            "landTaxNo": "string",
            "specialIndustryNumber": "string",
            "crossCityTaxVerifyNo": "string"
        },
        "travelerList": [
            [
                {
                    "traveler": "string",
                    "cardType": "100",
                    "cardNo": "string",
                    "travelDate": "2024-04-02",
                    "startPlace": "广东省深圳市宝安区",
                    "endPlace": "广东省东莞市南城区",
                    "transportType": "1",
                    "seatClass": "一等座"
                }
            ]
        ]
    }
}'

返回响应

🟢200成功

application/json

Body

message

string

必需

errorCode

string

响应码，成功-0

必需

success

boolean

成功传true

必需

示例

{
	"message": "回调成功",
	"errorCode": "0",
	"success": true
}

🟢200失败

修改于 2025-07-08 06:48:51

2.1.01 数电票蓝字发票开具

2.1.03 红字确认单生成