1、 通信约定
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:获取的所有发票数据的下载链接(当查询的数据存在未下载完成时 返回为空)
4.进项发票入账接口调用
接口地址: http://invoice.xinshui.com.cn/NEWKP/JXFP/CWRZ
body参数: json
请求头: Content-Type application/json;charset=UTF-8
| 字段 | 是否必填项 | 字符类型 | 描述 |
| spid | 否(平台提供) | 终端id(与企业税号不能同时为空) | |
| qysh | 否 | 企业税号(与终端id不能同时为空) | |
| data | 是 | list | |
| QDFPHM | 全电纸质发票号 | ||
| FPHM | 发票号码 | ||
| FPZL | 发票种类： 004纸质专票，007纸质普票，026电子普票，028电子专票， 020数电专票，021数电普票，022数电纸质专票，023数电纸质普票 | ||
| KPRQ | 开票日期 | ||
| KPJE | 不含税金额 | ||
| KPSE | 税额 | ||
| RZYT | 入账用途：已入账（企业所得税税前扣除）或，已入账（企业所得税不扣除） | ||
| token | 是(调用获取) |
示例json:
qysh=&data=[Base64编码]&token=
data格式：{"QDFPHM": "","FPHM": "","FPZL": "","KPRQ": "","KPJE": "","KPSE": "",
"RZYT": ""}转成base64
返回json:
{
"Result": "1",
"Message": "成功"
}
