Добавление наряда

Наряд в Планадо — это список работ, которые должен выполнить выездной сотрудник (исполнитель).

Для добавления наряда, отправьте POST-запрос на https://api.planadoapp.com/v2/jobs:

$ curl -H "X-Planado-API-Key:XXX" \
       --data "{\"description\": \"Диагностика\"}" \
       https://api.planadoapp.com/v2/jobs | jq
{
  "job_uuid": "8070f98d-b3f6-4cc8-b7c4-54b6709cd98b"
}

Схема запроса

Все поля необязательны.

Поле Тип JSON-тип Обязательно Может быть null Описание

template

Шаблон

Объект

Нет

Нет

Шаблон

job_type

Тип наряда

Объект

Нет

Нет

Тип наряда

external_id

Строка

Строка

Нет

Нет

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

external_order_id

Строка

Строка

Нет

Нет

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

description

Строка

Строка

Нет

Да

Текстовое описание наряда. Ограничено 15000 символов

scheduled_at

Дата и время

Строка

Нет

Да

Запланированная дата начала наряда

scheduled_duration

Длительность

Объект

Нет

Да

Запланированная длительность

assignee

Исполнитель

Объект

Нет

Да

Исполнитель — пользователь или бригада

possible_resolutions

[Резолюция]

Массив

Нет

Нет

Список возможных резолюций. Если передан, должен включать как минмум одну успешную и одну неуспешную резолюцию

address

Адрес

Объект

Нет

Нет

Адрес

contacts

[Контакт]

Массив

Нет

Нет

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

client

Клиент

Объект

Нет

Да

Клиент

site

Объект

Объект

Нет

Да

Объект

territory

Участок

Объект

Нет

Да

Участок

skills

[Навык]

Массив

Нет

Нет

Навыки, необходимые для выполнения наряда

custom_fields

[Доп. поле]

Массив

Нет

Нет

Значения дополнительных полей наряда

Группировка нярядов

Внешний идентификатор заказа. В отличие от external_id это поле неуникально. Обычно в нем содержится идентификатор сущности во внешней системе, которой может соответствовать несколько нарядов в Планадо. Например, сделка в CRM может включать несколько выездов для выполнения работ.

Используя external_order_id , можно фильтровать наряды