前言
随着金税四期和全面数字化电子发票（数电票）的推广，税务机关的监管已从“以票管税”转向“以数治税”。发票归集可以帮助企业自动化的管理进项、销项发票信息，方便企业开展报税等财税工作。
发票归集API可以输入纳税人识别号、开票月份、发票类型、进销项标志，按月返回所有的进项、销项发票全票面归集详情信息，是连接企业财务系统与税务局端数据的核心技术桥梁。通过API接口，企业系统可以直接从税务局的电子底账库或税务数字账户中，自动拉取全量的进销项发票数据，从而彻底替代传统的人工登录、手动下载和录入。
API介绍
发起归集API主要有发起归集任务和查询归集结果两个API。
戳这里查看详情
发起归集任务接口
请求参数
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
| nsrsbh | String | 是 | 纳税人识别号 |
| dateType | String | 否 | 日期类型，0-按月(时间跨度不超过一年), 1-按天(时间跨度不超过一个月), 默认：0 |
| kpsjq | String | 是 | 开票时间起，按月格式：yyyyMM，按日期格式：yyyyMMdd |
| kpsjz | String | 是 | 开票时间止，按月格式：yyyyMM，按日期格式：yyyyMMdd |
| fplx | String | 否 | 发票类型, 多个以英文","分割 |
| jxxbz | String | 否 | 进销项标志，jx-进项，xx-销项。为空表示全部 |
返回样例
{
"code": 200,
"msg": "成功",
"taskNo": "526782409178028989145499"
}
查询归集结果接口
业务参数
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
| nsrsbh | String | 是 | 纳税人识别号 |
| requestTaskNo | String | 是 | 发起归集任务接口返回的taskNo |
返回样例
归集成功返回样例
{
"code": 200,
"msg": "成功",
"taskNo": "043439882226367117195632",
"data": {
"requestTaskNo": "952389968135471173207309",
"nsrsbh": "91330110MA2CC1X505",
"kpsjq": "202211", // 开票时间起
"kpsjz": "202211", // 开票时间止
"resultUrl": "", // 开票记录下载地址
"result": [ // 开票记录
{
"fpdm": "3300224130", // 发票代码
"fphm": "19134628", // 发票号码
"gfsbh": "", // 购买方税号
"xfsbh": "91330110MA2CC1X505", // 销售方税号
"gfmc": "杭州****科技有限公司", // 购买方
"xfmc": "杭州***科技有限公司", // 销售方
"fplx": "01", // 发票类型
"jxxbz": "xx", // 进销项标志
"kpr": "张三", // 开票人
"se": 558.66, // 税额
"kprq": "2022-11-30 00:00:00", // 开票日期
"bz": "", //
"jshj": 9868, // 价税合计
"je": 9309.34, // 不含税金额
"fpztDm": "0", //
"hwxx": [ // 内容
{
"ggxh": "",
"se": 558.66,
"fpdm": "3300224130",
"jldw": "",
"dj": "93094.339622641509434",
"mc": "*研发和技术服务*服务费",
"mxxh": "1",
"sl": "1",
"je": 9309.34,
"slv": 0.06,
"spbm": "3040101000000000000",
"fphm": "19134628"
}
]
},
...
]
}
}
归集中返回样例
{
"code": 301,
"msg": "正在归集，请稍后再试",
"taskNo": "043439882226367117195632"
}
归集失败返回样例
{
"code": 302,
"msg": "归集失败，请重新发起归集任务",
"taskNo": "043439882226367117195632"
}
