- 所有接口通用的请求格式
| HTTP请求URL |
https://fpkj.market.alicloudapi.com/kpgl/fpkj |
| 请求方式 |
POST |
| 接口请求头部信息ContentType |
application/x-www-form-urlencoded;charset=UTF-8 |
| HTTP请求参数格式 |
DATA |
| HTTP返回参数格式 |
JSON |
2、全电发票开具接口
接口地址:
https://fpkj.market.alicloudapi.com/kpgl/fpkj
参数
token=&data=[发票报文json的base64]&spid=
说明：(注意：data有个[])，发票内容见下面内容
| 字段 |
描述 |
| data |
发票报文json的base64，同时需要对base64用[]括号起来 |
| spid |
税盘id |
发票报文JSON如下（注意：报文节点全大写）：
[{
"XTLSH": "单据号",
"KHMC": "客户名称",
"KHSH": "税号",
"KHDZ": "地址",
"KHKHYHZH": "客户银行账号",
"FPZL": "发票种类",
"BZ": "备注",
"KPR": "开票人",
"SKR": "收款人",
"FHR": "复核人",
"QYKHYHZH": "企业开户银行账号",
"QYDZDH": "企业地址电话",
"YFPHM": "红冲原发票号",
"XXBBH": "信息表编号",
"QDBZ": "清单标志",
"KHYJ": "客户邮件",
"KHSJ": "客户手机号",
"JDC": "机动车标识",
"DBTS": "代办退税标识",
"ITEM": [{
"CPMC": "产品名称1",
"CPXH": "产品型号",
"CPDW": "产品单位",
"SL": "税率",
"CPSL": "数量",
"BHSJE": "不含税金额",
"SE": "税额",
"FLBM": "分类编码",
"XSYH": "税率优惠",
"LSLBZ": "零税率标识",
"YHSM": "优惠说明",
"KCJE":"0"
}, {
"CPMC": "产品名称2",
"CPXH": "产品型号",
"CPDW": "产品单位",
"SL": "税率",
"CPSL": "数量",
"BHSJE": "不含税金额",
"SE": "税额",
"FLBM": "分类编码",
"XSYH": "税率优惠",
"LSLBZ": "零税率标识",
"YHSM": "优惠说明",
"KCJE":"0"
}]
}]
| 字段 |
是否必需（否的节点，可以不带此节点） |
描述 |
说明 |
| XTLSH |
是 |
单据号（相当于订单号） |
唯一字段 |
| KHMC |
是 |
客户名称 |
|
| KHSH |
否 |
客户税号 |
|
| KHDZ |
否 |
客户地址 |
|
| KHKHYHZH |
否 |
开户银行账号 |
|
| FPZL |
是 |
发票种类 |
020 全电专票 021 全电普票 |
| BZ |
否 |
备注 |
|
| KPR |
否 |
开票人 |
|
| SKR |
否 |
收款人 |
|
| FHR |
否 |
复核人 |
|
| QYKHYHZH |
否 |
销方银行账号 |
|
| QYDZDH |
否 |
销方地址电话 |
|
| YFPHM |
条件是 |
原发票号(原发票代码+原发票号码) |
红字发票必传，普票和电票必有，注意：含（代码）总共18位或20位。 |
| XXBBH |
条件是 |
信息表编号 |
红字专票必传，普票电票不需要传。 |
| QDBZ |
否 |
清单标志 |
默认为0 |
| KHYJ |
否 |
客户邮件 |
自动发邮件 |
| KHSJ |
否 |
客户手机 |
|
| JDC |
否 |
机动车标识 |
1为开具机动车专票 |
| DBTS |
否 |
代办退税标识 |
1为开具代办退税发票 |
| ITEM信息 |
|||
| CPMC |
是 |
产品名称 |
如果是折扣行，必需与正数行一致的名称 |
| CPXH |
否 |
产品型号 |
如果是折扣行，此值为空 |
| CPDW |
否 |
产品单位 |
如果是折扣行，此值为空 |
| SL |
是 |
税率 |
|
| CPSL |
否 |
产品数量 |
红冲时为负，红冲时，不能有正数金额。 |
| BHSJE |
是 |
不含税金额 |
红冲时为负 |
| SE |
是 |
税额 |
红冲时为负 |
| FLBM |
是 |
分类编码 |
必需到未级编码 |
| XSYH |
否 |
税收优惠 |
有优惠1 无优惠0 |
| LSLBZ |
否 |
零税率标识 |
SL=0时需要设置 1、免税（同时XSYH需设置成1），2、不征税（同时XSYH需设置成1），3、其它或0税率 Sl<>0时，值为空 |
| YHSM |
否 |
优惠政策说明 |
|
| KCJE |
否 |
扣除金额 |
差额开票时有用 |
{
"Reulst": "1",
"Message": "",
"SucessList": [{
"xtlsh": "001",
"fpzl": "",
"fpdm": "1233456789012",
"fphm": "12345678",
"kprq": "2023-01-12T11:20:33",
"skm": "税控码",
"jym": "校验码",
"ewm": "二维码",
"url": "",
"kpjg": "",
"kpfk": ""
}],
"ErrList": [{
"XTLSH": "",
"ErrMsg": ""
}]
}
注意：
Result=0时，说明数据肯定是有异常或流程有异常，此时需要关注下Message这个值。
Result=1时，不代表一定是开票成功，当离线开票或税盘不在线时可能代表接收成功，如果是批量开票时，还需要关注下ErrList这个值，此时有可能是部份成功，部份不成功。
唯一能确定开票成功开票的情况： SucessList列表并且发票号不是为空的情况，如果Result=1并且SucessList列表中返回的发票号码是空的，需要用异步获取开票结果进行获取开票状态。