小红书 API

开票列表查询

POST/ark/open_api/v3/common_controller

请求参数

invoiceStatus

string

必需

开票状态，1:待开票；6：已开票；10：待作废

refNo

string

来源单号

可选

startDateLong

string

可选

申请时间（开始时间）ms

endDateLong

string

可选

申请时间（结束时间）ms

pageNum

string

分页号

可选

pageSize

string

可选

分页大小,分页大小建议在100以内

sortEnum

string

必需

升序or降序，1:升序；2：降序

titleType

string

可选

发票抬头类型，1：个人；2：企业

{
  "invoiceStatus": "",
  "refNo": "null",
  "startDateLong": "",
  "endDateLong": "",
  "pageNum": "",
  "pageSize": "",
  "sortEnum": "",
  "titleType": ""
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

pageSize

string

分页大小

必需

pageIndex

string

页码

必需

total

string

总数

必需

totalPage

string

总页数

必需

invoiceRecords

array [object {19}]

发票列表

必需

invoiceStatus

string

可选

开票状态，待开票：1；暂停中：2；冻结中：3；开票中：4；开票失败：5；已开票：6；已作废：7

xhsInvoiceNo

string

系统开票号

可选

applyTime

string

申请时间

可选

title

string

发票抬头

可选

taxNo

string

企业税号

可选

taxBankAccount

string

开户银行账户

可选

taxBankName

string

开户银行名称

可选

invoiceType

string

可选

发票类型，0:发票类型未知;1:增值税专用发票；2:增值税纸质普通发票；3:增值税电子普通发票；4:形式发票

invoiceAmt

string

可选

开票总金额，单位元，精确到两位小数

invoiceNos

string

发票号码

可选

invoiceTotalAmt

string

可选

refNo

string

来源单号

可选

titleType

string

可选

发票抬头类型，1：个人；2：企业

updatedTime

string

更新时间

可选

attrMap

string

可选

itemList

array [object {5}]

商品列表

可选

invoiceFileList

array [object {3}]

发票文件

可选

picUrl

string

电子发票图片地址

可选

pdfUrl

string

电子发票H5地址

可选

{
  "pageSize": "",
  "pageIndex": "",
  "total": "",
  "totalPage": "",
  "invoiceRecords": [
    {
      "invoiceStatus": "",
      "xhsInvoiceNo": "null",
      "applyTime": "",
      "title": "null",
      "taxNo": "null",
      "taxBankAccount": "null",
      "taxBankName": "null",
      "invoiceType": "",
      "invoiceAmt": "null",
      "invoiceNos": "null",
      "invoiceTotalAmt": "",
      "refNo": "null",
      "titleType": "",
      "updatedTime": "",
      "attrMap": "",
      "itemList": [
        {
          "itemId": "null",
          "itemName": "null",
          "price": "null",
          "taxRate": "null",
          "boughtCount": "null"
        }
      ],
      "invoiceFileList": [
        {
          "originUrl": "null",
          "downloadUrl": "null",
          "fileName": "null"
        }
      ],
      "picUrl": "null",
      "pdfUrl": "null"
    }
  ]
}

最后修改时间： 2 年前