Lingxing
切换旧版

账单明细 - ShopeeAdjustment

POST/basicOpen/finance/shopee/adjustment/list

接口信息

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

请求参数

adjDimensionsarray<any>
调整维度数组（下拉多选）：
Order
Shop
other 其他维度
adjTypesarray<any>
调整类型数组（下拉多选）：
Refund Amount
Marketing Fee
Warehouse Fee
Other 其他类型
compareLogicstring
字段比较条件逻辑关系：
AND 所有条件都满足
OR 满足任一条件
默认 AND
currencyCodestring
目标货币代码（为空则使用原币种，切换后按打款时间汇率换算）
endDatestring
结束时间（结算时间），格式 yyyy-MM-dd，默认当前日期
envKeystring
环境标识
exportFieldsarray<any>
导出字段值
fieldComparesarray<any>
字段比较条件列表（多个条件之间的逻辑关系由 compareLogic 指定）
lengthnumber必填
分页大小，默认 20，最大不超过 200
offsetnumber必填
分页偏移，默认 0
platformCodestring
平台码
searchExactlyboolean
是否精确匹配
searchMultiValuearray<any>
多个搜索值（精确匹配）
searchSingleValuestring
单个搜索值（支持模糊匹配，多个值用逗号分隔）
searchTypenumber
搜索类型：
1 平台单号
sidsarray<any>
店铺 ID 数组
sitesarray<any>
站点数组
sortFieldstring
排序字段
sortTypestring
排序方向：
1 升序/ASC
0 降序/DESC
默认 0
startDatestring
开始时间（结算时间），格式 yyyy-MM-dd，默认当前月份第一天
storeTypesarray<any>
店铺类型数组：
1 跨境店(CB)
2 本土店(Local)

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/finance/shopee/adjustment/list?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "adjDimensions": ["Order"],
    "adjTypes": ["Refund Amount"],
    "compareLogic": "AND",
    "currencyCode": "USD",
    "startDate": "2026-03-01",
    "endDate": "2026-03-17",
    "length": 20,
    "offset": 0,
    "searchType": 1,
    "searchSingleValue": "ORDER20260317001",
    "sites": ["SG","MY"],
    "sids": [10001,10002],
    "storeTypes": [1,2]
}'

返回结果

JSON Object

codenumber必填
状态码，0：成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
示例 []
request_idstring必填
请求链路id
示例 ccafcc7d9a72484fac5a3889b5db2986.231.17611516492143035
response_timestring必填
响应时间
示例 2025-10-23 00:47:29
dataobject必填
响应数据
隐藏子属性
totalCountnumber必填
总记录数
示例 2
totalSumobject必填
汇总数据
隐藏子属性
amountstring必填
调整金额汇总
示例 320.50
currencystring必填
币种代码
示例 USD
currencyIconstring必填
币种图标
示例 $
totalCountnumber必填
总记录数
示例 2
listarray<object>必填
列表数据
隐藏子属性
uniqueNostring必填
业务唯一键
示例 SHOPEE-ADJ-001
originalPayoutTimenumber必填
原始结算时间戳
示例 1742198400
storeTypenumber必填
店铺类型：1-跨境店, 2-本土店
示例 1
amountstring必填
调整金额
示例 120.50
orderNostring必填
平台订单号
示例 ORDER20260317001
adjDimensionstring必填
调整维度
示例 Order
adjNumbernumber必填
调整明细序号
示例 1
adjRemarkstring必填
调整备注
示例 订单售后差异调整
adjScenariostring必填
调整场景
示例 After Sales
billingTransactionTypestring必填
账单交易类型
示例 adjustment
siteDisplaystring必填
站点中文展示
示例 新加坡
currencyIconstring必填
币种图标
示例 $
storeIdnumber必填
店铺 ID
示例 10001
payoutSnstring必填
账期 ID
示例 P20260317001
encryptedPayoutIdnumber必填
账期加密 ID（仅CB有）
示例 1234567890
transactionIdnumber必填
交易 ID（仅Local有）
示例 987654321
transactionTypestring必填
交易类型（仅Local有）
示例 SALE
payoutTimestring必填
结算时间
示例 2026-03-17 12:00:00
sitestring必填
站点代码
示例 SG
storeTypeDisplaystring必填
店铺类型展示
示例 跨境店
storeNamestring必填
店铺名
示例 Shopee-SG
currencystring必填
币种
示例 USD
idnumber必填
主键 ID
示例 1001
platformCodestring必填
平台码
示例 shopee
adjTypestring必填
调整类型
示例 Refund Amount

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "ccafcc7d9a72484fac5a3889b5db2986.231.17611516492143035",
    "response_time": "2025-10-23 00:47:29",
    "data": {
        "totalCount": 2,
        "totalSum": {
            "amount": "320.50",
            "currency": "USD",
            "currencyIcon": "$",
            "totalCount": 2
        },
        "list": [
            {
                "uniqueNo": "SHOPEE-ADJ-001",
                "originalPayoutTime": 1742198400,
                "storeType": 1,
                "amount": "120.50",
                "orderNo": "ORDER20260317001",
                "adjDimension": "Order",
                "adjNumber": 1,
                "adjRemark": "订单售后差异调整",
                "adjScenario": "After Sales",
                "billingTransactionType": "adjustment",
                "siteDisplay": "新加坡",
                "currencyIcon": "$",
                "storeId": 10001,
                "payoutSn": "P20260317001",
                "encryptedPayoutId": 1234567890,
                "transactionId": 987654321,
                "transactionType": "SALE",
                "payoutTime": "2026-03-17 12:00:00",
                "site": "SG",
                "storeTypeDisplay": "跨境店",
                "storeName": "Shopee-SG",
                "currency": "USD",
                "id": 1001,
                "platformCode": "shopee",
                "adjType": "Refund Amount"
            }
        ]
    }
}