轻易云
注册体验

领星ERP查询客户列表(新)接口

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
客服 · POST · 请求参数 11 个(必填 0) · 响应参数 33 个
更新日期
2026-11-21

查询客户列表(新)

POST/basicOpen/customerService/crm/customer/index
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/customerService/crm/customer/index"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "requestExample": {
    "sort_field": "order_items",
    "sort_type": "desc",
    "date_field": "first_purchase_date",
    "start_date": "2021-01-31",
    "end_date": "2021-03-02",
    "currency_type": 0,
    "search_field": "buyer_email",
    "offset": 0,
    "length": 20,
    "search_value": "t83lnqt83k5317b@marketplace.amazon.com",
    "sids": "17"
  },
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "842d7733ef5d4d968bc6877e06c34453.1697004896752",
    "response_time": "2023-10-11 14:14:56",
    "data": {
      "list": [
        {
          "buyer_email": "1f9rg94t5vnhqgm@marketplace.amazon.com",
          "buyer_name": "linda meckel",
          "sid": 109,
          "country": "美国",
          "order_items": 1,
          "volume": 1,
          "amount": 0,
          "per_customer_transaction": 0,
          "currency_icon": "$",
          "refund_number": 1,
          "refund_sales_number": 1,
          "refund_rate": 1,
          "return_number": 0,
          "return_sales_number": 0,
          "return_rate": 0,
          "feedback_number": 0,
          "seller_name": "篮球",
          "feedback_bad_number": 0,
          "feedback_rate": 0,
          "feedback_bad_rate": 0,
          "first_purchase_date": "2021-02-23 14:24:46",
          "last_purchase_date": "2021-02-23 14:24:46",
          "remark": "",
          "group": [
            "4.13验证",
            "选择两个店铺",
            "081111",
            "重构后验证",
            "自定义080801",
            "12"
          ]
        }
      ],
      "total": 1
    },
    "total": 1
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1sort_field结果按字段排序string—可选结果按字段排序
2sort_typedesc=倒序string—可选desc=倒序,asc=升序
3date_field时间筛选查询类型string—可选时间筛选查询类型,1:首次购买时间 ,2:最近购买时间
4start_date筛选开始时间string—可选筛选开始时间
5end_date筛选结束时间string—可选筛选结束时间
6currency_type币种number—可选币种,0=原币种,1=CNY,2=USD
7search_fieldsearch_fieldstring—可选支持搜索的字段 buyer_email、buyer_name
8offset偏移量number—可选偏移量
9length分页长度number—可选分页长度 ,默认20 ,上限200
10search_value搜索值string—可选搜索值
11sids店铺idstring—可选店铺id ,对应查询亚马逊店铺列表接口对应字段【sid】

接口响应参数

序号字段名称类型默认值必填描述
1code最近购买时间number0必填最近购买时间
2message消息提示stringsuccess必填消息提示
3error_details错误信息array<any>[]必填错误信息
4request_id请求idstring842d7733ef5d4d968bc6877e06c34453.1697004896752必填请求id
5response_time响应时间string2023-10-11 14:14:56必填响应时间
6datadataobject—必填
6.1listlistarray<object>—必填
6.1.1buyer_email买家邮箱string1f9rg94t5vnhqgm@marketplace.amazon.com必填买家邮箱
6.1.2buyer_name买家姓名stringlinda meckel必填买家姓名
6.1.3sid店铺idarray<any>109必填店铺id
6.1.4country国家名称string美国必填国家名称
6.1.5order_items总订单number1必填总订单
6.1.6volume总销量number1必填总销量
6.1.7amount总销售额number0必填总销售额
6.1.8per_customer_transaction平均客单价number0必填平均客单价
6.1.9currency_icon币种string$必填币种
6.1.10refund_number退款订单数number1必填退款订单数
6.1.11refund_sales_number退款销售数number1必填退款销售数
6.1.12refund_rate退款率number1必填退款率
6.1.13return_number退货订单数number0必填退货订单数
6.1.14return_sales_number退货销量数number0必填退货销量数
6.1.15return_rate退货率number0必填退货率
6.1.16feedback_numberFeedback评论数number0必填Feedback评论数
6.1.17seller_name店铺名称string篮球必填店铺名称
6.1.18feedback_bad_numberFeedback差评数number0必填Feedback差评数
6.1.19feedback_rateFeedback留评率number0必填Feedback留评率
6.1.20feedback_bad_rateFeedback差评率number0必填Feedback差评率
6.1.21first_purchase_date首次购买时间string2021-02-23 14:24:46必填首次购买时间
6.1.22last_purchase_date最近购买时间string2021-02-23 14:24:46必填最近购买时间
6.1.23remark备注string—必填备注
6.1.24group分组array<any>["4.13验证","选择两个店铺","081111","重构后验证","自定义080801","12"]必填分组
6.2total总数number—必填总数
7total总数number1必填总数

领星ERP的接口:查询客户列表(新)(/basicOpen/customerService/crm/customer/index),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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