获取进项发票接口
请求说明
HTTP请求方式:GET
base_url:
https://www.feeclouds.com
API:
/api/v2/deduction/result
请求参数格式:
form-data
参数说明
参数名称 | 参数类型 | 是否必须 | 说明 |
---|---|---|---|
company_key | str | 是 | 费耘系统提供的企业company_key |
nonce_str | str | 是 | 6位随机字符串 |
sign | str | 是 | 根据签名生成规则生成的签名 |
tax_no | str | 是 | 需要获取进项发票的公司的税号 |
fpdm | str | 否 | 发票代码 |
fphm | str | 否 | 发票号码 |
fpzt | str | 否 | 发票状态 0-正常 1-失控 2-作废 3-红冲 4-异常 |
inv_start_date | str | 否 | 发票开票日期起,格式为:由数字组成的长度为8的字符串,例如:"20170922" 代表2017年09月22日 |
inv_end_date | str | 否 | 发票开票日期止,格式为:由数字组成的长度为8的字符串,例如:"20170922" 代表2017年09月22日 |
tax_period | str | 否 | 税款所属期 如:“201805”代表税期为2018年5月 |
received_start_date | str | 否 | 发票签收起始日期,格式为:由数字组成的长度为8的字符串,例如:"20170922" 代表2017年09月22日 |
received_end_date | str | 否 | 发票签收结束日期,格式为:由数字组成的长度为8的字符串,例如:"20170922" 代表2017年09月22日 |
deduction_start_date | str | 否 | 发票认证起始日期,格式为:由数字组成的长度为8的字符串,例如:"20170922" 代表2017年09月22日 |
deduction_end_date | str | 否 | 发票认证结束日期,格式为:由数字组成的长度为8的字符串,例如:"20170922" 代表2017年09月22日 |
received_user_id | str | 否 | 签收人id(id为成员在费耘系统中的唯一标识) |
received_state | str | 否 | 发票签收状态 0-未签收 1-已签收 |
deduction_state | str | 否 | 发票认证状态 0-未认证 1-待认证 2-已发送认证 3-已认证 9-不需认证 |
page_num | int | 否 | 用来指定页数,不指定的情况下默认是1 |
page_size | int | 否 | 用来指定每页的条数,不指定的情况下默认是10 |
返回结果
返回json示例
{
'msg': '成功',
'code': 0,
'data': {
'invoices': [
{
"jshj": "300.00",
"fpzt": 0,
"xfsbh": "914409022084699999",
"tax_period": "201802",
"fpdm": "4403182111",
"reason": 1,
"deduction_state": 3,
"kprq": "20180117",
"gfsbh": "911101083069823000",
"je": "283.02",
"gfmc": "北京实施科技有限公司",
"fpzl": "01",
"fphm": "50800922",
"deduction_date": "20180210",
"deduction_result": 1,
"received_user_id": "",
"xfmc": "深圳市腾讯有限公司",
"received_date": "20180210",
"deduction_user_id": "7d5afe2eddae4e94b37161ad8891389d",
"received_state": 1,
"se": "16.98"
}
],
'total_count': 10,
'total_page': 1
}
}
返回参数说明
参数名称 | 参数类型 | 说明 |
---|---|---|
fpzl | str | 发票种类 "01": "增值税专用发票" "03": "机动车销售统一发票" "04": "增值税普通发票" '14': "增值税普通发票(通行费)" |
fpdm | str | 发票代码 |
fphm | str | 发票号码 |
kprq | str | 开票日期 |
je | str | 金额 |
se | str | 税额 |
jshj | str | 价税合计 |
xfmc | str | 销方名称 |
xfsbh | str | 销方识别 |
gfmc | str | 购方名称 |
gfsbh | str | 购方识别号 |
fpzt | int | 发票状态 0-正常 1-失控 2-作废 3-红冲 4-异常 |
tax_period | str | 税款所属期 |
received_state | int | 签收状态 0-未签收 1-签收 |
received_date | str | 签收日期 |
received_user_id | str | 签收人id |
deduction_state | int | 认证状态 0-未认证 1-待发送认证 2-认证中 3-已认证 4-待确认 9-不需认证 |
deduction_result | int | 认证结果 0-未认证 1-认证通过 2-认证不通过 9-不需认证 |
deduction_date | str | 认证时间 |
deduction_user_id | str | 认证人id |
reason | int | 认证结果信息 1-成功 2-未找到目标发票 3-异常发票无法认证,如失控、作废等异常状态发票 4-该票已经认证 5-该票已经逾期无法认证,即超过360天有效期 6-该票已经申请认证,处于认证中状态 7-申请认证月份已过期,如当前税期为2月,申报1月 8-其它异常,如发票在认证中就做申请统计,会导致发票认证异常 9-税期未到,如当前税期为2月,申报3月 10-红冲发票不能抵扣 11-认证类型错误,认证类型包含抵扣认证,不抵扣认证,取消认证,退税认证 |