请求
#
接口概述
#
获取供应商上传的发票列表(平台进项票)。不是供应商测提供的接口。
此接口用来获取供应商开具给平台的发票过往历史数据。
发票种类(invoice_kind)说明:
#
| 值 |
类型 |
说明 |
| 08 |
string |
纸质增值税电子专用发票 |
| 10 |
string |
纸质增值税电子普通发票 |
| 81 |
string |
数电票增值税专用发票 |
| 82 |
string |
数电票普通发票 |
发票类型(invoice_type)说明:
#
| 值 |
类型 |
说明 |
| 1 |
int |
蓝票 |
| 2 |
int |
红票 |
请求URL
#
| 参数名 |
类型 |
是否必填 |
说明 |
| Authorization |
string |
是 |
token |
请求参数(url path)
#
| 参数名 |
类型 |
是否必填 |
说明 |
| page |
int |
否 |
页码 |
| per_page |
int |
否 |
每页数量 |
| bill_no |
string |
否 |
账单编号 |
| electronic_no |
string |
否 |
发票号(模糊查询:invoice_no,invoice_code,electronic_no) |
| invoice_kind |
string |
否 |
发票种类(08,10,81,82) |
请求示例
#
GET {{host}}/invoices?page=1&per_page=10&bill_no=2024061217033&invoice_kind=08
响应
#
响应参数
#
| 参数名 |
类型 |
路径 |
说明 |
| code |
int |
|
错误码 |
| msg |
str |
|
错误信息 |
| page |
int |
|
页码 |
| per_page |
int |
|
每页数量 |
| total_rows |
int |
|
总条数 |
| data |
array |
|
发票列表 |
| id |
array |
data |
发票列表 |
| bill_id |
int |
data |
账单ID |
| bill_no |
string |
data |
账单编号 |
| electronic_no |
string |
data |
电子发票号 |
| invoice_no |
string |
data |
发票号码 |
| invoice_code |
string |
data |
发票代码 |
| invoiced_at |
string |
data |
开票时间 |
| invoice_kind |
string |
data |
发票种类 |
| invoice_type |
int |
data |
发票类型 |
| buyer_name |
string |
data |
买家名称 |
| buyer_tax_no |
string |
data |
买家税号 |
| buyer_address |
string |
data |
买家地址 |
| buyer_bank_name |
string |
data |
买家银行 |
| buyer_bank_account |
string |
data |
买家银行账号 |
| buyer_tel |
string |
data |
买家电话 |
| buyer_email |
string |
data |
买家邮箱 |
| amount_with_tax |
float |
data |
价税合计 |
| tax_amount |
float |
data |
税额 |
| no_tax_amount |
float |
data |
不含税金额 |
| seller_tax_no |
string |
data |
销方税号 |
| seller_name |
string |
data |
销方名称 |
| seller_tel |
string |
data |
销方电话 |
| invoice_xml |
string |
data |
发票xml |
| invoice_pdf_url |
string |
data |
发票pdf地址 |
| red_flag |
string |
data |
红票标志 |
| blue_invoice_no |
string |
data |
蓝票发票号 |
| blue_invoice_code |
string |
data |
蓝票发票代码 |
| blue_electronic_no |
string |
data |
蓝票电子发票号 |
| created_at |
string |
data |
创建时间 |
| updated_at |
string |
data |
更新时间 |
响应示例
#
{
"code": 10000,
"msg": "success",
"data": [
{
"id": 1,
"bill_id": 1,
"bill_no": "2024061217033",
"electronic_no": "123456",
"invoice_no": "123456",
"invoice_code": "123456",
"invoiced_at": "2024-06-13 15:04:05",
"invoice_kind": "08",
"invoice_type": 1,
"buyer_name": "买家",
"buyer_tax_no": "123456",
"buyer_address": "买家地址",
"buyer_bank_name": "买家银行",
"buyer_bank_account": "123456",
"buyer_tel": "123456",
"buyer_email": "123456@123.com",
"amount_with_tax": 100.00,
"tax_amount": 10.00,
"no_tax_amount": 90.00,
"seller_tax_no": "123456",
"seller_name": "平台",
"seller_tel": "123456",
"invoice_xml": "http://www.example.com/invoice.xml",
"invoice_pdf_url": "http://www.example.com/invoice.pdf",
"red_flag": "NOT_RED",
"blue_invoice_no": "123456",
"blue_invoice_code": "123456",
"blue_electronic_no": "123456",
"created_at": "2024-06-13 15:04:05",
"updated_at": "2024-06-13 15:04:05"
}
],
"page": 1,
"per_page": 2,
"total_rows": 5
}