OA发票管理 发票验真 费用报销流程对接

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	销售方税号

1. 响应数据：

{     "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-定额发票

1. 响应样例：

{ "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

1. 响应样例：

{ "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

1. 响应样例：

{ "code": “返回代码”, "msg": "提示信息", }

字段名	中文名	允许为空	类型	说明
code	返回代码	否	string	0-成功 其它值-失败
msg	提示信息	是	string