1. 发票金额算法：

1.1 蓝票算法：

不含税金额(四舍五入,保留两位小数)= 含税金额/(1+税率)
税额= 含税金额-不含税金额
不含税总金额=各行不含税金额相加
总税额 = 价税合计-不含税总金额
最后一项税额 = 总税额-（前n项税额之和）

1.2 红票算法：

价税合计=取蓝票的价税合计
合计税额=取蓝票的合计税额
合计金额=取蓝票合计金额

2. 明细项:

不含税金额(四舍五入,保留两位小数)= 含税金额/(1+税率)
税额= 含税金额-不含税金额
最后一项不含税金额 = 合计金额-（前n项不含税金额之和)
最后一项税额 = 合计税额-（前n项税额之和）

3. 误差规则

单行商品明细 |单价×数量-金额|<=0.01 元
|不含税金额×税率-税额|<=0.06元

4. 发票开具校验注意事项

4.1 正数发票

正数发票合计金额>0 ；
价税合计=合计金额+合计税额；
开票合计金额与明细行所有金额加起来要一致；
开票合计税额与明细行所有税额加起来要一致；
除折扣行外，正数发票的商品行金额必须大于0 ；
正数发票每行商品行金额均不能为0，税额不能为负数；
折扣行金额不能大于被折扣行金额。多行折扣情况下，折扣行金额不能大于各被折扣行金额之和。
正数发票金额为负的商品行（即折扣行），其上一行商品金额必须为正。
单价和数量同时为空，或都不能为空；
金额、税额、数量、单价必须是合法数字；
折扣行税率必须与被折扣行税率相同。多行折扣情况下，各被折扣行税率相同，且与折扣行税率相同。

4.2 负数发票

负数发票合计金额<0 ；
价税合计=合计金额+合计税额；
开票合计金额与明细行所有金额加起来要一致；
开票合计税额与明细行所有税额加起来要一致；
负数发票的商品行金额必须小于0，税额不能为正数；
单价和数量同时为空，或都不能为空；
金额、税额、数量、单价必须是合法数字

5. 差额征税发票注意事项

5.1 如果BMB_BBH不为空，并且第一行商品明细中KCE不为空，则认为是差额征税发票。

5.2 差额征税蓝字发票：只允许一条商品行，如果存在折扣行，则最多两条。

5.3 差额征税红字发票：只允许一条商品行。

5.4 差额征税蓝字发票：第一行商品明细中KCE不能为负数，并且不能大于第一行商品的不含税金额。

5.5 差额征税红字发票：第一行商品明细中KCE不能为正数，并且不能大于第一行商品的不含税金额。

5.6 差额征税蓝字发票：备注中要增加“差额征税：20.00。”字样，如图1。

5.7 差额征税红字发票：备注中要增加“差额征税。”字样，如图2。

5.8 差额征税计算公式：不含税差额 = 不含税金额 - 扣除额；税额 = 不含税差额*税率。开具请求报文要按照上述计算公式计算税额，合计税额等，开票服务不进行相应计算，只进行误差校验。

图一：

图二：

请求参数

Query 参数

name

string

必需

clientsecret+税盘号

reqid

string

必需

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

Header 参数

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

czlx

enum<string>

固定为：114

必需

枚举值:

114

sfrz

object

认证信息

必需

client_id

string

必需

sjd

object

请求信息

必需

invoice_code

string

必需

原蓝字发票代码,发票代码、号码和流水号二选一

invoice_num

string

必需

原蓝字发票号码，发票代码、号码和流水号二选一

fpqqlsh

string

必需

原蓝字发票的流水号，流水号和发票代码、号码二选一

new_fpqqlsh

string

可选

新开红票指定流水号若没有填写 20 位唯一流水号，则系统自动生成

hcyy

string

可选

红冲原因 1:销货退回 2:开票有误 3:服务中止 4:销售折让;除了专票，其余票种必填

dylppz

string

可选

对应蓝票票种 2:普通发票 41:卷票 51:电子普通发票 999:其他普通发票(如通行费发票);除了专票，其余票种必填

dylpkprq

string

可选

对应蓝票开票日期 YYYYMMDD 如20211230;除了专票，其余票种必填

hzxxb

string

可选

红字信息表编号(待红冲发票是电子专票,此项必填)

示例

{
  "czlx": "114",
  "sfrz": {
    "client_id": "string"
  },
  "sjd": {
    "invoice_code": "string",
    "invoice_num": "string",
    "fpqqlsh": "string",
    "new_fpqqlsh": "string",
    "hcyy": "string",
    "dylppz": "string",
    "dylpkprq": "string",
    "hzxxb": "string"
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

data

object

发票信息

必需

invoicecode

string

发票代码

必需

invoicenum

string

发票号码

必需

jym

string

校验码

必需

kdorgpdfurl

string

必需

pdfurl

string

pdf下载地址

必需

serialnum

string

流水号

必需

snapshoturl

string

必需

description

string

描述

必需

device_info

object

必需

开票设备信息对象该信息只在开具单机版电子发票时有效

card_no

string

必需

subid

number

税控设备分机号

必需

taxcode

string

税控设备税号

必需

errcode

string

必需

0000：成功其他：失败

示例

{
  "data": {
    "business_id": "",
    "invoicecode": "044031611112",
    "invoicenum": "13513968",
    "jym": "54620255790311466069",
    "kdorgpdfurl": "",
    "pdfurl": "https://api-dev.piaozone.com/test/m5/download/img/pdffile?fileSno=1825820210810111841",
    "serialnum": "PJYHX20151112174201111",
    "snapshoturl": ""
  },
  "description": "红冲成功",
  "device_info": {
    "card_no": "661532817749",
    "subid": 0,
    "taxcode": "440301999999030"
  },
  "errcode": "0000"
}

2.03.电子发票红冲 （只支持全额红冲）(czlx-114)

1. 发票金额算法：#

1.1 蓝票算法：#

1.2 红票算法：#

2. 明细项:#

3. 误差规则#

4. 发票开具校验注意事项#

4.1 正数发票#

4.2 负数发票#

5. 差额征税发票注意事项#

5.1 如果BMB_BBH不为空，并且第一行商品明细中KCE不为空，则认为是差额征税发票。#

5.2 差额征税蓝字发票：只允许一条商品行，如果存在折扣行，则最多两条。#

5.3 差额征税红字发票：只允许一条商品行。#

5.4 差额征税蓝字发票：第一行商品明细中KCE不能为负数，并且不能大于第一行商品的不含税金额。#

5.5 差额征税红字发票：第一行商品明细中KCE不能为正数，并且不能大于第一行商品的不含税金额。#

5.6 差额征税蓝字发票：备注中要增加“差额征税：20.00。”字样，如图1。#

5.7 差额征税红字发票：备注中要增加“差额征税。”字样，如图2。#

5.8 差额征税计算公式：不含税差额 = 不含税金额 - 扣除额； 税额 = 不含税差额*税率。 开具请求报文要按照上述计算公式计算税额，合计税额等，开票服务不进行相应计算，只进行误差校验。#

请求参数

示例代码

返回响应

2.03.电子发票红冲（只支持全额红冲）(czlx-114)

1. 发票金额算法：

1.1 蓝票算法：

1.2 红票算法：

2. 明细项:

3. 误差规则

4. 发票开具校验注意事项

4.1 正数发票

4.2 负数发票

5. 差额征税发票注意事项

5.1 如果BMB_BBH不为空，并且第一行商品明细中KCE不为空，则认为是差额征税发票。

5.2 差额征税蓝字发票：只允许一条商品行，如果存在折扣行，则最多两条。

5.3 差额征税红字发票：只允许一条商品行。

5.4 差额征税蓝字发票：第一行商品明细中KCE不能为负数，并且不能大于第一行商品的不含税金额。

5.5 差额征税红字发票：第一行商品明细中KCE不能为正数，并且不能大于第一行商品的不含税金额。

5.6 差额征税蓝字发票：备注中要增加“差额征税：20.00。”字样，如图1。

5.7 差额征税红字发票：备注中要增加“差额征税。”字样，如图2。

5.8 差额征税计算公式：不含税差额 = 不含税金额 - 扣除额；税额 = 不含税差额*税率。开具请求报文要按照上述计算公式计算税额，合计税额等，开票服务不进行相应计算，只进行误差校验。