Qeasy Cloud
Get Started

领星ERP 查询VC结算发票列表 API

Platform
领星ERP
Type
WebAPI
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
VC · POST · 请求参数 14 个(必填 2) · 响应参数 55 个 · 限流令牌桶容量 1
Updated At
2026-11-21

查询VC结算发票列表

POST/basicOpen/finance/vc/invoice/page
Factory
{
  "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&timestamp=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
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1pageNum页码integer—Optional页码,默认1,最小1
2pageSize每页数量integer—Optional每页数量,默认20,范围1~200
3countryList国家ID列表array<any>—Optional国家ID列表
4sidListVC店铺ID列表array<any>—OptionalVC店铺ID列表
5invoiceTypeList发票类型array<any>—Optional发票类型: invoice:采购发票 coop:合作费用发票 空数组:不筛选
6fundingTypeList资金类型array<any>—Optional资金类型: Accrual:应计 Straight Payment:直接付款 Vendor Funded Sales Discount:供应商资助销售折扣
7invoiceStatusList发票状态array<any>—Optional发票状态: PAID:已付款 UNPAID:未付款 QUEUED_FOR_PAYMENT:排队付款 PROCESSING,PENDING_AMAZON_ACTION:处理中/等待亚马逊操作,需作为一个字符串传入 空数组:不筛选
8startDate开始日期string—Required开始日期,格式yyyy-MM-dd,不能晚于endDate
9endDate结束日期string—Required结束日期,格式yyyy-MM-dd
10payeeCodeList供应商编码列表array<any>—Optional供应商编码列表,由客户直接传入;空数组不筛选
11dateType日期类型string—Optional日期类型,默认invoice: invoice:发票日期 payment:付款日期
12searchField搜索字段string—Optional搜索字段,默认invoiceNumber: invoiceNumber:发票编号 purchaseOrderNumber:采购订单编号
13searchValue单个搜索值string—Optional单个搜索值
14searchValueList批量搜索值列表array<any>—Optional批量搜索值列表

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0=成功
2message消息提示stringsuccessRequired消息提示
3error_details数据校验失败时的错误详情array<any>[]Required数据校验失败时的错误详情
4request_id请求链路IDstringa0d54debf93140f3b58d1ed81e8e3583Required请求链路ID
5response_time响应时间string2026-10-12 12:00:00Required响应时间
6data响应数据object—Required响应数据
6.1total总记录数integer2Required总记录数
6.2size每页数量integer20Required每页数量
6.3pageCount总页数integer1Required总页数
6.4current当前页码integer1Required当前页码
6.5currentSize当前页记录数integer2Required当前页记录数
6.6records发票列表array<object>—Required发票列表
6.6.1sidVC店铺IDinteger134225003201380860RequiredVC店铺ID
6.6.2storeName店铺名称stringVC美国店铺Required店铺名称
6.6.3country国家代码stringUSRequired国家代码
6.6.4invoiceNumber发票编号stringINV-250806-01Required发票编号
6.6.5invoiceType发票类型stringinvoiceRequired发票类型:invoice=采购发票,coop=合作费用发票
6.6.6invoiceDateStr发票日期string2025-08-06Required发票日期,格式yyyy-MM-dd
6.6.7isPaid是否已付款booleantrueRequired是否已付款,保持上游判断结果
6.6.8paymentResponseList付款明细列表array<object>—Required付款明细列表
6.6.8.1sidVC店铺IDinteger134225003201380860RequiredVC店铺ID
6.6.8.2invoiceNumber付款明细原始发票编号stringINV-250806-01PCRequired付款明细原始发票编号
6.6.8.3invoiceNumberExtract提取后的发票编号stringINV-250806-01Required提取后的发票编号
6.6.8.4currencyCode币种代码stringUSDRequired币种代码
6.6.8.5amountPaid已付金额number-78.01Required已付金额,可为负数
6.6.8.6remainingAmount剩余金额number0Required剩余金额
6.6.8.7invoiceAmount发票金额number78.8Required发票金额
6.6.8.8withholdingAmount预扣金额number0Required预扣金额
6.6.8.9termsDiscountTaken已享受的付款条款折扣number0.79Required已享受的付款条款折扣
6.6.8.10invoiceCurrency发票币种符号string$Required发票币种符号
6.6.8.11description付款描述string1RX2O6YR/RDU4/Required付款描述
6.6.8.12paymentNumber付款编号string366666688Required付款编号
6.6.8.13paymentDateStr付款日期string2025-08-07Required付款日期,格式yyyy-MM-dd
6.6.9currencyCode币种代码stringUSDRequired币种代码
6.6.10paymentDueDateStr付款到期日string2025-09-17Required付款到期日,格式yyyy-MM-dd,可能为null
6.6.11payeeCode收款方代码stringB0806Required收款方代码,可能为null
6.6.12purchaseOrderNumber采购订单编号stringPO25080601Required采购订单编号,可能为null
6.6.13invoiceStatus发票状态stringUNPAIDRequired发票状态,保持上游值,可能为null
6.6.14invoiceCurrencySymbol发票币种符号string$Required发票币种符号,可能为null
6.6.15invoiceAmount发票金额number370Required发票金额,可能为null
6.6.16actualPaidAmount实际已付金额number0Required实际已付金额,可能为null
6.6.17inProgressAmount处理中金额number370Required处理中金额,可能为null
6.6.18totalMatchedToDateAmount截至当前已匹配金额number370Required截至当前已匹配金额,可能为null
6.6.19queuedForPaymentAmount排队付款金额number370Required排队付款金额,可能为null
6.6.20quantityVarianceAmount数量差异金额number0Required数量差异金额,可能为null
6.6.21priceVarianceAmount价格差异金额number0Required价格差异金额,可能为null
6.6.22quickPayDiscount快速付款折扣number0Required快速付款折扣,可能为null
6.6.23agreementId合作协议IDinteger107450800Required合作协议ID,可能为null
6.6.24agreementTitle合作协议标题string合作费用协议示例Required合作协议标题,可能为null
6.6.25fundingType资金类型stringVendor Funded Sales DiscountRequired资金类型:Accrual、Straight Payment、Vendor Funded Sales Discount,可能为null
6.6.26originalBalance原始余额number90.09Required原始余额,可能为null
6.6.27originalBalanceCurrency原始余额币种符号string$Required原始余额币种符号,可能为null
6.7hasNextPage是否有下一页booleanfalseRequired是否有下一页
6.8hasPreviousPage是否有上一页booleanfalseRequired是否有上一页
7total总记录数integer2Required总记录数,与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.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.