Lingxing
切换旧版

查询请款池 - 其他费用

POST/basicOpen/finance/requestFundsPool/otherFee/list

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/finance/requestFundsPool/otherFee/listHTTPSPOST1

请求参数

endTimestring
结束时间,必填,格式:yyyy-MM-dd,根据searchFieldTime字段确定查询维度
startTimestring
开始时间,必填,格式:yyyy-MM-dd,根据searchFieldTime字段确定查询维度
lengthinteger
分页长度
offsetinteger
分页偏移量
purchaserIdsarray<any>
采购方ID列表,筛选指定采购方的其他费用
searchFieldstring
搜索字段,枚举值:order_sn-采购单号, create_username-采购员,配合searchValue使用
searchFieldTimestring
时间维度,枚举值:create_time-创建时间, close_time-付清时间,默认create_time
searchValuestring
搜索值,根据searchField字段进行搜索,支持模糊查询
statusinteger
付款状态,枚举值:0-查询未付清, 1-查询已付清,不传默认查询全部
supplierIdsarray<any>
应付对象ID列表,筛选指定供应商的其他费用

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/finance/requestFundsPool/otherFee/list?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "endTime": "2024-12-31",
    "startTime": "2024-01-01",
    "length": 20,
    "offset": 0,
    "purchaserIds": [1234567890,9876543210],
    "searchField": "order_sn",
    "searchFieldTime": "create_time",
    "searchValue": "PO20240101",
    "status": 0,
    "supplierIds": [1234567890,9876543210]
}'

返回结果

Json Object

codeinteger必填
响应码
dataobject必填
返回数据
隐藏子属性
listarray<object>必填
列表数据
隐藏子属性
amountNotPaidstring必填
未付金额,还需支付的金额
示例 2500
amountPaidstring必填
已付金额,已完成支付的金额
示例 1500.5
applyedAmountstring必填
已请款金额,已完成请款的金额
示例 3500
applyedDiscountstring必填
已请款折扣,已完成请款的折扣金额
示例 50
applyedGoodsValuestring必填
已请款货值,已完成请款的货物价值
示例 4500
applyingAmountstring必填
申请中金额,正在请款流程中的金额
示例 2000
applyingDiscountstring必填
请款中折扣,正在请款流程中的折扣金额
示例 30
applyingGoodsValuestring必填
请款中货值,正在请款流程中的货物价值
示例 3000
applyingOrdersarray<any>必填
请款中订单ID列表,正在请款流程中的订单
示例 [54321,98765]
closeDatestring必填
结清日期,格式:yyyy-MM-dd,完成付清的日期
示例 2024-11-15
closeTimeinteger必填
结清时间戳,完成付清的时间戳(秒)
示例 1700000000
closedByUidinteger必填
结清操作人UID,完成付清的用户ID
示例 1234567890
closedByUserstring必填
结清操作人姓名,完成付清的操作人员
示例 张三
closedRemarkstring必填
结清备注,付清时填写的备注说明
示例 已全额付清
currencystring必填
币种代码,费用金额使用的货币类型,如:CNY、USD
示例 CNY
customOrderSnstring必填
自定义单号,用户自定义的订单编号
示例 CUSTOM-2024-001
discountAmountstring必填
折扣金额,优惠折扣的金额
示例 100
feestring必填
费用金额,其他费用的总金额
示例 5000
feeTypeIdinteger必填
费用类型ID,费用分类的唯一标识
示例 1234567890
feeTypeNamestring必填
费用类型名称,费用分类的名称
示例 运输费
iconstring必填
图标标识,费用类型的图标地址或标识
示例 icon_other_fee.png
idinteger必填
其他费用记录ID,唯一标识
示例 1001
isAutoDoneinteger必填
是否自动完成,枚举值:0-否, 1-是,标识是否系统自动结清
示例 0
notApplyAmountstring必填
未请款金额,还未发起请款的金额
示例 1000
optRealnamestring必填
采购员
示例 李四
optUidinteger必填
创建操作人UID,创建该费用的用户ID
示例 1234567890
orderSnstring必填
订单编号,关联的采购单号
示例 PO202401010001
paidOrdersarray<any>必填
已付款请款单ID列表,记录已关联的付款单据
示例 [12345,67890]
payStatusinteger必填
付款状态,枚举值:0-未申请, 1-申请中, 2-已申请, 3-已付清
示例 2
payStatusTextstring必填
付款状态文本描述,如:未付清、已付清等
示例 未付清
payableAmountstring必填
应付金额,需要支付的总金额
示例 5000
purchaserIdinteger必填
采购方ID,发起采购的组织或个人ID
示例 1234567890
purchaserNamestring必填
采购方名称,发起采购的组织或个人名称
示例 深圳采购中心
supplierIdinteger必填
应付对象ID,供应商或应付方的ID
示例 1234567890
supplierNamestring必填
应付对象名称,供应商或应付方的名称
示例 顺丰物流
unapplyGoodsValuestring必填
未请款货值,还未发起请款的货物价值
示例 1500
updateUidinteger必填
更新操作人UID,最后修改该记录的用户ID
示例 1234567890
wareHouseNamestring必填
仓库名称,关联的仓库名称
示例 华南仓库
widinteger必填
仓库ID,关联的仓库唯一标识
示例 1234567890
totalinteger必填
总记录数
示例 100
error_detailsarray<any>必填
错误详情
messagestring必填
提示信息
request_idstring必填
请求id
response_timestring必填
响应时间
totalinteger必填
总记录数

返回成功示例

{
  "code": 0,
  "data": {
    "list": [
      {
        "amountNotPaid": "2500",
        "amountPaid": "1500.5",
        "applyedAmount": "3500",
        "applyedDiscount": "50",
        "applyedGoodsValue": "4500",
        "applyingAmount": "2000",
        "applyingDiscount": "30",
        "applyingGoodsValue": "3000",
        "applyingOrders": [
          54321,
          98765
        ],
        "closeDate": "2024-11-15",
        "closeTime": 1700000000,
        "closedByUid": 1234567890,
        "closedByUser": "张三",
        "closedRemark": "已全额付清",
        "currency": "CNY",
        "customOrderSn": "CUSTOM-2024-001",
        "discountAmount": "100",
        "fee": "5000",
        "feeTypeId": 1234567890,
        "feeTypeName": "运输费",
        "icon": "icon_other_fee.png",
        "id": 1001,
        "isAutoDone": 0,
        "notApplyAmount": "1000",
        "optRealname": "李四",
        "optUid": 1234567890,
        "orderSn": "PO202401010001",
        "paidOrders": [
          12345,
          67890
        ],
        "payStatus": 2,
        "payStatusText": "未付清",
        "payableAmount": "5000",
        "purchaserId": 1234567890,
        "purchaserName": "深圳采购中心",
        "supplierId": 1234567890,
        "supplierName": "顺丰物流",
        "unapplyGoodsValue": "1500",
        "updateUid": 1234567890,
        "wareHouseName": "华南仓库",
        "wid": 1234567890
      },
      {
        "amountNotPaid": "1000",
        "amountPaid": "500",
        "applyedAmount": "2000",
        "applyedDiscount": "20",
        "applyedGoodsValue": "2500",
        "applyingAmount": "500",
        "applyingDiscount": "10",
        "applyingGoodsValue": "1000",
        "applyingOrders": [
          11223,
          44556
        ],
        "closeDate": null,
        "closeTime": null,
        "closedByUid": null,
        "closedByUser": null,
        "closedRemark": null,
        "currency": "USD",
        "customOrderSn": "CUSTOM-2024-002",
        "discountAmount": "50",
        "fee": "3000",
        "feeTypeId": 2345678901,
        "feeTypeName": "关税",
        "icon": "icon_tariff.png",
        "id": 1002,
        "isAutoDone": 0,
        "notApplyAmount": "500",
        "optRealname": "王五",
        "optUid": 2345678901,
        "orderSn": "PO202401020002",
        "paidOrders": [
          99887
        ],
        "payStatus": 1,
        "payStatusText": "申请中",
        "payableAmount": "3000",
        "purchaserId": 2345678901,
        "purchaserName": "上海采购部",
        "supplierId": 2345678901,
        "supplierName": "UPS快递",
        "unapplyGoodsValue": "500",
        "updateUid": 2345678901,
        "wareHouseName": "华东仓库",
        "wid": 2345678901
      }
    ],
    "total": 2
  },
  "error_details": [],
  "message": "成功",
  "request_id": "some_request_id_123",
  "response_time": "2024-01-01 12:00:00",
  "total": 2
}