createOrder - создание реализации заказа

Суть задания (task): создать реализацию заказа в 1С на основе параметров из задания

Последовательность выполнения

1. Получаете задание через метод check
2. Меняете статус на work через changeTaskStatus
3. Создаете реализацию заказа в 1С
4. Отправляем статус done с Guid созданной реализации

Пошаговое выполнение

1. Получение задания

В параметрах задания получите информацию о заказе.

2. Взять задание в работу

Поменяйте статус на work через changeTaskStatus.

3. Создание реализации заказа

Структуру параметров смотрите в методе получения заказов. Обратите внимание: в отчёте возвращаются только завершённые отгрузки, а в задании массив Applications может содержать отгрузки в любом статусе.

Заказ может содержать несколько отгрузок. Каждая отгрузка находится в массиве Applications.

Проверьте статус каждой отгрузки

Перед созданием реализации проверьте поле Status у отгрузок в массиве Applications:

• done — отгрузка выполнена, данные окончательные. Только такие отгрузки стоит проводить как реализацию.
• Любой другой статус (new, loading, delivery, object, pouring, return) — отгрузка ещё не выполнена. Её объём, машина, водитель, время и состав товаров могут измениться, а при отмене, завершении или постановке заказа на паузу отгрузка в статусе new удаляется в Цифре и просто перестанет приходить в следующих заданиях.

Незавершённые отгрузки лучше не проводить: оставьте документ черновиком и дождитесь следующего задания. Задание при этом всё равно завершайте статусом done, чтобы оно не висело в очереди.

Полный список значений — в справочнике статусов отгрузки.

Создание реализации:

Процесс аналогичен созданию реализации, но данные берутся из структуры заказа:

• Основная информация из Params (контрагент, договор, счет)
• Товары и услуги из Applications[].Products и Applications[].Services
• Суммируйте данные по всем отгрузкам в заказе

4. Завершение задания

Используйте метод changeTaskStatus:

• Статус: done
• В Data.Guid отправьте идентификатор созданной реализации из 1С

Отличия от createApplication

• createApplication — реализация одной отгрузки
• createOrder — реализация заказа (может содержать несколько отгрузок)

См. также

• Метод check
• Метод changeTaskStatus
• Отчет по заказам — структура данных
• createApplication — создание реализации отгрузки