获取发票归集任务状态

1、接口描述

该接口用于获取企业指定开票月份、发票类型、进销项发票归集任务的状态，或者发起归集任务

2、接口地址

POST /v1/FP/getFpxzStatus  HTTP/1.1

3、请求参数

• 参数说明

请求参数为JSON格式。

• 示例参数

{
  "nsrsbh": "xxx",
  "kpyf": 202011,
  "jxxbzs": ["jx", "xx"],
  "fplxs": ["01", "04"]
}

4、返回结果

• 返回结果

返回结果为JSON格式。

{
  "result": {
    "success": true,
    "req_id": "b763b8603aa34dcb874e16fc31e22d28",
    "timestamp": 1606804799800,
    "time": 170
  },
  "value": [{ -- 任务状态列表
    "jxxbz": "jx", -- 进销项标识
    "fplx": "01", -- 发票类型代码
    "status": "processed", -- 状态
    "msg": "", -- 提示信息
    "time": "2020-11-30 14:25:09", -- 时间
    "downloadUrl": [ -- 发票源文件，有效期一个月
      "https://qxy-oss-test.oss-cn-beijing.aliyuncs.com/DOWNLOAD/0/def.xls",
      "https://qxy-oss-test.oss-cn-beijing.aliyuncs.com/DOWNLOAD/0/abc.xls"
    ],
    "errorCode": "" -- 发票任务异常状态代码
  }]
}

//失败返回结果

{
  "result": {
    "req_id": "f7005a7d9351462e8d5c569d4f36124c",
    "success": false,
    "time": 41,
    "timestamp": 1670323665906
  },
  "error": {
    "code": "xxxx",
    "message": "xxx"
  }
}

• 字段说明

5、错误码

发票归集

1、接口描述

该接口用于归集企业指定开票月份的进销项发票
需要在发票归集任务处理成功之后调用

2、接口地址

POST /v1/FP/cj  HTTP/1.1

3、请求参数

• 参数说明

请求参数为JSON格式。

分页信息说明

• 示例参数

{
  "nsrsbh": "xxx",
  "kpyf": 202011,
  "jxxbz": "jx",
  "fplx": "01",
  "page": {
    "pageSize": 20,
    "currentPage": 1
  }
}

4、返回结果

返回结果为JSON格式。

增值税专用发票、增值税普通发票、增值税普通发票（电子）、增值税普通发票（卷票）返回示例及字段说明
当发票为农产品收购发票时，由于是企业自己开具的发票，所以在销项发票里
{
  "result": {
    "success": true,
    "req_id": "6dd110823a33447b9944a8bd23b1cb17",
    "timestamp": 1606786781629,
    "time": 214
  },
  "value": {
    "page": { -- 分页信息，当分页信息参数没有传时不返回
      "pageSize": 20,
      "currentPage": 1,
      "totalPage": 1, -- 总页数
      "totalCount": 18 -- 总记录数
    },
    "list": [{ -- 发票信息列表
      "fpdm": "4400202130", -- 发票代码
      "fphm": "42657366", -- 发票号码
      "kprq": "2020-10-09 14:58:24", -- 开票日期
      "jym": "15092472377816055866", -- 校验码

      "xfsbh": "91441900663373086B", -- 销售方识别号
      "xfmc": "东莞市XX仪器有限公司", -- 销售方名称
      "xsfdzdh": "东莞市常平镇居民社区西兴三街68号C栋1、2楼0769-81691361", -- 销售方地址电话
      "xsfyhzh": "东莞农村商业银行股份有限公司常平支行", -- 销售方银行账号

      "gfsbh": "914413007946752601", -- 购买方识别号
      "gfmc": "XX(惠州)有限公司", -- 购买方名称
      "gmfdzdh": "惠州市博罗县罗阳镇", -- 购买方地址电话
      "gmfyhzh": "中国工商银行博罗县支行", -- 购买方银行账号
      "skm": "", -- 税控码/密码区

      "je": 792.92, -- 金额
      "se": 103.08, -- 税额
      "jshj": 896.0, -- 价税合计
      "bz": "", -- 备注

      "kpr": "曾晚霞", -- 开票人
      "skr": "曾利娟", -- 收款人
      "fhr": "缪钰如", -- 复核人


      "tspzDm": "", -- 特殊票种代码，02农产品收购发票 08成品油发票
      "fpztDm": "0", -- 发票状态代码

      "hwxx": [{ -- 货物信息列表
        "mxxh": 1, -- 明细序号
        "spbm": "1099900000000000000", -- 税局编码/税收分类编码
        "mc": "*其他机械设备*触控式拉力试验机（步进电机）", -- 货物劳务名称
        "ggxh": "", -- 规格型号
        "sl": "1", -- 数量
        "jldw": "台", -- 计量单位
        "dj": "792.920353982300885", -- 单价
        "slv": 0.13, -- 税率
        "se": 103.08, -- 税额
        "je": 792.92, -- 金额
        "qdbz": "00", -- 清单标识
        "hsdj":"1.23", ---含税单价(卷票的字段)
        "hsje":"30.35", ----含税金额(卷票的字段
        "lslbs": ""--- 空：非零税率，0：出口零税，1：免税，2：不征税，3 普通零税率

      }],
      "xhqdBz": "N", -- 销货清单标识
      "kjlx": "1",
      "kpjh": "499911561971",
      "tslsh": "4400202010091500214345202117", -- 推送流水号
      "kpyf": 202010, -- 开票月份
      "xfDsswjgDm": "144190000", -- 销方地市税务机关代码
      "xfQxswjgDm": "144192100", -- 销方区县税务机关代码
      "xfSjswjgDm": "144000000" -- 销方省级税务机关代码
    }]
  }
}

机动车销售统一发票返回示例及字段说明
{
  "result": {
    "success": true,
    "req_id": "3680cf18c4944ab5a44ae5aece463dcf",
    "timestamp": 1606795011477,
    "time": 289
  },
  "value": {
    "page": { -- 分页信息，当分页信息参数没有传时不返回
      "pageSize": 20,
      "currentPage": 1,
      "totalPage": 1, -- 总页数
      "totalCount": 18 -- 总记录数
    },
    "list": [{ -- 发票信息列表
      "fpdm": "144001924160", -- 发票代码
      "fphm": "00168986", -- 发票号码
      "kprq": "2019-06-21 00:00:00", -- 开票日期
      "skm": "037>935<74646<43+/*+41+913-267-25**0<71493+0>+6-0>3<-0+/38>10/6-4**28<6<-19812<1/9*11/<+3/<1>62+/4194*9345284</5/+<>122/>95693<-7+*870->126<8*-41>932+//264524/>2+8+0-987<->/990710150810449/2", -- 税控码

      "gfmc": "广州XX设备有限公司", -- 购买方名称
      "sfzhm": "", -- 身份证号码/组织机构代码
      "gfsbh": "9144010106867524XK", -- 购买方识别号
      "spbm": "1090305010100000000", -- 商品编码
      "cllx": "多用途乘用车", -- 车辆类型
      "cpxh": "雪佛兰牌/CHEVROLETSGM6479DAA1", -- 厂牌型号
      "cd": "武汉", -- 产地
      "hgzh": "WAE202190683558", -- 合格证号
      "jkzmsh": "", -- 进口证明书号
      "sjdh": "", -- 商检单号
      "fdjhm": "190773178", -- 发动机号码
      "cjhm": "LSGXC8350KV302216", -- 车架号码/车辆识别代码

      "jshj": 149900.0, -- 价税合计
      "xhdwmc": "广州XX服务有限公司", -- 销货单位名称
      "dh": "020-22222222", -- 电话
      "xhdwsbh": "91440101769504224R", -- 销货单位纳税人识别号
      "zh": "630139577", -- 账号
      "dz": "广州市黄埔区南云五路8号L栋301", -- 地址
      "khyh": "", -- 开户银行
      "slv": 0.13, -- 增值税税率或征收率
      "zzsse": 17245.13, -- 增值税税额
      "je": 132654.87, -- 不含税价
      "dw": "", -- 吨位
      "xcrs": "5", -- 限乘人数

      "kpr": "管理员", -- 开票人
      "fpztDm": "2", -- 发票状态代码

      "tslsh": "14400000003201906222413",-- 推送流水号
      "kpyf": 201906
    }]
  }
}

通行费发票返回示例及字段说明
{
  "result": {
    "success": true,
    "req_id": "b8186ea06adb418ab81d8fecf65a91db",
    "timestamp": 1606792656796,
    "time": 225
  },
  "value": {
    "page": { -- 分页信息，当分页信息参数没有传时不返回
      "pageSize": 20,
      "currentPage": 1,
      "totalPage": 1, -- 总页数
      "totalCount": 18 -- 总记录数
    },
    "list": [{ -- 发票信息列表
      "fpdm": "032001700212", -- 发票代码
      "fphm": "40055988", -- 发票号码
      "kprq": "2020-07-29 00:00:00", -- 开票日期
      "jym": "10614167016792203232", -- 校验码

      "xfsbh": "91320000134767063W", -- 销售方识别号
      "xfmc": "江苏XX有限公司", -- 销售方名称
      "xsfdzdh": "江苏省南京市玄武区", -- 销售方地址电话
      "xsfyhzh": "工商银行南京城南支行", -- 销售方银行账号

      "gfsbh": "91320115302341302G", -- 购买方识别号
      "gfmc": "南京XX有限公司", -- 购买方名称
      "gmfdzdh": "南京市江宁区科技园", -- 购买方地址电话
      "gmfyhzh": "南京银行江宁支", -- 购买方银行账号
      "skm": "03*705018714/9+99481>*-44></5453/+-3/27*3<20/>4+735455/+1/4647<<225*61-15-89-92172+-*50881/0<401340-19*<*//37488", -- 税控码/密码区

      "je": 18.15, -- 金额
      "se": 0.54, -- 税额
      "jshj": 18.69, -- 价税合计
      "bz": "汇总开具", -- 备注

      "kpr": "陈佩", -- 开票人
      "skr": "王皎", -- 收款人
      "fhr": "李剑羽", -- 复核人

      "fpztDm": "0", -- 发票状态代码

      "hwxx": [{ -- 货物信息列表
        "spbm": "3040502020301000000", -- 税局编码/税收分类编码
        "mc": "*经营租赁*通行费", -- 货物劳务名称
        "ggxh": "苏A3HE63", -- 车牌号
        "sl": "20200724", -- 运行日期起
        "jldw": "客车", -- 类型
        "dj": "20200724", -- 运行日期止
        "je": 18.15, -- 金额
        "slv": 0.03, -- 税率
        "se": 0.54, -- 税额
        "txrqz":"20200724",-- (通行费发票)运行日期止
        "txrqq":"20200724" -- (通行费发票)运行日期起
      }],
      "sbbh": "499098892654",
      "kpyf": 202007
    }]
  }
}

二手车统一销售发票返回示例及字段说明
{
  "result": {
    "success": true,
    "req_id": "267971738ea0465893e2242692d31723",
    "timestamp": 1606803461005,
    "time": 188
  },
  "value": {
    "page": { -- 分页信息，当分页信息参数没有传时不返回
      "pageSize": 20,
      "currentPage": 1,
      "totalPage": 1, -- 总页数
      "totalCount": 18 -- 总记录数
    },
    "list": [{ -- 发票信息列表
        "kpyf": 202104, --开票月份
        "jyPmSbh": "", --经营拍卖单位纳税人识别号
        "cjhj": 28000.0, --车价合计
        "zrdclglsMc": "成都市", --转入地车辆管理所名称
        "jyPmMc": "", --经营、拍卖单位名称
        "jyPmDz": "", --经营、拍卖单位地址
        "kprq": "2021-04-22 00:00:00", --开票日期
        "clsbdm": "LFPH4ACC7B1A23794", --车架号/车辆识别代码
        "escSbh": "成都高新区新盛路28号", --二手车市场识别号
        "bz": "", --备注
        "djzh": "510011290965", --登记证号
        "cllx": "小型轿车", --车辆类型
        "xfMc": "周吉方", --卖方单位/个人名称
        "xfDz": "成都市成华区玉双路8号7栋1单元2楼3号", --卖方单位/个人地址
        "escDh": "02885756138", --二手车市场电话
        "fpztDm": "0", --（电子底账用）发票状态代码：发票状态代码 0正常 2作废 3已红冲
        "jyPmDh": "", --经营、拍卖单位电话
        "fpdm": "051002000117", --发票代码
        "gfMc": "四川安居兴业置业有限公司", --买方单位/个人名称
        "gfDz": "成都市成华区羊子山路68号4栋2单元20层21号", --买方单位/个人地址
        "xfDh": "0", --卖方单位/个人电话
        "kpr": "何奕昕", --开票人
        "escMc": "成都嘉喻田园二手车交易市场管理有限公司", --二手车市场名称
        "escDz": "91510100MA6DFJQC7Q", --二手车市场地址
        "xfDm": "513822198303044184", --卖方单位/个人代码
        "gfDh": "0", --买方单位/个人电话
        "cpxh": "红旗牌CA7204MT4", --厂牌型号
        "cpzh": "", --车牌照号
        "jyPmYhzh": "", --经营、拍卖单位开户银行账号
        "gfDm": "915101083320084471", --买方单位/个人代码
        "escYhzh": "中国建设银行股份有限公司双流航空港分理处51050110203400000206",--二手车市场开户行账号
        "fphm": "00980026" --发票号码
    }]
  }
}

海关缴款书返回示例及字段说明
{
  "result": {
    "success": true,
    "req_id": "7f142148cd1b492c9f4e48608ca6ee99",
    "timestamp": 1606794234986,
    "time": 164
  },
  "value": {
    "page": { -- 分页信息，当分页信息参数没有传时不返回
      "pageSize": 20,
      "currentPage": 1,
      "totalPage": 1, -- 总页数
      "totalCount": 18 -- 总记录数
    },
    "list": [{ -- 发票信息列表
      "jkshm": "222520201000199034-L02", -- 缴款书号码
      "tfrq": "2020-08-10 00:00:00", -- 填发日期
      "jkdw1nsrsbh": "913101073242855915", -- 缴款单位一税号
      "jkdw1mc": "上海XX有限公司", -- 缴款单位一名称
      "jkdw2nsrsbh": "91320691MA1R8G3E40", -- 缴款单位二税号
      "jkdw2mc": "XX（南通）有限公司", -- 缴款单位二名称
      "jkkadm": "2225", -- 进口口岸代码
      "skje": 4646.93, -- 税款金额
      "hwxx": [{
        "shxx": "3403990000", -- 税号信息
        "hwmc": "润滑剂", -- 货物名称
        "sl": "544", -- 数量
        "dw": "035", -- 单位
        "wsjg": 35745.62, -- 完税价格
        "slv": 0.13, -- 税率
        "skje": 4646.93 -- 税款金额
      }],
      "srjg": "中央金库", -- 收入机关
      "yskmdm": "101010201", -- 预算科目代码
      "skgkdm": "0900110000", -- 收款国库代码
      "myfs": "0110", -- 贸易方式
      "sqdwbm": "3117980008", -- 申请单位编码
      "bgdbh": "222520201000199034", -- 报关单编号
      "hth": "20DL004673", -- 合同（批文）号
      "ysgj": "2031W", -- 运输工具（号）
      "jkqx": "2020-08-25 00:00:00", -- 缴款期限
      "tydh": "JJCOSSHSNC08817*07", -- 提运单号
      "tfyf": 202008, -- 填发月份
    }]
  }
}

全电发票返回示例及字段说明
{
    "result": {
        "req_id": "b8f8c257344c4b1ca480a2c3743e1d46",
        "success": true,
        "time": 33,
        "timestamp": 1654073177216
    },
    "value": {
        "list": [
            {
                "xfsbh": "91310118MA1JPDDL2G",  -- 销售方识别号
                "kpyf": 202112,  -- 开票月份
                "gfmc": "xxxxx技术有限公司",  -- 购买方名称
                "gmfyhzh": "", -- 购买方银行账号
                "xsfdzdh": "",  -- 销售方地址电话
                "se": 56.6, -- 税额
                "skm": "",  -- 税控码/密码区
                "kprq": "2021-12-20 00:00:00",  -- 开票日期
                "bz": "",  -- 备注
                "mxts": 1,  -- 明细条数
                "kjlx": "1",  -- 开具类型标识
                "skr": "",  -- 收款人
                "fpztDm": "8",  -- 发票状态代码
                "gfsbh": "91310115MA1K3R189Q",  -- 购买方识别号
                "fpdm": "",  -- 发票代码
                "kpr": "祝敏",  -- 开票人
                "fhr": "",  --  复核人
                "gmfdzdh": "",  -- 购买方地址电话
                "xsfyhzh": "",  -- 销售方银行账号
                "jshj": 1000,  -- 价税合计
                "je": 943.4,  -- 金额
                "xfmc": "xxxx（上海）信息有限公司",  -- 销售方名称
                "slv": 0.06,  --  税率
                "tspzDm": "", -- 特殊票种代码，02农产品收购发票 08成品油发票
                "hwxx": [  -- 货物信息列表
                    {
                        "ggxh": "",  -- 规格型号
                        "jldw": "",  -- 计量单位
                        "dj": "943.39622642",  -- 单价
                        "se": 56.6,  -- 税额
                        "mc": "*信息技术服务*技术服务费",  -- 货物劳务名称
                        "sl": "1",  -- 数量
                        "je": 943.4,  -- 金额
                        "slv": 0.06,  -- 税率
                        "spbm": "3040201990000000000",  -- 税局编码/税收分类编码
                        "lslbs": "" --- 空：非零税率，0：出口零税，1：免税，2：不征税，3 普通零税率
                    }
                ],
                "fphm": "21311000000000000063",  -- 发票号码
                "jym": ""  -- 校验码
            }
        ]
    }
}


//失败返回结果

{
  "result": {
    "req_id": "f7005a7d9351462e8d5c569d4f36124c",
    "success": false,
    "time": 41,
    "timestamp": 1670323665906
  },
  "error": {
    "code": "xxxx",
    "message": "xxx"
  }
}

• 字段说明

5、错误码

获取已勾选发票归集任务状态

1、接口描述

该接口用于获取企业指定税款所属期已勾选发票归集任务的状态，或者发起归集任务

2、接口地址

POST /v1/FP/getGxgxztStatus  HTTP/1.1

3、请求参数

• 参数说明

请求参数为JSON格式。

• 示例参数

{
  "nsrsbh": "xxx",
  "skssq": 202010
}

4、返回结果

返回结果为JSON格式。

{
  "result": {
    "success": true,
    "req_id": "2de1998ac0dc4de992bb96c401e3024d",
    "timestamp": 1606805793374,
    "time": 160
  },
  "value": {
    "status": "processed", -- 状态
    "msg": "", -- 提示信息
    "time": "2020-11-30 14:25:09" -- 时间
    "errorCode": "", -- 发票任务异常状态代码
  }
}

//失败返回结果

{
  "result": {
    "req_id": "f7005a7d9351462e8d5c569d4f36124c",
    "success": false,
    "time": 41,
    "timestamp": 1670323665906
  },
  "error": {
    "code": "xxxx",
    "message": "xxx"
  }
}

• 字段说明

5、错误码

已勾选发票归集

1、接口描述

该接口用于归集企业指定税款所属期的已勾选进项发票
需要在发票归集任务处理成功之后调用

2、接口地址

POST /v1/FP/cjYgx  HTTP/1.1

3、请求参数

• 参数说明

请求参数为JSON格式。

分页信息说明

• 示例参数

{
  "nsrsbh": "xxx",
  "skssq": 202011,
  "fplx": "01",
  "page": {
    "pageSize": 20,
    "currentPage": 1
  }
}

4、返回结果

返回结果为JSON格式。

{
  "result": {
    "success": true,
    "req_id": "1274968a4b404642980d650c6a87590d",
    "timestamp": 1660198585710,
    "time": 2
  },
  "value": {
    "page": {  -- 分页信息，当分页信息参数没有传时不返回
      "pageSize": 20,  -- 分页大小
      "currentPage": 1, -- 当前页
      "totalPage": 1,  -- 总页数
      "totalCount": 1  -- 总记录数
    },
    "list": [  -- 发票信息列表
      {
        "fpdm": "3300204130",  -- 发票代码
        "fphm": "21096249", -- 发票号码
        "kprq": "2022-03-01 00:00:00", -- 开票日期
        "jym": "59254238940673469323", -- 校验码
        "xfsbh": "913301105714------", -- 销方识别号
        "xfmc": "------有限公司", -- 销方名称
        "xsfdzdh": "浙江省杭州市余杭区五常街道大华西溪风情新天地大楼 0571-85851555", -- 销售方地址电话
        "xsfyhzh": "建行杭州高新支行33001616727053005738", -- 销售方银行账号
        "gfsbh": "91320903MA1W------", -- 购方识别号
        "gfmc": "------有限公司", -- 购方名称
        "gmfdzdh": "盐城市盐都区大冈 12室315124141", --  购买方地址电话
        "gmfyhzh": "江苏盐城农村商业银行股份有限公司大冈支行3209020151010000177989", --  购买方银行账号
        "skm": "+5*087044+1+<57121252282236-0>>0*7>5<503283</6<-*/9>+61/>/28*9+291+507<5-43035+79237232/>*51<7654<>02-128248", --  税控码
        "je": 281.13, --  金额
        "slv": 0.06, --  税率
        "se": 16.87, --  税额
        "jshj": 298.0, --  价税合计
        "bz": "", --  备注
        "kpr": "陈姣", --  开票人
        "skr": "史燕红", --  收款人
        "fhr": "史燕红", --  复核人
        "mxts": 1,  -- 明细条数
        "xhqdBz": "N",  -- 销货清单标识
        "kjlx": "1", -- 开具类型标识
        "tspzDm": " ", -- 特殊票种代码，02农产品收购发票
        "kpjh": null, -- 开票机号
        "sbbh": "661603451440", -- 设备编号
        "kpyf": 202203, -- 开票日期
        "fpztDm": "0", -- 发票状态代码,
        "tspzDm": "", -- 特殊票种代码，02农产品收购发票 08成品油发票
        "hwxx": [ -- 货物信息
          {
            "spbm": "3070402000000000000", -- 商品数量
            "mc": "*住宿服务*住宿费", -- 名称
            "ggxh": "", -- 规格型号
            "sl": "1", -- 数量
            "jldw": "", -- 计量单位
            "dj": "281.132075471698113", -- 单价
            "je": 281.13, -- 金额
            "slv": 0.06, -- 税率
            "se": 16.87, -- 税额
            "lslbs": "", --- 空：非零税率，0：出口零税，1：免税，2：不征税，3 普通零税率
            "txrqz":"20200724",-- (通行费发票)运行日期止
            "txrqq":"20200724" -- (通行费发票)运行日期起
          }
        ],
        "gxxx": {  -- 勾选信息
          "skssq": 202207,  -- 税款所属期
          "gxsj": "2022-07-30 00:00:00",  -- 勾选时间
          "gxztDm": "1",  -- 勾选状态代码：0未勾选；1已勾选
          "hxytDm": "1",  -- 勾选用途
          "seYxdk": 16.87  -- 有效抵扣税额
        }
      }
    ]
  }
}

//失败返回结果

{
  "result": {
    "req_id": "f7005a7d9351462e8d5c569d4f36124c",
    "success": false,
    "time": 41,
    "timestamp": 1670323665906
  },
  "error": {
    "code": "xxxx",
    "message": "xxx"
  }
}

• 字段说明