Получение клиента

Клиент может быть получен по uuid или external_id.

Юрлица и физлица имеют различный набор полей, см. таблицу.
Получение юрлица по uuid
$ curl -H "X-Planado-API-Key:XXX" https://api.planadoapp.com/v2/clients/50c773b3-a4f8-5619-be47-cb6a0edb22cc | jq
{
  "client": {
    "uuid": "50c773b3-a4f8-5619-be47-cb6a0edb22cc",
    "external_id": "423430387320568-acme",
    "name": "ACME Corporation",
    "organization": true,
    "organization_name": "ACME Corporation",
    "site_address": {
      "formatted": "Passeig de Gràcia, 92, 08008 Barcelona, Spain",
      "entrance_no": "1",
      "apartment": null,
      "floor": "1",
      "description": "Entrance via Carrer de Procença",
      "geolocation": {
        "longitude": 37.6785237278356,
        "latitude": 55.7862807707096
      }
    },
    "contacts": [
      {
        "name": "Pedro",
        "value": "(834) 362-5246",
        "type": "phone"
      }
    ],
    "version": 1
  }
}
Получение юрлица по external_id
$ curl -H "X-Planado-API-Key:XXX" https://api.planadoapp.com/v2/clients/423430387320568-acme | jq
{
  "client": {
    "uuid": "50c773b3-a4f8-5619-be47-cb6a0edb22cc",
    "external_id": "423430387320568-acme",
    "name": "ACME Corporation",
    ...
  }
}
Получение физлица по uuid
$ curl -H "X-Planado-API-Key:XXX" https://api.planadoapp.com/v2/clients/b2584e3c-25dd-4773-ab8b-0a018fd58d2b | jq
{
  "client": {
    "uuid": "b2584e3c-25dd-4773-ab8b-0a018fd58d2b",
    "external_id": "22451458596510-john-doe-the-second",
    "name": "John Doe the Second",
    "organization": false,
    "first_name": "John",
    "last_name": "Doe",
    "middle_name": "the second",
    "site_address": {
      "formatted": "VFWH+25 Rome, Metropolitan City of Rome, Italy",
      "entrance_no": "3",
      "apartment": "11",
      "floor": "2",
      "description": "Knock hard",
      "geolocation": {
        "longitude": 12.4772501,
        "latitude": 41.8950619
      }
    },
    "contacts": [
      {
        "name": "John",
        "value": "(923) 820-5063",
        "type": "phone"
      }
    ]
  }
}
Table 1. Поля client
Поле Тип JSON-тип Может быть null Описание

uuid

UUID

Строка

Нет

Уникальный идентификатор

external_id

Строка

Строка

Да

Внешний идентификатор

name

Строка

Строка

Нет

Имя клиента. Это значение берется автоматически из organization_name или складывается из значений полей first_name, last_name, и middle_name

organization_name*

Строка

Строка

Нет

Название юрлица. Ограничено 5000 символов

organization

Булев

Булев

Нет

Является ли клиент юрлицом

first_name**

Строка

Строка

Да

Имя

last_name**

Строка

Строка

Да

Фамилия

middle_name**

Строка

Строка

Да

Отчество

contacts

[Контакт]

Массив

Нет

Список контактов

site_address

Адрес

Объект

Да

Адрес

version

Целое

Число

Нет

Версия

* Эти поля присутствуют только для юрлиц (organization == true)

** Эти поля присутствуют только для физлиц (organization == false)