2.1.02 数电票回调

返回编码统一参考：《返回编码说明》

请求参数

Body 参数application/json

returnMsg

string

必需

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

returnCode

string

必需

0-成功 9999-失败

interfaceCode

string

接口编码

必需

data

object

必需

需要把data的值进行解密

serialNo

string

必需

外部流水号，返回调用时传入的流水号【长度：50】

<= 50 字符

invoiceNum

string

发票号码

必需

<= 100 字符

invoiceProperty

string

必需

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

invoiceDate

string

开票日期

必需

invoiceType

string

必需

发票种类， 01-数字化电子专票，02-数字化电子普票

includeTaxAmount

number

含税金额

必需

sellerName

string

必需

销方名称【长度：不超过100】，如果在星瀚有配置企业信息可不填，

<= 100 字符

sellerTaxpayerId

string

销方税号

必需

<= 20 字符

sellerBank

string

必需

销方银行【长度：不超过100】

<= 100 字符

sellerBankAccount

string

必需

销方银账号【长度：不超过100】

<= 100 字符

sellerAddress

string

必需

销方地址【长度：不超过100】

<= 100 字符

sellerTel

string

必需

销方电话【长度：不超过100】

<= 100 字符

buyerName

string

必需

购买方名称【长度：不超过100】

<= 100 字符

buyerTaxpayerId

string

可选

购买方税号（专票必填）

<= 20 字符

buyerBank

string

购买方银行

可选

<= 100 字符

buyerBankAccount

string

购买方银行账号

可选

<= 100 字符

buyerAddress

string

购买方地址

可选

<= 100 字符

buyerTel

string

购买方电话

可选

<= 100 字符

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

可选

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

<= 230 字符

drawer

string

必需

开票人【长度：10】

<= 10 字符

deduction

number

可选

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

deductionType

string

可选

差额征税类型代码，空：非差额发票01：全额开票 02：差额开票

purchaseType

string

可选

收购发票类型代码，空：非收购发票01：农产品收购发票02：光伏收购发票 03：二手车收购发票

exportationType

string

可选

出口业务适用政策代码，空：非出口业务01：退税政策02：免税政策03：征税政策

vatTaxRefundType

enum<string>

可选

增值税即征即退类型，空：非增值税即征即退

枚举值:

010203040506070809101112

originalInvoiceNumber

string

可选

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

<= 20 字符

redInfoBillNo

string

可选

红字确认单编号，数电票红票、红冲必传【长度：16】

<= 16 字符

govRedConfirmBillUuid

string

可选

数电票红字确认单税局uuid（数电票红票必填）

originalIssueTime

string

可选

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

agentUser

string

可选

（数电票）经办人名称

agentCardType

string

可选

（数电票）经办人证件类型

agentCardNo

string

可选

（数电票）经办人证件号码

agentCountry

string

可选

（数电票）经办人国籍(地区)

agentTaxNo

string

可选

（数电票）经办人自然人纳税人识别号

naturalPersonFlag

string

可选

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

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时必填

redConfirmBillStatus

enum<string>

可选

红字确认单状态。发票云版本5.0.024支持

枚举值:

01020304050607080910

travelerList

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

可选

示例

{
  "returnMsg": "string",
  "returnCode": "string",
  "interfaceCode": "string",
  "data": {
    "serialNo": "string",
    "invoiceNum": "string",
    "invoiceProperty": "string",
    "invoiceDate": "string",
    "invoiceType": "string",
    "includeTaxAmount": 0,
    "sellerName": "string",
    "sellerTaxpayerId": "string",
    "sellerBank": "string",
    "sellerBankAccount": "string",
    "sellerAddress": "string",
    "sellerTel": "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": "string",
    "purchaseType": "string",
    "exportationType": "string",
    "vatTaxRefundType": "01",
    "originalInvoiceNumber": "string",
    "redInfoBillNo": "string",
    "govRedConfirmBillUuid": "string",
    "originalIssueTime": "string",
    "agentUser": "string",
    "agentCardType": "string",
    "agentCardNo": "string",
    "agentCountry": "string",
    "agentTaxNo": "string",
    "naturalPersonFlag": "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"
    },
    "redConfirmBillStatus": "01",
    "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 'Content-Type: application/json' \
--data-raw '{
    "returnMsg": "string",
    "returnCode": "string",
    "interfaceCode": "string",
    "data": {
        "serialNo": "string",
        "invoiceNum": "string",
        "invoiceProperty": "string",
        "invoiceDate": "string",
        "invoiceType": "string",
        "includeTaxAmount": 0,
        "sellerName": "string",
        "sellerTaxpayerId": "string",
        "sellerBank": "string",
        "sellerBankAccount": "string",
        "sellerAddress": "string",
        "sellerTel": "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": "string",
        "purchaseType": "string",
        "exportationType": "string",
        "vatTaxRefundType": "01",
        "originalInvoiceNumber": "string",
        "redInfoBillNo": "string",
        "govRedConfirmBillUuid": "string",
        "originalIssueTime": "string",
        "agentUser": "string",
        "agentCardType": "string",
        "agentCardNo": "string",
        "agentCountry": "string",
        "agentTaxNo": "string",
        "naturalPersonFlag": "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"
        },
        "redConfirmBillStatus": "01",
        "travelerList": [
            [
                {
                    "traveler": "string",
                    "cardType": "100",
                    "cardNo": "string",
                    "travelDate": "2024-04-02",
                    "startPlace": "广东省深圳市宝安区",
                    "endPlace": "广东省东莞市南城区",
                    "transportType": "1",
                    "seatClass": "一等座"
                }
            ]
        ]
    }
}'

application/json

Body

message

string

必需

errorCode

string

响应码，成功-0

必需

success

boolean

成功传true

必需

示例

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

请求参数

示例代码

返回响应