Lingxing
切换旧版

供应商对账明细

POST/basicOpen/purchase/supplierData/getSupplierPurchaseDataDetail

按供应商查询采购对账明细,返回分页明细和当前筛选条件下的汇总数据。

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/purchase/supplierData/getSupplierPurchaseDataDetailHTTPSPOST1

请求参数

startDatestring
开始日期。非必填;传入时格式必须为 yyyy-MM-dd,传入 timeType 时 startDate 和 endDate 必须同时传入
endDatestring
结束日期。非必填;传入时格式必须为 yyyy-MM-dd,查询包含结束日期当天;传入 timeType 时 startDate 和 endDate 必须同时传入
timeTypeinteger
时间类型:1 下单时间,2 到货时间,4 质检完成时间
searchFieldstring
查询字段。传入 searchValue 时生效
searchValuestring
查询关键字
widstring
仓库 ID,支持数组或英文逗号分隔字符串
buyerUidstring
采购员 UID,支持数组或英文逗号分隔字符串
supplierIdinteger必填
供应商 ID
offsetinteger必填
分页偏移量
lengthinteger必填
单页条数,最大 100

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/purchase/supplierData/getSupplierPurchaseDataDetail?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "supplierId": 10001,
    "startDate": "2026-09-01",
    "endDate": "2026-09-10",
    "timeType": 1,
    "offset": 0,
    "length": 20
}'

返回结果

Json Object

codeinteger必填
状态码,0:成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
request_idstring必填
请求链路id
示例 a0d54debf93140f3b58d1ed81e8e3583
response_timestring必填
响应时间
示例 2026-09-10 12:00:00
dataobject必填
响应数据
隐藏子属性
summaryobject
当前筛选条件下的汇总数据;无汇总数据时返回 null
隐藏子属性
purchaseQuantitystring必填
采购量汇总
示例 100
receiveQuantitystring必填
到货量汇总
示例 80
waitQuantitystring必填
待到货量汇总
示例 20
quantityDiffstring必填
结束差异量汇总
示例 0
overReceiveNumstring必填
超量收货量汇总
示例 0
exchangeQuantitystring必填
换货量汇总
示例 0
returnQuantitystring必填
退货量汇总
示例 0
goodQuantitystring必填
可用量汇总
示例 80
badQuantitystring必填
次品量汇总
示例 0
purchaseAmountstring必填
订货金额(含税)汇总
示例 1000.00
receiveAmountstring必填
到货金额(含税)汇总
示例 800.00
waitAmountstring必填
待到货金额(含税)汇总
示例 200.00
returnAmountstring必填
退货金额(含税)汇总
示例 0.00
deductionAmountstring必填
扣款/退货金额(含税)汇总
示例 0.00
purchaseAmountWithoutTaxstring必填
订货金额(不含税)汇总
示例 884.96
receiveAmountWithoutTaxstring必填
到货金额(不含税)汇总
示例 707.96
waitAmountWithoutTaxstring必填
待到货金额(不含税)汇总
示例 176.99
inboundPurchaseAmountWithoutTaxstring必填
入库口径订货金额(不含税)汇总
示例 884.96
inboundReceiveAmountWithoutTaxstring必填
入库口径到货金额(不含税)汇总
示例 707.96
listarray<object>必填
采购对账明细
隐藏子属性
rowIdstring必填
列表行 ID
示例 900001
orderSnstring必填
系统单据号
示例 CG202609100001
customOrderSnstring必填
自定义单号;为空时通常与系统单据号一致
示例 CUSTOM001
itemIdinteger必填
单据明细 ID
示例 20001
typeinteger必填
单据类型编码
示例 1
typeNamestring必填
单据类型名称
示例 采购单
sourceTypeinteger必填
来源类型编码
示例 1
widinteger必填
仓库 ID
示例 1001
warehouseNamestring必填
仓库名称
示例 深圳仓
supplierIdinteger必填
供应商 ID
示例 10001
supplierNamestring必填
供应商名称;无权限时返回 ***
示例 深圳市示例供应商有限公司
buyerUidinteger必填
采购员 UID
示例 10001
buyerNamestring必填
采购员名称
示例 李四
productIdinteger必填
产品 ID
示例 30001
productNamestring必填
品名
示例 示例产品
spustring必填
SPU
示例 SPU001
spuNamestring必填
款名
示例 示例款式
skustring必填
SKU
示例 SKU001
mskustring必填
MSKU
示例 MSKU001
fnskustring必填
FNSKU
示例 FNSKU001
attributearray<object>必填
产品属性
隐藏子属性
attrNamestring必填
属性名称
示例 颜色
attrValuestring必填
属性值
示例 黑色
sellerIdstring必填
店铺 ID
示例 40001
sellerNamestring必填
店铺名称
示例 示例店铺
countrystring必填
国家或地区
示例 US
purchaserNamestring必填
采购方
示例 示例采购方
purchaseCurrencystring必填
采购币种
示例 CNY
settlementDescriptionstring必填
结算描述
示例 月结
createRealnamestring必填
创建人
示例 王五
isGiftinteger必填
是否赠品:0 否,1 是
示例 0
purchaseQuantitystring必填
采购量
示例 100
receiveQuantitystring必填
到货量
示例 80
waitQuantitystring必填
待到货量
示例 20
quantityDiffstring必填
结束差异量
示例 0
overReceiveNumstring必填
超量收货量
示例 0
goodQuantitystring必填
可用量
示例 80
badQuantitystring必填
次品量
示例 0
exchangeQuantitystring必填
换货量
示例 0
returnQuantitystring必填
退货量
示例 0
priceWithoutTaxstring必填
单价(不含税),保留四位小数
示例 8.8496
pricestring必填
含税单价,保留四位小数
示例 10.0000
purchaseAmountstring必填
订货金额(含税)
示例 1000.00
receiveAmountstring必填
到货金额(含税)
示例 800.00
waitAmountstring必填
待到货金额(含税)
示例 200.00
deductionAmountstring必填
扣款/退货金额(含税)
示例 0.00
purchaseAmountWithoutTaxstring必填
订货金额(不含税)
示例 884.96
receiveAmountWithoutTaxstring必填
到货金额(不含税)
示例 707.96
waitAmountWithoutTaxstring必填
待到货金额(不含税)
示例 176.99
goodAmountstring必填
良品入库货值;仅采购入库单返回金额,其他单据返回 null
示例 707.96
payableAmountstring必填
应付金额
示例 800.00
paidAmountstring必填
实付金额
示例 500.00
discountAmountstring必填
折扣金额
示例 0.00
unpaidAmountstring必填
未付金额
示例 300.00
applyingAmountstring必填
申请中金额
示例 100.00
notAppliedAmountstring必填
未申请金额
示例 200.00
operateTimestring必填
操作时间/下单时间,格式 YYYY-MM-DD HH:mm:ss;无值时可能返回 -
示例 2026-09-10 12:00:00
qcListarray<object>必填
质检单列表,按质检完成时间倒序
隐藏子属性
qcSnstring必填
质检单号
示例 QC202609100001
customQcTimestring必填
质检完成时间
示例 2026-09-10 11:00:00
totalinteger必填
明细总数
示例 1

返回成功示例

{
    "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
}

空数据说明

当筛选条件下没有明细数据时,data.summary 返回 null,data.list 返回空数组,total 返回 0。