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

BILL.PUSH

POST/kapi/app/sim/openApi

开红票，数量和金额都应该传负数，单价传正数

例如一个开票申请单开了N张发票，
如果业务编号 businessSystemCode 以 3std1 开头,那么将按照接口(5.1.03.回调接口（单据对应的所有发票开票完毕后一起回调）)回调，
如果业务编号 businessSystemCode 不以 3std1 开头，则默认按照接口(5.1.02.回调接口(一次回调一张发票信息))回调

请求参数

Query 参数

access_token

string

可选

示例值:

1617326422240529408_YGVCbl9K6s8XTrIE0J9rdaztYI5Nw9LqmCadaCx2kW9v5CLRGZwLetQjDShDRbi3LVxQQTH5e9v1v7h4ac4L2BUTF1n6ucvd1wM8

requestId

string

时间戳

必需

businessSystemCode

string

必需

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

interfaceCode

enum<string>

接口业务编码

必需

枚举值:

BILL.PUSH

data

array [object {66}]

必需

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

billNo

string <regex>

必需

单据编号；参数限制：数字、英文、下划线、-

<= 50 字符

默认值:

正则匹配:

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

orgCode

string

可选

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

billDate

string

可选

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

account

string

可选

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

totalAmount

number

可选

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

autoInvoice

string

可选

自动开票，0-否，1-是，默认0

autoMerge

string

可选

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

invoiceType

enum<string>

可选

发票种类，未配置票种管理策略时必填枚举值
枚举值说明
028,增值税电子专用发票;
026,增值税电子普通发票;
004,增值税纸质专用发票;
007,增值税纸质普通发票;
025,卷票;
08xdp,数电发票（增值税专用发票）;
10xdp,数电发票（普通发票）;

枚举值:

02802600400702508xdp10xdp

priority

string

可选

优先级，0,普通，1-加急

contractNo

string

可选

合同号【长度：50】

buyerName

string

可选

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

buyerCode

string

购方编码

可选

buyerTaxpayerId

string

可选

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

buyerBankAndAccount

string

可选

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

buyerAddressAndTel

string

可选

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

buyerRecipientPhone

string

可选

电子发票收票手机号,电票buyerRecipientPhone、buyerRecipientMail必填其一

buyerRecipientMail

string

可选

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

buyerProperty

enum<string>

可选

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

枚举值:

012

默认值:

sellerTaxpayerId

string

可选

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

sellerName

string

可选

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

sellerBankAndAccount

string

可选

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

sellerAddressAndTel

string

可选

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

showBuyerBank

string

可选

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

showSalerBank

string

可选

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

showBuyerAddressTel

string

可选

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

showSalerAddressTel

string

可选

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

includeTaxFlag

enum<string>

可选

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

枚举值:

默认值:

deviceNo

string

可选

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

terminalNo

string

可选

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

deduction

number

可选

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

taxationStyle

enum<string>

可选

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

枚举值:

01230102

默认值:

reductionTaxType

enum<string>

减按征税类型

可选

枚举值:

0102030405515253

drawer

string

可选

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

payee

string

可选

收款人【长度：10】

reviewer

string

可选

复核人【长度：10】

remark

string

可选

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

pushMatchRules

enum<string>

可选

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

枚举值:

0123

默认值:

fillValueRule

enum<string>

可选

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

枚举值:

nullgoodsNamegoodsCodematerialType

blueinvoiceCode

string

可选

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

blueinvoiceNo

string

可选

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

applicant

string

可选

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

infoCode

string

可选

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

originalIssueTime

string

可选

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

blueInvoiceType

string

可选

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

redReason

enum<string>

可选

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

枚举值:

1234

默认值:

specialType

enum<string>

可选

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

枚举值:

0002081118E01E03E04E05E06E09E14E18

默认值:

cardType

enum<string>

可选

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

枚举值:

103201208210213215219220221233299

默认值:

103

issueBizType

string

可选

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

invoiceProperty

enum<string>

可选

发票性质，0：蓝票；1：红票。不填默认蓝票

枚举值:

默认值:

billDiscountAmount

number

整单折扣金额

可选

textField1

string

可选

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

textField2

string

可选

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

textField3

string

可选

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

textField4

string

可选

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

textField5

string

可选

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

extJson

object

可选

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

estateLeaseInfo

object (不动产租赁)

可选

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

estateLeaseItems

object (不动产租赁)

可选

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

buildInfo

object (建筑服务)

可选

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

estateSaleInfo

object (不动产销售)

可选

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

estateSaleItems

object (不动产销售)

不动产销售必填

可选

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版本支持

billDetail

array [object {23}]

单据明细

可选

{
  "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": "个"
        }
      ]
    }
  ]
}

示例代码

返回响应

成功(200)

失败(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

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
}

最后修改时间： 8 天前