开票列表查询 - 小红书 API

curl --location --request POST 'https://ark.xiaohongshu.com/ark/open_api/v3/common_controller' \ --header 'Content-Type: application/json;charset=utf-8' \ --data-raw '{ "invoiceStatus": "", "refNo": "null", "startDateLong": "", "endDateLong": "", "pageNum": "", "pageSize": "", "sortEnum": "", "titleType": "" }'

{ "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" } ] }

请求参数

Header 参数

Content-Type

string

可选

默认值:

application/json;charset=utf-8

Body 参数application/json

timestamp

string

必需

接口调用时的时间戳，即当前时间戳（时间戳：当前距离Epoch（1970年1月1日) 以秒计算的时间，即unix-timestamp

appId

string

必需

第三方获取到的appid

sign

string

输入参数的签名结果

必需

version

string

必需

版本号，采用oauth2授权后均填入2.0

method

string

具体调用方法

必需

accessToken

string

可选

业务接口鉴权。非必须，调用商家业务接口必须使用

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：企业

示例

返回响应

🟢200成功

application/json

Body

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地址

可选