1.1.5 移动采集对接
接口提供方:税务共享平台
接口调用方:业务系统
功能描述:通过URL访问到移动采集页面
请求URL: http:// 218.29.69.148:8081/oa/oaLogin.do (税务共享平台标准API服务接口,请求路径固定,主机和端口号根据实际部署部署)
请求样例:
移动端采集跳转:http://218.29.69.148:8081/oa/oaLogin.do?mm=5107f3c8ffc75d2ba1ceaafd153d0f52a29d0e9f7fd274ac mm明文:1001&201&DFD0001(gsdm&bmdm&yhdm) PC端采集跳转:http://218.29.69.148:8081/oa/oaLogin.do?mm=5107f3c8ffc75d2ba1ceaafd153d0f52a29d0e9f7fd274ac&from=1 mm明文:1001&201&DFD0001(gsdm&bmdm&yhdm) |
字段名 | 中文名 | 是否必传 | 类型 | 说明 |
mm | 密文 | 是 | string | 通过明文加密 |
yhdm | 用户代码 | 是 | string | |
bmdm | 部门代码 | 是 | string | |
gsdm | 公司代码 | 是 | string |
例:
String key = "91410800719115730E".getBytes(); // 秘钥 String gsdm = ""; String bmdm= ""; String ygdm= `"DFD0001"; String str = gsdm+"&"+bmdm+"&"+yhdm; // 明文 1001&A01&DFD0001 // 对明文加密得到 5107f3c8ffc75d2ba1ceaafd153d0f52a29d0e9f7fd274ac String mm= Robot.byteToHex(Robot.encryptMode(key, str.getBytes("UTF-8"))); // 对密文解密 String mw = new String(Robot.decryptMode(key, Robot.hexToBytes(mm))); |
1.1.1 个人采集发票查询
接口提供方:税务共享平台
接口调用方:业务系统
功能描述:税务共享平台将企业微信采集的发票信息进行保存,提供接口供客户方进行查询。终止日期取当天,起始日期=当天-180天
请求方式:POST
请求URL:http://10.0.0.196:8088/api/jxgl/dns/fyfpcx
请求样例:
{ "yhdm":"用户代码",(必填) "gsdm":"公司代码", "qsrq":"起始日期(格式:yyyy-mm-dd)", "zzrq":"终止日期(格式:yyyy-mm-dd)", "phone":"手机号", "xfmc":"销方名称", "xfsh":"销方税号" } |
字段说明
字段名 | 中文名 | 是否必传 | 类型 | 说明 |
phone | 手机号码 | 否 | string | 根据手机号查询 |
yhdm | 用户代码 | 是 | string | 报账人用户代码 |
bmdm | 部门代码 | 否 | string | 报账人所在部门代码 |
qsrq | 起始日期 | 否 | string | 发票采集的日期 |
zzrq | 终止日期 | 否 | string | 发票采集的日期 |
xfmc | 销方名称 | 否 | string | 销售方名称 |
xfsh | 销方税号 | 否 | string | 销售方税号 |
- 响应数据:
{ "msg": "成功", "code": "0", "data": [ { "fylxid": "104", "se": "0.00", "fpdm": "032002100304", "gfsh": "91410800719115730E", "fplxdm": "10101", "gfmc": "多氟多新材料股份有限公司", "kprq": "2021-10-29", "hsje": 466, "xfsh": "913213020518248510", "xfmc": "宿迁正道酒店管理有限公司", "hjje": "466.00", "fphm": "26598346" }, { "fylxid": "104", "se": 26.49, "fpdm": "3300211130", "gfsh": "91410800719115730E", "fplxdm": "10100", "gfmc": "多氟多新材料股份有限公司", "kprq": "2021-10-26", "hsje": 468, "xfsh": "91330102MA28TYD1X1", "xfmc": "杭州锦悦酒店有限公司", "hjje": 441.51, "fphm": "50625642" }, { "fylxid": "101", "se": 2.85, "fpdm": "", "gfsh": "", "fplxdm": "10200", "gfmc": "谢超", "kprq": "2021-11-12", "hsje": 34.5, "xfsh": null, "xfmc": "中国铁路", "hjje": 31.65, "fphm": "36L091939" } ] } |
字段名 | 中文名 | 是否必传 | 类型 | 说明 |
fpdm | 发票代码 | 否 | string | |
fphm | 发票号码 | 是 | string | |
fplxdm | 发票类型代码 | 是 | string | 10100-增值税专用发票 10101-增值税普通发票 10102-增值税电子普通发票 10103-增值税普通发票(卷票) 10107-电子专票 10200-火车票 10201-出租车票 10202-航空运输电子客票行程单 10203-客运票 10204 过路费发票 10300-定额发票 |
kprq | 开票日期 | 否 | string | |
gfmc | 购方名称 | 否 | string | |
gfsh | 购方税号 | 否 | string | |
xfmc | 销方名称 | 否 | string | |
xfsh | 销方税号 | 否 | string | |
hsje | 含税金额 | 是 | string | 发票票面金额 |
hjje | 合计金额 | 否 | string | 增值税发票不含税金额 |
se | 税额 | 否 | string |
1.1.2 单据绑定接口
功能描述:接收业务系统传过来采系统发票号和金税发票绑定关系。
请求方式:POST
请求URL:http://10.0.0.196:8088/api/jxgl/dns/ywdjbd
接收报文:
{ "djzt":"单据状态", "djbh":"单据编号", "sjly":"数据来源", "djlx":"单据类型", "hjse":"单据合计税额", "fpje":"单据合计金额", "gsdm":"公司代码", "mxxx":[{ "invoiceCode":"发票代码", "invoiceNo":"发票号码", "invoiceType":"发票类型" },... ]} |
请求参数说明:
字段名 | 中文名 | 允许为空 | 类型 | 说明 |
djzt | 单据状态 | 否 | String | 默认:0绑定 |
djbh | 单据编号 | 是 | String | OA系统报销单据中来源流程的单号 |
sjly | 数据来源 | 否 | String | 传7 1.SAP 2.NC 3.SRM 4.EMS 5.FSSC 6.DMS 7.OA |
djlx | 单据类型 | 是 | String | 传7 1.预置发票单 2.采购发票单 3.付款单 4.结算单 5. 应付单 6.报账单 7.报销单 |
hjse | 单据合计税额 | 否 | BigDecimal | 保留两位小数 |
fpje | 单据合计金额 | 是 | 报销单的报销金额 保留两位小数 | |
gsdm | 公司代码 | 是 | String | |
mxxx | 发票信息 | 否 | List | |
invoiceCode | 发票代码 | 否 | String | |
invoiceNo | 发票号码 | 是 | String | |
invoiceType | 发票类型 | 否 | String | 10100-增值税专用发票 10101-增值税普通发票 10102-增值税电子普通发票 10103-增值税普通发票(卷票) 10107-电子专票 10200-火车票 10201-出租车票 10202-航空运输电子客票行程单 10203-客运票 10204 过路费发票 10300-定额发票 |
- 响应样例:
{ "code": “返回代码”, "msg": "提示信息", } |
字段名 | 中文名 | 允许为空 | 类型 | 说明 |
code | 返回代码 | 否 | string | 0-成功 其它值-失败 |
msg | 提示信息 | 是 | string |
1.1.3 单据解绑接口
功能描述:将单据和发票信息推送给税务共享平台,进行单据和发票解绑操作。
请求方式:post
请求url:http://10.0.0.196:8088/api/jxgl/dns/ywdjjb
请求样例:
{ "djbh":"单据编号" } |
请求参数说明:
字段名 | 中文名 | 允许为空 | 类型 | 说明 |
djbh | 单据编号 | 否 | String |
- 响应样例:
{ "code": “返回代码”, "msg": "提示信息", } |
字段名 | 中文名 | 允许为空 | 类型 | 说明 |
code | 返回代码 | 否 | string | 0-成功 其它值-失败 |
msg | 提示信息 | 是 | string |
1.1.4 凭证推送接口
功能描述:将凭证和单据信息推送给税务共享平台,进行审核,反审操作。
审核:进行单据审核,发票勾选操作。
反审:进行单据反审(取消凭证与单号的对应关系),并解绑,发票取消勾选操作。
请求方式:post
请求url:http://10.0.0.196:8088/api/jxgl/dns/ywpzts
请求样例:
[{ "pzdh":"凭证单号", "gsdm":"公司代码", "kjnd":"会计年度", "djzt":"单据状态", "gzrq":"过账日期", "zdr":"制单人", "pzje":"凭证金额", "pzse":"凭证税额", "mxxx":[{ "djbh":"单据编号" },... ],... }] |
请求参数说明:
字段名 | 中文名 | 允许为空 | 类型 | 说明 |
djzt | 单据状态 | 是 | String | 1审核,2反审 |
pzdh | 凭证单号 | 是 | String | |
gsdm | 公司代码 | 是 | String | |
kjnd | 会计年度 | 是 | String | |
gzrq | 过账日期 | 是 | String | YYYY-MM-DD |
pzse | 凭证税额 | String | ||
zdr | 制单人 | 是 | String | |
pzje | 凭证金额 | String | ||
mxxx | 否 | List | ||
djbh | 单据编号 | 否 | String |
- 响应样例:
{ "code": “返回代码”, "msg": "提示信息", } |
字段名 | 中文名 | 允许为空 | 类型 | 说明 |
code | 返回代码 | 否 | string | 0-成功 其它值-失败 |
msg | 提示信息 | 是 | string |