获取增值税发票接口
请求说明
HTTP请求方式：GET
base_url:
https://www.feeclouds.com
API:
/api/v1/invoice
请求参数格式:
form-data
参数说明
| 参数 | 参数类型 | 必须 | 说明 |
|---|---|---|---|
| company_key | str | 是 | 费耘系统提供的企业company_key |
| nonce_str | str | 是 | 6位随机字符串 |
| sign | str | 是 | 根据签名生成规则生成的签名 |
| department_ids | str | 否 | 需要获取发票的所属部门，支持获取多个子部门的发票 获取多个部门发票时，id用","分隔，并且用单引号引起来 示例： '8da63bfd4a0a482cb8661c0bcdec7693,9f02d76eba2145a8bc710d972a08b078' 注：有集团模式公司可传子公司的department_id，获取整个子公司的发票 |
| invoiceid | str | 否 | 需要获取的发票的id |
| start_time | str | 否 | 发票查验时间起（create_time），格式为：由数字组成的长度为14的字符串，例如："20170922110000" 代表2017年09月22日11时0分0秒 |
| end_time | str | 否 | 发票查验时间止（create_time），格式为：由数字组成的长度为14的字符串，例如："20170922240000" 代表2017年09月22日24时0分0秒 |
| user_id | str | 否 | 发票归属人的id |
| state | str | 否 | 发票状态标识，2：已提交，3：已导出，4：已删除，不指定的情况下默认是"2,3" |
| page_num | int | 否 | 用来指定页数，不指定的情况下默认是1 |
| page_size | int | 否 | 用来指定每页的条数，不指定的情况下默认是10 |
返回结果
返回成功json示例
{
"msg": "成功",
"code": 0,
"data": {
"count": 2,
"data": [{
"invoice_detail": [{
"cph": null,
"fyxm": null,
"dj": "108.85",
"tszcbs": " ",
"ggxh": "无",
"hwmc": "*运输服务*客运服务费",
"slv": "3",
"txrqz": null,
"sjsl": " ",
"txrqq": null,
"dw": "次",
"sl": "1",
"je": "108.85",
"lx": null,
"se": "3.27",
"sjse": " "
}],
"invoice": {
"invoiceid": "1bf8faba939643bb929fcd9762e4f009",
"zh": null,
"xfsbh": "911201163409833307",
"gfdzdh": " ",
"department_id": "92eae8cfda6540b09d6d1980f94f7508",
"swjg_dm": null,
"xcrs": null,
"fpdm": "012001800311",
"zfbz": "N",
"xfdzdh": "北京市朝阳国贸C座102室12单元001-59002821",
"create_time": "2019-04-17 21:43:35",
"kprq": "2019-02-25",
"dw": null,
"fdjhm": null,
"gfsbh": "91110108MA004B7X3P",
"cjfy": null,
"dkbz": null,
"user_id": "ae6d6a51a470434ea683c32da5db3043",
"gfyhzh": " ",
"sjdh": null,
"wspzhm": null,
"cd": null,
"state": "已导出",
"tags": [项目1， 上海]
"sfzhm": null,
"memo": "",
"cpxh": null,
"jqbh": "499099604536",
"hgzs": null,
"jshj": "112.12",
"dh": null,
"cjhm": null,
"fplc": null,
"jkzmsh": null,
"cpybz": "N",
"dz": null,
"cllx": null,
"je": "108.85",
"gfmc": "北京方大科技有限公司",
"fpzl": "10",
"bswj_match": "1",
"bswj": {
"file_type": "ofd",
"path": "https://app-fc-hybrid.oss-accelerate.aliyuncs.com/bswj/124/051002000113_15655349.ofd?OSSAccessKeyId=UtsfGjiJTnHhgKLZ&Expires=1620802492&Signature=igEWbqxsaBzhMf5ulKT7u6TOY7Q%3D",
"preview_url": "https://app-fc-hybrid.oss-accelerate.aliyuncs.com/bswj/124/051002000113_15655349.jpg?OSSAccessKeyId=UtsfGjiJTnHhgKLZ&Expires=1620802492&Signature=Ex6ACB6dfdwsh1%2BGJ4jewDhHXQw%3D"
},
"bz": " ",
"fphm": "02880602",
"xhdwmc": null,
"ghdw": null,
"file_url": [
"http://hybrid.feeclouds.com/pictures_ocr%2F309%2F5p8WGtzwBd.pdf?OSSAccessKeyId=UtsfGjiJTnHhgKLZ&Expires=1556356725&Signature=EWVdk84fXISmZfQnY%2FngyzjUtnY%3D"
],
"swjg_mc": null,
"nsrsbh": null,
"xfmc": "迪迪出行科技有限公司",
"zzssl": null,
"xfyhzh": "招商银行股份有限公司天津支行122905939913333",
"zzsse": null,
"jym": "10220255606947321111",
"khyh": null,
"se": "3.27",
"tspzbz": "";
}
}, {
"invoice_detail": [{
"ggxh": "",
"dw": "",
"sl": "",
"dj": "",
"je": "",
"slv": null,
"se": "92.48",
"fyxm": null,
"hwmc": "",
"txrqz": null,
"txrqq": null,
"lx": null,
"cph": null,
"tszcbs": "",
"sjsl": "",
"sjse": "",
"hd": "1",
"sfz": "成都-双流 T2",
"mdz": "无锡-苏南硕放 T2",
"cyr": "川航",
"hbh": "3U8981",
"zwdj": "E",
"cyrq": "2024-08-15",
"qfsj": "09:05",
"kpjb": "SA"
}],
"invoice": {
"bswj_match": 1,
"fpdm": "",
"fphm": "24518876211001638532",
"kprq": "2024-08-16",
"xfmc": "",
"xfsbh": null,
"xfdzdh": null,
"dkbz": "",
"xfyhzh": null,
"cpybz": "N",
"gfmc": "沈阳脱普生活用品服务有限公司成都分公司",
"gfsbh": "91510100690918395P",
"gfdzdh": null,
"gfyhzh": null,
"jym": "",
"se": "92.48",
"jshj": "1170.00",
"je": "",
"jqbh": null,
"zfbz_new": "0",
"fpzl": "61",
"bz": null,
"ghdw": null,
"sfzhm": null,
"cllx": null,
"cpxh": null,
"cd": null,
"hgzs": null,
"cjfy": null,
"sjdh": null,
"fdjhm": null,
"cjhm": null,
"jkzmsh": null,
"xhdwmc": null,
"dh": null,
"nsrsbh": null,
"zh": null,
"dz": null,
"khyh": null,
"zzssl": null,
"zzsse": null,
"swjg_dm": null,
"wspzhm": null,
"dw": null,
"xcrs": null,
"fplc": null,
"swjg_mc": null,
"create_time": "2024-08-21 15:09:57",
"user_id": "46f1f3e45fc147879cb39e5322fdaeb6",
"invoiceid": "4f7de817bb004a6caed9cd6092025ab1",
"memo": null,
"state": "已提交",
"department_id": "6cca2333b1ef429f9edf9004d88deb41",
"bswj": {
"path": "https://app-fc-test.oss-cn-beijing.aliyuncs.com/bswj/1939/_24518876211001638532.pdf?Expires=1724236617&OSSAccessKeyId=LTAI5tA5egm1TVH8K1ucCgS3&Signature=cWjt26JYiJTNBY5eKONh7hZhBDY%3D",
"file_type": "pdf"
},
"bswj_list": [{
"path": "https://app-fc-test.oss-cn-beijing.aliyuncs.com/bswj/1939/_24518876211001638532.pdf?Expires=1724236617&OSSAccessKeyId=LTAI5tA5egm1TVH8K1ucCgS3&Signature=cWjt26JYiJTNBY5eKONh7hZhBDY%3D",
"file_type": "pdf"
},
{
"path": "https://app-fc-test.oss-cn-beijing.aliyuncs.com/bswj/1939/_24518876211001638532.ofd?Expires=1724236617&OSSAccessKeyId=LTAI5tA5egm1TVH8K1ucCgS3&Signature=SAh710UR5L0SgGLqaFLsTk7zz7g%3D",
"file_type": "ofd",
"preview_url": "https://app-fc-test.oss-cn-beijing.aliyuncs.com/bswj/1939/_24518876211001638532.jpg?Expires=1724236617&OSSAccessKeyId=LTAI5tA5egm1TVH8K1ucCgS3&Signature=qGkRVn4yURzKpQSfVsk%2BqSalodQ%3D"
},
{
"path": "https://app-fc-test.oss-cn-beijing.aliyuncs.com/bswj/1939/_24518876211001638532.xml?Expires=1724236617&OSSAccessKeyId=LTAI5tA5egm1TVH8K1ucCgS3&Signature=1BGSjt4r3yaYLjZpsQFRhp14nHo%3D",
"file_type": "xml"
}
],
"zfbz": "N",
"file_url": [
"https://app-fc-test.oss-cn-beijing.aliyuncs.com/f_screenshot/2024/08/21/_24518876211001638532.png?Expires=1724236617&OSSAccessKeyId=LTAI5tA5egm1TVH8K1ucCgS3&Signature=3Bmt1M264dWImnh%2FkJhmCnUWIyc%3D"
],
"tags": []
}
}]
}
}
返回参数(invoice)说明
invoice公共字段详见查验接口invoice公共字段说明
| 参数 | 参数类型 | 说明 |
|---|---|---|
| user_id | str | 发票归属人的id |
| invoiceid | str | 发票在费耘系统中的唯一标识 |
| department_id | str | 发票归属人所在部门id |
| file_url | str | 查验截屏附件地址，有效时间为10分钟 各个链接判断： 最后一个：查验截屏（f_screenshot) 第一个：发票切图（如有） 第二个：上传的发票原文件（如有） 其他：上传的附件 |
| bswj_list | str | 返回数电票（fpzl：0910、0920、61、83）的版式文件，最多包含pdf、ofd、xml三种格式的版式文件。 |
返回参数(invoice_detail)说明
详见查验接口invoice_detail说明