轻易云
注册体验

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

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
VC · POST · 请求参数 14 个(必填 2) · 响应参数 55 个 · 限流令牌桶容量 1
更新日期
2026-11-21

查询VC结算发票列表

POST/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&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
  }
}

接口请求参数

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

接口响应参数

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

领星ERP的接口:查询VC结算发票列表(/basicOpen/finance/vc/invoice/page),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。