На этой странице

Руководство по интеграции · API v1

Быстрый старт

От API-токена до первого визита: последовательность действий без лишних шагов.

1. Получите токен#

Для работы с API в заголовке каждого запроса необходимо передавать Bearer Token. Его можно сгенерировать самостоятельно. Для этого нужно:

Авторизоваться на портале Заездо под пользователем с правами «Администратор клиента».
Пройти по адресу Настройки → Интеграция.
Нажать кнопку «Сгенерировать токен».

Кнопка «Сгенерировать токен» в настройках интеграции — Настройки интеграции Заездо Нажмите, чтобы увеличить

Система выдаст ключ, который нужно скопировать:

Скопируйте созданный токен — Полное значение токена показывается только один раз. На иллюстрации ключ скрыт. Нажмите, чтобы увеличить

Полученный токен нужно сохранить во внешней системе для связи с Заездо.

Заголовок каждого запроса

Authorization: Bearer ВАШ_API_ТОКЕН

Проверить подключение с помощью GET /ping

Выполните запрос с полученным токеном. Ответ HTTP 200 и status: "ok" подтверждает успешную проверку подключения.

HTTP

GET /api/v1/ping HTTP/1.1
Host: app.zaezdo.pro
Authorization: Bearer ВАШ_API_ТОКЕН
Accept: application/json

HTTP 200 · JSON

{
  "status": "ok",
  "integration_id": "DEMO-INT-1C",
  "tenant_id": "CLIENT-DEMO",
  "version": "0.1.85"
}

Полное описание проверки подключения →

2. Подготовьте справочники#

Чтобы полноценно использовать возможности Заездо, необходимо организовать обмен нормативно-справочными данными между информационными системами.

Для этого API поддерживает следующие методы:

Вид данных	Метод обмена
Площадки (склады)	PUT `/api/v1/sites/{source_id}` ↗
Контрагенты (поставщики, клиенты, перевозчики и т.п.)	PUT `/api/v1/counterparties/{source_id}` ↗
Автомобили	PUT `/api/v1/vehicles/{source_id}` ↗
Водители	PUT `/api/v1/drivers/{source_id}` ↗

Сценарии обмена

Первичный перенос справочников. Перед началом промышленной эксплуатации из внешней системы в Заездо единоразово передаются площадки, контрагенты, автомобили и водители.
Регулярный автоматический обмен. В дальнейшем обмен происходит автоматически по мере появления новых данных в мастер-системе.

Примеры запросов для первоначального переноса справочников

Площадки

HTTP

PUT /api/v1/sites/WH-SEVER HTTP/1.1
Host: app.zaezdo.pro
Authorization: Bearer ВАШ_API_ТОКЕН
Content-Type: application/json

{
  "name": "Склад Север",
  "code": "СКЛ-000042",
  "address": "Москва, Складская улица, 15",
  "comment": "Основной склад",
  "admission_mode": "MANUAL_REVIEW"
}

JSON

{
  "name": "Склад Север",
  "code": "СКЛ-000042",
  "address": "Москва, Складская улица, 15",
  "comment": "Основной склад",
  "admission_mode": "MANUAL_REVIEW"
}

cURL · Bash / Git Bash

curl --request PUT \
  --url "https://app.zaezdo.pro/api/v1/sites/WH-SEVER" \
  --header "Authorization: Bearer ВАШ_API_ТОКЕН" \
  --header "Content-Type: application/json" \
  --data '{
  "name": "Склад Север",
  "code": "СКЛ-000042",
  "address": "Москва, Складская улица, 15",
  "comment": "Основной склад",
  "admission_mode": "MANUAL_REVIEW"
}'

Контрагенты

HTTP

PUT /api/v1/counterparties/CP-0042 HTTP/1.1
Host: app.zaezdo.pro
Authorization: Bearer ВАШ_API_ТОКЕН
Content-Type: application/json

{
  "name": "ООО «Пример Логистика»",
  "inn": "7701234560",
  "kpp": "770101001",
  "comment": "Поставщик"
}

JSON

{
  "name": "ООО «Пример Логистика»",
  "inn": "7701234560",
  "kpp": "770101001",
  "comment": "Поставщик"
}

cURL · Bash / Git Bash

curl --request PUT \
  --url "https://app.zaezdo.pro/api/v1/counterparties/CP-0042" \
  --header "Authorization: Bearer ВАШ_API_ТОКЕН" \
  --header "Content-Type: application/json" \
  --data '{
  "name": "ООО «Пример Логистика»",
  "inn": "7701234560",
  "kpp": "770101001",
  "comment": "Поставщик"
}'

Автомобили

HTTP

PUT /api/v1/vehicles/VEH-0085 HTTP/1.1
Host: app.zaezdo.pro
Authorization: Bearer ВАШ_API_ТОКЕН
Content-Type: application/json

{
  "make": "MAN",
  "model": "TGX",
  "plate_number": "А123ВС77",
  "comment": "Тягач"
}

JSON

{
  "make": "MAN",
  "model": "TGX",
  "plate_number": "А123ВС77",
  "comment": "Тягач"
}

cURL · Bash / Git Bash

curl --request PUT \
  --url "https://app.zaezdo.pro/api/v1/vehicles/VEH-0085" \
  --header "Authorization: Bearer ВАШ_API_ТОКЕН" \
  --header "Content-Type: application/json" \
  --data '{
  "make": "MAN",
  "model": "TGX",
  "plate_number": "А123ВС77",
  "comment": "Тягач"
}'

Водители

HTTP

PUT /api/v1/drivers/DRV-0017 HTTP/1.1
Host: app.zaezdo.pro
Authorization: Bearer ВАШ_API_ТОКЕН
Content-Type: application/json

{
  "last_name": "Иванов",
  "first_name": "Иван",
  "middle_name": "Иванович",
  "license_series": "77 15",
  "license_number": "123456",
  "passport_series": "4510",
  "passport_number": "123456",
  "comment": ""
}

JSON

{
  "last_name": "Иванов",
  "first_name": "Иван",
  "middle_name": "Иванович",
  "license_series": "77 15",
  "license_number": "123456",
  "passport_series": "4510",
  "passport_number": "123456",
  "comment": ""
}

cURL · Bash / Git Bash

curl --request PUT \
  --url "https://app.zaezdo.pro/api/v1/drivers/DRV-0017" \
  --header "Authorization: Bearer ВАШ_API_ТОКЕН" \
  --header "Content-Type: application/json" \
  --data '{
  "last_name": "Иванов",
  "first_name": "Иван",
  "middle_name": "Иванович",
  "license_series": "77 15",
  "license_number": "123456",
  "passport_series": "4510",
  "passport_number": "123456",
  "comment": ""
}'

Готовая интеграция с 1С

Мы реализовали интеграцию 1С с Заездо, где поддерживаются оба перечисленных сценария. Использование данных разработок полностью бесплатно.

Версия 1С	Название решения
Управление торговлей ред. 11.5	Интеграция с Заездо (УТ) ред. 1.2 (расширение)
ERP ред. 2.5	Интеграция с Заездо (ERP) ред. 1.4 (расширение)

3. Подготовьте ответственных лиц#

Ответственные лица — это пользователи Заездо, имеющие определенные права.

Чтобы создать визит нужен пользователь с ролью «Менеджер» и правом работы с площадкой, на которую оформляется визит.

Таким образом, к моменту запуска регулярного АПИ-обмена, соответствующие пользователи уже должны быть созданы. Проверьте это здесь: https://app.zaezdo.pro/directory/users

В карточке нужного пользователя Заездо укажите его идентификатор из внешней системы в поле «Идентификатор для синхронизации с 1С». Например, "AfoninGA". Пользователь должен быть активен и иметь действующую учётную запись.

Для проверки возможности создания визита от имени конкретного менеджера существует специальный метод:

GET/api/v1/users/{source_id}Описание метода ↗

Для проверки конкретной площадки укажите её идентификатор в site_source_id. В примере ниже менеджер "AfoninGA" проверяется для площадки "WH-SEVER".

HTTP

GET /api/v1/users/AfoninGA?site_source_id=WH-SEVER HTTP/1.1
Host: app.zaezdo.pro
Authorization: Bearer ВАШ_API_ТОКЕН
Accept: application/json

Фрагмент ответа · HTTP 200

{
  "can_be_responsible_for_site": {
    "site_source_id": "WH-SEVER",
    "allowed": true
  }
}

Если в ответе вы получили can_be_responsible_for_site.allowed: true, то менеджер может работать с конкретной площадкой.

4. Создайте визит#

После подготовки справочных данных можно переходить к созданию визитов.

Для этого предусмотрен метод:

POST/api/v1/visitsОписание метода ↗

В примере используются подготовленные выше площадка "WH-SEVER", контрагент "CP-0042", автомобиль "VEH-0085", водитель "DRV-0017" и менеджер "AfoninGA". Идентификатор заявки во внешней системе — "ТД00-000015".

HTTP

POST /api/v1/visits HTTP/1.1
Host: app.zaezdo.pro
Authorization: Bearer ВАШ_API_ТОКЕН
Content-Type: application/json

{
  "external_id": "ТД00-000015",
  "site_source_id": "WH-SEVER",
  "planned_arrival_at": "2026-11-03 10:30",
  "purpose": "UNLOADING",
  "counterparty_source_id": "CP-0042",
  "responsible_user_source_id": "AfoninGA",
  "vehicle_source_id": "VEH-0085",
  "driver_source_id": "DRV-0017",
  "basis": "Поставка по заявке №123"
}

JSON

{
  "external_id": "ТД00-000015",
  "site_source_id": "WH-SEVER",
  "planned_arrival_at": "2026-11-03 10:30",
  "purpose": "UNLOADING",
  "counterparty_source_id": "CP-0042",
  "responsible_user_source_id": "AfoninGA",
  "vehicle_source_id": "VEH-0085",
  "driver_source_id": "DRV-0017",
  "basis": "Поставка по заявке №123"
}

cURL · Bash / Git Bash

curl --request POST \
  --url "https://app.zaezdo.pro/api/v1/visits" \
  --header "Authorization: Bearer ВАШ_API_ТОКЕН" \
  --header "Content-Type: application/json" \
  --data '{
  "external_id": "ТД00-000015",
  "site_source_id": "WH-SEVER",
  "planned_arrival_at": "2026-11-03 10:30",
  "purpose": "UNLOADING",
  "counterparty_source_id": "CP-0042",
  "responsible_user_source_id": "AfoninGA",
  "vehicle_source_id": "VEH-0085",
  "driver_source_id": "DRV-0017",
  "basis": "Поставка по заявке №123"
}'

Метод не создаёт площадки, контрагентов, автомобили, водителей или другую информацию. В случае отсутствия необходимых данных он выдаст ошибку. Обработайте ее и догрузите недостающие данные, если требуется, с помощью методов PUT.

5. Обработайте результат#

Если визит успешно создан, система вернет:

HTTP 201 · Визит создан

{
  "id": "VST-EXAMPLE001",
  "external_id": "ТД00-000015",
  "created": true,
  "status": "PLANNED",
  "admission_status": "UNDEFINED"
}

Сохраните результат в вашей информационной системе.

Первый визит передан.

Теперь повторяйте этот порядок для новых заявок: поддерживайте справочники в актуальном состоянии, указывайте ответственного и обрабатывайте результат создания.

Общие правила обмена →