createApplication - создание реализации в 1С
Суть задания: взять параметры из задания и на их основе создать реализацию "Товары и услуги" в 1С
Последовательность выполнения
- Получаете задание через метод check
- Меняете статус на work через changeTaskStatus
- Выполняем необходимые действия
- Отправляем статус done с Guid созданной реализации
Пошаговое выполнение
1. Получение задания
Пример получения заданий post-запросом на метод check
Задания отдаются массивом. Анализируйте тип задания (Task), запоминайте идентификатор (Id) и параметры (Params).
2. Взять задание в работу
Поменяйте статус задания на work с помощью метода changeTaskStatus.
3. Заполнение основной информации
Структуру параметров смотрите в методе получения отгрузок (свойство Data).
Основные поля:
- Дата документа: Params.Date
- Контрагент: Params.Client
- Если Params.Client.Guid заполнен → найти по нему
- Если пустой → создать по Params.Client.Name и Params.Client.Inn
- Договор: Params.Contract
- Если Params.Contract.Guid заполнен → найти по нему
- Если пустой → оставить пустым или заполнить по бизнес-логике
- Счет на оплату: Params.Invoice (аналогично договору)
- Способ доставки: Params.Type
- delivery → доставка
- take-away → самовывоз
- Организация: Params.Seller (по умолчанию или по Params.Seller.Guid)
- Склад: не передаётся, добавьте в код
- Банковский счет: не передаётся, добавьте в код
- Подразделение: не передаётся, добавьте в код
Дополнительные параметры:
- Рецепт: Params.Recipe
- Спецификация: Params.Spec
- ТС: Params.Car
- Водитель: Params.Driver
3.1. Добавление товаров
Товары находятся в Params.Products (массив):
- Товар: найти или создать по Guid или Name
- Количество: Quantity
- Цена: Price или из счета/договора
- Сумма: Sum или рассчитать
- НДС: VatRate или из счета/договора
Если Params.Products пустой, используйте Params.Recipe и Params.Total.
3.2. Добавление услуг
Услуги находятся в Params.Services (массив). Структура аналогична товарам.
Если Params.Services пустой, не заполняйте раздел услуг.
4. Завершение задания
Используйте метод changeTaskStatus:
- Статус: done
- В Data.Guid отправьте идентификатор созданной реализации из 1С
5. Задание выполнено!
Если всё сделано верно, задание будет успешно завершено и реализация добавлена в 1С из Цифры.
См. также
- Метод check
- Метод changeTaskStatus
- Отчет по отгрузкам — структура данных