/basicOpen/finance/vc/invoice/page{
"operation": {
"method": "POST",
"path": "/basicOpen/finance/vc/invoice/page"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/finance/vc/invoice/page?access_token=value×tamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n \"pageNum\": 1,\n \"pageSize\": 20,\n \"countryList\": [],\n \"sidList\": [],\n \"invoiceTypeList\": [],\n \"paymentStatus\": \"\",\n \"fundingTypeList\": [],\n \"invoiceStatusList\": [],\n \"startDate\": \"2025-08-01\",\n \"endDate\": \"2026-08-01\",\n \"payeeCodeList\": [],\n \"dateType\": \"invoice\",\n \"searchField\": \"invoiceNumber\",\n \"searchValue\": \"\",\n \"searchValueList\": []\n}'",
"responseExample": {
"code": 0,
"message": "success",
"error_details": [],
"request_id": "a0d54debf93140f3b58d1ed81e8e3583",
"response_time": "2026-10-12 12:00:00",
"data": {
"total": 2,
"size": 20,
"pageCount": 1,
"current": 1,
"currentSize": 2,
"records": [
{
"sid": 134225003201380860,
"storeName": "VC美国店铺",
"country": "US",
"invoiceNumber": "INV-250806-01",
"invoiceType": "invoice",
"invoiceDateStr": "2025-08-06",
"isPaid": true,
"paymentResponseList": [
{
"sid": 134225003201380860,
"invoiceNumber": "INV-250806-01PC",
"invoiceNumberExtract": "INV-250806-01",
"currencyCode": "USD",
"amountPaid": -78.01,
"remainingAmount": 0,
"invoiceAmount": 78.8,
"withholdingAmount": 0,
"termsDiscountTaken": 0.79,
"invoiceCurrency": "$",
"description": "1RX2O6YR/RDU4/",
"paymentNumber": "366666688",
"paymentDateStr": "2025-08-07"
}
],
"currencyCode": "USD",
"paymentDueDateStr": "2025-09-17",
"payeeCode": "B0806",
"purchaseOrderNumber": "PO25080601",
"invoiceStatus": "UNPAID",
"invoiceCurrencySymbol": "$",
"invoiceAmount": 370,
"actualPaidAmount": 0,
"inProgressAmount": 370,
"totalMatchedToDateAmount": 370,
"queuedForPaymentAmount": 370,
"quantityVarianceAmount": 0,
"priceVarianceAmount": 0,
"quickPayDiscount": 0,
"agreementId": null,
"agreementTitle": null,
"fundingType": null,
"originalBalance": null,
"originalBalanceCurrency": null
},
{
"sid": 134225003201380860,
"storeName": "VC美国店铺",
"country": "US",
"invoiceNumber": "2050-1414856005",
"invoiceType": "coop",
"invoiceDateStr": "2026-05-14",
"isPaid": false,
"paymentResponseList": [],
"currencyCode": "USD",
"paymentDueDateStr": null,
"payeeCode": null,
"purchaseOrderNumber": null,
"invoiceStatus": null,
"invoiceCurrencySymbol": null,
"invoiceAmount": null,
"actualPaidAmount": null,
"inProgressAmount": null,
"totalMatchedToDateAmount": null,
"queuedForPaymentAmount": null,
"quantityVarianceAmount": null,
"priceVarianceAmount": null,
"quickPayDiscount": null,
"agreementId": 107450800,
"agreementTitle": "合作费用协议示例",
"fundingType": "Vendor Funded Sales Discount",
"originalBalance": 90.09,
"originalBalanceCurrency": "$"
}
],
"hasNextPage": false,
"hasPreviousPage": false
},
"total": 2
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | pageNum | 页码 | integer | — | Optional | 页码,默认1,最小1 |
| 2 | pageSize | 每页数量 | integer | — | Optional | 每页数量,默认20,范围1~200 |
| 3 | countryList | 国家ID列表 | array<any> | — | Optional | 国家ID列表 |
| 4 | sidList | VC店铺ID列表 | array<any> | — | Optional | VC店铺ID列表 |
| 5 | invoiceTypeList | 发票类型 | array<any> | — | Optional | 发票类型: invoice:采购发票 coop:合作费用发票 空数组:不筛选 |
| 6 | fundingTypeList | 资金类型 | array<any> | — | Optional | 资金类型: Accrual:应计 Straight Payment:直接付款 Vendor Funded Sales Discount:供应商资助销售折扣 |
| 7 | invoiceStatusList | 发票状态 | array<any> | — | Optional | 发票状态: PAID:已付款 UNPAID:未付款 QUEUED_FOR_PAYMENT:排队付款 PROCESSING,PENDING_AMAZON_ACTION:处理中/等待亚马逊操作,需作为一个字符串传入 空数组:不筛选 |
| 8 | startDate | 开始日期 | string | — | Required | 开始日期,格式yyyy-MM-dd,不能晚于endDate |
| 9 | endDate | 结束日期 | string | — | Required | 结束日期,格式yyyy-MM-dd |
| 10 | payeeCodeList | 供应商编码列表 | array<any> | — | Optional | 供应商编码列表,由客户直接传入;空数组不筛选 |
| 11 | dateType | 日期类型 | string | — | Optional | 日期类型,默认invoice: invoice:发票日期 payment:付款日期 |
| 12 | searchField | 搜索字段 | string | — | Optional | 搜索字段,默认invoiceNumber: invoiceNumber:发票编号 purchaseOrderNumber:采购订单编号 |
| 13 | searchValue | 单个搜索值 | string | — | Optional | 单个搜索值 |
| 14 | searchValueList | 批量搜索值列表 | array<any> | — | Optional | 批量搜索值列表 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | Required | 状态码,0=成功 |
| 2 | message | 消息提示 | string | success | Required | 消息提示 |
| 3 | error_details | 数据校验失败时的错误详情 | array<any> | [] | Required | 数据校验失败时的错误详情 |
| 4 | request_id | 请求链路ID | string | a0d54debf93140f3b58d1ed81e8e3583 | Required | 请求链路ID |
| 5 | response_time | 响应时间 | string | 2026-10-12 12:00:00 | Required | 响应时间 |
| 6 | data | 响应数据 | object | — | Required | 响应数据 |
| 6.1 | total | 总记录数 | integer | 2 | Required | 总记录数 |
| 6.2 | size | 每页数量 | integer | 20 | Required | 每页数量 |
| 6.3 | pageCount | 总页数 | integer | 1 | Required | 总页数 |
| 6.4 | current | 当前页码 | integer | 1 | Required | 当前页码 |
| 6.5 | currentSize | 当前页记录数 | integer | 2 | Required | 当前页记录数 |
| 6.6 | records | 发票列表 | array<object> | — | Required | 发票列表 |
| 6.6.1 | sid | VC店铺ID | integer | 134225003201380860 | Required | VC店铺ID |
| 6.6.2 | storeName | 店铺名称 | string | VC美国店铺 | Required | 店铺名称 |
| 6.6.3 | country | 国家代码 | string | US | Required | 国家代码 |
| 6.6.4 | invoiceNumber | 发票编号 | string | INV-250806-01 | Required | 发票编号 |
| 6.6.5 | invoiceType | 发票类型 | string | invoice | Required | 发票类型:invoice=采购发票,coop=合作费用发票 |
| 6.6.6 | invoiceDateStr | 发票日期 | string | 2025-08-06 | Required | 发票日期,格式yyyy-MM-dd |
| 6.6.7 | isPaid | 是否已付款 | boolean | true | Required | 是否已付款,保持上游判断结果 |
| 6.6.8 | paymentResponseList | 付款明细列表 | array<object> | — | Required | 付款明细列表 |
| 6.6.8.1 | sid | VC店铺ID | integer | 134225003201380860 | Required | VC店铺ID |
| 6.6.8.2 | invoiceNumber | 付款明细原始发票编号 | string | INV-250806-01PC | Required | 付款明细原始发票编号 |
| 6.6.8.3 | invoiceNumberExtract | 提取后的发票编号 | string | INV-250806-01 | Required | 提取后的发票编号 |
| 6.6.8.4 | currencyCode | 币种代码 | string | USD | Required | 币种代码 |
| 6.6.8.5 | amountPaid | 已付金额 | number | -78.01 | Required | 已付金额,可为负数 |
| 6.6.8.6 | remainingAmount | 剩余金额 | number | 0 | Required | 剩余金额 |
| 6.6.8.7 | invoiceAmount | 发票金额 | number | 78.8 | Required | 发票金额 |
| 6.6.8.8 | withholdingAmount | 预扣金额 | number | 0 | Required | 预扣金额 |
| 6.6.8.9 | termsDiscountTaken | 已享受的付款条款折扣 | number | 0.79 | Required | 已享受的付款条款折扣 |
| 6.6.8.10 | invoiceCurrency | 发票币种符号 | string | $ | Required | 发票币种符号 |
| 6.6.8.11 | description | 付款描述 | string | 1RX2O6YR/RDU4/ | Required | 付款描述 |
| 6.6.8.12 | paymentNumber | 付款编号 | string | 366666688 | Required | 付款编号 |
| 6.6.8.13 | paymentDateStr | 付款日期 | string | 2025-08-07 | Required | 付款日期,格式yyyy-MM-dd |
| 6.6.9 | currencyCode | 币种代码 | string | USD | Required | 币种代码 |
| 6.6.10 | paymentDueDateStr | 付款到期日 | string | 2025-09-17 | Required | 付款到期日,格式yyyy-MM-dd,可能为null |
| 6.6.11 | payeeCode | 收款方代码 | string | B0806 | Required | 收款方代码,可能为null |
| 6.6.12 | purchaseOrderNumber | 采购订单编号 | string | PO25080601 | Required | 采购订单编号,可能为null |
| 6.6.13 | invoiceStatus | 发票状态 | string | UNPAID | Required | 发票状态,保持上游值,可能为null |
| 6.6.14 | invoiceCurrencySymbol | 发票币种符号 | string | $ | Required | 发票币种符号,可能为null |
| 6.6.15 | invoiceAmount | 发票金额 | number | 370 | Required | 发票金额,可能为null |
| 6.6.16 | actualPaidAmount | 实际已付金额 | number | 0 | Required | 实际已付金额,可能为null |
| 6.6.17 | inProgressAmount | 处理中金额 | number | 370 | Required | 处理中金额,可能为null |
| 6.6.18 | totalMatchedToDateAmount | 截至当前已匹配金额 | number | 370 | Required | 截至当前已匹配金额,可能为null |
| 6.6.19 | queuedForPaymentAmount | 排队付款金额 | number | 370 | Required | 排队付款金额,可能为null |
| 6.6.20 | quantityVarianceAmount | 数量差异金额 | number | 0 | Required | 数量差异金额,可能为null |
| 6.6.21 | priceVarianceAmount | 价格差异金额 | number | 0 | Required | 价格差异金额,可能为null |
| 6.6.22 | quickPayDiscount | 快速付款折扣 | number | 0 | Required | 快速付款折扣,可能为null |
| 6.6.23 | agreementId | 合作协议ID | integer | 107450800 | Required | 合作协议ID,可能为null |
| 6.6.24 | agreementTitle | 合作协议标题 | string | 合作费用协议示例 | Required | 合作协议标题,可能为null |
| 6.6.25 | fundingType | 资金类型 | string | Vendor Funded Sales Discount | Required | 资金类型:Accrual、Straight Payment、Vendor Funded Sales Discount,可能为null |
| 6.6.26 | originalBalance | 原始余额 | number | 90.09 | Required | 原始余额,可能为null |
| 6.6.27 | originalBalanceCurrency | 原始余额币种符号 | string | $ | Required | 原始余额币种符号,可能为null |
| 6.7 | hasNextPage | 是否有下一页 | boolean | false | Required | 是否有下一页 |
| 6.8 | hasPreviousPage | 是否有上一页 | boolean | false | Required | 是否有上一页 |
| 7 | total | 总记录数 | integer | 2 | Required | 总记录数,与data.total一致 |
The 查询VC结算发票列表 API (/basicOpen/finance/vc/invoice/page) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.