2.1.01 数电票蓝字发票开具 - 发票云(旗舰版)API文档

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

请求参数

Query 参数

access_token

string

必需

Header 参数

access_token

string

可选

默认值:

Body 参数application/json

requestId

string

必需

当前13位毫秒级时间戳加3位随机数字(总共16位)

businessSystemCode

string

必需

对接业务系统来源编码，用于区分不同业务系统的回调接口

interfaceCode

enum<string>

必需

接口编码，固定值：ALLE.INVOICE.OPEN

枚举值:

ALLE.INVOICE.OPEN

data

object

必需

需要把data的值进行加密

serialNo

string

必需

外部流水号，由对接者定义及保障全局唯一性【长度：50】

<= 50 字符

orgCode

string

可选

组织编码（可以不传，会通过销方税号自动匹配，一个税号分配给多个组织使用的必须要传组织）【长度：20】bu

<= 20 字符

invoiceProperty

string

可选

开票类型，0-蓝票【长度：1】，默认为：0 （补充：本字段只为兼容老客户开红票场景，此时传值: 1；新对接客户要开具红票，请用2.1.04红冲接口）

invoiceType

string

必需

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

account

string

可选

数电账号，数电票时可以传入，非数电传入会清空，发票云版本6.0.2可用

<= 50 字符

sellerName

string

必需

销方名称【长度：GBK编码100字节】，如果在星瀚有配置企业信息可不填，

<= 100 字符

sellerTaxpayerId

string

必需

销方税号【长度：最大20字符】

<= 20 字符

sellerBank

string

必需

销方银行【长度：不超过100】【销方银行+销方银行账号 GBK编码100字节】

<= 100 字符

sellerBankAccount

string

必需

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

<= 100 字符

sellerAddress

string

必需

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

<= 100 字符

sellerTel

string

可选

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

<= 20 字符

buyerName

string

必需

购买方名称【长度：GBK编码100字节】

<= 100 字符

buyerTaxpayerId

string

可选

购买方税号（专票必填）【长度：最大20字符】

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

cardType

enum<string>

可选

证件类型，数电发票农产品收购必填

枚举值:

103201208210213215219220221233299

默认值:

103

issueBizType

string

可选

调度开票业务类型（传开票业务类型编码）

buyerRecipientPhone

string

可选

电子发票收票手机号【长度：50；最多三个手机号】

<= 50 字符

buyerRecipientMail

string

可选

电子发票收票邮箱【长度：GBK编码100字节】

<= 100 字符

remark

string

可选

备注【长度：200字节】

<= 200 字符

drawer

string

开票人

必需

<= 10 字符

payee

string

收款人

可选

<= 10 字符

reviewer

string

复核人

可选

<= 10 字符

deduction

number

可选

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

deductionType

string

可选

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

reductionTaxType

enum<string>

减按征税方式

可选

枚举值:

0102030405515253

purchaseType

string

可选

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

exportationType

string

可选

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

vatTaxRefundType

enum<string>

可选

【暂未实现】增值税即征即退类型，空：非增值税即征即退

枚举值:

010203040506070809101112

agentUser

string

可选

（数电票）经办人名称【长度：50字节】

<= 50 字符

agentCardType

enum<string>

可选

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

枚举值:

101102103199201202203204205206207208210212213214215216217218219220221222224225226227228229230231232233234235236237238239240241291299

默认值:

103

agentCardNo

string

可选

（数电票）经办人证件号码【长度：50】

<= 50 字符

agentCountry

string

可选

（数电票）经办人国籍(地区)【长度：100字节】

<= 100 字符

agentTaxNo

string

可选

（数电票）经办人自然人纳税人识别号【长度：30】

<= 30 字符

naturalPersonFlag

string

可选

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

extJson

object

可选

二开扩展字段。7.0.2版本支持

invoiceDetail

array [object {16}]

发票明细

必需

estateSaleInfo

object (不动产销售)

可选

不动产销售服务信息，特定要素类型代码为05时必填

estateLeaseInfo

object (不动产租赁)

可选

不动产经营租赁服务信息，特定要素类型代码为06时必填

estateLeaseItems

array [object {11}]

可选

不动产经营租赁服务信息，特定要素类型代码为06时必填

buildInfo

object (建筑服务)

可选

建筑服务信息，特定要素类型代码为03时必填

travelerList

array [object {8}]

可选

旅客运输信息，特定要素类型代码为09时必填(待开发)

vehicheVesselShipList

array [object {8}]

可选

车船税明细，发票云版本6.0.15版本支持

eleFreightItems

array [object {5}]

可选

货物运输信息，特定要素类型为04时必填，版本V7.0.11支持

示例

{
  "requestId": "1624601109096",
  "businessSystemCode": "BUSINESS_FPY",
  "interfaceCode": "ALLE.INVOICE.OPEN",
  "data": {
    "serialNo": "202403011709193622521",
    "invoiceType": "02",
    "sellerName": "金蝶票据云科技(深圳)有限公司",
    "sellerTaxpayerId": "91440300MA5G9GK78Y",
    "sellerBank": "中国银行深圳皇岗支行1111111111",
    "sellerBankAccount": "4000027219200486412",
    "sellerAddress": "高新技术产业园南区科技南十二路11111111111111",
    "buyerName": "深圳金蝶账无忧网络科技有限公司",
    "buyerTaxpayerId": "91440300358768292H1",
    "drawer": "张三",
    "invoiceDetail": [
      {
        "lineProperty": "0",
        "goodsName": "纸电一体开收票",
        "amount": 2000,
        "taxRate": "0.01",
        "revenueCode": "3040201010000000000"
      }
    ]
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

errorCode

string

响应码，0-成功

必需

message

string

错误信息

可选

success

boolean

成功响应

必需

data

string

必需

流水号。需要解密。当响应码(errorCode)为30001时，返回的是风控编码，用于风控解除，风控相关于发票云版本6.0.6支持。

示例

{"data":"BAIDU_TEST202203281503331951","errorCode":"0","success":true}

🟢200失败