轻易云
注册体验

领星ERP美客多账单明细接口

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
多平台 / 财务 / 美客多财务 · POST · 请求参数 19 个(必填 3) · 响应参数 89 个 · 限流令牌桶容量 1
更新日期
2026-11-21

美客多账单明细

POST/basicOpen/multiplatformFinance/mercado/bill/list
加工厂
{
  "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
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1sids店铺ID列表array<any>—可选店铺ID列表,元素为字符串
2storeTypes店铺类型array<any>—可选店铺类型:0-本土店 1-跨境店
3sites站点array<any>—可选站点: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—必填币种
5descriptionTypes描述类型array<any>—可选描述类型: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—必填开始时间,格式 yyyy-MM-dd HH:mm:ss
7endDate结束时间string—必填结束时间,格式 yyyy-MM-dd HH:mm:ss
8searchField1商品搜索字段string—可选商品搜索字段,可选值:msku、mskuId、itemId
9productSearchValue商品搜索内容string—可选商品搜索内容
10productSearchArr商品精确搜索内容array<any>—可选商品精确搜索内容
11searchField2订单搜索字段string—可选订单搜索字段:orderId-ORDER ID platformOrderNo-平台单号 platformOrderItemNo-平台子单号 packId-包裹单号 externalReference-参考号 sourceId-来源 ID shippingId-运单号
12orderSearchValue订单搜索内容string—可选订单搜索内容
13orderSearchArr订单精确搜索内容array<any>—可选订单精确搜索内容
14orderIdFilterTypesORDER ID 筛选类型array<any>—可选ORDER ID 筛选类型:0-ORDER ID 为空 1-ORDER ID 首位为 2 2-ORDER ID 首位为 4 3-其他首位
15offset分页偏移量integer—可选分页偏移量,从0开始,默认0
16length分页长度integer—可选分页长度,默认20,最大200
17sortField排序字段string—可选排序字段,可选值:releaseDate、netCreditAmount、netDebitAmount、grossAmount、sellerAmount、mpFeeAmount、financingFeeAmount、shippingFeeAmount、taxesAmount、couponAmount、saleQuantity、refundQuantity
18sortType排序类型string—可选排序类型,可选值:DESC、ASC
19includedInSettlement是否包含在结算中boolean—可选是否包含在结算中

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0:成功
2message消息提示stringsuccess必填消息提示
3error_details数据校验失败时的错误详情array<any>—必填数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583必填请求链路id
5response_time响应时间string2026-08-05 12:00:00必填响应时间
6data响应数据object—必填响应数据
6.1totalCount数据总数integer1必填数据总数
6.2list明细数据array<object>—必填明细数据
6.2.1reportId关联系统报告编号integer1必填关联系统报告编号
6.2.2companyId公司IDinteger1必填公司ID
6.2.3releaseDate放款日期string2026-01-01必填放款日期
6.2.4sourceId来源IDstringSOURCE001必填来源ID
6.2.5externalReference参考号stringREF001必填参考号
6.2.6recordType交易类型stringPayment必填交易类型
6.2.7description描述stringPayment必填描述
6.2.8netCreditAmount净入账金额number100必填净入账金额
6.2.9netDebitAmount净出账金额number0必填净出账金额
6.2.10grossAmount总金额number100必填总金额
6.2.11sellerAmount分期购买付款金额number100必填分期购买付款金额
6.2.12mpFeeAmount平台佣金number10必填平台佣金
6.2.13financingFeeAmount分期手续费number1必填分期手续费
6.2.14shippingFeeAmount平台物流费number5必填平台物流费
6.2.15taxesAmount税费number3必填税费
6.2.16couponAmount优惠金额number2必填优惠金额
6.2.17currency币种stringUSD必填币种
6.2.18installments分期期数string1必填分期期数
6.2.19paymentMethod支付方式stringcredit_card必填支付方式
6.2.20taxDetail税费明细string—必填税费明细
6.2.21taxAmountTelco电信服务税number0必填电信服务税
6.2.22approvalDate支付批准日期string2026-01-01必填支付批准日期
6.2.23posId收银机IDstringPOS001必填收银机ID
6.2.24posName收银机名称stringPOS必填收银机名称
6.2.25externalPosId自定义收银机IDstringPOS001必填自定义收银机ID
6.2.26storeId1分支机构IDstringSTORE001必填分支机构ID
6.2.27externalStoreId自定义分支机构IDstringSTORE001必填自定义分支机构ID
6.2.28taxesDisaggregated税费分项明细string—必填税费分项明细
6.2.29shippingId运单号stringSHIP001必填运单号
6.2.30shipmentMode物流方式stringshipping必填物流方式
6.2.31orderId平台单号stringORDER001必填平台单号
6.2.32packId包裹单号stringPACK001必填包裹单号
6.2.33metadata元数据string—必填元数据
6.2.34effectiveCouponAmount实际优惠金额number2必填实际优惠金额
6.2.35poiId受理点IDstringPOI001必填受理点ID
6.2.36cardInitialNumber卡号前几位string123456必填卡号前几位
6.2.37operationTags物流类型标签string—必填物流类型标签
6.2.38itemIdMSKU IDstringITEM001必填MSKU ID
6.2.39bankOfOrigin发卡行stringbank必填发卡行
6.2.40digitalWallet电子钱包stringwallet必填电子钱包
6.2.41businessUnit核算主体stringunit必填核算主体
6.2.42subUnit核算细分单元stringsub-unit必填核算细分单元
6.2.43balance账户余额string0.00必填账户余额
6.2.44payoutBankAccountNumber提款银行账号string123456必填提款银行账号
6.2.45productSkuproductSkustringMSKU001必填MSKU
6.2.46saleDetail销售详情string—必填销售详情
6.2.47paymentMethodType支付方式类型stringcredit_card必填支付方式类型
6.2.48transactionIntentId交易意图IDstringTX001必填交易意图ID
6.2.49franchise银行卡品牌stringVISA必填银行卡品牌
6.2.50issuerName发卡机构名称stringissuer必填发卡机构名称
6.2.51lastFourDigits银行卡后四位string1234必填银行卡后四位
6.2.52orderMp美客多订单IDstringMLB001必填美客多订单ID
6.2.53avkId跨行清算标识stringAVK001必填跨行清算标识
6.2.54purchaseId购买IDstringPURCHASE001必填购买ID
6.2.55shippingOrderId配送关联IDstringDELIVERY001必填配送关联ID
6.2.56gmtCreate创建日期string2026-01-01 00:00:00必填创建日期
6.2.57gmtModified更新日期string2026-01-01 00:00:00必填更新日期
6.2.58storeName店铺名称stringMercado Store必填店铺名称
6.2.59others其他object—必填其他
6.2.60includedInSettlement计入结算booleantrue必填计入结算
6.2.61saleQuantity销售数量string1必填销售数量
6.2.62refundQuantity退款数量string0必填退款数量
6.3totalSum汇总数据object—必填汇总数据
6.3.1netCreditAmount净入账金额number100必填净入账金额
6.3.2netDebitAmount净出账金额number0必填净出账金额
6.3.3grossAmount总金额number100必填总金额
6.3.4sellerAmount分期购买付款金额number100必填分期购买付款金额
6.3.5mpFeeAmount平台佣金number10必填平台佣金
6.3.6financingFeeAmount分期手续费number1必填分期手续费
6.3.7shippingFeeAmount平台物流费number5必填平台物流费
6.3.8taxesAmount税费number3必填税费
6.3.9couponAmount优惠金额number2必填优惠金额
6.3.10currency币种stringUSD必填币种
6.3.11taxAmountTelco电信服务税number0必填电信服务税
6.3.12effectiveCouponAmount实际优惠金额number2必填实际优惠金额
6.3.13currencyIcon币种图片string$必填币种图片
6.3.14totalCount总数integer1必填总数
6.3.15saleQuantity销售数量string1必填销售数量
6.3.16refundQuantity退款数量string0必填退款数量
6.3.17others其他string—必填其他
7total总数integer1必填总数

领星ERP的接口:美客多账单明细(/basicOpen/multiplatformFinance/mercado/bill/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。