1. 主要信息采集
1.1. 接口描述
通过此接口返回无明细的发票主体信息(无明细原因:还未补全明细以及查验异常的发票,例如查验平台升级等)。
1.2. 调用方式
请求方式:POST
https://invoice.youepiao.com/input/openApi/mainInvoice
1.3. 请求参数
1.3.1. 参数示例
{
"GMFSBH": "",
"PCH": "12345678901234567890123456789012",
"CJKSRQ": "20170101010130",
"CJJSRQ": " 20170101010230",
"KSHS": 10,
"ZTBZ": "1"
}
1.3.2. 参数说明
参数 | 参数名称 | 类型 | 长度 | 必须 | 备注 |
---|---|---|---|---|---|
GMFSBH | 购方税号 | String | 15/18 | 否 | 15或18位 |
PCH | 批次号 | String | 32 | 是 | 32位如果多次重复的话,此值要一样,代表是一次请求 |
CJKSRQ | 发票采集开始时间 | String | 14 | 是 | yyyyMMddHHmmss 例如:20170101140245 |
CJJSRQ | 发票采集结束时间 | String | 14 | 是 | yyyyMMddHHmmss 例如:20170101140345 |
KSHS | 开始行数 | int | 是 | 整数,第一次请求时为1 | |
ZTBZ | 状态标志 | String | 1 | 是 | 当给1时继续请求,0时结束请求 |
1.4. 返回结果
1.4.1. 返回示例
{
"ZTDM": "",
"ZTXX": "",
"ZHS": 360,
"KSHS": 1,
"BCQQFHHS": 10,
"FPZHXX": [
{
"FPDM": "",
"FPHM": "",
"DQSKSSQ": "",
"GXJZR": "",
"GXRQQ": "",
"GXRQZ": "",
"FPLXDM": "",
"GMFSBH": "",
"XHFMC": "",
"XHFSBH": "",
"KPRQ": "",
"HJJE": "",
"SE": "",
"FPZT": "",
"RZZT": "",
"RZRQ": "",
"RZSQ": "",
"SFDBTS": "",
"RZLX": "",
"JYM": "",
"XXLY": "",
"YXSE": "",
"YQKGXBZ": "",
"GLZT": ""
}
]
}
1.4.2. 返回说明
参数 | 参数名称 | 类型 | 长度 | 必须 | 备注 |
---|---|---|---|---|---|
ZHS | 总行数 | int | 是 | 整数 | |
KSHS | 开始行数 | int | 是 | 整数,第一次请求时为1 | |
BCQQFHHS | 本次请求返回行数 | int | 是 | 整数 | |
FPDM | 发票代码 | String | 10/12 | 是 | 10或12位 |
FPHM | 发票号码 | String | 8 | 是 | 8位 |
DQSKSSQ | 当前税款所属期 | String | 6 | 是 | yyyyMM |
GXJZR | 当前税款所属期勾选截止日 | String | 8 | 是 | yyyyMMdd |
GXRQQ | 当前税款所属期可勾选发票开票日期起 | String | 8 | 是 | yyyyMMdd |
GXRQZ | 当前税款所属期可勾选发票开票日期止 | String | 8 | 是 | yyyyMMdd |
FPLXDM | 发票类型 | String | 2 | 是 | 增值税专用发票:01 机动车销售统一发票:03 增值税电子专用发票:08 通行费电子发票:14 电子发票(增值税专用发票): 31 |
GMFSBH | 购方税号 | string | 15/18 | 否 | 现在是15/18位 |
XHFMC | 销方名称 | string | 100 | 否 | |
XHFSBH | 销方税号 | string | 20 | 否 | 真实税号是15/18位 |
KPRQ | 开票日期 | string | 8 | 否 | yyyyMMdd |
HJJE | 发票金额 | string | 16 | 否 | |
SE | 发票税额 | string | 16 | 否 | |
FPZT | 发票状态 | string | 2 | 否 | 0-正常 1-失控 2-作废 3-红冲 4-异常 |
RZZT | 认证状态 | string | 1 | 否 | 0-未认证 1-已认证 |
RZRQ | 认证日期 | string | 8 | 否 | yyyyMMdd |
RZSQ | 认证归属期 | String | 6 | 否 | yyyyMM |
SFDBTS | 是否代办退税 | String | 1 | 否 | 0-否 1-是 |
RZLX | 认证类型 | String | 1 | 否 | 0-未抵扣 1-抵扣 2-退税 3-代理退税 4-不抵扣 |
JYM | 校验码 | String | 20 | 否 | 通行费发票有该值 |
XXLY | 信息来源 | String | 1 | 否 | 0扫描认证 1系统推送 2出口转内销 |
YXSE | 有效税额 | String | 20 | 否 | 当RZLX=1(抵扣)、4(不抵扣)、时不为空 |
YQKGXBZ | 逾期可勾选标志 | String | 1 | 否 | 逾期可勾选标志 0默认值 1 可勾选逾期 |
GLZT | 管理状态 | String | 1 | 是 | 0 正常 1 异常 2 疑似非正常 |