Как работают наряды на выполнение работ через API
Если ваша организация планирует работы в другом программном обеспечении (например, Agvance), подключение API отправляет эти наряды на выполнение работ в Mixmate, поэтому никому не нужно вводить их повторно. В этой статье описан весь процесс: от момента, когда заказ покидает ваше программное обеспечение, до смешивания его оператором на планшете.
Прежде чем начать:
Подключение настраивает администратор в Intersect, и для него нужен уровень «Премиум».
Импорт выполняется в веб-приложении (app.mixmate.com). Приложение на планшете не импортирует наряды на выполнение работ через API; оно получает их после того, как они импортированы.
Процесс вкратце
Заголовок раздела «Процесс вкратце»Ваше программное обеспечение отправляет заказ. Он ожидает в подключении, пока кто-нибудь его не импортирует.
Вы синхронизируете API в веб-приложении. Mixmate собирает ожидающие заказы и пытается импортировать каждый из них.
Полные заказы импортируются сами. Их продукты сопоставляются с уже существующими, а новые создаются.
Неполные заказы удерживаются во «Входящих API», пока кто-нибудь не заполнит недостающее.
Планшет получает импортированные заказы при следующей синхронизации с облаком.
1. Синхронизация API
Заголовок раздела «1. Синхронизация API»Новые заказы не импортируются сами по себе: кто-то должен синхронизировать API. Делайте это всякий раз, когда были отправлены новые заказы, например в начале дня.
В веб-приложении откройте вкладку «Администрирование».
Найдите карточку «Неимпортированные наряды на выполнение работ». На ней показаны два счётчика:
Первое число: заказы, удерживаемые для проверки в текущем сеансе (см. шаг 3).
«Доступно для импорта»: заказы, ожидающие в ваших подключениях, включая удерживаемые заказы, которые ещё не обработаны.
В узком окне браузера счётчики скрыты; расширьте окно, чтобы их увидеть.
Нажмите «Синхронизировать API» на карточке. Откроется окно «Синхронизация API», в котором отображается ход выполнения:
«Получение нарядов на выполнение работ через API для импорта»: Mixmate собирает ожидающие заказы. Число увеличивается по мере их поступления.
«Импорт нарядов на выполнение работ через API»: каждый заказ проверяется и импортируется, с индикатором выполнения.
«Завершено»: всё обработано. Становится доступной кнопка «Закрыть».


Совет: не закрывайте вкладку, пока в окне не появится «Завершено». Если закрыть браузер на полпути, оставшиеся заказы продолжат ожидать; просто синхронизируйте ещё раз.
2. Что импортируется само
Заголовок раздела «2. Что импортируется само»Для каждого заказа Mixmate сначала проверяет его продукты, а затем наряд на выполнение работ.
Продукты
Используются продукты, которые у вас уже есть. Продукт совпадает, если это тот же продукт, который API отправлял ранее, у него те же внешние идентификаторы или то же название. Если совпадающий продукт архивирован, он восстанавливается.
Новые продукты создаются, если API отправил всё, что для них нужно Mixmate (например, плотность сухого продукта).
Существующие продукты сохраняют ваши сведения, если в настройках группы не включён параметр «Обновлять продукты API при импорте». Включите его, если список продуктов вы ведёте в другом программном обеспечении.
Наряд на выполнение работ
Полный заказ импортируется сразу, без проверки.
Заказ, номер наряда на выполнение работ которого у вас уже есть, пропускается. Он не импортируется повторно, и изменения в нём не применяются. Чтобы изменить уже импортированный заказ, отредактируйте его в Mixmate.
Всё, что не удаётся импортировать из-за отсутствующей информации, удерживается для проверки.
3. Заказы, удерживаемые для проверки
Заголовок раздела «3. Заказы, удерживаемые для проверки»Заказ удерживается, когда Mixmate нужно что-то, чего API не отправил. Частые причины:
У нового продукта отсутствуют сведения, например плотность, норма плотности или размер ёмкости.
У наряда на выполнение работ отсутствует размер, например площадь в акрах для заказа на основе нормы, или его нормы внесения.
Нажмите на карточку «Неимпортированные наряды на выполнение работ», чтобы открыть «Входящие API». Там перечислены все удерживаемые заказы с подключением, из которого они пришли.

Нажмите на заказ, чтобы исправить и утвердить его. В статье Ручной импорт нарядов на выполнение работ через API это описано пошагово.
Заказ не нужен? Нажмите значок корзины рядом с ним, затем «Удалить». Он удаляется из «Входящих API» и из подключения и не импортируется.

Удерживаемые заказы и перезагрузка страницы: «Входящие API» заполняются кнопкой «Синхронизировать API». Если перезагрузить веб-приложение или войти снова, «Входящие API» будут пустыми, но удерживаемые заказы по-прежнему учитываются в счётчике «Доступно для импорта». Нажмите «Синхронизировать API» ещё раз, и они вернутся во «Входящие API».
4. На планшете
Заголовок раздела «4. На планшете»Импортированные заказы сразу сохраняются в вашей облачной учётной записи. Каждый планшет получает их при следующей синхронизации с облаком. После этого это обычные наряды на выполнение работ: выберите один из них в «Настройке смешивания» и выполните смешивание как обычно.
Устранение неполадок
Заголовок раздела «Устранение неполадок»Я не вижу карточку «Неимпортированные наряды на выполнение работ». Она есть только в веб-приложении, а не на планшете. Если вы в веб-приложении, вашей организации нужен уровень «Премиум» и подключение API, настроенное в Intersect.
В счётчике «Доступно для импорта» есть заказы, но «Входящие API» пусты. Нажмите «Синхронизировать API». Заказы, которые импортируются, сразу попадают в ваши наряды на выполнение работ; остальные появляются во «Входящих API».
Отправленного мной заказа нет в Mixmate. Синхронизируйте API. Если его всё ещё нет, проверьте, не существует ли уже наряд на выполнение работ с таким же номером: если да, новый был пропущен.
На планшете нет заказа. Убедитесь, что он импортирован (он есть в нарядах на выполнение работ в веб-приложении и отсутствует во «Входящих API»). Затем синхронизируйте планшет с облаком.
Сведения о продукте постоянно возвращаются к прежним. Включён параметр «Обновлять продукты API при импорте», поэтому каждый импорт обновляет продукт из вашего другого программного обеспечения. Измените продукт там или отключите этот параметр.