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

快速开始环境

POST

/kapi/app/sim/openApi

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

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

请求参数

Query 参数

access_token

string

可选

示例值:

1617326422240529408_YGVCbl9K6s8XTrIE0J9rdaztYI5Nw9LqmCadaCx2kW9v5CLRGZwLetQjDShDRbi3LVxQQTH5e9v1v7h4ac4L2BUTF1n6ucvd1wM8

Body 参数application/json

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】

<= 20 字符

billDate

string

可选

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

account

string

可选

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

<= 50 字符

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】

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

默认值:

sellerTaxpayerId

string

可选

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

<= 20 字符

sellerName

string

可选

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

<= 100 字符

sellerBankAndAccount

string

可选

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

<= 150 字符

sellerAddressAndTel

string

可选

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

<= 120 字符

showBuyerBank

string

可选

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

<= 1 字符

showSalerBank

string

可选

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

<= 1 字符

showBuyerAddressTel

string

可选

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

<= 1 字符

showSalerAddressTel

string

可选

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

<= 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】，未配置开票人策略时必填

<= 10 字符

payee

string

可选

收款人【长度：10】

<= 10 字符

reviewer

string

可选

复核人【长度：10】

<= 10 字符

remark

string

可选

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

<= 230 字符

pushMatchRules

enum<string>

可选

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

枚举值:

0123

默认值:

fillValueRule

enum<string>

可选

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

枚举值:

nullgoodsNamegoodsCodematerialType

blueinvoiceCode

string

可选

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

<= 200 字符

blueinvoiceNo

string

可选

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

<= 200 字符

applicant

string

可选

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

infoCode

string

可选

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

<= 200 字符

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字节】

<= 160 字符

textField2

string

可选

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

<= 160 字符

textField3

string

可选

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

<= 160 字符

textField4

string

可选

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

<= 160 字符

textField5

string

可选

主表扩展字段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版本支持

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

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://cosmic-sandbox.piaozone.com/jdpjykjyxgs/kapi/app/sim/openApi?access_token=1617326422240529408_YGVCbl9K6s8XTrIE0J9rdaztYI5Nw9LqmCadaCx2kW9v5CLRGZwLetQjDShDRbi3LVxQQTH5e9v1v7h4ac4L2BUTF1n6ucvd1wM8' \
--header 'Content-Type: application/json' \
--data-raw '{
  "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成功

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

修改于 2025-03-31 10:31:43

开票申请单错误码列表

1.1.02 开票申请单撤回（对接方主动撤回）