纸质发票给到购买方之后，销方没有在当月及时拿去做冲红，然后在之后再要去冲红就需要填这个红字申请单去冲红
测试环境未连接税局端系统，无法继续测试

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>

固定为：20

必需

枚举值:

sfrz

object

身份认证

必需

client_id

string

由发票云分配的id

必需

client_secret

string

由发票云分配的密钥

可选

timestamp

string

时间戳

可选

sjd

object

必需

专用发票申请红字信息表

fpdm

string

发票代码

必需

fphm

string

发票号码

必需

ghf_mc

string

购货方名称

必需

ghf_nsrsbh

string

购货方纳税人识别号

必需

hjbhsje

string

合计金额（不含税）

必需

hjse

string

合计税额

必需

hsbz

string

必需

含税标识 0：不含税 1：含税

items

array [object {10}]

发票明细行信息

必需

sqsm

string

必需

申请说明（0：购方发起已抵扣 1：购方发起未抵扣 2：销方），详见额外说明

szlb

string

必需

税种类别（0：营业税 1：增值税（目前全部为1）

tkrq

string

必需

信息表填开日期 yyyy-MM-DD (不传则默认为系统当前日期)

kprq

string

必需

原蓝字发票开票日期 yyyy-MM-DD

xhf_mc

string

销货方名称

必需

xhf_nsrsbh

string

销货方纳税人识别号

必需

xxblx

string

必需

信息表类型（0 正常；1 逾期（仅销方开具）

hcyy

string

必需

红冲原因 1:销货退回 2:开票有误 3:服务中止 4:销售折让,非专票红冲必填

fplx

string

可选

发票类型：4、纸质专票；26、数电普票（如果存在数电普票红冲，必传）；27、数电专票

示例

{
  "czlx": "20",
  "sfrz": {
    "client_id": "string",
    "client_secret": "string",
    "timestamp": "string"
  },
  "sjd": {
    "fpdm": "string",
    "fphm": "string",
    "ghf_mc": "string",
    "ghf_nsrsbh": "string",
    "hjbhsje": "string",
    "hjse": "string",
    "hsbz": "string",
    "items": [
      {
        "ggxh": "string",
        "se": "string",
        "sl": "string",
        "taxcode": {
          "kce": "string",
          "lslbs": "string",
          "qyzbm": "string",
          "ssflbm": "string",
          "ssyhzc": "string",
          "ssyhzcnr": "string",
          "bmbb": "string"
        },
        "xmdj": "string",
        "xmdw": "string",
        "xmje": "string",
        "xmmc": "string",
        "hh": "string",
        "xmsl": "string"
      }
    ],
    "sqsm": "string",
    "szlb": "string",
    "tkrq": "string",
    "kprq": "string",
    "xhf_mc": "string",
    "xhf_nsrsbh": "string",
    "xxblx": "string",
    "hcyy": "string",
    "fplx": "string"
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

description

string

描述

必需

errcode

string

必需

0000：成功其他：失败

sjd

object

结果信息

必需

fpdm

string

发票代码

必需

fphm

string

发票号码

必需

hzxxbm

string

红字信息编码

必需

sqdh

string

申请单号

必需

ztm

string

状态码

必需

ztms

string

状态描述

必需

示例

{
  "description": "税局端系统响应错误。通讯接口返回值【-960031167】，返回报文【】，返回错误信息【】",
  "errcode": "1500"
}

1.07.专用发票申请红字信息表(czlx-20)

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

请求参数

示例代码

返回响应

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