进项发票列表

请求地址: /api/v3/syncCollectTask

请求方式: POST

接口说明

根据税号及日期范围，同步采集企业进/销项发票数据。支持增值税发票、数电票、机动车发票、二手车发票、客运票据等全票种归集。返回完整的发票结构化信息，包含货物明细、特定要素、行程单信息等扩展数据。

请求参数

请求方式：POST，Content-Type: application/json

参数名称	参数类型	必填	说明
taxNo	string	是	企业税号 / 统一社会信用代码
startDay	string	是	开始日期，格式：`YYYY-MM-DD`
endDay	string	是	结束日期，格式：`YYYY-MM-DD`（包含当日）

请求示例

json

{
  "taxNo": "91440101MA5ABCD123",
  "startDay": "2026-01-01",
  "endDay": "2026-03-31"
}

响应参数

参数名称	参数类型	说明
code	integer	业务状态码，`200` 表示成功，其他见错误码
msg	string	提示信息
data	array[object]	数据主体，发票列表

发票列表 (data 数组元素)

返回的每一张发票均包含以下基础字段、扩展字段及嵌套明细。

字段名	类型	必填	描述 / 枚举
xfsbh	string	否	销方识别号
gfsbh	string	否	购方识别号
jxxbz	string	否	进销项标志：`xx`-销项，`jx`-进项
xfmc	string	否	销方名称
gfmc	string	否	购方名称
fplx	string	否	发票类型代码，参考附录发票类型代码
tdywlx	string	否	特定业务类型代码，参考附录特定业务类型代码
fpztDm	string	否	发票状态代码：`0` 正常，`2` 作废，`7` 部分红冲，`8` 全额红冲
fpfxdj	string	否	发票风险等级：正常、异常凭证、疑点发票、疑似异常凭证
fply	string	否	发票来源：增值税发票管理系统、电子发票服务平台
sfzsfp	string	否	是否正数发票：`0` 正数，`1` 负数
fpdm	string	否	增值税发票代码（传统发票）
fphm	string	否	增值税发票号码（传统发票）
sdphm	string	否	数电票号码（全电发票号码）
kprq	string	否	开票日期，格式 `YYYY-MM-DD HH:MM:SS`
je	number	否	金额（不含税）
se	number	否	税额
jshj	number	否	价税合计
kpr	string	否	开票人
bz	string	否	备注
hwxx	array[object]	否	货物（劳务）信息明细，结构见下方“货物信息对象”
tdysList	array[object]	否	特定要素列表，当特定业务类型为不动产经营租赁、旅客运输、货物运输、建筑服务时返回具体要素对象
xcdxx	array[object]	否	行程单信息，仅当发票类型为铁路客票(51)或航空行程单(61)时返回
fdjhm	string	否	发动机号码（机动车发票类型代码83 时返回）
cpzh	string	否	车牌照号（二手车发票类型代码70 时返回）
djzh	string	否	登记证号（二手车发票类型代码70 时返回）
escMc	string	否	二手车市场名称（二手车发票）
escSbh	string	否	二手车市场识别号（二手车发票）
zrdclglsMc	string	否	转入地车辆管理所名称（二手车发票）

货物信息对象 (hwxx 数组元素)

字段	类型	必填	描述
mxxh	string	否	明细序号
spbm	string	否	商品编码（税收分类编码）
mc	string	否	商品名称
ggxh	string	否	规格型号
jldw	string	否	计量单位
sl	string	否	数量
dj	string	否	单价
je	number	否	金额
slv	number	否	税率（小数，示例 `0.13` 即 13%）
ysslv	number	否	原始税率（百分比形式，例如 `13%`）
se	number	否	税额
lslbs	string	否	零税率标识：空-非零税率，`0`-出口零税，`1`-免税，`2`-不征税，`3`-普通零税率

说明

特定要素 (tdysList)：针对不动产经营租赁、旅客运输服务、货物运输服务、建筑服务等业务，返回的特定要素对象结构不同。
行程单信息 (xcdxx)：仅当发票类型为铁路客票(51)或航空行程单(61)时返回，字段包含乘车人、座位、客票号等信息。

枚举速查表

枚举域	可选值
jxxbz (进销项)	`xx`-销项，`jx`-进项
fpztDm (发票状态)	`0`-正常，`2`-作废，`7`-部分红冲，`8`-全额红冲
fpfxdj (风险等级)	正常、异常凭证、疑点发票、疑似异常凭证
fply (来源)	增值税发票管理系统、电子发票服务平台
sfzsfp (正负数)	`0`-正数，`1`-负数
lslbs (零税率标识)	空（非零税率）、`0`-出口零税、`1`-免税、`2`-不征税、`3`-普通零税率

响应示例（JSON 片段）

json

{
  "code": 200,
  "msg": "查询成功",
  "data": [
    {
      "kpyf": "202604",
      "xfsbh": "91510xxxxxxxxx04J",
      "gfsbh": "9152xxxxxxxxQ5D32",
      "fpdm": "",
      "gfmc": "四川XXXXXX公司",
      "sfzsfp": "0",
      "fplx": "82",
      "fply": "电子发票服务平台",
      "sdphm": "26517000000327940961",
      "fpfxdj": "正常",
      "jxxbz": "jx",
      "kpr": "王梅",
      "se": 10.31,
      "kprq": "2026-04-22 18:03:55",
      "bz": "订单号:3474279015425864",
      "jshj": 89.64,
      "je": 79.33,
      "fpztDm": "0",
      "slv": "",
      "xfmc": "成都XXXXXXX限公司",
      "hwxx": [
        {
          "ggxh": "羽柔软抽纸面巾110抽*24包",
          "fpdm": "",
          "jldw": "箱",
          "dj": "26.4433333333333",
          "mxxh": "1",
          "se": 10.31,
          "mc": "*纸制品*京东京造 羽柔纸巾 3层110抽*24包 卫生纸 餐巾纸擦手纸 整箱抽纸京东自营",
          "sl": "3.00000000",
          "je": 79.33,
          "slv": 0.13,
          "ysslv": "13%",
          "spbm": "1060105040000000000",
          "fphm": "26517000000327940961"
        }
      ],
      "fphm": "26517000000327940961"
    }
  ]
}

错误码说明

code	msg 示例	处理建议
400	参数错误 / 日期格式不正确	检查请求参数类型及日期范围

补充说明

⚙️ 若需补充更多字段说明，可根据实际返回结构继续扩展。

进项发票列表 ​

接口说明 ​

请求参数 ​

请求示例 ​

响应参数 ​

发票列表 (data 数组元素) ​

货物信息对象 (hwxx 数组元素) ​

说明 ​

枚举速查表 ​

响应示例（JSON 片段） ​

错误码说明 ​

补充说明 ​