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

返回编码统一参考：《返回编码说明》
支持通过乐企、电子税局RPA开具数电蓝字发票，调用本接口将直接开票，不进行数据匹配、补全等处理。
使用场景：调用方仅需要开票，且可提供完整的开票数据时，使用本接口。发票开具完成后，可通过2.1.02数电票回调接口回调发票数据。本接口调用即开票，不支持审批流。

请求参数

Query 参数

access_token

string

必需

Header 参数

access_token

string

可选

默认值:

Body 参数application/json

requestId

string

时间戳

必需

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

businessSystemCode

string

对接业务系统来源编码

必需

对接不同系统来源编码，用于区分不同系统的回调接口，例如：对接开票系统是OA系统就把业务系统编码设置为OAsystem

interfaceCode

enum<string>

接口业务编码

必需

固定值：ALLE.INVOICE.OPEN

枚举值:

ALLE.INVOICE.OPEN

data

object

必需

需要把data的值进行加密

serialNo

string

外部流水号

必需

由对接者定义及保障全局唯一性

<= 50 字符

orgCode

string

组织编码

可选

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

<= 20 字符

invoiceProperty

string

开票类型

可选

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

<= 1 字符

invoiceType

enum<string>

发票种类

必需

枚举值:

0102

account

string

数电账号

可选

发票云版本6.0.2可用
1、通过电子税局开票选传，传输后使用传输的电子税局账号开票，未传输使用默认电子税局账号开票
2、提供乐企开票时不传

<= 50 字符

sellerName

string

销方名称

必需

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

<= 100 字符

sellerTaxpayerId

string

销方税号

必需

<= 20 字符

sellerBank

string

销方银行

可选

【销方银行+销方银行账号 GBK编码150字节】
1、通过乐企开票可选填
2、通过电子税局账号开票必填

<= 150 字符

sellerBankAccount

string

销方银账号

可选

【销方银行+销方银行账号 GBK编码150字节】
1、通过乐企开票可选填
2、通过电子税局账号开票必填

<= 150 字符

sellerAddress

string

销方地址

可选

【销方地址+销方电话 GBK编码120字节】
1、通过乐企开票可选填
2、通过电子税局账号开票必填

<= 120 字符

sellerTel

string

销方电话

可选

【销方地址+销方电话 GBK编码120字节】
1、通过乐企开票可选填
2、通过电子税局账号开票必填

<= 120 字符

buyerName

string

购买方名称

必需

【长度：GBK编码100字节】

<= 100 字符

buyerTaxpayerId

string

购买方税号

可选

发票种类invoiceType=01专票时必填

<= 20 字符

buyerBank

string

购买方银行

可选

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

<= 150 字符

buyerBankAccount

string

购买方银行账号

可选

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

<= 150 字符

buyerAddress

string

购买方地址

可选

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

<= 120 字符

buyerTel

string

购买方电话

可选

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

<= 120 字符

specialType

enum<string>

特定要素类型代码

可选

默认为空。空：非特定要素；01：成品油发票；03：建筑服务发票；04：货物运输服务发票；05：不动产销售服务发票；06：不动产租赁服务发票；07：代收车船税；12：自产农产品销售发票；16：农产品收购发票；18：卷烟发票

枚举值:

null01E0203040506070809101112131415021718

默认值:

null

cardType

enum<string>

证件类型

可选

数电发票农产品收购必填

枚举值:

103201208210213215219220221233299

默认值:

103

issueBizType

string

调度开票业务类型

可选

（传开票业务类型编码），传输后可按照开票业务控制管控，可在发票云-基础资料-开票业务管控中配置。

buyerRecipientPhone

string

电子发票收票手机号

可选

最多可填写3个手机号，手机号间通过英文分隔符;隔开

<= 80 字符

buyerRecipientMail

string

电子发票收票邮箱

可选

最多可填写10个邮箱，邮箱间通过英文分隔符;隔开

<= 300 字符

remark

string

备注

可选

1、乐企开票最长450位，电子税局RPA开票最长200位，一个汉字、数字、英文、特殊字符算1位
2、开票时按对应长度处理，可以在发票云→基础资料→开票参数设置→开票其他设置中设置为超长自动截取或超长提示

<= 450 字符

drawer

string

开票人

必需

1、使用乐企开票时，必传，可展示为传输的开票人。
2、使用数电账号开票时，不传，票面的开票人展示为数电账号绑定的开票人名称，不按传输开票人展示；

<= 10 字符

payee

string

收款人

可选

<= 10 字符

reviewer

string

复核人

可选

<= 10 字符

deduction

number

差额征税差额

可选

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

deductionType

enum<string>

差额征税类型代码

可选

枚举值:

空0102

reductionTaxType

enum<string>

减按征税类型

可选

开具减按征税业务的发票，且使用数电账号开票时传输

枚举值:

0102030405515253

purchaseType

string

收购发票类型代码

可选

默认为空，空：非收购发票01：农产品收购发票

exportationType

enum<string>

出口业务适用政策代码

可选

默认为空，通过乐企开具出口业务发票时选填

枚举值:

空010203

vatTaxRefundType

enum<string>

可选

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

枚举值:

010203040506070809101112

agentUser

string

经办人名称

可选

【长度：50字节】

<= 50 字符

agentCardType

enum<string>

经办人证件类型

可选

枚举值

枚举值:

101102103199201202203204205206207208210212213214215216217218219220221222224225226227228229230231232233234235236237238239240241291299

默认值:

103

agentCardNo

string

经办人证件号码

可选

【长度：50】

<= 50 字符

agentCountry

enum<string>

经办人国籍(地区)

可选

传输国家数字代码，【长度：100字节】

枚举值:

004008010012016020024028031032036040044048050051052056060064068070072074076084086090092096100104108112116120124132136140144148152156158162166170174175178180184188191192196203204208212214218222226231232233234238239242246250254258260262266268270275276288292296300304308312316320324328332334336340344348352356360364368372376380384388392398400404408410414417418422426428430434438440442446450454458462466470474478480484492496498499500504508512516520524528530533540548554558562566570574578580581583584585586591598600604608612616620624626630634638642643646654659660662666670674678682686688690694702703704705706710716724728732736740744748752756760762764768772776780784788792795796798800804807818826831832833834840850854858860862876882887891894A00

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时，estateLeaseInfo与estateLeaseItems二选一填写，建议V7.0.2版本及以上统一对接estateLeaseItems

estateLeaseItems

array [object {11}]

可选

不动产经营租赁服务信息，支持单行、多行不动产经营租赁服务信息，V7.0.2版本及以上支持本字段，特定要素类型代码为06时，estateLeaseInfo与estateLeaseItems二选一填写

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失败