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

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

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

$ curl -H "Authorization: Bearer api-key" \
       --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

Исполнитель

Объект

Нет

Да

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

assignees

[Множественный исполнитель]

Массив

Нет

Нет

Список исполнителей.
Если передан, то значение поля assignee игнорируется. Должен включать как минимум одного исполнителя с edit правом

possible_resolutions

[Резолюция]

Массив

Нет

Нет

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

address

Адрес

Объект

Нет

Нет

Адрес

contacts

[Контакт]

Массив

Нет

Нет

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

client

Существующий клиент или Новый клиент

Объект

Нет

Да

Клиент

site

Существующий объект или Новый объект

Объект

Нет

Да

Объект

territory

Участок

Объект

Нет

Да

Участок

skills

[Навык]

Массив

Нет

Нет

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

custom_fields

[Доп. поле]

Массив

Нет

Нет

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

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

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

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