发票云组件服务(开票)API说明文档

一、概述

文档概述

1.1目的

本文档旨在编写一个面向开发者的完整的API调用规范，供需要调用票无忧功能的开发者使用。本文档不包括API具体的实现细节。

1.2适用范围

本文档适用阅读人员包括：发票云的设计、开发人员，合作伙伴。
适用于航天信息金税盘或百望税控盘设备。
适用发票云组件版本：1.2.4或更新

1.3调用方式

接口均为POST方式，只支持Content-Length报文编码，不支持Chunk编码
所有接口均使用UTF-8编码请求与返回2.22二手车-发票开具

IP直连方式
适用于局域网内的HTTP调用方式，默认端口为61624

通过接口长连接方式调用
接口地址：
https://wss.piaozone.com/bill-websocket/invoicewebsocket/push

如clientsecret（发票云授权信息）为3de1f420ed08409bbc3d4b9a156b4945， 盘号为3312345667，则；链接地址为https://wss.piaozone.com/bill-websocket/invoicewebsocket/push?name=3de1f420ed08409bbc3d4b9a156b49453312345667

请求参数：

1.4接口认证方式

接口认证均使用sfrz字段中的认证信息

认证示例1：

"sfrz":{
    "client_id":"",
    "client_secret":""
}

认证示例2：

"sfrz":{
    "client_id":"",
    "timestamp":"",
    "signature":""
}

二、组件税控开票接口

纸质发票操作接口

支持的发票类型

2.1获取税盘信息

说明：
获取税盘设备信息。

请求参数：

请求示例：

{
"czlx":"7"
"sfrz":{...}
}

返回：

返回示例：

{
    "errcode": "0000",
    "description": "操作成功",
    "qymc": "测试企业",
    "qynsrsbh": "123456789012345678",
    "qydzdh": "",
    "qykhhjzh": "",
    "jsph": "614425321568",
    "jspjh": "0",
    "csbz": "1",
    "ssbz": "0",
    "ptfpsyfs": "",
    "ptfpdm": "",
    "ptfphm": "",
    "ptfpkpxe": "",
    "normal_papery_volumn": [
        {
            "invoice_code": "",
            "invoice_num": "",
            "remainder": 0,
            "amount": 0,
            "purchase_date": "2019-08-02",
            "purchase_person": ""
        }
    ]，
    "special_papery_volumn": []
}

2.2读取票种信息

说明：
读取票种信息，包含代码、号码、限额等信息

请求参数：

请求示例

{
    "sfrz":{...}
    "czlx":"30"，
    "invoice_type":"0"
}

返回：

返回示例：

{
"errcode":"0000",
"description":"操作成功",
"info":{
    "invoice_code":"012345678912",
    "invoice_num":"12345678",
    "remainder":100,
    "max_limit":"999999.99"
}
"volumn":[
    "invoice_code":"012345678912",
    "invoice_num":"12345678",
    "remainder":100,
    "amount":100,
    "purchase_date":"2019-08-09",
    "purchase_person":"张三",
]
}

2.3发票开具

说明：
发票开具

请求参数：

税收分类编码部分内容请参照税务局发布的最新相关文档

请求示例

{
    "czlx": "3",
    "sfrz":{...},
    "sjd": {
        "fpqqlsh": "cloud1553853372839",
        "hsbz": "0",
        "kpzl": "2",
        "kplx": "0",
        "qdbz": "0",
        "bz": "bbbbb",
        "yfpdm": "",
        "yfphm": "",
        "xhf_nsrsbh": "440301999999980",
        "xhf_mc": "航信培训企业",
        "xhf_dz": "北京市西城区北礼士路135号",
        "xhf_dh": "18681537039",
        "xhf_yhzh": "中国银行 5218666611118888",
        "ghf_nsrsbh": "440300618884098",
        "ghf_mc": "深圳证券信息有限公司",
        "ghf_sj": "13255556666",
        "ghf_openid": "",
        "ghf_dzdh": "南山区 075544512569",
        "ghf_yhzh": "高新园支行 6220252166542352",
        "kpy": "sam_lee",
        "sky": "sdr",
        "fhr": "fdr",
        "hjbhsje": "100",
        "kphjse": "16",
        "jshjje": "116",
        "items": [
            {
                "xmlx": "0",
                "xmdw": "kg",
                "xmmc": "",
                "xmsl": "2",
                "xmje": "100.00",
                "ggxh": "10",
                "se": "16.00",
                "taxcode": {
                    "kce": "",
                    "lslbs": "",
                    "qyzbm": "",
                    "ssflbm": "1010111010000000000",
                    "ssyhzc": "0",
                    "ssyhzcnr": ""
                },
                "sl": "0.16",
                "xmdj": "50"
            }
        ]
    }
}

返回：

字段	类型	描述
errcode	string	0：成功 其他：失败
description	string	描述
ddh	string	订单号，请求中的流水号(fpqqlsh)为20位时ddh与流水号相同，否则将生成一个新的ddh
business_id	string	单据编号，和请求信息中的ddh一致
is_duplicate	bool	是否是重复流水号，若是则会返回上一次的开票结果
device_info	object	开票设备信息对象
taxcode	string	税控设备税号
subid	int	税控设备分机号
card_no	string	税控设备编号 （税盘上带有xx-的一串数字，card_no不带'xx-'字符）
lists	array	兼容原因此处为数组，取第一条记录即可
fpdm	string	发票代码
fphm	string	发票号码
kprq	string	开票日期 yyyy-MM-DD hhss
hjbhsje	string	开票金额（不含税）
kphjse	string	税额
jshjje	string	价税合计
qdbz	string	清单标识 0：非清单 1：清单
pdfurl	string	pdf下载地址(只有电子发票才有pdf地址)
jym	string	校验码

返回示例

{
    "errcode": "0",
    "description": "开具成功",
    "ddh": "980ee3e1f22b44eb919a8f383d9adf7c",
    "is_duplicate":false,
    "device_info":{
        "card_no": "661626708050",
        "taxcode":"",
        "subid":0
    }
    "lists": [
        {
            "description": "开具成功",
            "errcode": "4011",
            "seller_taxcode":"",
            "seller_tax_subid":0,
            "fpdm": "",
            "fphm": "",
            "hjbhsje": "",
            "jshjje": "",
            "kphjse": "",
            "kprq": "2019-05-20 00:00:00",
            "pdfurl": "",
            "qdbz": "0",
            "jym":"",
            "business_id":""
        }
    ]
}

2.4发票作废

说明：
发票作废

请求参数：

请求示例

{
    "czlx":"6"，
    "sfrz":{...},
    "sjd":{
        "kpzl":"2",
        "fpdm":"0012345678",
        "fphm":"12345678",
        "zfr":"张三"
    }    
}

返回：

2.5发票查询

说明：
发票查询

请求参数：

请求示例

{
    "czlx":"5"，
     "sfrz":{...},
    "sjd":{
        "kpzl":"2",
        "fpdm":"0012345678",
        "fphm":"12345678",
    }
}

返回：

字段	类型	描述
errcode	string	0：成功 其他：失败
description	string	描述
sjd	object	查询发票信息
fpdm	string	查询发票的代码
fphm	string	查询发票的号码
kpzl	string	查询发票的类型
yfpdm	string	原发票的代码
yfphm	string	原发票的号码
ddh	string	订单号
kprq	string	开票日期 yyyy-MM-DD hhss
hjbhsje	string	合计金额（不含税）
kphjse	string	合计税额
xhf_mc	string	销售方名称
xhf_nsrsbh	string	销售方纳税人识别号
xhf_dzdh	string	销售方地址电话
xhf_yhzh	string	销售方银行账号
ghf_mc	string	购货方名称
ghf_nsrsbh	string	购货方纳税人识别号
ghf_dzdh	string	购货方地址电话
ghf_yhzh	string	购货方银行账号
bz	string	备注
kpy	string	开票员
sky	string	收款人
fhr	string	复核人
zfbz	string	作废标识 0：未作废 1：已作废
items	object	发票明细行信息
sm	string	税目
xmlx	string	明细类型 0：正常行（默认） 1：折扣行 2：被折扣行
xmmc	string	商品名称
xmdw	string	单位
ggxh	string	规格型号
xmsl	string	数量
xmdj	string	单价
sl	string	税率 （小数 如17%即为0.17）
xmje	string	金额
se	string	税额
taxcode	object	税收分类编码
kce	string	扣除额
lslbs	string	零税率标识
qyzbm	string	企业自编码
ssflbm	string	税收分类编码
ssyhzc	string	税收优惠政策 0：不享受优惠政策 1：享受优惠政策
ssyhzcnr	string	税收优惠政策具体内容

2.6发票打印

说明：
发票打印

请求参数：

请求示例

{
    "czlx":"4"，
     "sfrz":{...},
    "sjd":{
        "kpzl":"2",
        "fpdm":"0012345678",
        "fphm":"12345678",
        "ylbz":"0",
        "print_type":"0"
    }
}

返回：

2.7专用发票申请红字信息表

说明：
专用发票申请红字信息表

请求参数：

请求示例

    {
    "czlx": "20",
    "sfrz":{...},
    "sjd": {
        "fpdm": "4403092140",
        "fphm": "01626009",
        "ghf_mc": "金蝶软件",
        "ghf_nsrsbh": "110101MXB6CK9Q6",
        "hjbhsje": "-85.47",
        "hjse": "-14.53",
        "hsbz": "1",
        "items": [
            {
                "ggxh": "1",
                "se": "-14.53",
                "sl": "0.17",
                "taxcode": {
                    "bmbb": "12.0",
                    "kce": "",
                    "lslbs": "",
                    "qyzbm": "1040201100000000000",
                    "ssflbm": "1040201100000000000",
                    "ssyhzc": "0",
                    "ssyhzcnr": ""
                },
                "xmdj": "100",
                "xmdw": "dw",
                "xmje": "-100.00",
                "xmmc": "应税劳务1",
                "xmsl": "-1"
            }
        ],
        "sqsm": "2",
        "szlb": "1",
        "tkrq": "2017-07-05",
        "kprq": "2017-04-01",
        "xhf_mc": "深圳航信电子发票测试",
        "xhf_nsrsbh": "440300349724458",
        "xxblx": "0"
    }
}

返回：

2.8查询专用发票申请红字信息表

说明：
查询专用发票申请红字信息表。

请求参数：

请求示例

{
    "czlx": "18",
    "sfrz": {},
    "sjd": {
        "kjf_jh": "0",
        "kjf_nsrsbh": "91440300672996293K",
        "kjf_sbbh": "",
        "qstkrq": "",
        "jstkrq": "",
        "xhf_nsrsbh": "91440300672996293K",
        "ghf_nsrsbh": "914403006188392540",
        "xxbbh": "",
        "xzfw": "0",
        "yqzt": "N",
        "pageno": "1",
        "pagesize": "10"
    }
}

返回：

申请说明

    购方申请：
        0：蓝字发票已抵扣
        1：无法认证
        2：纳税人识别号认证不符
        3：增值税专用发票代码、号码认证不符
        4：所购货物不属于增值税扣税项目范围
    销方申请：
        5：因开票有误，购买方拒收的
        6：因开票有误等原因尚未交付的

    注：0:购方已抵扣，1-4：购方未抵扣，5-6：销方申请

返回示例

{
    "description": "查询成功",
    "errcode": "0000",
    "lists": [
        {
            "hzxxbm": "4403051706052197",
            "sqdh": "661540389318170610110520",
            "ztm": "TZD0072",
            "ztms": "已核销，待查证",
            "invoice": {
                "fpdm": "4403162130",
                "fphm": "70804523",
                "ghf_mc": "",
                "ghf_nsrsbh": "914403006188392540",
                "hjbhsje": "-188.03",
                "hsbz": "0",
                "items": [
                    {
                        "ggxh": "",
                        "se": "-31.97",
                        "sl": "0.17",
                        "taxcode": {
                            "bmbb": "12.0",
                            "kce": "",
                            "lslbs": "",
                            "qyzbm": "",
                            "ssflbm": "1040303020000000000",
                            "ssyhzc": "0",
                            "ssyhzcnr": ""
                        },
                        "xmdj": "220",
                        "xmdw": "件",
                        "xmje": "-188.03",
                        "xmmc": "双肩包",
                        "xmsl": "1"
                    }
                ],
                "jshjje": "-220.00",
                "kphjse": "-31.97",
                "kprq": "2017-05-31",
                "xhf_mc": "",
                "xhf_nsrsbh": "91440300672996293K"
            }
        }
    ]
}

2.9批量开票

说明：
批量开票

请求参数：

发票数据同2.3发票开具接口

返回：

字段	类型	描述
errcode	string	0000：全部成功 其他：失败
description	string	描述
count	int	开具失败的发票张数
device_info	object	开票设备信息对象
taxcode	string	税控设备税号
subid	int	税控设备分机号
card_no	string	税控设备编号 （税盘上带有xx-的一串数字，card_no不带'xx-'字符）
lists	array	结果数组
success	bool	是否开具成功 true：成功 false：开具失败
fpdm	string	发票代码
fphm	string	发票号码
orderid	string	订单号
kprq	string	开票日期 yyyy-MM-DD hhss
hjbhsje	string	开票金额（不含税）
kphjse	string	税额
jshjje	string	价税合计
qdbz	string	清单标识 0：非清单 1：清单
jym	string	校验码
business_id	string	单据编号，和请求信息中的ddh一致

2.10批量打印

说明：
批量打印

请求参数：

发票数据同2.6发票打印接口

返回：

2.11设置开票发票卷

当前只支持航信
当前仅有普票和卷票支持发票选卷功能

说明：
设置开票时所用的发票卷

请求参数：

请求示例

{
    "czlx":"23",
    "sfrz":{...},
    "sjd":{
        "fpdm":"150001201502",
        "fphm":"48010000",
        "kpzl":"41",
        "mrpj":0
    }
}

返回：

返回示例

{
    "description": "设置成功",
    "errcode": "0"
}

2.12机动车销售统一发票开具

金额信息精度均为小数点后两位

请求参数

请求示例

{
    "czlx": "40",
    "sfrz": {},
    "sjd": {
        "ori_code":"",
        "ori_num":"",
        "orderid":"",
        "business_id":"",
        "buyercode": "",
        "buyername": "",
        "idcard": "",
        "veh_kind": "",
        "brand": "",
        "place": "",
        "cert": "",
        "imp_cert": "",
        "com_inspect_no": "",
        "engine_no": "",
        "veh_no": "",
        "vd_name": "",
        "total": "",
        "taxrate": 6,
        "sellercode": "",
        "sellername": "",
        "sellerphone": "",
        "selleracc": "",
        "selleraddr": "",
        "sellerbank": "",
        "tonnage": "",
        "people_limit": "",
        "remark": "",
        "biller": "",
        "taxcode": {
            "deduction": "",
            "zerotag": "",
            "epno": "",
            "code": "",
            "taxpre": "0",
            "taxprecont": ""
        }
    }
}

返回：

字段	类型	描述
errcode	string	0000：成功 其他：失败
description	string	描述
is_duplicate	bool	是否是重复流水号，若是则会返回上一次的开票结果
device_info	object	开票设备信息对象 该信息只在开具单机版电子发票时有效
taxcode	string	税控设备税号
subid	int	税控设备分机号
data	object	返回信息
code	string	发票代码
number	string	发票号码
date	string	开票日期 yyyy-MM-DD hhss
total	string	价税合计
amt_nontax	string	不含税金额
tax	string	税额
business_id	string	调用方的业务单据编号

返回示例

{
    "errcode": "0000",
    "description": "",
    "is_duplicate": false,
    "device_info": {
        "taxcode": "",
        "subid": 0
    },
    "data": {
        "code": "",
        "number": "",
        "date": "yyyy-MM-dd hh:mm:ss",
        "total": "",
        "amt_nontax": "",
        "tax": "",
        "business_id": ""
    }
}

2.13机动车销售统一发票查询

说明：
机动车发票查询

请求参数：

请求示例

{
    "czlx":"41"，
     "sfrz":{...},
    "sjd":{
        "fpdm":"0012345678",
        "fphm":"12345678",
    }
}

返回：

2.14机动车销售统一发票红冲

说明：
根据发票代码号码红冲机动车类型发票

请求参数：

请求示例

{
    "czlx":"42"，
     "sfrz":{...},
    "sjd":{
        "fpdm":"0012345678",
        "fphm":"12345678",
    }
}

返回：

2.15寄送信息查询

说明：
查询发票申领人信息和寄送信息

请求参数：

请求示例

{
    "czlx":"50"
}

返回：

2.16核定票种查询

说明：
查询申领发票时的限制条件

请求参数：

请求示例

{
    "czlx":"51"
}

返回：

2.17发票申领

说明：
发票申领

请求参数：

注意：
1）申领人姓名为空,则默认使用税控系统中第一个申领人信息。
2）申领人姓名和证件号码必须同时为空或不为空。

请求示例

{
    "czlx": "52",
    "sjd":{
        "kpzl":"51",       
        "slfs":"1",          
        "slsm":"20200430",   
        "slrxm":"项少龙",          
        "slrzjhm":"440301100"
    }
}

返回：

返回示例

{
    "errcode": "0000",
    "description": "成功",
    "sjd":{
        "serial":"12345678"
    }
}

2.18发票申领结果查询

说明：
查询发票的申领结果

请求参数：

请求示例

{
    "czlx": "53",
    "sjd":{
        "kpzl":"51",
        "kssj":"20200401",
        "jzsj":"20200430",
        "slxh":"", 
        "clzt":""
    }
}

返回：

2.19数据抄报

说明：
发票汇总上报

请求参数：

请求示例

{
    "czlx": "36",
    "sjd":{
        "kpzl":"51",
        "zdqc":"1",
    }
}

注意：
1）发票类型如果为空,则默认对所有票种进行汇总上报
2）自动清卡,若该字段为0或不填,则默认不清卡

返回：

2.20批量查询发票

说明：
根据开票时间批量查找发票

请求参数：

请求示例

{
    "czlx": "38",
    "sjd":{
        "kpzl":"2",
        "kssj":"20200101",    //2020年1月1日
        "jzsj":"20200131"    //2020年1月31日
        "mysl":"1"            //每页数量(从1开始,0表示不分页,返回全部数据)
        "ymxh":"1"            //页码序号(从0开始，0标识第一页的数据)
    }
}

返回：

字段	类型	描述
errcode	string	0000：发票下载完成 0001：开始下载发票 0002：发票下载中 0003：没有查询到任何发票 0004：当前页没有查询到发票 9999：失败
description	string	描述
sjd	object	数据
zjsl	string	总计数量(符合条件的总发票数目)
dysl	string	当页数量(当前页的发票数量)
fpjh	array	发票集合
fpdm	string	查询发票的代码
fphm	string	查询发票的号码
kpzl	string	查询发票的类型
yfpdm	string	原发票的代码
yfphm	string	原发票的号码
ddh	string	订单号
kprq	string	开票日期 yyyy-MM-DD hhss
hjbhsje	string	合计金额（不含税）
kphjse	string	合计税额
xhf_mc	string	销售方名称
xhf_nsrsbh	string	销售方纳税人识别号
xhf_dzdh	string	销售方地址电话
xhf_yhzh	string	销售方银行账号
ghf_mc	string	购货方名称
ghf_nsrsbh	string	购货方纳税人识别号
ghf_dzdh	string	购货方地址电话
ghf_yhzh	string	购货方银行账号
bz	string	备注
secret	string	密码区
kpy	string	开票员
sky	string	收款人
fhr	string	复核人
zfbz	string	作废标识 0：未作废 1：已作废
items	object	发票明细行信息
sm	string	税目
xmlx	string	明细类型 0：正常行（默认） 1：折扣行 2：被折扣行
xmmc	string	商品名称
xmdw	string	单位
ggxh	string	规格型号
xmsl	string	数量
xmdj	string	单价
sl	string	税率 （小数 如17%即为0.17）
xmje	string	金额
se	string	税额
taxcode	object	税收分类编码
kce	string	扣除额
lslbs	string	零税率标识
qyzbm	string	企业自编码
ssflbm	string	税收分类编码
ssyhzc	string	税收优惠政策 0：不享受优惠政策 1：享受优惠政策
ssyhzcnr	string	税收优惠政策具体内容

返回示例

{
    "errcode": "0000",
    "description": "发票下载完成",
    "sjd":{
        "zjsl":"10",    //总计数量
        "dysl":"2",        //当页数量
        "dyxh":"0",        //当页序号
        fpjh[
            ....发票数据
        ],
        [
            ....发票数据
        ],
    }
}

2.21监控信息查询

说明：
查找税盘的监控信息

请求参数：

请求示例

{
    "czlx": "55",
    "sjd":{
        "kpzl":"0"
    }
}

返回：

2.22二手车-发票开具

说明：
仅支持航天信息金税盘

请求参数：

返回：

字段	类型	描述
errcode	string	0：开具成功 5000：开具失败
description	string	描述
is_duplicate	bool	是否为重复开票
device_info	object	开票设备信息对象
taxcode	string	税号
card_no	string	税控设备税号
subid	int	税控设备分机号
sjd	object	数据
cjhj	string	车价合计
fpdm	string	发票代码
fphm	string	发票号码
kpsj	string	开票时间(YYYY-DD-MM hhss 2021-10-14 1057)
lsh	string	流水号

2.23二手车-发票查询

说明：
仅支持航天信息金税盘

请求参数：

返回：

2.24二手车-发票红冲

说明：
仅支持航天信息金税盘

请求参数：

返回：

字段	类型	描述
errcode	string	0：开具成功 5000：开具失败
description	string	描述
device_info	object	开票设备信息对象
taxcode	string	税号
card_no	string	税控设备税号
subid	int	税控设备分机号
sjd	object	数据
cjhj	string	车价合计
fpdm	string	发票代码
fphm	string	发票号码
kpsj	string	开票时间(YYYY-DD-MM hhss 2021-10-14 1057)

2.25发票统计信息查询

请求参数：

返回：

2.26红字信息表撤销

（仅支持航信税盘和税务UKEY）

请求参数：

返回：

三、电子发票操作接口

电子发票接口根据所连接税盘的订货信息判断处理发票的类型，纸电一体开具单机盘电子发票，单机版纸票则开具托管电子发票
（单机版电子发票也可通过czlx=3的接口（2.3）开具）

3.1电子发票开具

说明：
开具电子发票

请求参数：

请求示例

{
    "czlx": "3",
    "sfrz":{...},
    "sjd": {
        "ddh": "cloud1553853372839",
        "hsbz": "0",
        "kplx": "0",
        "kpzl": "0",
        "qdbz": "0",
        "bz": "bbbbb",
        "yfpdm": "",
        "yfphm": "",
        "xhf_nsrsbh": "440301999999980",
        "xhf_mc": "航信培训企业",
        "xhf_dz": "北京市西城区北礼士路135号",
        "xhf_dh": "18681537039",
        "xhf_yhzh": "中国银行 5218666611118888",
        "ghf_nsrsbh": "440300618884098",
        "ghf_mc": "深圳证券信息有限公司",
        "ghf_sj": "13255556666",
        "ghf_openid": "",
        "ghf_dzdh": "南山区 075544512569",
        "ghf_yhzh": "高新园支行 6220252166542352",
        "kpy": "sam_lee",
        "sky": "sdr",
        "fhr": "fdr",
        "hjbhsje": "100",
        "kphjse": "16",
        "jshjje": "116",
        "items": [
            {
                "xmlx": "0",
                "xmdw": "kg",
                "xmmc": "",
                "xmsl": "2",
                "xmje": "100.00",
                "ggxh": "10",
                "se": "16.00",
                "taxcode": {
                    "kce": "",
                    "lslbs": "",
                    "qyzbm": "",
                    "ssflbm": "1010111010000000000",
                    "ssyhzc": "0",
                    "ssyhzcnr": ""
                },
                "sl": "0.16",
                "xmdj": "50"
            }
        ]
    }
}

返回字段：

返回示例

{
    "errcode": "0000",
    "description": "4011-开票成功[0000,]",
    "is_duplicate":false,
    "device_info":{
        "taxcode":"",
        "subid":0
    }
    "data": {
        "kdorgpdfurl": "",
        "serialnum": "14512120161208212119",
        "snapshoturl": "",
        "invoicenum": "10001312",
        "pdfurl": "",
        "invoicecode": "044001611111"
        "jym":"",
        "business_id":""
    }
}

3.2电子发票信息查询

说明：
电子发票信息查询

请求参数：

请求示例

{
    "czlx": "113",
    "sfrz": {},
    "sjd": {
        "fpqqlsh": ""
    }
}

返回字段

字段	类型	描述
errcode	string	0000：成功 其他：失败
description	string	描述
invoice	object	发票信息
xhf_mc	string	销方名称
xhf_nsrsbh	string	销方税号
xhf_dzdh	string	销方地址电话
xhf_yhzh	string	销方银行账号
fpqqlsh	string	流水号
yfpdm	string	原发票代码
yfphm	string	原发票号码
kprq	string	开票日期 yyyy-mm-dd hhss
hjbhsje	float	不含税金额
kphjse	float	合计税额
jshjje	float	价税合计
fpdm	string	发票代码
fphm	string	发票号码
ghf_mc	string	购方名称
ghf_nsrsbh	string	购方税号
ghf_yhzh	string	购方银行账号
ghf_dzdh	string	购方地址电话
ghf_sj	string	购方手机号
fhr	string	复核人
kpy	string	开票人
sky	string	收款人
pdf_url	string	pdf链接地址
checkcode	string	校验码
bz	string	备注
kplx	string	开票类型 0->正常发票 1->红冲发票
kpzl	string	发票类型 51：电子发票 61：电子专用发票
items	array	明细信息
xmdw	string	单位
ggxh	string	规格型号
se	float	税额
hsbz	float	含税标志 0->不含税 1->含税
xmmc	string	项目名称
xmdj	float	单价
xmsl	float	数量
xmje	float	金额
sl	float	税额 （小数）

返回示例

{
    "errcode": "0000",
    "description": "查询成功",
    "invoice": {
        "xhf_mc": "",
        "xhf_nsrsbh": "",
        "xhf_dzdh": "",
        "xhf_yhzh": "",
        "fpqqlsh": "",
        "ddh": "",
        "yfphm": "",
        "yfpdm": "",
        "kprq": "2017-01-06 16:23:02",
        "hjbhsje": 300,
        "kphjse": 51,
        "jshjje": 351,
        "fpdm": "",
        "fphm": "",
        "ghf_mc": "",
        "ghf_nsrsbh": "",
        "ghf_yhzh": "",
        "ghf_dzdh": "",
        "ghf_sj": "",
        "fhr": "",
        "kpy": "",
        "sky": "",
        "pdf_url": "",
        "checkcode": "",
        "kabao_url": "",
        "bz": "",
        "kplx": "0",
        "kpzl":"51",
        "zfbz": "",
        "fwm": "",
        "items": [
            {
                "xmdw": "dw",
                "ggxh": "1",
                "se": 17,
                "hsbz": 0,
                "xmmc": "",
                "xmdj": 100,
                "xmsl": 1,
                "xmje": 100,
                "sl": 0.17
            }
        ]
    }
}

3.3电子发票红冲

说明：
电子发票信息查询
接口优先使用“原蓝票代码号码”红冲，若代码或号码为空时，则使用原蓝票流水号红冲

请求参数：

请求示例

{
    "czlx": "114",
    "sfrz": {},
    "sjd": {
        "invoice_code":"x",
        "invoice_num":"x",
        "fpqqlsh": "",
        "new_fpqqlsh": "PJYHX20151112174201"
    }
}

返回字段
同电子发票开具接口3.1

返回示例
同电子发票开具接口3.1

3.4刷新PDF

说明：
按照代码号码或者流水号对当前PDF未生成的电子发票进行重新签章

（只有当前未生成PDF的发票才会进行重签）

请求参数：

{
    "czlx":"115"
    "sfrz":{...}
    "sjd":{
        "fpqqlsh":"",
        "fpdm":"",
        "fphm":""
    }
}

返回字段

返回示例

{
    "errcode":"",
    "description":""
}

3.5查询电子发票余量

说明：
查询已订货的电子发票的余量(仅支持托管电票查询)
请求参数：

{
"czlx":"116"
"sfrz":{...}
}

返回字段

返回示例

{
    "errcode":"",
    "description":"",
    "data":{
        "total":0
    }
}

四、其他功能

其他功能接口

4.1查询税收分类编码信息

说明：
根据分类编码查询简称等相关信息

请求参数：

请求示例

{
    "czlx": "504",
    "sfrz": {},
    "sjd": {
        "ssflbms":[
            {
                "ssflbm":""
            }
        ]
    }
}

返回字段

返回示例

{
    "errcode":"",
    "description":"",
    "ssflbms":[
        {
            "abbr":"",
            "ssflbm":""
        }
    ]
}

4.2发票拆分

说明：
对超限的发票数据进行拆分后得到多张限额内发票
当前拆分类型暂只支持按明细拆分

请求参数：

请求示例

{
    "czlx": "200",
    "sfrz":{...},
    "sjd": {
        "cf":{
            "limit":999.99,
            "remainder":10,
            "type":1,
        }
        "hsbz": "0",
        "hjbhsje": "100",
        "kphjse": "16",
        "jshjje": "116",
        "items": [
            {
                "xmlx": "0",
                "xmdw": "kg",
                "xmmc": "",
                "xmsl": "2",
                "xmje": "100.00",
                "ggxh": "10",
                "se": "16.00",
                "taxcode": {
                    "kce": "",
                    "lslbs": "",
                    "qyzbm": "",
                    "ssflbm": "",
                    "ssyhzc": "",
                    "ssyhzcnr": ""
                },
                "sl": "0.16",
                "xmdj": "50"
            }
        ]
    }
}

返回字段

返回示例

{
    "errcode": "0000",
    "description": "",
    "data": [{
        "hjbhsje": "",
        "kphjse": "",
        "jshjje": "",
        "hsbz": "0",
        "items": [{
            "xmlx": "",
            "xmdw": "",
            "xmmc": "",
            "xmsl": "",
            "xmje": "",
            "ggxh": "",
            "se": "",
            "sl": "",
            "xmdj": "",
            "taxcode": {
                "kce": "",
                "lslbs": "",
                "qyzbm": "",
                "ssflbm": "",
                "ssyhzc": "",
                "ssyhzcnr": ""
            }
        }]
    }]
}

4.3获取打印机列表

说明：
获取"金蝶发票管理应用程序"所在电脑的所有打印机连接信息

请求参数：

请求示例

{
    "czlx": "901"
}

返回字段

返回示例

"description": "获取打印机列表成功",
"errcode": "0000",
    "sjd": {
        "default_printer": "Microsoft Print to PDF",
        "printers": [
            {
                "name": "Microsoft Print to PDF"
            },
            {
                "name": "Foxit Reader PDF Printer"
            },
            {
                "name": "Foxit Phantom Printer"
            },
            {
                "name": "Fax"
            }
        ]
    }
}

五、附录

5.1税收分类编码

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

示例

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

5.2关于发票红冲

开具负数增值税普通发票

1.开具负数增值税普通发票，必须在备注中注明 对应正数发票代码:XXXXXXXXXX 号码:YYYYYYYY 字样，其中X为发票左上角10位或 12位代码数字，Y为发票右上角 8 位号码数字

开具负数增值税专用发票

2.开具负数增值税专用发票，必须在备注中注明开具红字增值税专用发票信息表编号XXXXXXXXXXXXXXXX，其中 X 为信息表编号。同时，数量、金额、税额为负数

3.开具货物运输发票的负数票备注中注明“ 开具红字货物运输业增值税专用发票信息表编号
XXXXXXXXXXXXXXX”，其中X 为信息表编号。

4.开具机动车销售统一发票的负数票需在备注中注明“对应正数发票代
码:XXXXXXXXXX 号码:YYYYYYYY”字样，其中“X”为发票左上角10 位
或12 位代码数字，“Y”为发票右上角8 位号码数字。