1. 全面采集
1.1. 接口说明
实时反馈结果、批量处理。第一次初始化获取发票数据(专票,机动车发票, 通行费发票)是两个属期的已认证发票数据和 2017.01.01 以后未认证的发票，往后每天获取增量的发票数据,系统传递参数发票采集日期，进项管理平台则根据 从国税采集发票的日期与此日期匹配，返回有明细发票,发票数量由明细总数量 (1000 条)决定。
1.2. 调用方式
请求方式：POST
https://invoice.youepiao.com/input/openApi/invoice
1.3. 请求参数
1.3.1. 参数示例
{
"GMFSBH": "3947574065434545",
"FPLXDM": "01",
"PCH": "12345678901234567890123456789012",
"CJKSRQ": "20170101010130",
"CJJSRQ": "20170101010230",
"KSHS": 10,
"ZTBZ": "1",
"FHHS": "10"
}
1.3.2. 参数说明
| 参数 | 参数名称 | 类型 | 长度 | 必须 | 备注 |
|---|---|---|---|---|---|
| GMFSBH | 购方税号 | String | 15/18 | 是 | 15或18位 |
| FPLXDM | 发票类型 | String | 2 | 是 | 增值税专用发票：01 机动车销售统一发票：03 增值税电子专用发票：08 通行费电子发票：14 电子发票（增值税专用发票）： 31 |
| PCH | 批次号 | String | 32 | 是 | 32位.代表一次请求，每次请求批次号不重复。如果数据一次性获取完成，批次号需要更换。如果一次性数据获取不完，批次号需保持一致。 |
| CJKSRQ | 发票采集开始时间 | String | 14 | 是 | yyyyMMddHHmmss 例如：20170101140245 |
| CJJSRQ | 发票采集结束时间 | String | 14 | 是 | yyyyMMddHHmmss 例如：20170101140345 |
| KSHS | 开始行数 | int | 是 | 整数,第一次请求时为1.(若本次返回行数小于总行数，需再次请求，开始行数为 本次返回行数.类似分页获取) | |
| ZTBZ | 状态标志 | String | 1 | 是 | 当给1时继续请求，0时结束请求。 |
| FHHS | 请求返回条数 | String | 否 | 当该参数有值时，接口按照参数返回发票条数，如果没值时，接口按照默认值返回发票条数 |
1.4. 返回结果
1.4.1. 增值税专用发票
{
"ZTDM": "",
"ZTXX": "",
"FPLXDM": "01",
"ZHS": 360,
"KSHS": 1,
"BCQQFHHS": 10,
"FPZHXX": [
{
"FPDM": "132000000366",
"FPHM": "00058848",
"DQSKSSQ": "202003",
"GXJZR": "20200420",
"GXRQQ": "20170101",
"GXRQZ": "20200331",
"FPLXDM": "03",
"GMFMC": "测试企业名称",
"KPRQ": "2020-04-01",
"GFSFHM": "9111222233334444DD",
"GMFSBH": "9111222233334444DD",
"CLLX": "",
"CPXH": "",
"CD": "",
"HGZS": "",
"JKZMSH": "",
"SJDH": "",
"FDJHM": "",
"CLSBH": "",
"JSHJ": "",
"XHFMC": "",
"XFDH": "",
"XHFSBH": "",
"XHFYHZH": "",
"XHFDZDH": "",
"XFKHYH": "",
"SL": "",
"SE": "",
"ZGSWJGDM": "",
"ZGSWJGMC": "",
"WSPZHM": "",
"DW": "",
"XCRS": "",
"RZRQ": "",
"SFYGX ": "",
"RZZT": "",
"RZSQ": "",
"SFDBTS": "",
"RZLX": "",
"XXLY": "",
"YXSE": "",
"YQKGXBZ ": "",
"GLZT": ""
}
]
}
字段说明
| 参数 | 参数名称 | 类型 | 长度 | 必须 | 备注 |
|---|---|---|---|---|---|
| FPLXDM | 发票类型 | String | 2 | 是 | 增值税专用发票：01 增值税电子专用发票：08 电子发票（增值税专用发票）： 31 |
| 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 增值税电子专用发票：08 电子发票（增值税专用发票）： 31 |
| GMFMC | 购方名称 | string | 100 | 否 | |
| GMFSBH | 购方税号 | string | 15/18 | 否 | 现在是15/18位 |
| GMFDZDH | 购方地址、电话 | string | 100 | 否 | |
| GMFYHZH | 购方开户行及账号 | string | 100 | 否 | |
| XHFMC | 销方名称 | string | 100 | 否 | |
| XHFSBH | 销方税号 | string | 20 | 否 | 真实税号是15/18位 |
| XHFDZDH | 销方地址、电话 | string | 100 | 否 | |
| XHFYHZH | 销方开户行及账号 | string | 100 | 否 | |
| KPRQ | 开票日期 | string | 8 | 否 | yyyyMMdd |
| HJJE | 发票金额 | string | 16 | 否 | |
| SE | 发票税额 | string | 16 | 否 | |
| JSHJ | 价税合计 | string | 16 | 否 | |
| BZ | 备注 | string | 200 | 否 | |
| 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 | 255 | 否 | 通行费发票字段 |
| TXFBZ | 通行费标志 | String | 1 | 否 | N-不可抵扣 Y-可抵扣通行费通行费发票字段 |
| LSLBZ | 零税率标志 | String | 1 | 否 | 空-非零税率 1-免税 2-不征收 3-零税率 通行费发票字段 |
| XXLY | 信息来源 | String | 1 | 否 | 0扫描认证 1系统推送 2出口转内销 |
| YXSE | 有效税额 | String | 20 | 否 | 当RZLX=1(抵扣)、4(不抵扣)、时不为空 |
| YQKGXBZ | 逾期可勾选标志 | String | 1 | 否 | 逾期可勾选标志0默认值 1 可勾选逾期 |
| GLZT | 管理状态 | String | 1 | 是 | 0 正常1 异常 2 疑似非正常 |
| XH | 明细编号 | string | 90 | 否 | |
| SPMC | 货物名称 | string | 255 | 否 | |
| SPBM | 商品编码 | String | 19 | 否 | |
| SPBMJC | 税收分类简码名称 | String | 255 | 否 | |
| GGXH | 规格型号 | string | 50 | 否 | |
| DW | 计量单位 | string | 10 | 否 | |
| SPSL | 数量 | string | 24 | 否 | |
| DJ | 不含税单价 | string | 24 | 否 | |
| JE | 金额 | string | 22 | 否 | |
| SL | 税率 | string | 10 | 否 | 正数如税率17%，填写17 |
| SE | 税额 | string | 24 | 否 | 保留小数点后两位 |
1.4.2. 机动车销售统一发票
{
"ZTDM": "",
"ZTXX": "",
"FPLXDM": "01",
"ZHS": 360,
"KSHS": 1,
"BCQQFHHS": 10,
"FPZHXX": [
{
"FPDM": "132000000366",
"FPHM": "00058848",
"DQSKSSQ": "202003",
"GXJZR": "20200420",
"GXRQQ": "20170101",
"GXRQZ": "20200331",
"FPLXDM": "03",
"GMFMC": "测试企业名称",
"KPRQ": "2020-04-01",
"GFSFHM": "9111222233334444DD",
"GMFSBH": "9111222233334444DD",
"CLLX": "",
"CPXH": "",
"CD": "",
"HGZS": "",
"JKZMSH": "",
"SJDH": "",
"FDJHM": "",
"CLSBH": "",
"JSHJ": "",
"XHFMC": "",
"XFDH": "",
"XHFSBH": "",
"XHFYHZH": "",
"XHFDZDH": "",
"XFKHYH": "",
"SL": "",
"SE": "",
"ZGSWJGDM": "",
"ZGSWJGMC": "",
"WSPZHM": "",
"DW": "",
"XCRS": "",
"RZRQ": "",
"SFYGX ": "",
"RZZT": "",
"RZSQ": "",
"SFDBTS": "",
"RZLX": "",
"XXLY": "",
"YXSE": "",
"YQKGXBZ ": "",
"GLZT": ""
}
]
}
字段说明
| 参数 | 参数名称 | 类型 | 长度 | 必须 | 备注 |
|---|---|---|---|---|---|
| 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位 | 是 | 机动车销售统一发票：03 |
| GMFMC | 购方名称 | string | 100 | 是 | |
| KPRQ | 开票日期 | String | 8 | 是 | yyyyMMdd |
| GFSFHM | 购买方身份 证号码/组织 机构代码 | String | 240 | 否 | |
| GMFSBH | 购方税号 | String | 15/18 | 是 | 现在是15/18位 |
| CLLX | 车辆类型 | String | 80 | 否 | |
| CPXH | 厂牌型号 | String | 100 | 否 | |
| CD | 产地 | String | 80 | 否 | |
| HGZS | 合格证书 | String | 100 | 否 | |
| JKZMSH | 进口证明书号 | String | 80 | 否 | |
| SJDH | 商检单号 | String | 80 | 否 | |
| FDJHM | 发动机号码 | String | 120 | 否 | |
| CLSBH | 车架号码/车辆识别号 | String | 40 | 否 | |
| JSHJ | 价税合计 | String | 16 | 否 | 2位小数 |
| XHFMC | 销货单位名称 | String | 240 | 是 | |
| XFDH | 电话 | String | 80 | 否 | |
| XHFSBH | 纳税人识别号 | String | 20 | 是 | |
| XHFYHZH | 账号 | String | 80 | 否 | 销方账号 |
| XHFDZDH | 地址 | String | 160 | 否 | |
| XFKHYH | 开户银行 | String | 160 | 否 | |
| SL | 税率 | string | 10 | 是 | 正数如税率17%，填写17 |
| SE | 税额 | String | 16 | 是 | 2位小数 |
| ZGSWJGDM | 主管税务机关代码 | String | 11 | 否 | |
| ZGSWJGMC | 主管税务机关名称 | String | 80 | 否 | |
| JSHJ | 合计金额 | String | 16 | 是 | 2位小数 |
| WSPZHM | 完税凭证号码 | String | 100 | 否 | |
| DW | 吨位 | String | 40 | 否 | |
| XCRS | 限乘人数 | String | 40 | 否 | |
| RZRQ | 发票状态 | String | 1 | 是 | 0-正常 1-失控 2-作废 3-红冲 4-异常 |
| SFYGX | 是否已勾选 | String | 1 | 是 | 0- 未勾选 1-已勾选 |
| RZZT | 认证状态 | String | 1 | 是 | 0-未认证 1-已认证 |
| RZRQ | 认证日期 | String | 8 | 否 | yyyyMMdd |
| RZSQ | 税款所属期 | String | 4 | 否 | yyyyMM |
| SFDBTS | 是否代办退税 | String | 1 | 否 | 0-否 1-是 |
| RZLX | 认证类型 | String | 1 | 否 | 0-未抵扣 1-抵扣 2-退税 3-代理退税 4-不抵扣 |
| XXLY | 信息来源 | String | 1 | 否 | 0扫描认证 1系统推送 2出口转内销 |
| YXSE | 有效税额 | String | 20 | 否 | 当RZLX=1(抵扣)、4(不抵扣)、时不为空 |
| YQKGXBZ | 逾期可勾选标志 | String | 1 | 否 | 逾期可勾选标志 0 默认值 ， 1 可勾选逾期 |
| GLZT | 管理状态 | String | 1 | 是 | 0 正常1 异常 2 疑似非正常 |
1.4.3. 通行费电子发票
{
"ZTDM": "",
"ZTXX": "",
"FPLXDM": "14",
"ZHS": 360,
"KSHS": 1,
"BCQQFHHS": 10,
"FPZHXX": [
{
"FPDM": "",
"FPHM": "",
"DQSKSSQ": "",
"GXJZR": "",
"GXRQQ": "",
"GXRQZ": "",
"FPLXDM": "",
"GMFMC": "",
"GMFSBH": "",
"GMFDZDH": "",
"GMFYHZH": "",
"XHFMC": "",
"XHFSBH": "",
"XHFDZDH": "",
"XHFYHZH": "",
"KPRQ": "",
"HJJE": "",
"SE": "",
"JSHJ": "",
"BZ": "",
"FPZT": "",
"RZZT": "",
"RZRQ": "",
"RZSQ": "",
"SFDBTS": "",
"RZLX": "",
"JYM": "",
"TXFBZ": "",
"LSLBZ": "",
"XXLY": "",
"YXSE": "",
"YQKGXBZ": "",
"GLZT": "",
"MXXX": [
{
"XH": "",
"SPMC": "",
"SPBM": "",
"SPBMJC": "",
"CPH": "",
"LX": "",
"TXSJQ": "",
"TXSJZ": "",
"JE": "",
"SL": "",
"SE": "",
"GGXH": "",
"DW": "",
"SPSL": "",
"DJ": ""
}
]
}
]
}
字段说明
| 参数 | 参数名称 | 类型 | 长度 | 必须 | 备注 |
|---|---|---|---|---|---|
| FPLXDM | 发票类型 | String | 2 | 是 | 通行费电子发票：14 |
| 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 | 是 | 通行费电子发票：14 |
| GMFMC | 购方名称 | string | 100 | 否 | |
| GMFSBH | 购方税号 | string | 15/18 | 否 | 现在是15/18位 |
| GMFDZDH | 购方地址、电话 | string | 100 | 否 | |
| GMFYHZH | 购方开户行及账号 | string | 100 | 否 | |
| XHFMC | 销方名称 | string | 100 | 否 | |
| XHFSBH | 销方税号 | string | 15/18 | 否 | 真实税号是15/18位 |
| XHFDZDH | 销方地址、电话 | string | 100 | 否 | |
| XHFYHZH | 销方开户行及账号 | string | 100 | 否 | |
| KPRQ | 开票日期 | string | 8 | 否 | yyyyMMdd |
| HJJE | 发票金额 | string | 16 | 否 | |
| SE | 发票税额 | string | 16 | 否 | |
| JSHJ | 价税合计 | string | 16 | 否 | |
| BZ | 备注 | string | 200 | 否 | |
| FPZT | 发票状态 | string | 2 | 否 | 0-正常 1-失控 2-作废 3-红冲 4-异常 |
| RZZT | 认证状态 | string | 1 | 否 | 0-未认证 1-1-已认证 |
| RZRQ | 认证日期 | string | 8位 | 否 | yyyyMMdd |
| RZSQ | 认证归属期 | String | 6 | 否 | yyyyMM |
| SFDBTS | 是否代办退税 | String | 1 | 否 | 0-否 1-是 |
| RZLX | 认证类型 | String | 1 | 否 | 0-未抵扣 1-抵扣 2-退税 3-代理退税 4-不抵扣 |
| JYM | 校验码 | String | 255 | 否 | |
| TXFBZ | 通行费标志 | String | 1 | 否 | N-不可抵扣通行费 Y-可抵扣通行费 |
| LSLBZ | 零税率标志 | String | 1 | 否 | 空-非零税率 1-免税 2-不征收 3-零税率 |
| XXLY | 信息来源 | String | 1 | 否 | 0扫描认证 1系统推送 2出口转内销 |
| YXSE | 有效税额 | String | 20 | 否 | 当RZLX=1(抵扣)、4(不抵扣)、时不为空 |
| YQKGXBZ | 逾期可勾选标志 | String | 1 | 否 | 逾期可勾选标志 0默认值 1 可勾选逾期 |
| GLZT | 管理状态 | String | 1 | 是 | 0 正常1 异常 2 疑似非正常 |
| XH | 明细编号 | string | 90 | 否 | |
| SPMC | 货物名称 | string | 255 | 否 | |
| SPBM | 商品编码 | String | 19 | 否 | |
| SPBMJC | 税收分类简码名称 | String | 255 | 否 | |
| CPH | 车牌号 | string | 50 | 否 | |
| LX | 类型 | String | 50 | ||
| TXSJQ | 通行时间起 | string | 50 | 否 | |
| TXSJZ | 通行时间止 | string | 50 | 否 | |
| JE | 金额 | string | 22 | 否 | |
| SL | 税率 | string | 10 | 否 | 正数如税率17%，填写17 |
| SE | 税额 | string | 24 | 否 | |
| GGXH | 规格型号 | string | 50 | 否 | 增值税专票字段 |
| DW | 计量单位 | string | 10 | 否 | 增值税专票字段 |
| SPSL | 数量 | string | 24 | 否 | 增值税专票字段 |
| DJ | 不含税单价 | string | 24 | 否 | 增值税专票字段 |