1.03.发票开具(czlx-3)

全电接口生产环境把接口地址改成https://api.piaozone.com/bill-websocket/v3/invoicewebsocket/push?taxNo=xxxxxxxxxxxxxx&clientId=xxxxxxxxxxxxxxxxxxxxxxxx
全电接口测试环境把接口地址改成https://api-dev.piaozone.com/test/bill-websocket/v3/invoicewebsocket/push?taxNo=当前企业税号&clientId=企业对应的发票云ClientId的值&paperInvoiceFlag=1&debugOpenInvoice=1

1. 发票金额算法：

1.1 蓝票算法：

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

1.2 红票算法：

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

2. 明细项:

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

3. 误差规则

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

4.1 正数发票

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

4.2 负数发票

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

4.3 关于发票红冲

提示：本节内容适用税控票，数电票仅做参考

4.3.1. 开具负数增值税普通发票，必须在备注中注明 对应正数发票代码:XXXXXXXXXX 号码:YYYYYYYY 字样，其中X为发票左上角10位或 12位代码数字，Y为发票右上角 8 位号码数字
4.3.2. 开具负数增值税专用发票，必须在备注中注明开具红字增值税专用发票信息表编号XXXXXXXXXXXXXXXX，其中 X 为信息表编号。同时，数量、金额、税额为负数
4.3.3. 开具货物运输发票的负数票备注中注明开具红字货物运输业增值税专用发票信息表编号
XXXXXXXXXXXXXXX，其中X 为信息表编号。
4.3.4. 开具机动车销售统一发票的负数票需在备注中注明对应正数发票代
码:XXXXXXXXXX 号码:YYYYYYYY字样，其中“X”为发票左上角10 位
或12 位代码数字，“Y”为发票右上角8 位号码数字。

4.4 税收分类编码

说明：商品和服务税收分类编码，详细编码信息可参考开票软件中的编码查询

API接口字段	是否必须	字段描述	字段解释
ssflbm	是	商品编码	有税务局统一规范的商品与服务代码
kce	否	扣除额	对于征税对象全部数额中扣除的一定数额
lslbs	否	零税率标识	空值->普通非零税率；0->出口退税; 1->免税; 2->不征收; 3->普通零税率
qyzbm	否	企业自编码	由企业自定义的编码
ssyhzc	是	优惠政策标识	0->不享受优惠政策，1->享受优惠政策
ssyhzcnr	否	优惠政策内容	具体的优惠政策内容当优惠政策标识为1时，必须填写优惠政策的具体内容

示例

null指代空值（以下表格不涵盖所有情况，只做示例作用）

类型	零税率标识	优惠政策标识	优惠政策内容
普通非零税率	null	0	null
普通零税率（税率=0）	3	null	null
免税（税率=0）	1	1	免税
出口退税（税率=0）	0	1	出口退税

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

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

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

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

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

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

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

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

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

图二：

请求参数

Query 参数

Header 参数

Body 参数application/json

示例

{
    "czlx": "3",
    "sfrz": {
        "client_id": "string",
        "client_secret": "string",
        "timestamp": "string"
    },
    "sjd": {
        "fpqqlsh": "string",
        "ddh": "string",
        "hsbz": "string",
        "hzqrdbh": "string",
        "kpzl": "string",
        "kplx": "string",
        "zsfs": "string",
        "qdbz": "string",
        "bz": "string",
        "yfpdm": "string",
        "yfphm": "string",
        "xhf_nsrsbh": "string",
        "xhf_mc": "string",
        "xhf_dz": "string",
        "xhf_dh": "string",
        "xhf_yhzh": "string",
        "ghf_nsrsbh": "string",
        "ghf_mc": "string",
        "ghf_sj": "string",
        "ghf_openid": "string",
        "ghf_dzdh": "string",
        "ghf_yhzh": "string",
        "gmfzrrbs": "string",
        "kpy": "string",
        "sky": "string",
        "fhr": "string",
        "hjbhsje": "string",
        "kphjse": "string",
        "jshjje": "string",
        "cezslxDm": "string",
        "kce": "string",
        "cepzmxList": [
            {
                "pzlx": "string",
                "fphm": "string",
                "fpdm": "string",
                "zzfphm": "string",
                "pzhm": "string",
                "kjrq": "string",
                "pzhjje": "string",
                "bckcje": "string",
                "bz": "string"
            }
        ],
        "tdyslxDm": "string",
        "bdczyTdys": {
            "cqzsh": "string",
            "bdcdz": "string",
            "bdcjtdz": "string",
            "zlqq": "string",
            "zlqz": "string",
            "kdsbz": "string",
            "dw": "string"
        },
        "bdcTdys": {
            "wqhtbabh": "string",
            "bdcdz": "string",
            "bdcjtdz": "string",
            "kdsbz": "string",
            "tdzzsxmbh": "string",
            "hdjsjg": "string",
            "sjcjhsje": "string",
            "cqzsh": "string",
            "dw": "string"
        },
        "lkysList": [
            {
                "qyd": "string",
                "ddd": "string",
                "cxr": "string",
                "cxrq": "string",
                "sfzjlx": "string",
                "sfzjhm": "string",
                "jtgjlx": "string",
                "dengj": "string"
            }
        ],
        "jzfwTdys": {
            "jzfwfsd": "string",
            "jzfwfsdjtdz": "string",
            "jzxmmc": "string",
            "tdzzsxmbh": "string",
            "kdsbz": "string",
            "kqysssxbyglbh ": "string"
        },
        "hwysfwdzfpmxbList": [
            {
                "qyd": "string",
                "ddd": "string",
                "ysgjzl": "string",
                "ysgjhp": "string",
                "yshwmc1": "string"
            }
        ],
        "items": [
            {
                "xmlx": "string",
                "xmdw": "string",
                "xmmc": "string",
                "xmsl": "string",
                "xmdj": "string",
                "xmje": "string",
                "sl": "string",
                "ggxh": "string",
                "se": "string",
                "taxcode": {
                    "kce": "string",
                    "lslbs": "string",
                    "qyzbm": "string",
                    "ssflbm": "string",
                    "ssyhzc": "string",
                    "ssyhzcnr": "string"
                },
                "hh": "string",
                "sm": "string"
            }
        ],
        "ghf_email": "string",
        "sgfp": "string",
        "hcyy": "string",
        "dylppz": "string",
        "dylpkprq": "string",
        "sfzsgmfyhzh": "string",
        "sfzsxsfyhzh": "string",
        "ncpsgzjlx": "string",
        "kjly": "string",
        "jazslxDm": "string",
        "sfzsxsfdzdh": "string",
        "sfzsgmfdzdh": "string"
    },
    "fjys": [
        {
            "fjysmc": "string",
            "fjyslx": "string",
            "fjysnr": "string"
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-dev.piaozone.com/test/?name=&reqid=&taxNo=&clientId=&paperInvoiceFlag=&invoiceCopyType=2' \
--header 'Content-Type: application/json' \
--data-raw '{
    "czlx": "3",
    "sfrz": {
        "client_id": "string",
        "client_secret": "string",
        "timestamp": "string"
    },
    "sjd": {
        "fpqqlsh": "string",
        "ddh": "string",
        "hsbz": "string",
        "hzqrdbh": "string",
        "kpzl": "string",
        "kplx": "string",
        "zsfs": "string",
        "qdbz": "string",
        "bz": "string",
        "yfpdm": "string",
        "yfphm": "string",
        "xhf_nsrsbh": "string",
        "xhf_mc": "string",
        "xhf_dz": "string",
        "xhf_dh": "string",
        "xhf_yhzh": "string",
        "ghf_nsrsbh": "string",
        "ghf_mc": "string",
        "ghf_sj": "string",
        "ghf_openid": "string",
        "ghf_dzdh": "string",
        "ghf_yhzh": "string",
        "gmfzrrbs": "string",
        "kpy": "string",
        "sky": "string",
        "fhr": "string",
        "hjbhsje": "string",
        "kphjse": "string",
        "jshjje": "string",
        "cezslxDm": "string",
        "kce": "string",
        "cepzmxList": [
            {
                "pzlx": "string",
                "fphm": "string",
                "fpdm": "string",
                "zzfphm": "string",
                "pzhm": "string",
                "kjrq": "string",
                "pzhjje": "string",
                "bckcje": "string",
                "bz": "string"
            }
        ],
        "tdyslxDm": "string",
        "bdczyTdys": {
            "cqzsh": "string",
            "bdcdz": "string",
            "bdcjtdz": "string",
            "zlqq": "string",
            "zlqz": "string",
            "kdsbz": "string",
            "dw": "string"
        },
        "bdcTdys": {
            "wqhtbabh": "string",
            "bdcdz": "string",
            "bdcjtdz": "string",
            "kdsbz": "string",
            "tdzzsxmbh": "string",
            "hdjsjg": "string",
            "sjcjhsje": "string",
            "cqzsh": "string",
            "dw": "string"
        },
        "lkysList": [
            {
                "qyd": "string",
                "ddd": "string",
                "cxr": "string",
                "cxrq": "string",
                "sfzjlx": "string",
                "sfzjhm": "string",
                "jtgjlx": "string",
                "dengj": "string"
            }
        ],
        "jzfwTdys": {
            "jzfwfsd": "string",
            "jzfwfsdjtdz": "string",
            "jzxmmc": "string",
            "tdzzsxmbh": "string",
            "kdsbz": "string",
            "kqysssxbyglbh ": "string"
        },
        "hwysfwdzfpmxbList": [
            {
                "qyd": "string",
                "ddd": "string",
                "ysgjzl": "string",
                "ysgjhp": "string",
                "yshwmc1": "string"
            }
        ],
        "items": [
            {
                "xmlx": "string",
                "xmdw": "string",
                "xmmc": "string",
                "xmsl": "string",
                "xmdj": "string",
                "xmje": "string",
                "sl": "string",
                "ggxh": "string",
                "se": "string",
                "taxcode": {
                    "kce": "string",
                    "lslbs": "string",
                    "qyzbm": "string",
                    "ssflbm": "string",
                    "ssyhzc": "string",
                    "ssyhzcnr": "string"
                },
                "hh": "string",
                "sm": "string"
            }
        ],
        "ghf_email": "string",
        "sgfp": "string",
        "hcyy": "string",
        "dylppz": "string",
        "dylpkprq": "string",
        "sfzsgmfyhzh": "string",
        "sfzsxsfyhzh": "string",
        "ncpsgzjlx": "string",
        "kjly": "string",
        "jazslxDm": "string",
        "sfzsxsfdzdh": "string",
        "sfzsgmfdzdh": "string"
    },
    "fjys": [
        {
            "fjysmc": "string",
            "fjyslx": "string",
            "fjysnr": "string"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

示例

{"business_id":"","ddh":"3973283AC7B5884196D8","description":"开具成功","device_info":{"card_no":"661532817749","subid":0,"taxcode":"440301999999030"},"errcode":"0","is_duplicate":false,"lists":[{"description":"开具成功","errcode":"4011","fpdm":"044031800105","fphm":"00412435","hjbhsje":"100.00","jshjje":"113.00","jym":"76820754360221005394","kphjse":"13.00","kprq":"2021-09-22 16:12:59","pdfurl":"","qdbz":"0"}]}

1. 发票金额算法：#

1.1 蓝票算法：#

1.2 红票算法：#

2. 明细项:#

3. 误差规则#

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

4.1 正数发票#

4.2 负数发票#

4.3 关于发票红冲#

4.4 税收分类编码#

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