轻易云
注册体验

领星ERP供应商对账明细接口

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

供应商对账明细

POST/basicOpen/purchase/supplierData/getSupplierPurchaseDataDetail
加工厂
{
  "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
  }
}

接口请求参数

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

接口响应参数

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

领星ERP的接口:供应商对账明细(/basicOpen/purchase/supplierData/getSupplierPurchaseDataDetail),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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