夜豺软件

Appearance

进项发票列表 ​

请求地址: /api/v3/syncCollectTask

请求方式: POST

接口说明 ​

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

请求参数 ​

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

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

请求示例 ​

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

响应参数 ​

参数名称参数类型说明
codeinteger业务状态码，200 表示成功，其他见错误码
msgstring提示信息
dataarray[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  | null | 否 | 发动机号码（机动车发票 类型代码83 时返回） | | cpzh | string  | null | 否 | 车牌照号（二手车发票 类型代码70 时返回） | | djzh | string  | null | 否 | 登记证号（二手车发票 类型代码70 时返回） | | escMc | string  | null | 否 | 二手车市场名称（二手车发票） | | escSbh | string  | null | 否 | 二手车市场识别号（二手车发票） | | zrdclglsMc | string  | null | 否 | 转入地车辆管理所名称（二手车发票） |

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

字段类型必填描述
mxxhstring否明细序号
spbmstring否商品编码（税收分类编码）
mcstring否商品名称
ggxhstring否规格型号
jldwstring否计量单位
slstring否数量
djstring否单价
jenumber否金额
slvnumber否税率（小数，示例 0.13 即 13%）
ysslvnumber否原始税率（百分比形式，例如 13%）
senumber否税额
lslbsstring否零税率标识：空-非零税率，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"
    }
  ]
}

错误码说明 ​

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

补充说明 ​

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