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

参数说明:

  1. 订单号和发票创建时间不能同时为空;
  2. 时间查询为 beginTime <= 时间 < endTime, 左闭合, 所以查询一个月的日期类似 beginTime = '2020-01-01 00:00:00', endTime = '2020-02-01 00:00:00', 一次查询区间不能超过一个自然月最大天数 31 天;
  3. 数据以返回的页码和总页码为准, 直到获取不到更多数据为止.

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, // 订单ID
                "type": 0, // 0-无发票,1-个人纸质普票,2-企业纸质普票,4-电子发票(旧版),5-个人电子普票,6-企业电子普票
                "invoiceTitle": "string(发票抬头)",
                "companyCode": "string(购方企业税号,电子发票公司编码)",
                "companyPhone": "string(购方企业电话)",
                "companyAddr": "string(购方企业地址)",
                "companyBankName": "string(购方企业开户行名称)",
                "companyBankAccount": "string(购方企业开户行账号)",
                "productList": [ // 订单购买的产品详情列表
                    { 
                        "name": "智米直流变频落地扇", // 产品名称
                        "pid": 1034, // 产品ID
                        "count": 1, // 该pid商品数量
                        "price": 799, // 产品支付价格,单位:元
                        "status": 1, // 发票状态(1-待开(已发货),2-已开,3-待作废,4-已作废,5-待开发票(已收货)),6-开票失败
                        "invoiceUrl": "https://fpkj.vpiaotong.com/pages/tp/scanInvoice/invoice-electronic.shtml?file=NDJMRkdZWlQzNTc0NDg2NA.pdf",
                    }
                ],
            }
        ],
    }
}

6. 发票类型字典

invoice type 字段描述 备注
0 不开发票
1 个人纸质普票
2 企业纸质普票
4 个人电子发票 已废弃
5 个人电子普票
6 企业电子普票
©xiaomiyoupin.com 苏B2-20180351 苏ICP备18025642号-1            该文件修订时间: 2023-04-26 01:54:18

results matching ""

    No results matching ""