Qeasy Cloud
Get Started

领星ERP 供应商对账明细 API

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

供应商对账明细

POST/basicOpen/purchase/supplierData/getSupplierPurchaseDataDetail
Factory
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/purchase/supplierData/getSupplierPurchaseDataDetail"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/purchase/supplierData/getSupplierPurchaseDataDetail?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"supplierId\": 10001,\n    \"startDate\": \"2026-09-01\",\n    \"endDate\": \"2026-09-10\",\n    \"timeType\": 1,\n    \"offset\": 0,\n    \"length\": 20\n}'",
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-09-10 12:00:00",
    "data": {
      "summary": {
        "purchaseQuantity": "100",
        "receiveQuantity": "80",
        "waitQuantity": "20",
        "quantityDiff": "0",
        "overReceiveNum": "0",
        "exchangeQuantity": "0",
        "returnQuantity": "0",
        "goodQuantity": "80",
        "badQuantity": "0",
        "purchaseAmount": "1000.00",
        "receiveAmount": "800.00",
        "waitAmount": "200.00",
        "returnAmount": "0.00",
        "deductionAmount": "0.00",
        "purchaseAmountWithoutTax": "884.96",
        "receiveAmountWithoutTax": "707.96",
        "waitAmountWithoutTax": "176.99",
        "inboundPurchaseAmountWithoutTax": "884.96",
        "inboundReceiveAmountWithoutTax": "707.96"
      },
      "list": [
        {
          "rowId": "900001",
          "orderSn": "CG202609100001",
          "customOrderSn": "CUSTOM001",
          "itemId": 20001,
          "type": 1,
          "typeName": "采购单",
          "sourceType": 1,
          "wid": 1001,
          "warehouseName": "深圳仓",
          "supplierId": 10001,
          "supplierName": "深圳市示例供应商有限公司",
          "buyerUid": 10001,
          "buyerName": "李四",
          "productId": 30001,
          "productName": "示例产品",
          "spu": "SPU001",
          "spuName": "示例款式",
          "sku": "SKU001",
          "msku": "MSKU001",
          "fnsku": "FNSKU001",
          "attribute": [
            {
              "attrName": "颜色",
              "attrValue": "黑色"
            }
          ],
          "sellerId": "40001",
          "sellerName": "示例店铺",
          "country": "US",
          "purchaserName": "示例采购方",
          "purchaseCurrency": "CNY",
          "settlementDescription": "月结",
          "createRealname": "王五",
          "isGift": 0,
          "purchaseQuantity": "100",
          "receiveQuantity": "80",
          "waitQuantity": "20",
          "quantityDiff": "0",
          "overReceiveNum": "0",
          "goodQuantity": "80",
          "badQuantity": "0",
          "exchangeQuantity": "0",
          "returnQuantity": "0",
          "priceWithoutTax": "8.8496",
          "price": "10.0000",
          "purchaseAmount": "1000.00",
          "receiveAmount": "800.00",
          "waitAmount": "200.00",
          "deductionAmount": "0.00",
          "purchaseAmountWithoutTax": "884.96",
          "receiveAmountWithoutTax": "707.96",
          "waitAmountWithoutTax": "176.99",
          "goodAmount": "707.96",
          "payableAmount": "800.00",
          "paidAmount": "500.00",
          "discountAmount": "0.00",
          "unpaidAmount": "300.00",
          "applyingAmount": "100.00",
          "notAppliedAmount": "200.00",
          "operateTime": "2026-09-10 12:00:00",
          "qcList": [
            {
              "qcSn": "QC202609100001",
              "customQcTime": "2026-09-10 11:00:00"
            }
          ]
        }
      ]
    },
    "total": 1
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1startDate开始日期string—Optional开始日期。非必填;传入时格式必须为 yyyy-MM-dd,传入 timeType 时 startDate 和 endDate 必须同时传入
2endDate结束日期string—Optional结束日期。非必填;传入时格式必须为 yyyy-MM-dd,查询包含结束日期当天;传入 timeType 时 startDate 和 endDate 必须同时传入
3timeType时间类型integer—Optional时间类型:1 下单时间,2 到货时间,4 质检完成时间
4searchField查询字段string—Optional查询字段。传入 searchValue 时生效
5searchValue查询关键字string—Optional查询关键字
6wid仓库 IDstring—Optional仓库 ID,支持数组或英文逗号分隔字符串
7buyerUid采购员 UIDstring—Optional采购员 UID,支持数组或英文逗号分隔字符串
8supplierId供应商 IDinteger—Required供应商 ID
9offset分页偏移量integer—Required分页偏移量
10length单页条数integer—Required单页条数,最大 100

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0:成功
2message消息提示stringsuccessRequired消息提示
3error_details数据校验失败时的错误详情array<any>—Required数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583Required请求链路id
5response_time响应时间string2026-09-10 12:00:00Required响应时间
6data响应数据object—Required响应数据
6.1summary当前筛选条件下的汇总数据object—Optional当前筛选条件下的汇总数据;无汇总数据时返回 null
6.1.1purchaseQuantity采购量汇总string100Required采购量汇总
6.1.2receiveQuantity到货量汇总string80Required到货量汇总
6.1.3waitQuantity待到货量汇总string20Required待到货量汇总
6.1.4quantityDiff结束差异量汇总string0Required结束差异量汇总
6.1.5overReceiveNum超量收货量汇总string0Required超量收货量汇总
6.1.6exchangeQuantity换货量汇总string0Required换货量汇总
6.1.7returnQuantity退货量汇总string0Required退货量汇总
6.1.8goodQuantity可用量汇总string80Required可用量汇总
6.1.9badQuantity次品量汇总string0Required次品量汇总
6.1.10purchaseAmount订货金额(含税)汇总string1000.00Required订货金额(含税)汇总
6.1.11receiveAmount到货金额(含税)汇总string800.00Required到货金额(含税)汇总
6.1.12waitAmount待到货金额(含税)汇总string200.00Required待到货金额(含税)汇总
6.1.13returnAmount退货金额(含税)汇总string0.00Required退货金额(含税)汇总
6.1.14deductionAmount扣款/退货金额(含税)汇总string0.00Required扣款/退货金额(含税)汇总
6.1.15purchaseAmountWithoutTax订货金额(不含税)汇总string884.96Required订货金额(不含税)汇总
6.1.16receiveAmountWithoutTax到货金额(不含税)汇总string707.96Required到货金额(不含税)汇总
6.1.17waitAmountWithoutTax待到货金额(不含税)汇总string176.99Required待到货金额(不含税)汇总
6.1.18inboundPurchaseAmountWithoutTax入库口径订货金额(不含税)汇总string884.96Required入库口径订货金额(不含税)汇总
6.1.19inboundReceiveAmountWithoutTax入库口径到货金额(不含税)汇总string707.96Required入库口径到货金额(不含税)汇总
6.2list采购对账明细array<object>—Required采购对账明细
6.2.1rowId列表行 IDstring900001Required列表行 ID
6.2.2orderSn系统单据号stringCG202609100001Required系统单据号
6.2.3customOrderSn自定义单号stringCUSTOM001Required自定义单号;为空时通常与系统单据号一致
6.2.4itemId单据明细 IDinteger20001Required单据明细 ID
6.2.5type单据类型编码integer1Required单据类型编码
6.2.6typeName单据类型名称string采购单Required单据类型名称
6.2.7sourceType来源类型编码integer1Required来源类型编码
6.2.8wid仓库 IDinteger1001Required仓库 ID
6.2.9warehouseName仓库名称string深圳仓Required仓库名称
6.2.10supplierId供应商 IDinteger10001Required供应商 ID
6.2.11supplierName供应商名称string深圳市示例供应商有限公司Required供应商名称;无权限时返回 ***
6.2.12buyerUid采购员 UIDinteger10001Required采购员 UID
6.2.13buyerName采购员名称string李四Required采购员名称
6.2.14productId产品 IDinteger30001Required产品 ID
6.2.15productName品名string示例产品Required品名
6.2.16spuspustringSPU001RequiredSPU
6.2.17spuName款名string示例款式Required款名
6.2.18skuskustringSKU001RequiredSKU
6.2.19mskumskustringMSKU001RequiredMSKU
6.2.20fnskufnskustringFNSKU001RequiredFNSKU
6.2.21attribute产品属性array<object>—Required产品属性
6.2.21.1attrName属性名称string颜色Required属性名称
6.2.21.2attrValue属性值string黑色Required属性值
6.2.22sellerId店铺 IDstring40001Required店铺 ID
6.2.23sellerName店铺名称string示例店铺Required店铺名称
6.2.24country国家或地区stringUSRequired国家或地区
6.2.25purchaserName采购方string示例采购方Required采购方
6.2.26purchaseCurrency采购币种stringCNYRequired采购币种
6.2.27settlementDescription结算描述string月结Required结算描述
6.2.28createRealname创建人string王五Required创建人
6.2.29isGift是否赠品integer0Required是否赠品:0 否,1 是
6.2.30purchaseQuantity采购量string100Required采购量
6.2.31receiveQuantity到货量string80Required到货量
6.2.32waitQuantity待到货量string20Required待到货量
6.2.33quantityDiff结束差异量string0Required结束差异量
6.2.34overReceiveNum超量收货量string0Required超量收货量
6.2.35goodQuantity可用量string80Required可用量
6.2.36badQuantity次品量string0Required次品量
6.2.37exchangeQuantity换货量string0Required换货量
6.2.38returnQuantity退货量string0Required退货量
6.2.39priceWithoutTax单价(不含税)string8.8496Required单价(不含税),保留四位小数
6.2.40price含税单价string10.0000Required含税单价,保留四位小数
6.2.41purchaseAmount订货金额(含税)string1000.00Required订货金额(含税)
6.2.42receiveAmount到货金额(含税)string800.00Required到货金额(含税)
6.2.43waitAmount待到货金额(含税)string200.00Required待到货金额(含税)
6.2.44deductionAmount扣款/退货金额(含税)string0.00Required扣款/退货金额(含税)
6.2.45purchaseAmountWithoutTax订货金额(不含税)string884.96Required订货金额(不含税)
6.2.46receiveAmountWithoutTax到货金额(不含税)string707.96Required到货金额(不含税)
6.2.47waitAmountWithoutTax待到货金额(不含税)string176.99Required待到货金额(不含税)
6.2.48goodAmount良品入库货值string707.96Required良品入库货值;仅采购入库单返回金额,其他单据返回 null
6.2.49payableAmount应付金额string800.00Required应付金额
6.2.50paidAmount实付金额string500.00Required实付金额
6.2.51discountAmount折扣金额string0.00Required折扣金额
6.2.52unpaidAmount未付金额string300.00Required未付金额
6.2.53applyingAmount申请中金额string100.00Required申请中金额
6.2.54notAppliedAmount未申请金额string200.00Required未申请金额
6.2.55operateTime操作时间/下单时间string2026-09-10 12:00:00Required操作时间/下单时间,格式 YYYY-MM-DD HH:mm:ss;无值时可能返回 -
6.2.56qcList质检单列表array<object>—Required质检单列表,按质检完成时间倒序
6.2.56.1qcSn质检单号stringQC202609100001Required质检单号
6.2.56.2customQcTime质检完成时间string2026-09-10 11:00:00Required质检完成时间
7total明细总数integer1Required明细总数

The 供应商对账明细 API (/basicOpen/purchase/supplierData/getSupplierPurchaseDataDetail) 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.