ircloud-assistant/skills/irun-yidianhuo/customer.md

客户查询接口

1. 客户分类列表

GET https://openapi.77ircloud.com/organization-aggregation/organizations/customer-categories

Header: access_token: {token}

返回：

{
  "code": 200,
  "data": [
    {"id": 2116753907815520, "name": "普通客户", "defaultFlag": true},
    {"id": 2116796845712896, "name": "尊宝快递", "defaultFlag": false},
    {"id": 2116796846321152, "name": "家庭客户", "defaultFlag": false}
  ]
}

---

2. 客户列表（查询）

POST https://openapi.77ircloud.com/organization-aggregation/customer/search

Header: access_token: {token} + Content-Type: application/json

Body 参数：

{
  "pageNum": 1,
  "pageSize": 10,
  "keyword": "成都"  // 可选，按客户名称模糊搜索
}

返回：

{
  "code": 200,
  "data": {
    "items": [
      {
        "id": 2139500795701856,
        "code": "0411190513901",
        "name": "成都冷鲜优选供应链公司",
        "contactName": "周总",
        "contactPhone": "136xxx",
        "categoryId": 2116753907815520,
        "categoryName": "普通客户"
      }
    ]
  }
}

说明： 这是查询类接口（POST 方法是业务含义上的查询，不是写操作）

---

3. 收货地址列表

GET https://openapi.77ircloud.com/organization-aggregation/organizations/{orgId}/delivery-addresses

Header: access_token: {token}

路径参数：

• orgId: 客户ID（从客户列表获取）

返回：

{
  "code": 200,
  "data": [
    {
      "id": 2139500796169856,
      "contactName": "",
      "contactPhone": "",
      "provinceId": 510000,
      "cityId": 510100,
      "districtId": 510106,
      "address": "四川省成都市金牛区..."
    }
  ]
}