1. 状态采集
1.1. 接口说明
实时反馈结果、批量处理。系统传递发票变更日期,则进项管理平台则把此日期内发生认证状态、发票状态变化的发票及状态反馈给用户,用户可进行重复请求。
1.2. 调用方式
请求方式:POST
https://invoice.youepiao.com/input/openApi/invoiceState
1.3. 请求参数
1.3.1. 参数示例
{
"GMFSBH": "",
"PCH": "12345678901234567890123456789012",
"ZTBGKSRQ": "20170101010120",
"ZTBGJSRQ": "20170101010220",
"ZTBZ": "1",
"KSHS": "1"
}
1.3.2. 参数说明
参数 | 参数名称 | 类型 | 长度 | 必须 | 备注 |
---|---|---|---|---|---|
GMFSBH | 购方税号 | String | 15/18 | 是 | 15或18位 |
PCH | 批次号 | String | 32 | 是 | 32位如果多次重复的话,此值要一样,代表是一次请求。 |
ZTBGKSRQ | 状态变更日期时间。开始 | String | 14 | 是 | 发票认证状态,发票状态都有可能变化保留最后时间。yyyyMMddHHmmss |
ZTBGJSRQ | 状态变更日期时间。结束 | String | 14 | 是 | 格式:yyyyMMddHHmmss |
ZTBZ | 状态 | String | 1 | 是 | 1继续请求,0结束请求 |
KSHS | 开始行号 | int | 是 | 从第几开始索取数据 |
1.4. 返回结果
1.4.1. 返回示例
{
"ZTDM": "",
"ZTXX": "",
"ZHS": 360,
"KSHS": 1,
"BCQQFHHS": 10,
"FPZHXX": [
{
"FPDM": "3200182130",
"FPHM": "01345676",
"FPZT": "0",
"RZZT": "1",
"RZRQ": "2020-04-01",
"RZSQ": "202003",
"XXLY": "1",
"YXSE": "4329.2000",
"YQKGXBZ": "0",
"GLZT": "0",
"RZLX": "1"
}
]
}
1.4.2. 返回说明
参数 | 参数名称 | 类型 | 长度 | 必须 | 备注 |
---|---|---|---|---|---|
ZHS | 涉及到总行数 | 数值 | 是 | 要返回值数据的总行数 | |
KSHS | 开始行数 | 数值 | 是 | 本次返回结果的是从总集合里第几行开始获取的 | |
BCQQFHHS | 本次返回行数 | 数值 | 是 | 本次返回的内容共多少行 | |
FPDM | 发票代码 | String | 10/12 | 是 | 10或12位 |
FPHM | 发票号码 | String | 8 | 是 | 8位 |
FPZT | 发票状态 | string | 1 | 是 | 0-正常 1-失控 2-作废 3-红冲 4-异常 |
RZZT | 认证状态 | string | 1 | 否 | 0-未认证 1-已认证; |
RZRQ | 认证日期 | string | 8 | 否 | yyyyMMdd |
RZSQ | 税款归属期 | String | 6 | 否 | yyyyMM |
XXLY | 信息来源 | String | 1 | 否 | 0扫描认证 1系统推送 2出口转内销 |
YXSE | 有效税额 | String | 20 | 否 | 当RZLX=1(抵扣)、4(不抵扣)、时不为空 |
YQKGXBZ | 逾期可勾选标志 | String | 1 | 否 | 逾期可勾选标志 0默认值, 1 可勾选逾期 |
GLZT | 管理状态 | String | 1 | 是 | 0 正常1 异常 2 疑似非正常 |
RZLX | 认证类型 | String | 1 | 否 | 0-未抵扣 1-抵扣 2-退税 3-代理退税 4-不抵扣 |