2.1.01 数电票蓝字发票开具

POST/kapi/app/sim/openApi

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

请求参数

Query 参数

access_token

string

必需

requestId

string

必需

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

businessSystemCode

string

必需

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

interfaceCode

enum<string>

必需

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

枚举值:

ALLE.INVOICE.OPEN

data

object

必需

需要把data的值进行加密

serialNo

string

必需

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

orgCode

string

可选

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

invoiceProperty

string

可选

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

invoiceType

string

必需

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

account

string

可选

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

sellerName

string

必需

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

sellerTaxpayerId

string

必需

销方税号【长度：不超过26】

sellerBank

string

必需

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

sellerBankAccount

string

必需

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

sellerAddress

string

必需

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

sellerTel

string

可选

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

buyerName

string

必需

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

buyerTaxpayerId

string

可选

购买方税号（专票必填）【长度：最大26字符，数字、字母组成】

buyerBank

object

可选

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

buyerBankAccount

string

可选

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

buyerAddress

string

可选

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

buyerTel

string

可选

购买方电话【购买方地址+购买方电话 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；最多三个手机号】

buyerRecipientMail

string

可选

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

remark

string

可选

备注【长度：200字节】

drawer

string

必需

开票人【长度：16字节】

payee

string

可选

收款人【长度：16字节】

reviewer

string

可选

复核人【长度：16字节】

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

agentCardType

enum<string>

可选

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

枚举值:

101102103199201202203204205206207208210212213214215216217218219220221222224225226227228229230231232233234235236237238239240241291299

默认值:

103

agentCardNo

string

可选

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

agentCountry

string

可选

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

agentTaxNo

string

可选

（数电票）经办人自然人纳税人识别号【长度：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版本支持

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

示例代码

返回响应

成功(200)

失败(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

errorCode

string

响应码，0-成功

必需

message

string

错误信息

可选

success

boolean

成功响应

必需

data

string

必需

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

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

最后修改时间： 1 个月前