2.2.01税控开票（直接开票，不支持拆分合并）

快速开始环境

https://cosmic-sandbox.piaozone.com/jdpjykjyxgs

POST

/kapi/app/sim/openApi

0：成功
-10001：数据传入为空
-10001：单据编号：%s,机动车增值税发票的发票类型必须专票
-10001：单据编号：%s,机动车增值税发票数量必须为正整数
-10001：单据编号：%s,机动车增值税发票单价必须为正数
-10001：单据编号：%s,单位栏必须为:辆
-10001：您的税号或组织编号无法找到设备请校验是否已维护设备！
-10001：当前设备已经被禁用！
-10001：创建折扣行失败
-10001：全电发票账号自动登录失败，无法自动开票：
10101：单据编号不能为空，且不能超过50
10127：单据编号重复
10164：税号未查询到组织信息或当前设备未绑定组织！
10120：销方名称不正确：GBK长度至多100
10121：购方名称不正确：GBK长度至多100
10122：销方开户行及账号不正确：GBK长度至多100
10123：购方开户行及账号不正确：GBK长度至多100
10124：销方地址电话不正确：GBK长度至多100
10125：购方地址电话不正确：GBK长度至多100
10131：收票手机和收票邮箱不能同时为空
10126：邮箱格式不正确：GBK长度至多100，最多3个邮箱用；分隔
10130：收票号码格式有误
10102：销方税号不正确:字母或数字；只能15、17、18、20位
10104：发票性质不正确：0 正数发票（蓝票）、1 负数发票（红票）
10105：发票种类不正确：004纸质专用发票、007纸质普通发票、028电子专用发票、026电子普通发票
10106：企业性质为个人时，不允许开具专票
10107：红字信息表编号:需要直接开具专用红字发票时，必填
10109：购方名称不能为空
10110：购方税号不正确:字母或数字；只能15、17、18、20位
10111：含税标识错误：0,不含税 1,含税
10112：发票明细行只能传一行
10113：开票人不正确
10114：收款人不正确
10115：复核人不正确
10108：对应蓝票代码,对应蓝票代码:需要直接开红票时必填
10108：红字信息表未提交
10108：红字信息表审核失败
10108：蓝票已作废，不能进行红冲
10108：蓝票已红冲，不能进行红冲
10507：对应蓝票类型和原蓝票开票时间:普票直接开红票时必填
10508：对发票类型为卷票:普票直接开红票时对应蓝票类型也必须为卷票
10116：当前销方纳税人识别号未在本系统中找到，请先维护企业信息
10116：销售方名称与税号不一致
10150：明细行编号不正确：长度至多32位
10151：开红票时发票商品明细金额不能大于0，且不能有折扣行
10151：蓝票明细行金额不能小于0
10151：蓝票折扣行金额不能大于0
10152：商品编号、商品名称：如果在本系统已维护，商品编号、商品名称二选一必填；未维护，则名称必填
10153：商品名称长度不能大于92，GBK格式
10154：规格型号:长度最多为40
10155：单位：长度最多22
10157：税率不合法
10156：当商品金额为空或为0时，单价和数量皆不能为空为0
10158：税额不合法
10159：折扣率不正确:支持格式：0.，%
10160：税收分类编码与商品编码不能同时为空
10161：税收分类编码为汇总项或不存在
10153：商品名称长度不能大于92，GBK格式
10162：优惠政策标识为【享受优惠】,优惠政策内容不能为空
10163：优惠政策标识为【不享受优惠】,优惠政策内容必须为空
9999：第%s行明细是被折扣行，下一行必须为折扣行
9999：第%s行明细是折扣行，上一行必须为被折扣行
9999：折扣行数量,单价都应为空
10503：蓝票合计金额不能小于0
10504：蓝票合计税额不能小于0
10505：红票合计金额不能大于0
10506：红票合计税额不能大于0

请求参数

Query 参数

access_token

string

必需

Body 参数application/json

requestId

string

时间戳

必需

businessSystemCode

string

必需

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

interfaceCode

string

必需

接口编码，开票固定为[INVOICE.OPEN]

data

array [object {32}]

必需

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

serialNo

string

可选

单据编号，【长度：50】

<= 50 字符

deviceNo

string

可选

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

terminalNo

string

可选

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

orgCode

string

可选

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

<= 20 字符

account

string

可选

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

<= 20 字符

invoiceProperty

string

必需

开票类型，0蓝票，1红票【长度：1】

invoiceType

string

必需

发票种类， 028-增值税电子专用发票， 004-增值税纸质专用发票， 026-增值税电子普通发票， 007-增值税纸质普通发票，025-卷票，08xdp-全电发票（增值税专用发票）， 10xdp-全电发票（普通发票）【长度：4】

sellerName

string

必需

销方名称【长度：不超过100】，如果在星瀚有配置企业信息可不填，

<= 100 字符

sellerTaxpayerId

string

必需

销方税号,只能15、17、18、20位

<= 20 字符

sellerBankAndAccount

string

必需

销方银行和账号【长度：不超过100】

<= 100 字符

sellerAddressAndTel

string

必需

销方地址和电话【长度：不超过100】

<= 100 字符

buyerName

string

必需

购买方名称【长度：不超过100】

<= 100 字符

buyerTaxpayerId

string

可选

购买方税号（专票必填）

<= 20 字符

buyerBankAndAccount

string

可选

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

<= 100 字符

buyerAddressAndTel

string

必需

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

<= 100 字符

buyerProperty

string

可选

购买方性质，0-企业，1-个人,不填默认为0

includeTaxFlag

string

必需

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

buyerRecipientPhone

string

可选

电子发票收票手机号，电票必填

<= 80 字符

buyerRecipientMail

string

可选

电子发票收票邮箱，电票必填【长度：不超过100】，可填最多三个邮箱，用英文分号(;)隔开

<= 100 字符

remark

string

必需

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

<= 230 字符

deduction

number

可选

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

taxedType

string

必需

征税方式 0-普通，1-减按计征，2-差额征税

drawer

string

必需

开票人【长度：10】

<= 10 字符

reviewer

string

可选

复核人【长度：10】

<= 10 字符

payee

string

可选

收款人【长度：10】

<= 10 字符

originalInvoiceCode

string

可选

原蓝票发票代码，开红票必传【长度：12】

<= 12 字符

originalInvoiceNumber

string

可选

原蓝票发票号码，开红票必传【长度：8】

<= 8 字符

redInfoBillNo

string

可选

红字信息表编号，专用发票红冲必传【长度：16】

<= 16 字符

originalIssueTime

string

可选

原蓝票开票日期：开红字普票时，且发票云不存在该蓝票时必填

originalInvoiceType

string

可选

原蓝票发票种类，026-增值税电子普通发票， 007-增值税纸质普通发票，025-卷票【长度：4】（开红字普票时，且发票云不存在该蓝票时必填）

issueBizType

string

可选

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

invoiceDetail

array [object {17}]

发票明细

可选

示例

{
  "requestId": "string",
  "businessSystemCode": "string",
  "interfaceCode": "string",
  "data": [
    {
      "serialNo": "string",
      "deviceNo": "string",
      "terminalNo": "string",
      "orgCode": "string",
      "account": "string",
      "invoiceProperty": "string",
      "invoiceType": "string",
      "sellerName": "string",
      "sellerTaxpayerId": "string",
      "sellerBankAndAccount": "string",
      "sellerAddressAndTel": "string",
      "buyerName": "string",
      "buyerTaxpayerId": "string",
      "buyerBankAndAccount": "string",
      "buyerAddressAndTel": "string",
      "buyerProperty": "string",
      "includeTaxFlag": "string",
      "buyerRecipientPhone": "string",
      "buyerRecipientMail": "string",
      "remark": "string",
      "deduction": 0,
      "taxedType": "string",
      "drawer": "string",
      "reviewer": "string",
      "payee": "string",
      "originalInvoiceCode": "string",
      "originalInvoiceNumber": "string",
      "redInfoBillNo": "string",
      "originalIssueTime": "string",
      "originalInvoiceType": "string",
      "issueBizType": "string",
      "invoiceDetail": [
        {
          "billSourceId": "string",
          "goodsCode": "string",
          "goodsName": "string",
          "specification": "string",
          "units": "string",
          "quantity": 0,
          "price": 0,
          "amount": 0,
          "taxRate": "string",
          "taxAmount": 0,
          "discountAmount": 0,
          "discountRate": "string",
          "revenueCode": "string",
          "privilegeFlag": "string",
          "privilegeContent": "string",
          "zeroTaxRateFlag": "string",
          "lineProperty": "string"
        }
      ]
    }
  ]
}

示例代码

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=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "requestId": "string",
    "businessSystemCode": "string",
    "interfaceCode": "string",
    "data": [
        {
            "serialNo": "string",
            "deviceNo": "string",
            "terminalNo": "string",
            "orgCode": "string",
            "account": "string",
            "invoiceProperty": "string",
            "invoiceType": "string",
            "sellerName": "string",
            "sellerTaxpayerId": "string",
            "sellerBankAndAccount": "string",
            "sellerAddressAndTel": "string",
            "buyerName": "string",
            "buyerTaxpayerId": "string",
            "buyerBankAndAccount": "string",
            "buyerAddressAndTel": "string",
            "buyerProperty": "string",
            "includeTaxFlag": "string",
            "buyerRecipientPhone": "string",
            "buyerRecipientMail": "string",
            "remark": "string",
            "deduction": 0,
            "taxedType": "string",
            "drawer": "string",
            "reviewer": "string",
            "payee": "string",
            "originalInvoiceCode": "string",
            "originalInvoiceNumber": "string",
            "redInfoBillNo": "string",
            "originalIssueTime": "string",
            "originalInvoiceType": "string",
            "issueBizType": "string",
            "invoiceDetail": [
                {
                    "billSourceId": "string",
                    "goodsCode": "string",
                    "goodsName": "string",
                    "specification": "string",
                    "units": "string",
                    "quantity": 0,
                    "price": 0,
                    "amount": 0,
                    "taxRate": "string",
                    "taxAmount": 0,
                    "discountAmount": 0,
                    "discountRate": "string",
                    "revenueCode": "string",
                    "privilegeFlag": "string",
                    "privilegeContent": "string",
                    "zeroTaxRateFlag": "string",
                    "lineProperty": "string"
                }
            ]
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

data

string

返回内容，需要解密

必需

errorCode

string

响应码

必需

success

boolean

成功响应

必需

示例

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

🟢200失败

2.1.14 发票用途状态查询（发票云版本6.0.11支持，暂只支持乐企）

2.2.02税控发票快速红冲（仅支持全额红冲）