Цифра ↔ 1С

createApplication - создание реализации в 1С

Суть задания: взять параметры из задания и на их основе создать реализацию "Товары и услуги" в 1С

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

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

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

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

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

Пример получения заданий post-запросом на метод check

Задания отдаются массивом. Анализируйте тип задания (Task), запоминайте идентификатор (Id) и параметры (Params).

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

Смена статуса

Поменяйте статус задания на work с помощью метода changeTaskStatus.

3. Заполнение основной информации

Основные данные

Структуру параметров смотрите в методе получения отгрузок (свойство Data).

Основные поля:

  1. Дата документа: Params.Date
  2. Контрагент: Params.Client
    • Если Params.Client.Guid заполнен → найти по нему
    • Если пустой → создать по Params.Client.Name и Params.Client.Inn
  3. Договор: Params.Contract
    • Если Params.Contract.Guid заполнен → найти по нему
    • Если пустой → оставить пустым или заполнить по бизнес-логике
  4. Счет на оплату: Params.Invoice (аналогично договору)
  5. Способ доставки: Params.Type
    • delivery → доставка
    • take-away → самовывоз
  6. Организация: Params.Seller (по умолчанию или по Params.Seller.Guid)
  7. Склад: не передаётся, добавьте в код
  8. Банковский счет: не передаётся, добавьте в код
  9. Подразделение: не передаётся, добавьте в код

Дополнительные параметры:

3.1. Добавление товаров

Товары

Товары находятся в Params.Products (массив):

  1. Товар: найти или создать по Guid или Name
  2. Количество: Quantity
  3. Цена: Price или из счета/договора
  4. Сумма: Sum или рассчитать
  5. НДС: VatRate или из счета/договора

Если Params.Products пустой, используйте Params.Recipe и Params.Total.

3.2. Добавление услуг

Услуги

Услуги находятся в Params.Services (массив). Структура аналогична товарам.

Если Params.Services пустой, не заполняйте раздел услуг.

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

Завершение

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

5. Задание выполнено!

Если всё сделано верно, задание будет успешно завершено и реализация добавлена в 1С из Цифры.

См. также