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 |
企业电子普票 |