/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
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | pageNum | 页码 | integer | — | 可选 | 页码,默认1,最小1 |
| 2 | pageSize | 每页数量 | integer | — | 可选 | 每页数量,默认20,范围1~200 |
| 3 | countryList | 国家ID列表 | array<any> | — | 可选 | 国家ID列表 |
| 4 | sidList | VC店铺ID列表 | array<any> | — | 可选 | VC店铺ID列表 |
| 5 | invoiceTypeList | 发票类型 | array<any> | — | 可选 | 发票类型: invoice:采购发票 coop:合作费用发票 空数组:不筛选 |
| 6 | fundingTypeList | 资金类型 | array<any> | — | 可选 | 资金类型: Accrual:应计 Straight Payment:直接付款 Vendor Funded Sales Discount:供应商资助销售折扣 |
| 7 | invoiceStatusList | 发票状态 | array<any> | — | 可选 | 发票状态: PAID:已付款 UNPAID:未付款 QUEUED_FOR_PAYMENT:排队付款 PROCESSING,PENDING_AMAZON_ACTION:处理中/等待亚马逊操作,需作为一个字符串传入 空数组:不筛选 |
| 8 | startDate | 开始日期 | string | — | 必填 | 开始日期,格式yyyy-MM-dd,不能晚于endDate |
| 9 | endDate | 结束日期 | string | — | 必填 | 结束日期,格式yyyy-MM-dd |
| 10 | payeeCodeList | 供应商编码列表 | array<any> | — | 可选 | 供应商编码列表,由客户直接传入;空数组不筛选 |
| 11 | dateType | 日期类型 | string | — | 可选 | 日期类型,默认invoice: invoice:发票日期 payment:付款日期 |
| 12 | searchField | 搜索字段 | string | — | 可选 | 搜索字段,默认invoiceNumber: invoiceNumber:发票编号 purchaseOrderNumber:采购订单编号 |
| 13 | searchValue | 单个搜索值 | string | — | 可选 | 单个搜索值 |
| 14 | searchValueList | 批量搜索值列表 | array<any> | — | 可选 | 批量搜索值列表 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | 必填 | 状态码,0=成功 |
| 2 | message | 消息提示 | string | success | 必填 | 消息提示 |
| 3 | error_details | 数据校验失败时的错误详情 | array<any> | [] | 必填 | 数据校验失败时的错误详情 |
| 4 | request_id | 请求链路ID | string | a0d54debf93140f3b58d1ed81e8e3583 | 必填 | 请求链路ID |
| 5 | response_time | 响应时间 | string | 2026-10-12 12:00:00 | 必填 | 响应时间 |
| 6 | data | 响应数据 | object | — | 必填 | 响应数据 |
| 6.1 | total | 总记录数 | integer | 2 | 必填 | 总记录数 |
| 6.2 | size | 每页数量 | integer | 20 | 必填 | 每页数量 |
| 6.3 | pageCount | 总页数 | integer | 1 | 必填 | 总页数 |
| 6.4 | current | 当前页码 | integer | 1 | 必填 | 当前页码 |
| 6.5 | currentSize | 当前页记录数 | integer | 2 | 必填 | 当前页记录数 |
| 6.6 | records | 发票列表 | array<object> | — | 必填 | 发票列表 |
| 6.6.1 | sid | VC店铺ID | integer | 134225003201380860 | 必填 | VC店铺ID |
| 6.6.2 | storeName | 店铺名称 | string | VC美国店铺 | 必填 | 店铺名称 |
| 6.6.3 | country | 国家代码 | string | US | 必填 | 国家代码 |
| 6.6.4 | invoiceNumber | 发票编号 | string | INV-250806-01 | 必填 | 发票编号 |
| 6.6.5 | invoiceType | 发票类型 | string | invoice | 必填 | 发票类型:invoice=采购发票,coop=合作费用发票 |
| 6.6.6 | invoiceDateStr | 发票日期 | string | 2025-08-06 | 必填 | 发票日期,格式yyyy-MM-dd |
| 6.6.7 | isPaid | 是否已付款 | boolean | true | 必填 | 是否已付款,保持上游判断结果 |
| 6.6.8 | paymentResponseList | 付款明细列表 | array<object> | — | 必填 | 付款明细列表 |
| 6.6.8.1 | sid | VC店铺ID | integer | 134225003201380860 | 必填 | VC店铺ID |
| 6.6.8.2 | invoiceNumber | 付款明细原始发票编号 | string | INV-250806-01PC | 必填 | 付款明细原始发票编号 |
| 6.6.8.3 | invoiceNumberExtract | 提取后的发票编号 | string | INV-250806-01 | 必填 | 提取后的发票编号 |
| 6.6.8.4 | currencyCode | 币种代码 | string | USD | 必填 | 币种代码 |
| 6.6.8.5 | amountPaid | 已付金额 | number | -78.01 | 必填 | 已付金额,可为负数 |
| 6.6.8.6 | remainingAmount | 剩余金额 | number | 0 | 必填 | 剩余金额 |
| 6.6.8.7 | invoiceAmount | 发票金额 | number | 78.8 | 必填 | 发票金额 |
| 6.6.8.8 | withholdingAmount | 预扣金额 | number | 0 | 必填 | 预扣金额 |
| 6.6.8.9 | termsDiscountTaken | 已享受的付款条款折扣 | number | 0.79 | 必填 | 已享受的付款条款折扣 |
| 6.6.8.10 | invoiceCurrency | 发票币种符号 | string | $ | 必填 | 发票币种符号 |
| 6.6.8.11 | description | 付款描述 | string | 1RX2O6YR/RDU4/ | 必填 | 付款描述 |
| 6.6.8.12 | paymentNumber | 付款编号 | string | 366666688 | 必填 | 付款编号 |
| 6.6.8.13 | paymentDateStr | 付款日期 | string | 2025-08-07 | 必填 | 付款日期,格式yyyy-MM-dd |
| 6.6.9 | currencyCode | 币种代码 | string | USD | 必填 | 币种代码 |
| 6.6.10 | paymentDueDateStr | 付款到期日 | string | 2025-09-17 | 必填 | 付款到期日,格式yyyy-MM-dd,可能为null |
| 6.6.11 | payeeCode | 收款方代码 | string | B0806 | 必填 | 收款方代码,可能为null |
| 6.6.12 | purchaseOrderNumber | 采购订单编号 | string | PO25080601 | 必填 | 采购订单编号,可能为null |
| 6.6.13 | invoiceStatus | 发票状态 | string | UNPAID | 必填 | 发票状态,保持上游值,可能为null |
| 6.6.14 | invoiceCurrencySymbol | 发票币种符号 | string | $ | 必填 | 发票币种符号,可能为null |
| 6.6.15 | invoiceAmount | 发票金额 | number | 370 | 必填 | 发票金额,可能为null |
| 6.6.16 | actualPaidAmount | 实际已付金额 | number | 0 | 必填 | 实际已付金额,可能为null |
| 6.6.17 | inProgressAmount | 处理中金额 | number | 370 | 必填 | 处理中金额,可能为null |
| 6.6.18 | totalMatchedToDateAmount | 截至当前已匹配金额 | number | 370 | 必填 | 截至当前已匹配金额,可能为null |
| 6.6.19 | queuedForPaymentAmount | 排队付款金额 | number | 370 | 必填 | 排队付款金额,可能为null |
| 6.6.20 | quantityVarianceAmount | 数量差异金额 | number | 0 | 必填 | 数量差异金额,可能为null |
| 6.6.21 | priceVarianceAmount | 价格差异金额 | number | 0 | 必填 | 价格差异金额,可能为null |
| 6.6.22 | quickPayDiscount | 快速付款折扣 | number | 0 | 必填 | 快速付款折扣,可能为null |
| 6.6.23 | agreementId | 合作协议ID | integer | 107450800 | 必填 | 合作协议ID,可能为null |
| 6.6.24 | agreementTitle | 合作协议标题 | string | 合作费用协议示例 | 必填 | 合作协议标题,可能为null |
| 6.6.25 | fundingType | 资金类型 | string | Vendor Funded Sales Discount | 必填 | 资金类型:Accrual、Straight Payment、Vendor Funded Sales Discount,可能为null |
| 6.6.26 | originalBalance | 原始余额 | number | 90.09 | 必填 | 原始余额,可能为null |
| 6.6.27 | originalBalanceCurrency | 原始余额币种符号 | string | $ | 必填 | 原始余额币种符号,可能为null |
| 6.7 | hasNextPage | 是否有下一页 | boolean | false | 必填 | 是否有下一页 |
| 6.8 | hasPreviousPage | 是否有上一页 | boolean | false | 必填 | 是否有上一页 |
| 7 | total | 总记录数 | integer | 2 | 必填 | 总记录数,与data.total一致 |
领星ERP的接口:查询VC结算发票列表(/basicOpen/finance/vc/invoice/page),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。