Lingxing
切换旧版

Walmart - 查询结算账单列表

POST/basicOpen/multiplatformFinance/walmart/bill/statement/list

Walmart-查询结算账单列表,支持按订单、商品、账期、交易类型、金额类型和时间范围查询 Walmart 结算账单明细。

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/multiplatformFinance/walmart/bill/statement/listHTTPSPOST1

请求参数

amountTypesarray<any>
金额类型数组
currencyCodestring
目标货币代码
endDatestring
结束时间,格式:yyyy-MM-dd
fulfillmentTypesarray<any>
发货类型数组
lengthinteger必填
分页大小,默认 20,最大 200
offsetinteger必填
分页偏移量,默认 0
searchExactlyboolean
是否精确匹配
searchMultiValuearray<any>
多个搜索值,精确匹配时使用
searchSingleValuestring
单个搜索值
searchTypeinteger
搜索类型
1:平台单号
2:客户单号
3:MSKU
4:GTIN
5:商品标题
6:账期ID
sidsarray<any>
店铺ID数组,数组元素为查询多平台店铺信息接口返回的沃尔玛店铺 store_id
sortFieldstring
排序字段
sortTypestring
排序方向
1:升序
0:降序
startDatestring
开始时间,格式:yyyy-MM-dd
transactionDescriptionsarray<any>
交易描述数组
transactionTypesarray<any>
交易类型数组
Sale
Refund
Campaigns
Adjustment
Service Fee
Customer Fee
Misc Adjustment
Dispute Settlement
Prepaid
Prepaid Recouped
Rewards
Other

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/multiplatformFinance/walmart/bill/statement/list?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
  "sids": [],
  "amountTypes": [],
  "currencyCode": "",
  "fulfillmentTypes": [],
  "transactionDescriptions": [],
  "transactionTypes": ["Other"],
  "startDate": "2026-01-01",
  "endDate": "2026-06-29",
  "offset": 0,
  "length": 20
}'

返回结果

JSON Object

codeinteger必填
状态码,0:成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
request_idstring必填
请求链路id
示例 a0d54debf93140f3b58d1ed81e8e3583
response_timestring必填
响应时间
示例 2026-05-25 12:00:00
dataobject必填
响应数据
隐藏子属性
listarray<object>必填
列表数据
隐藏子属性
amountnumber必填
金额
示例 35.5
amountTypestring必填
费用名称
示例 Commission
baseCommissionRatenumber必填
基础佣金费率
示例 0.15
campaignIdstring必填
广告活动ID
示例 C10001
chargeSavingsnumber必填
费用补贴
示例 2
commissionIncentiveProgramstring必填
平台激励项目
示例 Incentive
commissionRatenumber必填
佣金费率
示例 0.12
commissionRulestring必填
佣金规则
示例 Standard
commissionSavingnumber必填
佣金折扣
示例 1.5
companyIdinteger必填
公司ID
示例 10001
contractCategorystring必填
品类大类
示例 Electronics
currencystring必填
币种
示例 USD
currencyIconstring必填
币种图标
示例 $
customerOrderLineNostring必填
客户子单号
示例 COL-10001
customerOrderNostring必填
客户单号
示例 CO-10001
customerPromoTypestring必填
卖家促销类型
示例 Coupon
deleteFlaginteger必填
删除标识
示例 0
fulfillmentDetailsstring必填
发货说明
示例 WFS fulfillment
fulfillmentTypestring必填
发货类型
示例 WFS
idinteger必填
主键ID
示例 100001
incentiveProgramNamestring必填
激励项目名称
示例 Pro Seller
itemConditionstring必填
商品属性
示例 New
originalChargenumber必填
费用原值
示例 10
originalCommissionnumber必填
佣金原值
示例 6
partnerGtinstring必填
GTIN
示例 00012345678905
partnerItemIdstring必填
MSKU
示例 MSKU-001
partnerItemNamestring必填
商品标题
示例 Wireless Mouse
periodEndDatestring必填
周期结束日期
示例 2026-01-31
periodStartDatestring必填
周期开始日期
示例 2026-01-01
platformCodestring必填
平台码
示例 walmart
productTaxCodestring必填
商品税代码
示例 2038710
productTypestring必填
品类小类
示例 Mouse
purchaseOrderLineNostring必填
平台子单号
示例 POL-10001
purchaseOrderNostring必填
平台单号
示例 PO-10001
remarkstring必填
备注
示例 normal
reportDatestring必填
报告日期
示例 2026-01-31
reportIdinteger必填
报告ID
示例 90001
reportKeystring必填
报告唯一键
示例 RPT-202601
shipQtyinteger必填
发货量
示例 2
shipToCitystring必填
收货城市
示例 Los Angeles
shipToCountrystring必填
收货国
示例 US
shipToStatestring必填
收货省州
示例 CA
shipToZipcodestring必填
收货邮编
示例 90001
shippingMethodstring必填
发货方式
示例 Standard
sitestring必填
站点代码
示例 US
siteCodestring必填
站点
示例 US
siteDisplaystring必填
站点中文展示
示例 美国
storeIdinteger必填
店铺ID
示例 123456
storeNamestring必填
店铺名
示例 Walmart US Store
totalPayablenumber必填
结算金额
示例 120.5
totalWalmartFundedSavingsProgramnumber必填
平台补贴
示例 3
transactionDescriptionstring必填
交易描述
示例 Item Sale
transactionKeystring必填
结算ID
示例 TXN-10001
transactionPostedTimestampstring必填
结算时间
示例 2026-01-15 10:30:00
transactionReasonDescriptionstring必填
交易说明
示例 Product charge
transactionTypestring必填
交易类型
示例 Sales
uniqueNostring必填
唯一标识
示例 UNQ-10001
totalCountinteger必填
总记录数
示例 1
totalSumobject必填
汇总数据
隐藏子属性
amountnumber必填
交易金额汇总
示例 35.5
chargeSavingsnumber必填
收费节省汇总
示例 2
commissionSavingnumber必填
佣金节省汇总
示例 1.5
currencystring必填
货币代码
示例 USD
currencyIconstring必填
货币图标
示例 $
originalChargenumber必填
原始收费汇总
示例 10
originalCommissionnumber必填
原始佣金汇总
示例 6
shipQtyinteger必填
发货数量汇总
示例 2
totalCountinteger必填
总记录数
示例 1
totalPayablenumber必填
应付总额
示例 120.5
totalWalmartFundedSavingsProgramnumber必填
Walmart补贴总额
示例 3

返回成功示例

{
  "code": 0,
  "message": "success",
  "error_details": [],
  "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
  "response_time": "2026-05-25 12:00:00",
  "data": {
    "list": [
      {
        "amount": 35.50,
        "amountType": "Commission",
        "baseCommissionRate": 0.15,
        "campaignId": "C10001",
        "chargeSavings": 2.00,
        "commissionIncentiveProgram": "Incentive",
        "commissionRate": 0.12,
        "commissionRule": "Standard",
        "commissionSaving": 1.50,
        "companyId": 10001,
        "contractCategory": "Electronics",
        "currency": "USD",
        "currencyIcon": "$",
        "customerOrderLineNo": "COL-10001",
        "customerOrderNo": "CO-10001",
        "customerPromoType": "Coupon",
        "deleteFlag": 0,
        "fulfillmentDetails": "WFS fulfillment",
        "fulfillmentType": "WFS",
        "id": 100001,
        "incentiveProgramName": "Pro Seller",
        "itemCondition": "New",
        "originalCharge": 10.00,
        "originalCommission": 6.00,
        "partnerGtin": "00012345678905",
        "partnerItemId": "MSKU-001",
        "partnerItemName": "Wireless Mouse",
        "periodEndDate": "2026-01-31",
        "periodStartDate": "2026-01-01",
        "platformCode": "walmart",
        "productTaxCode": "2038710",
        "productType": "Mouse",
        "purchaseOrderLineNo": "POL-10001",
        "purchaseOrderNo": "PO-10001",
        "remark": "normal",
        "reportDate": "2026-01-31",
        "reportId": 90001,
        "reportKey": "RPT-202601",
        "shipQty": 2,
        "shipToCity": "Los Angeles",
        "shipToCountry": "US",
        "shipToState": "CA",
        "shipToZipcode": "90001",
        "shippingMethod": "Standard",
        "site": "US",
        "siteCode": "US",
        "siteDisplay": "美国",
        "storeId": 123456,
        "storeName": "Walmart US Store",
        "totalPayable": 120.50,
        "totalWalmartFundedSavingsProgram": 3.00,
        "transactionDescription": "Item Sale",
        "transactionKey": "TXN-10001",
        "transactionPostedTimestamp": "2026-01-15 10:30:00",
        "transactionReasonDescription": "Product charge",
        "transactionType": "Sales",
        "uniqueNo": "UNQ-10001"
      }
    ],
    "totalCount": 1,
    "totalSum": {
      "amount": 35.50,
      "chargeSavings": 2.00,
      "commissionSaving": 1.50,
      "currency": "USD",
      "currencyIcon": "$",
      "originalCharge": 10.00,
      "originalCommission": 6.00,
      "shipQty": 2,
      "totalCount": 1,
      "totalPayable": 120.50,
      "totalWalmartFundedSavingsProgram": 3.00
    }
  }
}