Lingxing
切换旧版

账单明细 - ShopeeIncome

POST/basicOpen/finance/shopee/income/list

接口信息

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

请求参数

compareLogicstring
字段比较条件逻辑关系:
AND 所有条件都满足
OR 满足任一条件
默认 AND
currencyCodestring
目标货币代码(为空则使用原币种,切换后按打款时间汇率换算)
endDatestring
结束时间(结算时间),格式 yyyy-MM-dd,默认当前日期
envKeystring
环境标识
expandChildrenboolean
是否展开子项(商品明细),默认 true 展开树形结构
exportFieldsarray<any>
导出字段值
fieldComparesarray<any>
字段比较条件列表(多个条件之间的逻辑关系由 compareLogic 指定)
lengthnumber必填
分页大小,默认 20,最大不超过 200
offsetnumber必填
分页偏移,默认 0
platformCodestring
平台码
searchExactlyboolean
是否精确匹配
searchExactly1boolean
商品搜索是否精确匹配
searchMultiValuearray<any>
多个搜索值(精确匹配)
searchMultiValue1array<any>
商品搜索值(多个,精确匹配)
searchSingleValuestring
单个搜索值(支持模糊匹配,多个值用逗号分隔)
searchSingleValue1string
商品搜索值(单个,支持模糊匹配,多个值用逗号分隔)
searchTypenumber
搜索类型:
1 平台单号
searchType1number
商品搜索类型:
11 MSKU ID
12 MSKU
13 MSKU 名称
14 商品ID
15 全球商品货号
16 商品名称
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/income/list?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "compareLogic": "AND",
    "currencyCode": "USD",
    "startDate": "2026-03-01",
    "endDate": "2026-03-17",
    "expandChildren": true,
    "length": 20,
    "offset": 0,
    "searchType": 1,
    "searchSingleValue": "ORDER20260317001",
    "searchType1": 12,
    "searchSingleValue1": "MSKU001",
    "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必填
汇总数据
隐藏子属性
actualCommissionFeestring必填
实际佣金汇总
示例 32.10
actualInstallationFeestring必填
实际安装费汇总
示例 5.20
actualServiceFeestring必填
实际服务费汇总
示例 18.60
actualShippingFeestring必填
实际运费汇总
示例 -12.80
adsEscrowTopUpFeeOrTechnicalSupportFeestring必填
技术支持费汇总
示例 3.20
amountstring必填
结算金额汇总
示例 1250.50
amsCommissionFeestring必填
联盟营销佣金汇总
示例 6.50
buyerActualCashRefundstring必填
退款给买家的现金金额汇总
示例 12.00
buyerPaidPackagingFeestring必填
买家支付包装费汇总
示例 1.60
buyerPaidShippingFeestring必填
买家支付运费汇总
示例 20.50
buyerTotalAmountstring必填
买家支付总金额汇总
示例 1450.00
campaignFeestring必填
活动费汇总
示例 8.30
commissionFeestring必填
佣金汇总
示例 30.20
currencystring必填
币种代码
示例 USD
currencyIconstring必填
币种图标
示例 $
deliverySellerProtectionFeePremiumAmountstring必填
保险费汇总
示例 0.80
discountedCostOfGoodsSoldstring必填
商品折后金额总额汇总
示例 850.60
discountedItemPricestring必填
商品折后金额汇总
示例 850.60
escrowImportTaxstring必填
进口税汇总
示例 1.20
escrowTaxstring必填
跨境税汇总
示例 2.10
fbsFeestring必填
FBS费汇总
示例 3.40
finalEscrowProductGststring必填
GST商品税汇总
示例 1.10
finalEscrowShippingGststring必填
GST运费税汇总
示例 0.60
finalProductVatTaxstring必填
VAT商品税汇总
示例 1.50
finalReturnToSellerShippingFeestring必填
退货给卖家运费汇总
示例 2.40
finalShippingVatTaxstring必填
VAT运费税汇总
示例 0.70
installationFeePaidByBuyerstring必填
买家支付安装费汇总
示例 0.30
itemDiscountstring必填
商品折扣额汇总
示例 22.40
itemDiscountTotalstring必填
商品折扣总额汇总
示例 22.40
orderChargeableWeightstring必填
订单计费重量汇总
示例 12.50
otherFeestring必填
其他费用汇总
示例 3.20
otherOrderFeestring必填
其他订单费汇总
示例 1.20
overseasReturnServiceFeestring必填
海外免退服务费汇总
示例 1.00
proratedCoinsValueOffsetReturnItemsstring必填
退款/退货商品的按比例Shopee币抵消汇总
示例 0.50
proratedPaymentChannelPromoBankOffsetReturnItemsstring必填
退货退款商品的按比例银行支付渠道优惠汇总
示例 0.80
proratedPaymentChannelPromoShopeeOffsetReturnItemsstring必填
退货退款商品的按比例Shopee支付渠道优惠汇总
示例 0.90
proratedSellerVoucherOffsetReturnItemsstring必填
退货退款商品的按比例卖家优惠券抵消汇总
示例 1.10
proratedShopeeVoucherOffsetReturnItemsstring必填
退货商品的按比例Shopee优惠券抵消汇总
示例 0.70
quantitynumber必填
销售数量汇总
示例 5
refundAmountstring必填
商品小计退款金额汇总
示例 20.00
reverseShippingFeestring必填
退货运费汇总
示例 2.50
reverseShippingFeeSststring必填
退货运费SST汇总
示例 0.10
rsfSellerProtectionFeeClaimAmountstring必填
运费节省计划汇总
示例 0.60
salesTaxOnLvgstring必填
LVG销售税汇总
示例 0.20
sellerCoinCashBackstring必填
卖家Shopee币回扣汇总
示例 1.30
sellerLostCompensationstring必填
损失赔偿汇总
示例 0.40
sellerOrderProcessingFeestring必填
订单处理费汇总
示例 2.60
sellerProductRebateCommissionFeeOffsetstring必填
佣金抵扣金额汇总
示例 0.90
sellerProductRebateServiceFeeOffsetstring必填
服务费抵扣金额汇总
示例 0.50
sellerShippingDiscountstring必填
卖家运费促销汇总
示例 1.70
sellerTransactionFeestring必填
交易手续费汇总
示例 5.00
sellerVoucherCodestring必填
优惠码
示例 SELLER-20260317
serviceFeestring必填
服务费原始值汇总
示例 19.80
shippingFeeDiscountFrom3plstring必填
3PL运费折扣汇总
示例 0.40
shippingFeeSststring必填
运费SST汇总
示例 0.20
shippingSellerProtectionFeeAmountstring必填
运费节省计划费用汇总
示例 0.50
shopeeDiscountstring必填
Shopee回扣金额汇总
示例 4.10
shopeeShippingRebatestring必填
Shopee运费补贴汇总
示例 2.30
thImportDutystring必填
泰国进口税汇总
示例 0.10
totalCountnumber必填
总记录数
示例 2
totalIncomeTaxstring必填
所得税总和汇总
示例 1.80
totalOriginalItemPricestring必填
商品原价汇总
示例 900.00
totalTariffstring必填
关税总和汇总
示例 0.30
totalVatTaxstring必填
增值税总和汇总
示例 1.90
tradeInBonusBySellerstring必填
以旧换新补贴汇总
示例 0.50
vatOnImportedGoodsstring必填
进口增值税汇总
示例 0.20
voucherFromSellerstring必填
卖家优惠券汇总
示例 6.30
withholdingPitTaxstring必填
PIT汇总
示例 0.40
withholdingTaxstring必填
收入预提税汇总
示例 0.60
withholdingVatTaxstring必填
增值税预提汇总
示例 0.30
listarray<object>必填
列表数据
隐藏子属性
actualCommissionFeestring必填
实际佣金
示例 16.10
actualInstallationFeestring必填
实际安装费
示例 2.60
actualServiceFeestring必填
实际服务费
示例 9.30
actualShippingFeestring必填
实际运费(取反)
示例 -6.40
adsEscrowTopUpFeeOrTechnicalSupportFeestring必填
技术支持费
示例 1.60
amountstring必填
结算金额
示例 625.25
amsCommissionFeestring必填
联盟营销佣金
示例 3.25
buyerActualCashRefundstring必填
退款给买家的现金金额
示例 6.00
buyerPaidPackagingFeestring必填
买家支付包装费
示例 0.80
buyerPaidShippingFeestring必填
买家支付运费
示例 10.25
buyerPaymentMethodstring必填
买家支付方式
示例 Credit Card
buyerTotalAmountstring必填
买家支付总金额
示例 725.00
buyerUserNamestring必填
买家账号
示例 buyer_demo
campaignFeestring必填
活动费
示例 4.15
childrenarray<object>必填
子项列表(商品明细)
隐藏子属性
actualCommissionFeestring必填
子项-实际佣金
示例 8.00
actualInstallationFeestring必填
子项-实际安装费
示例 1.20
actualServiceFeestring必填
子项-实际服务费
示例 4.30
actualShippingFeestring必填
子项-实际运费(取反)
示例 -3.10
adsEscrowTopUpFeeOrTechnicalSupportFeestring必填
子项-技术支持费
示例 0.80
amountstring必填
子项-结算金额
示例 320.10
amsCommissionFeestring必填
子项-联盟营销佣金
示例 1.80
buyerActualCashRefundstring必填
子项-退款给买家的现金金额
示例 2.50
buyerPaidPackagingFeestring必填
子项-买家支付包装费
示例 0.30
buyerPaidShippingFeestring必填
子项-买家支付运费
示例 4.50
buyerTotalAmountstring必填
子项-买家支付总金额
示例 360.00
campaignFeestring必填
子项-活动费
示例 2.10
commissionFeestring必填
子项-佣金原始值
示例 7.80
companyIdnumber必填
子项-公司 ID
示例 1234567890
currencystring必填
子项-币种
示例 USD
currencyIconstring必填
子项-币种图标
示例 $
dataTypenumber必填
子项-数据类型:2 商品明细
示例 2
deliverySellerProtectionFeePremiumAmountstring必填
子项-保险费
示例 0.20
discountedCostOfGoodsSoldstring必填
子项-商品金额(折扣后)
示例 210.50
encryptedPayoutIdnumber必填
子项-账期加密ID
示例 1234567890
escrowImportTaxstring必填
子项-进口税
示例 0.30
escrowTaxstring必填
子项-跨境税
示例 0.55
fbsFeestring必填
子项-FBS费
示例 0.90
finalEscrowProductGststring必填
子项-GST商品税
示例 0.20
finalEscrowShippingGststring必填
子项-GST运费税
示例 0.10
finalProductVatTaxstring必填
子项-VAT商品税
示例 0.30
finalReturnToSellerShippingFeestring必填
子项-退货给卖家运费
示例 0.60
finalShippingVatTaxstring必填
子项-VAT运费税
示例 0.15
globalItemSkustring必填
子项-全球商品货号
示例 GLOBAL-SKU-001
idnumber必填
子项-主键ID
示例 2001
installationFeePaidByBuyerstring必填
子项-买家支付安装费
示例 0.05
instalmentPlanstring必填
子项-分期计划
示例 3期免息
itemDiscountstring必填
子项-商品折扣额
示例 5.60
itemDiscountTotalstring必填
子项-商品折扣总额
示例 5.60
itemIdnumber必填
子项-商品ID
示例 3001001
itemNamestring必填
子项-商品名称
示例 Wireless Mouse
itemNumbernumber必填
子项-商品序号
示例 1
modelIdnumber必填
子项-Model ID
示例 50001
modelNamestring必填
子项-Model名称
示例 Black
modelSkustring必填
子项-Model SKU
示例 MODEL-SKU-001
mskustring必填
子项-MSKU
示例 MSKU001
mskuIdnumber必填
子项-MSKU ID
示例 80001
mskuNamestring必填
子项-MSKU名称
示例 无线鼠标-黑色
orderSnstring必填
子项-平台订单号
示例 ORDER20260317001
originalItemPricestring必填
子项-商品原价
示例 225.00
originalPayoutTimenumber必填
子项-原始结算时间戳
示例 1742198400
otherFeestring必填
子项-其他费用
示例 0.80
otherOrderFeestring必填
子项-其他订单费
示例 0.30
overseasReturnServiceFeestring必填
子项-海外免退服务费
示例 0.20
parentIdnumber必填
子项-父行ID
示例 1001
payoutSnstring必填
子项-账期ID
示例 P20260317001
payoutTimestring必填
子项-结算时间
示例 2026-03-17 12:00:00
platformCodestring必填
子项-平台码
示例 shopee
proratedCoinsValueOffsetReturnItemsstring必填
子项-按比例Shopee币抵消
示例 0.10
proratedPaymentChannelPromoBankOffsetReturnItemsstring必填
子项-按比例银行支付渠道优惠
示例 0.15
proratedPaymentChannelPromoShopeeOffsetReturnItemsstring必填
子项-按比例Shopee支付渠道优惠
示例 0.18
proratedSellerVoucherOffsetReturnItemsstring必填
子项-按比例卖家优惠券抵消
示例 0.20
proratedShopeeVoucherOffsetReturnItemsstring必填
子项-按比例Shopee优惠券抵消
示例 0.12
quantitynumber必填
子项-商品销售数量
示例 2
refundAmountstring必填
子项-退款金额
示例 4.00
reverseShippingFeestring必填
子项-退货运费
示例 0.60
reverseShippingFeeSststring必填
子项-退货运费SST
示例 0.02
rsfSellerProtectionFeeClaimAmountstring必填
子项-运费节省计划
示例 0.15
salesTaxOnLvgstring必填
子项-LVG销售税
示例 0.05
sellerCoinCashBackstring必填
子项-卖家Shopee币回扣
示例 0.30
sellerLostCompensationstring必填
子项-损失赔偿
示例 0.10
sellerOrderProcessingFeestring必填
子项-订单处理费
示例 0.60
sellerProductRebateCommissionFeeOffsetstring必填
子项-佣金抵扣金额
示例 0.20
sellerProductRebateServiceFeeOffsetstring必填
子项-服务费抵扣金额
示例 0.10
sellerShippingDiscountstring必填
子项-卖家运费促销
示例 0.40
sellerTransactionFeestring必填
子项-交易手续费
示例 1.20
sellerVoucherCodestring必填
子项-优惠码
示例 SELLER-20260317
serviceFeestring必填
子项-服务费原始值
示例 4.50
shippingFeeDiscountFrom3plstring必填
子项-3PL运费折扣
示例 0.10
shippingFeeSststring必填
子项-运费SST
示例 0.05
shippingSellerProtectionFeeAmountstring必填
子项-运费节省计划费用
示例 0.10
shopeeDiscountstring必填
子项-Shopee回扣金额
示例 1.00
shopeeShippingRebatestring必填
子项-Shopee运费补贴
示例 0.50
sitestring必填
子项-站点代码
示例 SG
siteDisplaystring必填
子项-站点中文展示
示例 新加坡
storeIdnumber必填
子项-店铺ID
示例 10001
storeNamestring必填
子项-店铺名
示例 Shopee-SG
storeTypenumber必填
子项-店铺类型
示例 1
storeTypeDisplaystring必填
子项-店铺类型展示
示例 跨境店
thImportDutystring必填
子项-泰国进口税
示例 0.03
totalIncomeTaxstring必填
子项-所得税总和
示例 0.40
totalOriginalItemPricestring必填
子项-商品原价
示例 225.00
totalTariffstring必填
子项-关税总和
示例 0.06
totalVatTaxstring必填
子项-增值税总和
示例 0.45
tradeInBonusBySellerstring必填
子项-以旧换新补贴
示例 0.10
transactionIdstring必填
子项-交易ID
示例 TXN20260317001
transactionTypestring必填
子项-交易类型
示例 SALE
uniqueNostring必填
子项-业务唯一键
示例 SHOPEE-INCOME-001-1
vatOnImportedGoodsstring必填
子项-进口增值税
示例 0.05
voucherFromSellerstring必填
子项-卖家优惠券
示例 1.60
withholdingPitTaxstring必填
子项-PIT
示例 0.10
withholdingTaxstring必填
子项-收入预提税
示例 0.15
withholdingVatTaxstring必填
子项-增值税预提
示例 0.07
commissionFeestring必填
佣金原始值
示例 15.10
currencystring必填
币种
示例 USD
currencyIconstring必填
币种图标
示例 $
dataTypenumber必填
数据类型:1 订单汇总,2 商品明细
示例 1
deliverySellerProtectionFeePremiumAmountstring必填
保险费
示例 0.40
discountedCostOfGoodsSoldstring必填
商品小计-商品金额(折扣后)
示例 425.30
encryptedPayoutIdnumber必填
账期加密ID(仅CB有)
示例 1234567890
escrowImportTaxstring必填
进口税
示例 0.60
escrowTaxstring必填
跨境税
示例 1.05
fbsFeestring必填
FBS费
示例 1.70
finalEscrowProductGststring必填
GST商品税
示例 0.55
finalEscrowShippingGststring必填
GST运费税
示例 0.30
finalProductVatTaxstring必填
VAT商品税
示例 0.75
finalReturnToSellerShippingFeestring必填
退货给卖家运费
示例 1.20
finalShippingVatTaxstring必填
VAT运费税
示例 0.35
hasChildrenboolean必填
是否有子项
示例 true
idnumber必填
主键ID
示例 1001
installationFeePaidByBuyerstring必填
买家支付安装费
示例 0.15
instalmentPlanstring必填
分期计划
示例 3期免息
itemDiscountstring必填
商品折扣额
示例 11.20
itemDiscountTotalstring必填
商品折扣总额
示例 11.20
orderChargeableWeightstring必填
订单计费重量
示例 6.25
orderSnstring必填
平台订单号
示例 ORDER20260317001
originalItemPricestring必填
商品原价(商品维度)
示例 450.00
originalPayoutTimenumber必填
原始结算时间戳
示例 1742198400
otherFeestring必填
其他费用
示例 1.60
otherOrderFeestring必填
其他订单费
示例 0.60
overseasReturnServiceFeestring必填
海外免退服务费
示例 0.50
payoutSnstring必填
账期ID
示例 P20260317001
payoutTimestring必填
结算时间
示例 2026-03-17 12:00:00
platformCodestring必填
平台码
示例 shopee
proratedCoinsValueOffsetReturnItemsstring必填
退款/退货商品的按比例Shopee币抵消
示例 0.25
proratedPaymentChannelPromoBankOffsetReturnItemsstring必填
退货退款商品的按比例银行支付渠道优惠
示例 0.40
proratedPaymentChannelPromoShopeeOffsetReturnItemsstring必填
退货退款商品的按比例Shopee支付渠道优惠
示例 0.45
proratedSellerVoucherOffsetReturnItemsstring必填
退货退款商品的按比例卖家优惠券抵消
示例 0.55
proratedShopeeVoucherOffsetReturnItemsstring必填
退货商品的按比例Shopee优惠券抵消
示例 0.35
refundAmountstring必填
商品小计-退款金额
示例 10.00
reverseShippingFeestring必填
退货运费
示例 1.25
reverseShippingFeeSststring必填
退货运费SST
示例 0.05
rsfSellerProtectionFeeClaimAmountstring必填
运费节省计划
示例 0.30
salesTaxOnLvgstring必填
LVG销售税
示例 0.10
sellerCoinCashBackstring必填
卖家Shopee币回扣
示例 0.65
sellerLostCompensationstring必填
损失赔偿
示例 0.20
sellerOrderProcessingFeestring必填
订单处理费
示例 1.30
sellerProductRebateCommissionFeeOffsetstring必填
佣金抵扣金额
示例 0.45
sellerProductRebateServiceFeeOffsetstring必填
服务费抵扣金额
示例 0.25
sellerShippingDiscountstring必填
卖家运费促销
示例 0.85
sellerTransactionFeestring必填
交易手续费
示例 2.50
sellerVoucherCodestring必填
优惠码
示例 SELLER-20260317
serviceFeestring必填
服务费原始值
示例 9.90
shippingFeeDiscountFrom3plstring必填
3PL运费折扣
示例 0.20
shippingFeeSststring必填
运费SST
示例 0.10
shippingSellerProtectionFeeAmountstring必填
运费节省计划费用
示例 0.25
shopeeDiscountstring必填
Shopee回扣金额
示例 2.05
shopeeShippingRebatestring必填
Shopee运费补贴
示例 1.15
sitestring必填
站点代码
示例 SG
siteDisplaystring必填
站点中文展示
示例 新加坡
storeIdnumber必填
店铺ID
示例 10001
storeNamestring必填
店铺名
示例 Shopee-SG
storeTypenumber必填
店铺类型:1-跨境店, 2-本土店
示例 1
storeTypeDisplaystring必填
店铺类型展示
示例 跨境店
thImportDutystring必填
泰国进口税
示例 0.05
totalIncomeTaxstring必填
所得税总和
示例 0.90
totalOriginalItemPricestring必填
商品小计-商品原价
示例 450.00
totalTariffstring必填
关税总和
示例 0.15
totalVatTaxstring必填
增值税总和
示例 0.95
tradeInBonusBySellerstring必填
以旧换新补贴
示例 0.25
transactionIdstring必填
交易ID(仅Local有)
示例 TXN20260317001
transactionTypestring必填
交易类型(仅Local有)
示例 SALE
uniqueNostring必填
业务唯一键
示例 SHOPEE-INCOME-001
vatOnImportedGoodsstring必填
进口增值税
示例 0.10
voucherFromSellerstring必填
卖家优惠券
示例 3.15
withholdingPitTaxstring必填
PIT
示例 0.20
withholdingTaxstring必填
收入预提税
示例 0.30
withholdingVatTaxstring必填
增值税预提
示例 0.15

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "ccafcc7d9a72484fac5a3889b5db2986.231.17611516492143035",
    "response_time": "2025-10-23 00:47:29",
    "data": {
        "totalCount": 2,
        "totalSum": {
            "amount": "1250.50",
            "currency": "USD",
            "currencyIcon": "$",
            "sellerVoucherCode": "SELLER-20260317",
            "quantity": 5,
            "totalCount": 2
        },
        "list": [
            {
                "uniqueNo": "SHOPEE-INCOME-001",
                "hasChildren": true,
                "orderSn": "ORDER20260317001",
                "storeName": "Shopee-SG",
                "site": "SG",
                "siteDisplay": "新加坡",
                "storeId": 10001,
                "storeType": 1,
                "storeTypeDisplay": "跨境店",
                "payoutSn": "P20260317001",
                "encryptedPayoutId": 1234567890,
                "payoutTime": "2026-03-17 12:00:00",
                "instalmentPlan": "3期免息",
                "transactionId": "TXN20260317001",
                "transactionType": "SALE",
                "amount": "625.25",
                "currency": "USD",
                "currencyIcon": "$",
                "sellerVoucherCode": "SELLER-20260317",
                "children": [
                    {
                        "uniqueNo": "SHOPEE-INCOME-001-1",
                        "parentId": 1001,
                        "itemNumber": 1,
                        "itemId": 3001001,
                        "itemName": "Wireless Mouse",
                        "modelId": 50001,
                        "modelName": "Black",
                        "modelSku": "MODEL-SKU-001",
                        "mskuId": 80001,
                        "msku": "MSKU001",
                        "mskuName": "无线鼠标-黑色",
                        "globalItemSku": "GLOBAL-SKU-001",
                        "quantity": 2,
                        "amount": "320.10",
                        "sellerVoucherCode": "SELLER-20260317"
                    }
                ]
            }
        ]
    }
}