/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×tamp=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
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | startDate | 开始日期 | string | — | Optional | 开始日期。非必填;传入时格式必须为 yyyy-MM-dd,传入 timeType 时 startDate 和 endDate 必须同时传入 |
| 2 | endDate | 结束日期 | string | — | Optional | 结束日期。非必填;传入时格式必须为 yyyy-MM-dd,查询包含结束日期当天;传入 timeType 时 startDate 和 endDate 必须同时传入 |
| 3 | timeType | 时间类型 | integer | — | Optional | 时间类型:1 下单时间,2 到货时间,4 质检完成时间 |
| 4 | searchField | 查询字段 | string | — | Optional | 查询字段。传入 searchValue 时生效 |
| 5 | searchValue | 查询关键字 | string | — | Optional | 查询关键字 |
| 6 | wid | 仓库 ID | string | — | Optional | 仓库 ID,支持数组或英文逗号分隔字符串 |
| 7 | buyerUid | 采购员 UID | string | — | Optional | 采购员 UID,支持数组或英文逗号分隔字符串 |
| 8 | supplierId | 供应商 ID | integer | — | Required | 供应商 ID |
| 9 | offset | 分页偏移量 | integer | — | Required | 分页偏移量 |
| 10 | length | 单页条数 | integer | — | Required | 单页条数,最大 100 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | Required | 状态码,0:成功 |
| 2 | message | 消息提示 | string | success | Required | 消息提示 |
| 3 | error_details | 数据校验失败时的错误详情 | array<any> | — | Required | 数据校验失败时的错误详情 |
| 4 | request_id | 请求链路id | string | a0d54debf93140f3b58d1ed81e8e3583 | Required | 请求链路id |
| 5 | response_time | 响应时间 | string | 2026-09-10 12:00:00 | Required | 响应时间 |
| 6 | data | 响应数据 | object | — | Required | 响应数据 |
| 6.1 | summary | 当前筛选条件下的汇总数据 | object | — | Optional | 当前筛选条件下的汇总数据;无汇总数据时返回 null |
| 6.1.1 | purchaseQuantity | 采购量汇总 | string | 100 | Required | 采购量汇总 |
| 6.1.2 | receiveQuantity | 到货量汇总 | string | 80 | Required | 到货量汇总 |
| 6.1.3 | waitQuantity | 待到货量汇总 | string | 20 | Required | 待到货量汇总 |
| 6.1.4 | quantityDiff | 结束差异量汇总 | string | 0 | Required | 结束差异量汇总 |
| 6.1.5 | overReceiveNum | 超量收货量汇总 | string | 0 | Required | 超量收货量汇总 |
| 6.1.6 | exchangeQuantity | 换货量汇总 | string | 0 | Required | 换货量汇总 |
| 6.1.7 | returnQuantity | 退货量汇总 | string | 0 | Required | 退货量汇总 |
| 6.1.8 | goodQuantity | 可用量汇总 | string | 80 | Required | 可用量汇总 |
| 6.1.9 | badQuantity | 次品量汇总 | string | 0 | Required | 次品量汇总 |
| 6.1.10 | purchaseAmount | 订货金额(含税)汇总 | string | 1000.00 | Required | 订货金额(含税)汇总 |
| 6.1.11 | receiveAmount | 到货金额(含税)汇总 | string | 800.00 | Required | 到货金额(含税)汇总 |
| 6.1.12 | waitAmount | 待到货金额(含税)汇总 | string | 200.00 | Required | 待到货金额(含税)汇总 |
| 6.1.13 | returnAmount | 退货金额(含税)汇总 | string | 0.00 | Required | 退货金额(含税)汇总 |
| 6.1.14 | deductionAmount | 扣款/退货金额(含税)汇总 | string | 0.00 | Required | 扣款/退货金额(含税)汇总 |
| 6.1.15 | purchaseAmountWithoutTax | 订货金额(不含税)汇总 | string | 884.96 | Required | 订货金额(不含税)汇总 |
| 6.1.16 | receiveAmountWithoutTax | 到货金额(不含税)汇总 | string | 707.96 | Required | 到货金额(不含税)汇总 |
| 6.1.17 | waitAmountWithoutTax | 待到货金额(不含税)汇总 | string | 176.99 | Required | 待到货金额(不含税)汇总 |
| 6.1.18 | inboundPurchaseAmountWithoutTax | 入库口径订货金额(不含税)汇总 | string | 884.96 | Required | 入库口径订货金额(不含税)汇总 |
| 6.1.19 | inboundReceiveAmountWithoutTax | 入库口径到货金额(不含税)汇总 | string | 707.96 | Required | 入库口径到货金额(不含税)汇总 |
| 6.2 | list | 采购对账明细 | array<object> | — | Required | 采购对账明细 |
| 6.2.1 | rowId | 列表行 ID | string | 900001 | Required | 列表行 ID |
| 6.2.2 | orderSn | 系统单据号 | string | CG202609100001 | Required | 系统单据号 |
| 6.2.3 | customOrderSn | 自定义单号 | string | CUSTOM001 | Required | 自定义单号;为空时通常与系统单据号一致 |
| 6.2.4 | itemId | 单据明细 ID | integer | 20001 | Required | 单据明细 ID |
| 6.2.5 | type | 单据类型编码 | integer | 1 | Required | 单据类型编码 |
| 6.2.6 | typeName | 单据类型名称 | string | 采购单 | Required | 单据类型名称 |
| 6.2.7 | sourceType | 来源类型编码 | integer | 1 | Required | 来源类型编码 |
| 6.2.8 | wid | 仓库 ID | integer | 1001 | Required | 仓库 ID |
| 6.2.9 | warehouseName | 仓库名称 | string | 深圳仓 | Required | 仓库名称 |
| 6.2.10 | supplierId | 供应商 ID | integer | 10001 | Required | 供应商 ID |
| 6.2.11 | supplierName | 供应商名称 | string | 深圳市示例供应商有限公司 | Required | 供应商名称;无权限时返回 *** |
| 6.2.12 | buyerUid | 采购员 UID | integer | 10001 | Required | 采购员 UID |
| 6.2.13 | buyerName | 采购员名称 | string | 李四 | Required | 采购员名称 |
| 6.2.14 | productId | 产品 ID | integer | 30001 | Required | 产品 ID |
| 6.2.15 | productName | 品名 | string | 示例产品 | Required | 品名 |
| 6.2.16 | spu | spu | string | SPU001 | Required | SPU |
| 6.2.17 | spuName | 款名 | string | 示例款式 | Required | 款名 |
| 6.2.18 | sku | sku | string | SKU001 | Required | SKU |
| 6.2.19 | msku | msku | string | MSKU001 | Required | MSKU |
| 6.2.20 | fnsku | fnsku | string | FNSKU001 | Required | FNSKU |
| 6.2.21 | attribute | 产品属性 | array<object> | — | Required | 产品属性 |
| 6.2.21.1 | attrName | 属性名称 | string | 颜色 | Required | 属性名称 |
| 6.2.21.2 | attrValue | 属性值 | string | 黑色 | Required | 属性值 |
| 6.2.22 | sellerId | 店铺 ID | string | 40001 | Required | 店铺 ID |
| 6.2.23 | sellerName | 店铺名称 | string | 示例店铺 | Required | 店铺名称 |
| 6.2.24 | country | 国家或地区 | string | US | Required | 国家或地区 |
| 6.2.25 | purchaserName | 采购方 | string | 示例采购方 | Required | 采购方 |
| 6.2.26 | purchaseCurrency | 采购币种 | string | CNY | Required | 采购币种 |
| 6.2.27 | settlementDescription | 结算描述 | string | 月结 | Required | 结算描述 |
| 6.2.28 | createRealname | 创建人 | string | 王五 | Required | 创建人 |
| 6.2.29 | isGift | 是否赠品 | integer | 0 | Required | 是否赠品:0 否,1 是 |
| 6.2.30 | purchaseQuantity | 采购量 | string | 100 | Required | 采购量 |
| 6.2.31 | receiveQuantity | 到货量 | string | 80 | Required | 到货量 |
| 6.2.32 | waitQuantity | 待到货量 | string | 20 | Required | 待到货量 |
| 6.2.33 | quantityDiff | 结束差异量 | string | 0 | Required | 结束差异量 |
| 6.2.34 | overReceiveNum | 超量收货量 | string | 0 | Required | 超量收货量 |
| 6.2.35 | goodQuantity | 可用量 | string | 80 | Required | 可用量 |
| 6.2.36 | badQuantity | 次品量 | string | 0 | Required | 次品量 |
| 6.2.37 | exchangeQuantity | 换货量 | string | 0 | Required | 换货量 |
| 6.2.38 | returnQuantity | 退货量 | string | 0 | Required | 退货量 |
| 6.2.39 | priceWithoutTax | 单价(不含税) | string | 8.8496 | Required | 单价(不含税),保留四位小数 |
| 6.2.40 | price | 含税单价 | string | 10.0000 | Required | 含税单价,保留四位小数 |
| 6.2.41 | purchaseAmount | 订货金额(含税) | string | 1000.00 | Required | 订货金额(含税) |
| 6.2.42 | receiveAmount | 到货金额(含税) | string | 800.00 | Required | 到货金额(含税) |
| 6.2.43 | waitAmount | 待到货金额(含税) | string | 200.00 | Required | 待到货金额(含税) |
| 6.2.44 | deductionAmount | 扣款/退货金额(含税) | string | 0.00 | Required | 扣款/退货金额(含税) |
| 6.2.45 | purchaseAmountWithoutTax | 订货金额(不含税) | string | 884.96 | Required | 订货金额(不含税) |
| 6.2.46 | receiveAmountWithoutTax | 到货金额(不含税) | string | 707.96 | Required | 到货金额(不含税) |
| 6.2.47 | waitAmountWithoutTax | 待到货金额(不含税) | string | 176.99 | Required | 待到货金额(不含税) |
| 6.2.48 | goodAmount | 良品入库货值 | string | 707.96 | Required | 良品入库货值;仅采购入库单返回金额,其他单据返回 null |
| 6.2.49 | payableAmount | 应付金额 | string | 800.00 | Required | 应付金额 |
| 6.2.50 | paidAmount | 实付金额 | string | 500.00 | Required | 实付金额 |
| 6.2.51 | discountAmount | 折扣金额 | string | 0.00 | Required | 折扣金额 |
| 6.2.52 | unpaidAmount | 未付金额 | string | 300.00 | Required | 未付金额 |
| 6.2.53 | applyingAmount | 申请中金额 | string | 100.00 | Required | 申请中金额 |
| 6.2.54 | notAppliedAmount | 未申请金额 | string | 200.00 | Required | 未申请金额 |
| 6.2.55 | operateTime | 操作时间/下单时间 | string | 2026-09-10 12:00:00 | Required | 操作时间/下单时间,格式 YYYY-MM-DD HH:mm:ss;无值时可能返回 - |
| 6.2.56 | qcList | 质检单列表 | array<object> | — | Required | 质检单列表,按质检完成时间倒序 |
| 6.2.56.1 | qcSn | 质检单号 | string | QC202609100001 | Required | 质检单号 |
| 6.2.56.2 | customQcTime | 质检完成时间 | string | 2026-09-10 11:00:00 | Required | 质检完成时间 |
| 7 | total | 明细总数 | integer | 1 | Required | 明细总数 |
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.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.