进项发票接口文档
（v2.4.0）
2024年2月
1、 通信约定
- 所有的调用都采用POST方式。
- 除了获取token接口外，都需要参数token（小写）
- 路径中不含127.0.0.1的参数路径前加前缀http://invoice.xinshui.com.cn，不是以JSON进行传送，表单方式提交值： 参数1=值1&参数2=值…… 方式传送，含有127.0.01的，都是以JSON进行传送。
- Content-Type：application/x-www-form-urlencoded;charset=UTF-8。
- 返回值是以JSON形式返回，返回值中都有Result和Message节点，Result=1时，表示调用成功，0表示失败，Message,为调用信息。
- 参数都是用小写，如果文档自动转换成大写，请忽略大写。
- 需要进行base64加密的报文，比如：FPKJ中的data参数，JSON节点都用大写。
- 参数字段说明中，如果没有 “是否必需” 这一列，说明是必需要有的。
- POSTMAN的具体调用如下：
- 所有用到Base64的地方，都采用utf-8字符集加密。
- token是需要放在head头部。
2、获取token
说明：
获取平台token，有效期为一年，每次新的登陆会停止原有的token，在调用业务api时，如果返回中有Code字段（c是大写），并且Code值在2001-2009范围 ，那么需要重新获取一次token。
路径：
http://invoice.xinshui.com.cn/NEWKP/LOGIN/GetToken
参数：
UserName=[用户名]&Password1=[密码]
请求示例：
UserName=TEST&Password1=Aa123456
返回值：
{
“Result”: “1”,
“Message”: “系统登陆成功。”,
“ID”: “[mOqngQUp9/IS5qvk5VuiUZoViBuHCN787eXqq0HcopVCdw43ZKyS8uz10lRwlsu7STs4ckgbKvaqZfvi5IRdYT5MvswRBUuWhijy0MtCyDZ/GLsg0wTSh//Jh Kt/6w9/n7FKCmhTFt1FRff4ESG8BgdEYVxGq/hg3P ssuWoIE=~1064deb4d310430490cfa8237e4d5d84~190ACA1704AF55AA9FE1E8DE908C11044820A1B6C0E56F1E]”
}
返回值说明：
1、获取到的ID,用于以下接口的header头的token参数。
2、获取到的ID,前后是有[]括起来的，请不要去掉中括号。
3、所有接口头部都需要加上token,如下图：
3.进项发票接口调用
接口地址: http://invoice.xinshui.com.cn/api/jcsk
请求头: Content-Type application/json;charset=UTF-8
body参数: json
| 序号 | 参数 | 类型 | 示例 | 注释 |
| 1 | kprqq | 日期起始 | 2024-10-01 | |
| 2 | kprqz | 日期截止 | 2024-10-31 | |
| 3 | dfnsrsbh | 税号 | 914301000558414990 | |
| 4 | sjlx | 数据类型 | 1 | 1:进项 2:销项 |
| 5 | fplx | 发票类型 | 81:数电专票82:数电普票83:机动车销售电子统一发票87:纸质发票(机动车销售统一发票)84:二手车销售电子统一发票85:纸质专票(数电开具)86:纸质普票(数电开具)08:增值税电专10:增值税电普01:增值税专票04:增值税普票03:机动车销售统一发票15:二手车销售统一发票51:数电发票(铁路电子客票)61:数电发票(航空运输电子客票行程单)88:纸质发票(二手车销售统一发票)02:货物运输业增值税专用发票注意:数电专票(机动车)发票只能传 81或者 85 | |
| 6 | fpzt | 发票状态 | 0:正常 1:已作废 2:已红冲 | |
| 7 | fphm | 发票号码 | 20位 | 传发票号码时其他参数不做验证 |
| 8 | fileDown | 是否下载成功 | 传1只获取下载三个板式文件成功的发票数据 | |
| 9 | token | 授权的token | ||
| 10 | pageindex | 签页 | 1 | |
| 11 | pagesize | 页面大小 | 500 |
示例json:
{
“kprqq”: “2024-10-01”,
“kprqz”: “2024-10-31”,
“dfnsrsbh”: “914301000558414990”,
“sjlx”: “1”,
“fplx”: “”,
“fpzt”: “”,
“fphm”: “”,
“fileDown”: “1”,
“token”:””,
“pageindex”: 1,
“pagesize”: 500
}
返回json:
{
“ContentEncoding”: null,
“ContentType”: null,
“Data”: {
“code”: 0,
“message”: “成功 SELECT * FROM XZFPSJBT where dfnsrsbh =:spid and jxbz = :jxbz and fphm = :fphm order by xh==b742ecb4889543cea4c2e1025b7e6a09”,
“data”: {
“FPJCXX”: [
{
“XH”: “1”,
“FPDM”: “”,
“FPHM”: “25137000000007109805”,
“SDFPHM”: “25137000000007109805”,
“XFSBH”: “130923199604094313”,
“XFMC”: “郑淑行”,
“GFSBH”: “91130923MA07L9GL6J”,
“GMFMC”: “国网河北省电力有限公司东光县供电分公司”,
“KPRQ”: “2025-01-05 08:43:26”,
“JE”: “318.28”,
“SE”: “0”,
“FPLY”: “增值税发票管理系统”,
“FPPZ”: “82”,
“FPZT”: “0”,
“FPFXDJ”: “正常”,
“KPR”: “陈金迎”,
“BZ”: “1300769913203 202412”,
“SJURL”: “”,
“MX”: [
{
“XH”: “1”,
“FPDM”: “”,
“FPHM”: “25137000000007109805”,
“SDPHM”: “25137000000007109805”,
“SSFLBM”: “1100101010600000000”,
“HWHYSLWMC”: “*发电*光伏上网电费”,
“TDYWLX”: “”,
“GGXH”: “”,
“DW”: “千瓦时”,
“SL”: “807”,
“DJ”: “0.3643990087”,
“JE”: “294.07”,
“SLV”: “0”,
“SE”: “0”
},
{
“XH”: “2”,
“FPDM”: “”,
“FPHM”: “25137000000007109805”,
“SDPHM”: “25137000000007109805”,
“SSFLBM”: “1100101010600000000”,
“HWHYSLWMC”: “*发电*光伏中央补助”,
“TDYWLX”: “”,
“GGXH”: “”,
“DW”: “千瓦时”,
“SL”: “807”,
“DJ”: “0.03”,
“JE”: “24.21”,
“SLV”: “0”,
“SE”: “0”
}
],
“GMFDZDH”: “”,
“GMFYHZH”: “”,
“XFDZDH”: “”,
“XFYHZH”: “”,
“JYM”: “”,
“SSQ”: “”,
“GXSJ”: “”,
“GXZTDM”: “”,
“YXDKSE”: “”
}
],
“total”: 1,
“XZLJ”: “https://fptb.51dzfp.cn/DZFP/DownloadFile/20250205181854024413”
}
},
“JsonRequestBehavior”: 0,
“MaxJsonLength”: 2147483647,
“RecursionLimit”: null
}
字段释义:
XH:序号
FPDM:发票代码
FPHM:发票号码
SDFPHM:数电发票号码
XFSBH:销售方税号
XFMC:销售方名称
GFSBH:购方税号
GMFMC:购买方名称
KPRQ:开票时间
JE:金额
SE:税额
FPLY:发票来源
FPPZ:发票种类
FPZT:发票状态
FPFXDJ:发票状态
KPR:开票人
BZ:备注
SJURL:税局下载链接
SSFLBM:税收分类编码
HWHYSLWMC:产品名称
TDYWLX:特定业务类型
GGXH:型号
DW:单位
SL:数量
DJ:单价
JE:金额
slv:税率
SE:税额
GMFDZDH:购买方地址电话
GMFYHZH:购买方银行账号
XFDZDH:销方地址电话
XFYHZH:销方银行账号
JYM:校验码
XZLJ:获取的所有发票数据的下载链接(当查询的数据存在未下载完成时 返回为空)
