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