1. 申请认证
1.1. 接口说明
通过此接口，用户可以推送认证的发票，经过数据校验后，反馈给请求处理结果，如果数据校验通过则反馈接收成功，否则反馈失败原因；【发票认证过程是异步过程，不实时返回，建议一次请求认证发票数量小于500张】。
1.2. 调用方式
请求方式：POST
https://invoice.youepiao.com/input/openApi/applyLegalize
1.3. 请求参数
1.3.1. 参数示例
{
"PCH": "JXCS2020062213492222121248888888",
"GMFSBH": "91110104444324CP321",
"FHHS": "2",
"FPZHXX": [
{
"FPDM": "3100174130",
"FPHM": "08975555",
"GMFSBH": "91110104444324CP321",
"SQRZLX": "1",
"FPLXDM": "01",
"SQSKSSQ": "202005",
"YXSE": "200"
},
{
"FPDM": "3100174130",
"FPHM": "08974444",
"GMFSBH": "91110104444324CP321",
"SQRZLX": "1",
"FPLXDM": "01",
"SQSKSSQ": "202004",
"YXSE": "100"
}
]
}
1.3.2. 参数说明
| 参数 |
参数名称 |
类型 |
长度 |
必须 |
备注 |
| FHHS |
总条数 |
Int |
|
是 |
本次请求，共多少条 |
| PCH |
批次号 |
String |
32 |
是 |
32位代表本次请求的批次，下次查询发票认证状态时，也需要此值 |
| FPDM |
发票代码 |
String |
10/12 |
是 |
10或12位 |
| FPHM |
发票号码 |
String |
8 |
是 |
8位 |
| SQSKSSQ |
申请税款所属期 |
String |
6 |
是 |
6位（yyyyMM）当前税款所属期 |
| GMFSBH |
购方税号 |
String |
15/18 |
是 |
15或18位 |
| SQRZLX |
申请认证类型 |
String |
1 |
是 |
1-抵扣 2-退税 3-代办退税 4-不抵扣 5-撤销抵扣 6-撤销不抵扣 |
| YXSE |
有效税额 |
String |
20 |
是 |
默认与税额相等 |
| FPLXDM |
发票类型 |
String |
20 |
是 |
发票类型 01-专 14-通行费 03-机动车 08-增值税电子专用发票 |
1.4. 返回结果
1.4.1. 返回示例
{
"ZTDM": "",
"ZTXX": ""
}
1.4.2. 返回说明
| 参数 |
参数名称 |
类型 |
长度 |
必须 |
备注 |
| ZTDM |
状态代码 |
String |
|
是 |
状态代码描述 |
| ZTXX |
状态信息 |
String |
|
是 |
状态信息 |
1.4.3. 状态代码说明
| 数据项 |
说明 |
| 0000 |
处理成功 |
| 9999 |
处理失败 |
| 2001 |
发票不存在 |
| 2002 |
授权信息错误 |
| 2003 |
请求报文格式错误 |
| 2004 |
内容有差异（传过去 500，但实际确 100） |
| 2005 |
接口代码不存在 |
| 2006 |
批次号不能为空并且为 32 位 |
| 2007 |
当期起始日期不能为空并且为 14 位 |
| 2008 |
状态标志不能为空并且为 1 位 |
| 2009 |
开始行数为数字并且不为空 |
| 2010 |
当期结束日期不能为空并且为 14 位 |
| 2011 |
其他异常 |
| 2012 |
请确认 ip 与税号是否授权 ! |
| 2013 |
无此集团 |
| 2014 |
税号不能为空 |
| 2015 |
代码与号码长度不符 |
| 2016 |
申请认证税款所属期不能为空 |
| 2017 |
无此票 |
| 2018 |
申请确认统计时间不能为空 |
| 2019 |
确认标识不能为空 |
| 2020 |
统计标识不能为空 |
| 2021 |
统计属期不能为空 |
| 2022 |
校验码错误 |
| 2023 |
确认密码不能为空 |
| 2024 |
确认密码不能小于六位或大于 20 位 |