1.1.01 开票申请单生成及开票（支持拆分合并后，再开票）

本接口用于生成开票申请单，并在满足条件的情况下自动触发开票流程。支持对原始业务数据进行多张合并开票或单张拆分开票处理，也支持自动补全开票项，适用于复杂业务场景下的开票自动化需求。
对于开具红票的情况下，数量和金额都应该传负数，单价传正数
例如一个开票申请单开了N张发票，如果业务编号 businessSystemCode 以 3std1 开头,那么将按照接口(5.1.03.回调接口（单据对应的所有发票开票完毕后一起回调）)回调；如果业务编号 businessSystemCode 不以 3std1 开头，则默认按照接口(5.1.02.回调接口(一次回调一张发票信息))回调

请求参数

Query 参数

access_token

string

可选

示例值:

1617326422240529408_YGVCbl9K6s8XTrIE0J9rdaztYI5Nw9LqmCadaCx2kW9v5CLRGZwLetQjDShDRbi3LVxQQTH5e9v1v7h4ac4L2BUTF1n6ucvd1wM8

Header 参数

access_token

string

可选

默认值:

Body 参数application/json

requestId

string

时间戳

必需

请求唯一ID，可使用时间戳或UUID如：1624601109096

businessSystemCode

string

来源系统；

必需

对接不同系统来源编码，用于区分不同系统的回调接口；例如SRM系统，你可以传入SRM

interfaceCode

enum<string>

接口业务编码

必需

接口业务编码，使用BILL.PUSH

枚举值:

BILL.PUSH

data

array [object {66}]

开票请求参数

必需

需要把data的值加密成字符串，默认为base64

billNo

string <regex>

单据编号

必需

参数限制：数字、英文、下划线、-如:Srm_20250518001

<= 50 字符

默认值:

正则匹配:

^[a-zA-Z0-9_-]+$

billDate

string

单据日期

可选

格式：yyyy-MM-dd)；如果为空，则默认为当天日期

invoiceProperty

enum<string>

发票性质

可选

0：蓝票；1：红票。不填默认蓝票

枚举值:

默认值:

invoiceType

enum<string>

发票种类

可选

未配置票种管理策略时必填枚举值

枚举值:

02802600400702508xdp10xdp

specialType

enum<string>

特殊票种

可选

【注意】同一个票种名称，开数电发票和开税控发票所给枚举值不同

枚举值:

0002081118E01E03E04E05E06E09E14E18

默认值:

remark

string

备注

可选

GBK编码230字节【长度：230】

<= 230 字符

contractNo

string

合同号

可选

发票相关的合同号

<= 50 字符

buyerName

string

购买方名称

可选

[购方]根据购方名称匹配税号、地址电话、开户行账号（如有），不传且需自动开票时，提示：购方名称为空，请补充，不传且不自动开票时，保存为开票申请单

<= 100 字符

buyerCode

string

购方编码

可选

[购方]购方编码

<= 50 字符

buyerTaxpayerId

string

购方税号

可选

[购方]（专票必填）当购买方性质为企业填写税号，当购方性质为个人填写身份证

<= 50 字符

buyerBankAndAccount

string

购方银行和账号

可选

[购方]购买方银行和账号，（税控专票必填，数电专票选填）GBK编码100字节，开专票时若未传入则用名称匹配系统维护的银行和账号【长度：100】

<= 150 字符

buyerAddressAndTel

string

购方地址电话

可选

[购方]购买方地址和电话，（税控专票必填，数电专票选填）GBK编码100字节，开专票时若未传入则用名称匹配系统维护的地址电话【长度：100】

<= 120 字符

buyerRecipientPhone

string

购方收票手机号

可选

[购方/交付]电子发票收票手机号,电票buyerRecipientPhone、buyerRecipientMail必填其一或者两者都不填写，按照发票云--基础资料--开票参数设置--开票其他设置中的配置

<= 200 字符

buyerRecipientMail

string

购方收件邮箱

可选

[购方/交付]电子发票收票邮箱，电票buyerRecipientPhone、buyerRecipientMail必填其一,可填最多三个邮箱，用英文分号(;)隔开

<= 200 字符

buyerProperty

enum<string>

购买方性质

可选

[购方]购买方性质，0-企业，1-个人，2-非企业单位

枚举值:

012

默认值:

orgCode

string

购方组织号

可选

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

<= 20 字符

showBuyerAddressTel

string

是否展示购方地址电话标识

可选

[购方]是否展示购方地址电话，Y展示，N不展示，不填取系统服务云中配置，发票云版本7.0.1支持

<= 1 字符

showBuyerBank

string

是否展示购方银行账号标识

可选

[购方]是否展示购方银行账号，Y展示，N不展示，不填取系统服务云中配置，发票云版本6.0.18支持

<= 1 字符

sellerTaxpayerId

string

销方税号

可选

[销方]销方税号。组织编号、销方名称/税号三选一必传（1）传组织编号，销方信息未传时，根据组织编号找销方信息。（2）销方税号/销方二选一，两者都填，以销方税号为准。

<= 20 字符

sellerName

string

销方名称

可选

[销方]销方名称，销方税号或销方二选一必填，两者都填，以销方税号为准

<= 100 字符

sellerBankAndAccount

string

销方银行和账号

可选

[销方]销方银行和账号，若未传入则用名称匹配系统维护的银行和账号【长度：不超过100】

<= 150 字符

sellerAddressAndTel

string

销方地址和电话

可选

[销方]销方地址和电话，若未传入则用名称匹配系统维护的地址电话【长度：不超过100】

<= 120 字符

showSalerBank

string

是否展示销方银行账号标识

可选

[销方]是否展示销方银行账号，Y展示，N不展示，不填取系统服务云中配置，发票云版本6.0.18支持

<= 1 字符

showSalerAddressTel

string

是否展示销方地址电话标识

可选

[销方]是否展示销方地址电话，Y展示，N不展示，不填取系统服务云中配置，发票云版本7.0.1支持

<= 1 字符

cardType

enum<string>

证件类型

可选

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

枚举值:

103201208210213215219220221233299

默认值:

103

deduction

number

差额征税差额

可选

[税]差额征税差额【长度：(14,2)】

taxationStyle

enum<string>

征税方式

可选

[税]征税方式，0:普通征税,1:减按计征（税控发票）,2:差额征税（税控发票）,3:减按征税（数电发票）,01:差额征税-全额开票（数电票）,02:差额征税-差额开票（数电票）、默认0；

枚举值:

01230102

默认值:

reductionTaxType

enum<string>

减按征税类型

可选

[税]减按征税类型

枚举值:

0102030405515253

totalAmount

number

单据金额

可选

单据金额，根据含税标记区分，含税标志是不含税时为不含税金额，含税是含税金额，不传使用明细金额累加。

includeTaxFlag

enum<string>

含税标识

可选

含税标识，0-不含税，1-含税【长度：1】，默认为0

枚举值:

默认值:

billDiscountAmount

number

整单折扣金额

可选

整单折扣金额

billDetail

array [object {23}]

单据明细

可选

单据明细

drawer

string

开票人

可选

开票人【长度：10】，未配置开票人策略时必填

<= 10 字符

payee

string

收款人

可选

[税控]收款人【长度：10】

<= 10 字符

reviewer

string

复核人

可选

[税控]复核人【长度：10】

<= 10 字符

deviceNo

string

]设备编号

可选

[税控]设备编号（可以不传，不传自动匹配税号默认设备）

terminalNo

string

终端号码

可选

[税控]终端号码（可以不传，只有百旺服务器才需要传）

blueinvoiceCode

string

待冲蓝票代码

可选

[红字]待冲蓝票代码，开具税控红字专票与数电票时选填，开具税控红字普票时必填

<= 200 字符

blueinvoiceNo

string

待冲蓝票号码

可选

[红字]待冲蓝票号码，开具税控红字专票与数电票时选填，开具税控红字普票时必填

<= 200 字符

applicant

string

申请方

可选

[红字]0：购方申请-发票已抵扣； 1：购方申请-发票未抵扣；2：销方申请；默认为销方申请【长度：10】

infoCode

string

红字信息表编号或红字确认单编号

可选

[红字]红字信息表编号或红字确认单编号。红字信息表编号长度：16位；红字确认单编号长度：20位

<= 200 字符

redReason

enum<string>

冲红原因

可选

[红字]冲红原因，开具红字普票时选填，1销货退回；2开票有误；3开票中止；4销售折让（填了待冲蓝票代码、号码时，如不填，默认为2开票有误）

枚举值:

1234

默认值:

originalIssueTime

string

待冲蓝票开票日期

可选

[红字]待冲蓝票开票日期：格式为yyyy-MM-dd，数电票为yyyy-MM-dd HH:mm:ss，传入红字确认单编号或红字信息表编号时可不传

blueInvoiceType

string

待冲蓝票类型

可选

[红字]待冲蓝票类型，开具红字普票时选填，（028-增值税电子专用发票， 004-增值税纸质专用发票， 026-增值税电子普通发票， 007-增值税纸质普通发票，025-卷票【长度：4】）

textField1

string

主表扩展字段1

可选

主表扩展字段1【长度：GBK150字节】

<= 160 字符

textField2

string

主表扩展字段2

可选

主表扩展字段2【长度：GBK150字节】

<= 160 字符

textField3

string

主表扩展字段3

可选

主表扩展字段3【长度：GBK150字节】

<= 160 字符

textField4

string

主表扩展字段4

可选

主表扩展字段4【长度：GBK150字节】

<= 160 字符

textField5

string

主表扩展字段5

可选

主表扩展字段5【长度：GBK150字节】

<= 160 字符

extJson

object

二开扩展字段

可选

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

estateLeaseInfo

object (不动产租赁)

可选

已废弃，不动产租赁必填，发票云版本5.0.017支持

estateLeaseItems

array [object {10}]

不动产租赁明细

必需

不动产租赁必填，发票云版本7.0.2支持

buildInfo

object (建筑服务)

建筑服务

可选

建筑服务必填，发票云版本5.0.017支持

estateSaleInfo

object (不动产销售)

不动产销售明细

可选

已废弃，不动产销售必填，发票云版本5.0.020支持

estateSaleItems

array [object {9}]

不动产销售明细

必需

不动产销售必填

freightItems

array [object {5}]

货物运输服务明细

可选

货物运输服务必填，发票云版本5.0.022支持

travelerList

array [object {8}]

旅客运输明细

可选

旅客运输明细，发票云版本6.0.11支持

deductionItems

array [object {9}]

数电票差额征税明细

可选

数电票差额征税-差额开票必填，发票云版本5.0.020支持

vehicheVesselShipList

array [object {8}]

车船税明细

可选

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

autoInvoice

string

自动开票标记

可选

[系统]自动开票，0-否，1-是，默认0

autoMerge

string

自动合并标记

可选

[系统]自动合并 0-否，1-是，自动开票为1时生效

pushMatchRules

enum<string>

商品明细匹配规则

可选

[系统]商品明细匹配规则 0-按物料匹配（默认） 1-物料分类匹配 2-按商品匹配 3-按开票项匹配

枚举值:

0123

默认值:

issueBizType

string

调度开票业务类型

可选

[系统]调度开票业务类型（传开票业务类型编码）

priority

string

优先级

可选

[系统]优先级，0,普通，1-加急

fillValueRule

enum<string>

商品名称取值规则

可选

[系统]商品名称取值规则默认-取开票项名称 goodsName-取上游商品名称goodsCode-取上游商品编码 materialType-取上游物料分类

枚举值:

nullgoodsNamegoodsCodematerialType

account

string

数电账号

可选

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

<= 50 字符

示例

{
  "requestId": "1624601109096",
  "businessSystemCode": "BUSINESS_FPY",
  "interfaceCode": "BILL.PUSH",
  "data": [
    {
      "billNo": "ids-uat-3std1-29",
      "billDate": "2023-05-17",
      "totalAmount": 11300,
      "autoInvoice": "0",
      "invoiceType": "08xdp",
      "buyerName": "深圳市顺丰快运有限公司test01",
      "buyerProperty": "0",
      "sellerTaxpayerId": "91440300MA5G9GK78Y",
      "sellerName": "金蝶票据云科技(深圳)有限公司",
      "sellerBankAndAccount": "13710884704",
      "sellerAddressAndTel": "高新技术产业园南区科技南十二路58996989",
      "drawer": "开票人",
      "billDetail": [
        {
          "amount": 11300,
          "detailId": "1194121661989796666",
          "goodsName": "蜂胶口腔膜",
          "lineProperty": 2,
          "price": 11300,
          "quantity": 1,
          "revenueCode": "1070304990000000000",
          "taxRate": "0.13",
          "units": "个"
        }
      ]
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

data

object | null

返回内容，需要解密

可选

riskInfo

array [object {2}]

可选

风控信息。当错误编码(errorCode)为30001时，存在当前节点数据。发票云版本6.0.6支持。如需解除风控，请调用6.0.01 风控解除接口。

errorCode

string

0为成功

必需

success

boolean

成功响应

必需

示例

{
    "message": "开票申请单推送成功",
    "errorCode": "0",
    "status": true,
    "success": true
}

🟢200失败