2.03.电子发票红冲 (只支持全额红冲)(czlx-114)
POST
/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 差额征税计算公式:不含税差额 = 不含税金额 - 扣除额; 税额 = 不含税差额*税率。 开具请求报文要按照上述计算公式计算税额,合计税额等,开票服务不进行相应计算,只进行误差校验。
图一:
图二:
请求参数
clientsecret+税盘号
当前13位毫秒级时间戳加3位随机数字(总共16位)
原蓝字发票代码,发票代码、号码和流水号二选一
原蓝字发票号码,发票代码、号码和流水号二选一
原蓝字发票的流水号,流水号和发票代码、号码二选一
新开红票指定流水号 若没有填写 20 位唯一流水号,则系统自动生成
红冲原因 1:销货退回 2:开票有误 3:服务中止 4:销售折让;除了专票,其余票种必填
对应蓝票票种 2:普通发票 41:卷票 51:电子普通发票 999:其他普通发票(如 通行费发票);除了专票,其余票种必填
对应蓝票开票日期 YYYYMMDD 如20211230;除了专票,其余票种必填
红字信息表编号(待红冲发票是电子专票,此项必填)
{
"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"
}
}
示例代码
返回响应
开票设备信息对象 该信息只在开具单机版电子发票时有效
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"
}