Перейти к содержимому

Как работают наряды на выполнение работ через API

Если ваша организация планирует работы в другом программном обеспечении (например, Agvance), подключение API отправляет эти наряды на выполнение работ в Mixmate, поэтому никому не нужно вводить их повторно. В этой статье описан весь процесс: от момента, когда заказ покидает ваше программное обеспечение, до смешивания его оператором на планшете.

Прежде чем начать:

  • Подключение настраивает администратор в Intersect, и для него нужен уровень «Премиум».

  • Импорт выполняется в веб-приложении (app.mixmate.com). Приложение на планшете не импортирует наряды на выполнение работ через API; оно получает их после того, как они импортированы.


  1. Ваше программное обеспечение отправляет заказ. Он ожидает в подключении, пока кто-нибудь его не импортирует.

  2. Вы синхронизируете API в веб-приложении. Mixmate собирает ожидающие заказы и пытается импортировать каждый из них.

  3. Полные заказы импортируются сами. Их продукты сопоставляются с уже существующими, а новые создаются.

  4. Неполные заказы удерживаются во «Входящих API», пока кто-нибудь не заполнит недостающее.

  5. Планшет получает импортированные заказы при следующей синхронизации с облаком.


Новые заказы не импортируются сами по себе: кто-то должен синхронизировать API. Делайте это всякий раз, когда были отправлены новые заказы, например в начале дня.

  1. В веб-приложении откройте вкладку «Администрирование».

  2. Найдите карточку «Неимпортированные наряды на выполнение работ». На ней показаны два счётчика:

    • Первое число: заказы, удерживаемые для проверки в текущем сеансе (см. шаг 3).

    • «Доступно для импорта»: заказы, ожидающие в ваших подключениях, включая удерживаемые заказы, которые ещё не обработаны.

    В узком окне браузера счётчики скрыты; расширьте окно, чтобы их увидеть.

  3. Нажмите «Синхронизировать API» на карточке. Откроется окно «Синхронизация API», в котором отображается ход выполнения:

    • «Получение нарядов на выполнение работ через API для импорта»: Mixmate собирает ожидающие заказы. Число увеличивается по мере их поступления.

    • «Импорт нарядов на выполнение работ через API»: каждый заказ проверяется и импортируется, с индикатором выполнения.

    • «Завершено»: всё обработано. Становится доступной кнопка «Закрыть».

Окно «Синхронизация API» во время получения нарядов на выполнение работ для импорта
Окно «Синхронизация API» после завершения импорта, с доступной кнопкой «Закрыть»

Совет: не закрывайте вкладку, пока в окне не появится «Завершено». Если закрыть браузер на полпути, оставшиеся заказы продолжат ожидать; просто синхронизируйте ещё раз.


Для каждого заказа Mixmate сначала проверяет его продукты, а затем наряд на выполнение работ.

Продукты

  • Используются продукты, которые у вас уже есть. Продукт совпадает, если это тот же продукт, который API отправлял ранее, у него те же внешние идентификаторы или то же название. Если совпадающий продукт архивирован, он восстанавливается.

  • Новые продукты создаются, если API отправил всё, что для них нужно Mixmate (например, плотность сухого продукта).

  • Существующие продукты сохраняют ваши сведения, если в настройках группы не включён параметр «Обновлять продукты API при импорте». Включите его, если список продуктов вы ведёте в другом программном обеспечении.

Наряд на выполнение работ

  • Полный заказ импортируется сразу, без проверки.

  • Заказ, номер наряда на выполнение работ которого у вас уже есть, пропускается. Он не импортируется повторно, и изменения в нём не применяются. Чтобы изменить уже импортированный заказ, отредактируйте его в Mixmate.

Всё, что не удаётся импортировать из-за отсутствующей информации, удерживается для проверки.


Заказ удерживается, когда Mixmate нужно что-то, чего API не отправил. Частые причины:

  • У нового продукта отсутствуют сведения, например плотность, норма плотности или размер ёмкости.

  • У наряда на выполнение работ отсутствует размер, например площадь в акрах для заказа на основе нормы, или его нормы внесения.

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

«Входящие API» со списком из двух неимпортированных нарядов на выполнение работ через API из Agvance

Нажмите на заказ, чтобы исправить и утвердить его. В статье Ручной импорт нарядов на выполнение работ через API это описано пошагово.

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

Окно «Подтверждение удаления» для наряда на выполнение работ через API, который ещё не утверждён

Удерживаемые заказы и перезагрузка страницы: «Входящие API» заполняются кнопкой «Синхронизировать API». Если перезагрузить веб-приложение или войти снова, «Входящие API» будут пустыми, но удерживаемые заказы по-прежнему учитываются в счётчике «Доступно для импорта». Нажмите «Синхронизировать API» ещё раз, и они вернутся во «Входящие API».


Импортированные заказы сразу сохраняются в вашей облачной учётной записи. Каждый планшет получает их при следующей синхронизации с облаком. После этого это обычные наряды на выполнение работ: выберите один из них в «Настройке смешивания» и выполните смешивание как обычно.


  • Я не вижу карточку «Неимпортированные наряды на выполнение работ». Она есть только в веб-приложении, а не на планшете. Если вы в веб-приложении, вашей организации нужен уровень «Премиум» и подключение API, настроенное в Intersect.

  • В счётчике «Доступно для импорта» есть заказы, но «Входящие API» пусты. Нажмите «Синхронизировать API». Заказы, которые импортируются, сразу попадают в ваши наряды на выполнение работ; остальные появляются во «Входящих API».

  • Отправленного мной заказа нет в Mixmate. Синхронизируйте API. Если его всё ещё нет, проверьте, не существует ли уже наряд на выполнение работ с таким же номером: если да, новый был пропущен.

  • На планшете нет заказа. Убедитесь, что он импортирован (он есть в нарядах на выполнение работ в веб-приложении и отсутствует во «Входящих API»). Затем синхронизируйте планшет с облаком.

  • Сведения о продукте постоянно возвращаются к прежним. Включён параметр «Обновлять продукты API при импорте», поэтому каждый импорт обновляет продукт из вашего другого программного обеспечения. Измените продукт там или отключите этот параметр.