createCompany - создание контрагента
Суть задания: добавить нового контрагента в соответствующий справочник
Последовательность выполнения:
- Получаете задание через метод регулярной проверки наличия заданий
- Меняете у задания статус на work (в работе) с помощью метода смены статуса заданий
- Выполняем необходимые действия (подробнее ниже)
- Новый статус done (завершено) отправляем снова по методу смены статуса задания
Пошаговое выполнение
1. Вы получили задание через метод регулярной проверки наличия заданий:
Пример получения заданий post-запросом на метод check
Задания (Tasks) отдаются массивом. Выполнение заданий также предполагается через цикл, в котором вы последовательно выполняете каждое. Поэтому вам необходимо взять массив Tasks и перебрать его. При каждом проходе цикла анализируйте тип задания (Task), запоминайте идентификатор задания (Id) и его параметры (Params), если они подразумеваются заданием
2. Взяли задание createCompany в работу
Первом делом поменяйте статус задания на work с помощью метода смены статуса заданий:
Пример смены статуса задания. Нужно отправить Id заданий и новый статус
Это нужно для корректной работы выдачи заданий. Цифра будет понимать, что задание уже в работе и точно не создат дублирующие заданий, а также не пустит вперед другие задания, ожидающие завершение текущего
3. Добавьте контрагента в справочник 1С
В задании вы получили следующие параметры (свойство Params):
- Id - это внутренний номер контрагента в Цифре, вам он не нужен
- Name - наименование контрагента
- ShortName - короткое наименование контрагента. Если его нет в Цифре, то мы присылаем полное наименование
- Inn - ИНН контрагента
- CompanyType - тип контрагента, может быть seller (поставщик) или client (покупатель)
Добавьте новое значение в справочник и запомните получившийся Guid в 1С
4. Завершите задание, пришлите идентификатор контрагента из 1С
Снова воспользуйтесь методом смены статуса заданий, только теперь статус будет done (выполнено), также пришлите идентификатор контрагента из 1с, добавив его как свойство Guid к верхнему свойству Data:
Пример завершения задания. Добавили статус done и в Data положили параметр Guid, в котором записали идентификатор из 1С
5. Задание выполнено!
Если все сделано верно, то задание будет успешно завершено и данными действиями вы свяжите нового контрагента в Цифре и в 1С