Qeasy Cloud
Get Started

领星ERP 美客多账单明细 API

Platform
领星ERP
Type
WebAPI
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
多平台 / 财务 / 美客多财务 · POST · 请求参数 19 个(必填 3) · 响应参数 89 个 · 限流令牌桶容量 1
Updated At
2026-11-21

美客多账单明细

POST/basicOpen/multiplatformFinance/mercado/bill/list
Factory
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/multiplatformFinance/mercado/bill/list"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/multiplatformFinance/mercado/bill/list?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"sids\": [\"123456789012345678\"],\n    \"storeTypes\": [1],\n    \"sites\": [\"MX\"],\n    \"currencyCode\": \"USD\",\n    \"descriptionTypes\": [\"Payment\"],\n    \"startDate\": \"2026-01-01 00:00:00\",\n    \"endDate\": \"2026-01-31 23:59:59\",\n    \"searchField1\": \"msku\",\n    \"productSearchValue\": \"MSKU001\",\n    \"productSearchArr\": [\"MSKU001\"],\n    \"searchField2\": \"platformOrderNo\",\n    \"orderSearchValue\": \"ORDER001\",\n    \"orderSearchArr\": [\"ORDER001\"],\n    \"orderIdFilterTypes\": [1],\n    \"offset\": 0,\n    \"length\": 20,\n    \"sortField\": \"releaseDate\",\n    \"sortType\": \"DESC\",\n    \"includedInSettlement\": true\n}'",
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-08-05 12:00:00",
    "data": {
      "totalCount": 1,
      "list": [
        {
          "reportId": 1,
          "companyId": 1,
          "releaseDate": "2026-01-01",
          "sourceId": "SOURCE001",
          "recordType": "Payment",
          "description": "Payment",
          "netCreditAmount": 100,
          "netDebitAmount": 0,
          "grossAmount": 100,
          "currency": "USD",
          "orderId": "ORDER001",
          "productSku": "MSKU001",
          "includedInSettlement": true
        }
      ],
      "totalSum": {
        "netCreditAmount": 100,
        "netDebitAmount": 0,
        "grossAmount": 100,
        "currency": "USD",
        "totalCount": 1
      }
    },
    "total": 1
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1sids店铺ID列表array<any>—Optional店铺ID列表,元素为字符串
2storeTypes店铺类型array<any>—Optional店铺类型:0-本土店 1-跨境店
3sites站点array<any>—Optional站点:MX-墨西哥 MX-full-墨西哥-Full AR-阿根廷 BO-玻利维亚 BR-巴西 CL-智利 CL-full-智利-Full CO-哥伦比亚 COCR-哥斯达黎加 DO-多米尼加 EC-厄瓜多尔 GT-危地马拉 HN-洪都拉斯 NI-尼加拉瓜 PA-巴拿马 PY-巴拉圭 PE-秘鲁 SV-萨尔瓦多 UY-乌拉圭 VE-委内瑞拉
4currencyCode币种string—Required币种
5descriptionTypes描述类型array<any>—Optional描述类型:0-空 1-payment 2-refund 3-mediation 4-mediation_cancel 5-shipping 6-shipping fee 7-shipping_cancel 8-shipping_return 9-restriction 10-dispute 11-tax_payment_ibex 12-tax_payment_iibb_cre_ 13-tax_iibb_ 14-tax_iva 15-tax_iva_cre 16-tax_withholding 17-tax_withholding_cancel 18-tax_withholding_payer 19-tax_withholding_collector 20-tax_withholding_payout 21-tax_withholding_shipping 22-fee_release_in_advance 23-digitalchange_transaction 24-asset_management_gain 25-asset_management_loss 26-chargeback 27-credit_payment 28-cash withdrawal 29-withdrawal 30-payout 31-reserve_for_payment 32-reserve for payout 33-reserve for refund 34-reserve_for_dispute 35-reserve_for_embargo_invested 36-reserve_for_bpp_shipping_return 37-reserve_for_debt_payment 38-reserve_for_cbk_cross_recovery 39-其他描述
6startDate开始时间string—Required开始时间,格式 yyyy-MM-dd HH:mm:ss
7endDate结束时间string—Required结束时间,格式 yyyy-MM-dd HH:mm:ss
8searchField1商品搜索字段string—Optional商品搜索字段,可选值:msku、mskuId、itemId
9productSearchValue商品搜索内容string—Optional商品搜索内容
10productSearchArr商品精确搜索内容array<any>—Optional商品精确搜索内容
11searchField2订单搜索字段string—Optional订单搜索字段:orderId-ORDER ID platformOrderNo-平台单号 platformOrderItemNo-平台子单号 packId-包裹单号 externalReference-参考号 sourceId-来源 ID shippingId-运单号
12orderSearchValue订单搜索内容string—Optional订单搜索内容
13orderSearchArr订单精确搜索内容array<any>—Optional订单精确搜索内容
14orderIdFilterTypesORDER ID 筛选类型array<any>—OptionalORDER ID 筛选类型:0-ORDER ID 为空 1-ORDER ID 首位为 2 2-ORDER ID 首位为 4 3-其他首位
15offset分页偏移量integer—Optional分页偏移量,从0开始,默认0
16length分页长度integer—Optional分页长度,默认20,最大200
17sortField排序字段string—Optional排序字段,可选值:releaseDate、netCreditAmount、netDebitAmount、grossAmount、sellerAmount、mpFeeAmount、financingFeeAmount、shippingFeeAmount、taxesAmount、couponAmount、saleQuantity、refundQuantity
18sortType排序类型string—Optional排序类型,可选值:DESC、ASC
19includedInSettlement是否包含在结算中boolean—Optional是否包含在结算中

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0:成功
2message消息提示stringsuccessRequired消息提示
3error_details数据校验失败时的错误详情array<any>—Required数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583Required请求链路id
5response_time响应时间string2026-08-05 12:00:00Required响应时间
6data响应数据object—Required响应数据
6.1totalCount数据总数integer1Required数据总数
6.2list明细数据array<object>—Required明细数据
6.2.1reportId关联系统报告编号integer1Required关联系统报告编号
6.2.2companyId公司IDinteger1Required公司ID
6.2.3releaseDate放款日期string2026-01-01Required放款日期
6.2.4sourceId来源IDstringSOURCE001Required来源ID
6.2.5externalReference参考号stringREF001Required参考号
6.2.6recordType交易类型stringPaymentRequired交易类型
6.2.7description描述stringPaymentRequired描述
6.2.8netCreditAmount净入账金额number100Required净入账金额
6.2.9netDebitAmount净出账金额number0Required净出账金额
6.2.10grossAmount总金额number100Required总金额
6.2.11sellerAmount分期购买付款金额number100Required分期购买付款金额
6.2.12mpFeeAmount平台佣金number10Required平台佣金
6.2.13financingFeeAmount分期手续费number1Required分期手续费
6.2.14shippingFeeAmount平台物流费number5Required平台物流费
6.2.15taxesAmount税费number3Required税费
6.2.16couponAmount优惠金额number2Required优惠金额
6.2.17currency币种stringUSDRequired币种
6.2.18installments分期期数string1Required分期期数
6.2.19paymentMethod支付方式stringcredit_cardRequired支付方式
6.2.20taxDetail税费明细string—Required税费明细
6.2.21taxAmountTelco电信服务税number0Required电信服务税
6.2.22approvalDate支付批准日期string2026-01-01Required支付批准日期
6.2.23posId收银机IDstringPOS001Required收银机ID
6.2.24posName收银机名称stringPOSRequired收银机名称
6.2.25externalPosId自定义收银机IDstringPOS001Required自定义收银机ID
6.2.26storeId1分支机构IDstringSTORE001Required分支机构ID
6.2.27externalStoreId自定义分支机构IDstringSTORE001Required自定义分支机构ID
6.2.28taxesDisaggregated税费分项明细string—Required税费分项明细
6.2.29shippingId运单号stringSHIP001Required运单号
6.2.30shipmentMode物流方式stringshippingRequired物流方式
6.2.31orderId平台单号stringORDER001Required平台单号
6.2.32packId包裹单号stringPACK001Required包裹单号
6.2.33metadata元数据string—Required元数据
6.2.34effectiveCouponAmount实际优惠金额number2Required实际优惠金额
6.2.35poiId受理点IDstringPOI001Required受理点ID
6.2.36cardInitialNumber卡号前几位string123456Required卡号前几位
6.2.37operationTags物流类型标签string—Required物流类型标签
6.2.38itemIdMSKU IDstringITEM001RequiredMSKU ID
6.2.39bankOfOrigin发卡行stringbankRequired发卡行
6.2.40digitalWallet电子钱包stringwalletRequired电子钱包
6.2.41businessUnit核算主体stringunitRequired核算主体
6.2.42subUnit核算细分单元stringsub-unitRequired核算细分单元
6.2.43balance账户余额string0.00Required账户余额
6.2.44payoutBankAccountNumber提款银行账号string123456Required提款银行账号
6.2.45productSkuproductSkustringMSKU001RequiredMSKU
6.2.46saleDetail销售详情string—Required销售详情
6.2.47paymentMethodType支付方式类型stringcredit_cardRequired支付方式类型
6.2.48transactionIntentId交易意图IDstringTX001Required交易意图ID
6.2.49franchise银行卡品牌stringVISARequired银行卡品牌
6.2.50issuerName发卡机构名称stringissuerRequired发卡机构名称
6.2.51lastFourDigits银行卡后四位string1234Required银行卡后四位
6.2.52orderMp美客多订单IDstringMLB001Required美客多订单ID
6.2.53avkId跨行清算标识stringAVK001Required跨行清算标识
6.2.54purchaseId购买IDstringPURCHASE001Required购买ID
6.2.55shippingOrderId配送关联IDstringDELIVERY001Required配送关联ID
6.2.56gmtCreate创建日期string2026-01-01 00:00:00Required创建日期
6.2.57gmtModified更新日期string2026-01-01 00:00:00Required更新日期
6.2.58storeName店铺名称stringMercado StoreRequired店铺名称
6.2.59others其他object—Required其他
6.2.60includedInSettlement计入结算booleantrueRequired计入结算
6.2.61saleQuantity销售数量string1Required销售数量
6.2.62refundQuantity退款数量string0Required退款数量
6.3totalSum汇总数据object—Required汇总数据
6.3.1netCreditAmount净入账金额number100Required净入账金额
6.3.2netDebitAmount净出账金额number0Required净出账金额
6.3.3grossAmount总金额number100Required总金额
6.3.4sellerAmount分期购买付款金额number100Required分期购买付款金额
6.3.5mpFeeAmount平台佣金number10Required平台佣金
6.3.6financingFeeAmount分期手续费number1Required分期手续费
6.3.7shippingFeeAmount平台物流费number5Required平台物流费
6.3.8taxesAmount税费number3Required税费
6.3.9couponAmount优惠金额number2Required优惠金额
6.3.10currency币种stringUSDRequired币种
6.3.11taxAmountTelco电信服务税number0Required电信服务税
6.3.12effectiveCouponAmount实际优惠金额number2Required实际优惠金额
6.3.13currencyIcon币种图片string$Required币种图片
6.3.14totalCount总数integer1Required总数
6.3.15saleQuantity销售数量string1Required销售数量
6.3.16refundQuantity退款数量string0Required退款数量
6.3.17others其他string—Required其他
7total总数integer1Required总数

The 美客多账单明细 API (/basicOpen/multiplatformFinance/mercado/bill/list) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.