前言

随着金税四期和全面数字化电子发票（数电票）的推广，税务机关的监管已从“以票管税”转向“以数治税”。发票归集可以帮助企业自动化的管理进项、销项发票信息，方便企业开展报税等财税工作。

发票归集API可以输入纳税人识别号、开票月份、发票类型、进销项标志，按月返回所有的进项、销项发票全票面归集详情信息，是连接企业财务系统与税务局端数据的核心技术桥梁。通过API接口，企业系统可以直接从税务局的电子底账库或税务数字账户中，自动拉取全量的进销项发票数据，从而彻底替代传统的人工登录、手动下载和录入。

API介绍

发起归集API主要有发起归集任务和查询归集结果两个API。

戳这里查看详情

发起归集任务接口

请求参数

返回样例

{
  "code": 200, 
  "msg": "成功",
  "taskNo": "526782409178028989145499"
}

查询归集结果接口

业务参数

返回样例

归集成功返回样例

{
  "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"
}