31. 发票列表
1. 接口
/mtop/aftersale/openapi/invoice/list
2. 接口参数
公共参数
公共参数
请求参数
data:
字段 |
类型 |
是否必填 |
备注 |
orderId |
Long |
否 |
订单号 |
status |
Integer |
否 |
发票状态: 2-已开票, 3-待作废, 4-已作废, 5-待开票, 6-开票失败 |
beginTime |
String |
否 |
发票数据创建开始时间, yyyy-MM-dd HH:mm:ss 格式 |
endTime |
String |
否 |
发票创建结束时间, yyyy-MM-dd HH:mm:ss 格式 |
pageNo |
Integer |
否 |
当前页号, 默认1, 从1开始 |
pageSize |
Integer |
否 |
页大小, 默认20 pageSize <= 20 |
参数说明:
- 订单号和发票创建时间不能同时为空;
- 时间查询为 beginTime <= 时间 < endTime, 左闭合, 所以查询一个月的日期类似
beginTime = '2020-01-01 00:00:00', endTime = '2020-02-01 00:00:00'
, 一次查询区间不能超过一个自然月最大天数 31 天;
- 数据以返回的页码和总页码为准, 直到获取不到更多数据为止.
3. 请求示例
{
"beginTime": "2019-11-28 00:00:00",
"endTime": "2019-12-10 00:00:00",
"pageNo": 1,
"pageSize": 20
}
4. 返回结果
字段 |
类型 |
备注 |
pageNo |
Integer |
当前页码 |
pageSize |
Integer |
每页数据条数 |
total |
Integer |
数据总条数 |
orderList |
List<Order> |
订单发票列表 |
List<Order>
信息:
字段 |
类型 |
备注 |
orderId |
Long |
订单号 |
batchNumber |
String |
批次号 |
type |
Integer |
发票类型 |
typeDesc |
String |
发票类型描述 |
invoiceTitle |
String |
发票抬头 |
companyCode |
String |
发票公司企业编码 |
companyPhone |
String |
购方企业电话 |
companyAddr |
String |
购方企业地址 |
companyBankName |
String |
购方企业开户行名称 |
companyBankAccount |
String |
购方企业开户行账号 |
productList |
List<InvoiceListResp.Product> |
订单中商品和发票信息 |
List<InvoiceListResp.Product>
信息:
字段 |
类型 |
备注 |
name |
String |
商品pid名称 |
pid |
Long |
商品pid标识 |
count |
Integer |
商品pid当前有效开票数量 |
price |
Integer |
商品pid价格, 不含运费, 单位分 |
expressFee |
Integer |
商品pid分摊的运费, 不包含在商品价格中, 单位分 |
status |
Integer |
商品pid名称发票状态 |
statusDesc |
String |
商品pid名称发票状态描述 |
invoiceUrl |
String |
商品pid名称发票地址, 多个地址英文逗号, 分隔 |
5. 返回示例
{
"code": 0,
"message": "ok",
"data": {
"pageNo": 1,
"pageSize": 20,
"total": 2000,
"orderList": [
{
"orderId": 104154146,
"type": 0,
"invoiceTitle": "string(发票抬头)",
"companyCode": "string(购方企业税号,电子发票公司编码)",
"companyPhone": "string(购方企业电话)",
"companyAddr": "string(购方企业地址)",
"companyBankName": "string(购方企业开户行名称)",
"companyBankAccount": "string(购方企业开户行账号)",
"productList": [
{
"name": "智米直流变频落地扇",
"pid": 1034,
"count": 1,
"price": 799,
"status": 1,
"invoiceUrl": "https://fpkj.vpiaotong.com/pages/tp/scanInvoice/invoice-electronic.shtml?file=NDJMRkdZWlQzNTc0NDg2NA.pdf",
}
],
}
],
}
}
6. 发票类型字典
invoice type |
字段描述 |
备注 |
0 |
不开发票 |
|
1 |
个人纸质普票 |
|
2 |
企业纸质普票 |
|
4 |
个人电子发票 |
已废弃 |
5 |
个人电子普票 |
|
6 |
企业电子普票 |