Сотрудник сканирует товар, а приложение думает секунду, две, пять. Или фотографии не загружаются, документ открывается долго, а в МойСклад «ничего не сломалось». Часто это не баг, а лимит запросов: МойСклад отвечает не на все обращения подряд, и пределы у него общие для всех подключённых программ. Ниже объясняем, как это устроено, что тратит лимит и как работать, не упираясь в него.
Что такое лимит запросов
Любое приложение, которое работает с МойСклад, обращается к нему через интерфейс (API): запросить документ, найти товар, получить остатки, записать результат. Каждое такое обращение считается. МойСклад ограничивает частоту обращений. По нашим данным, предел составляет 45 запросов в минуту на аккаунт.
Ключевое слово здесь «на аккаунт». Лимит не делится между приложениями по справедливости и не привязан к одной программе. Если у вас подключены сборка, выгрузка в другую систему и ещё какой-нибудь сервис, они тратят один и тот же запас. Один шумный сервис может занять всё, и остальные начнут ждать.
Что съедает лимит
Приложению для сборки нужны обращения в нескольких случаях:
- открытие документа и получение его состава;
- завершение проверки и запись результата;
- сверка штрихкода с номенклатурой, если товара нет в документе;
- загрузка фотографий товаров: на каждую позицию отдельный запрос;
- поиск по номенклатуре.
Больше всего расходуют лимит фотографии. Документ на сорок позиций просит сорок снимков, и пока они загружаются, лимит выбирается быстро. Именно в этот момент сканирование у полки может начать ждать. Поиск по названию и артикулу по всей номенклатуре тоже тратит обращения.
Симптом, причина, что сделать
| Симптом | Вероятная причина | Что сделать |
|---|---|---|
| Фотографии то есть, то пропадают | Лимит выбран, загрузка снимков приостановлена | Подождать несколько минут или выключить фотографии |
| Документ открывается долго | Лимит делят несколько программ | Посмотреть, что ещё подключено к аккаунту |
| Сообщение, что МойСклад не отвечает | Сбой на стороне МойСклад или исчерпан лимит | Подождать, обновить страницу через несколько минут |
| Товара «нет в номенклатуре», хотя вы только что вписали код | Ответ про штрихкод хранится в кэше | Сбросить кэш номенклатуры в настройках |
| Всё тормозит в пик заказов | Много сотрудников и лишние функции | Отключить фотографии и поиск по номенклатуре, если они не нужны |
Как не упираться в лимит
Выключайте то, чем не пользуетесь. Фотографии и поиск по номенклатуре в нашем приложении выключены по умолчанию как раз потому, что расходуют лимит. Если сборщики и без снимков узнают товар, лучше оставить фотографии выключенными.
Проверьте другие подключённые программы. Если на аккаунте работают сразу несколько интеграций, лимит делится между ними. Одна из них может периодически выгружать большой объём данных.
Не нажимайте в панике. Когда лимит выбран, повторные нажатия только добавляют запросов. Правильнее подождать минуту.
Учитывайте пики. Утром, когда сотрудники открывают десятки документов сразу, лимит расходуется быстрее, чем днём.
Что происходит, когда лимит кончился
Хорошо спроектированное приложение не падает: оно ждёт и продолжает. Так делает и наше: при превышении лимита система корректно ждёт и продолжает работу, не блокируя других пользователей.
Для фотографий есть отдельный предохранитель. Если МойСклад три раза за минуту отказал в выдаче снимков, приложение отключает фотографии на 10 минут. Уже загруженные снимки остаются на месте, проверка товаров не прерывается, а о паузе приложение сообщает спокойным значком, без ошибочного звука. После паузы загрузка возобновляется.
Ещё одна экономия: ответ про штрихкод приложение хранит 12 часов, чтобы не обращаться к МойСклад повторно за одним и тем же. Побочный эффект такой: если вы только что вписали штрихкод в карточку товара и хотите проверить сразу, кэш надо сбросить. Кнопка сброса есть в настройках, рядом написано, когда это делали в прошлый раз.
Как понять, что виноват именно лимит
Признаки такие: тормозит не одно действие, а всё сразу и у всех сотрудников; замедление проходит само через минуту-две; чаще всего это случается в пик, когда документов открыто много. Если зависание постоянное и одинаковое при любой нагрузке, смотрите в сторону связи на устройстве или самого МойСклад.
Полезно также спросить себя, что изменилось недавно. Подключили новую программу к аккаунту, включили фотографии, начали выгружать данные в другую систему? Лимит один на всех, поэтому новое подключение сразу отражается на скорости остальных.
Если проблема не в лимите
Не всё зависание объясняется лимитом. Проверьте связь на устройстве, обновите страницу, убедитесь, что МойСклад сам отвечает. Если сообщение говорит, что МойСклад временно не отвечает, это сбой на его стороне, и нужно подождать.
А если штрихкод в приложении вообще не находится, причина может быть в другом. Например, сканер вводит русские буквы: сканер вводит штрихкод русскими буквами. Если не сохраняются коды маркировки: МойСклад не сохраняет коды маркировки.
Если документы не грузятся вовсе, причина может быть не в лимитах: ТСД не подключается к МойСклад: как проверить.
Как это решает приложение
Приложение учитывает, что лимит общий на весь аккаунт, и по умолчанию не тратит его на необязательное. Поиск по номенклатуре и фотографии товаров включаются отдельными галочками в настройках; если вам они не нужны, они не расходуют ни одного обращения. Сообщение о ненайденной позиции подсказывает, где функция включается, чтобы выключенная функция не выглядела поломкой.
Когда лимит выбран, сборка идёт дальше: приложение само приостанавливает загрузку фотографий на несколько минут, а проверка товаров не прерывается. Снимки загружаются втрое быстрее, чем раньше, потому что приложение сообщает серверу вид товара сразу, а у услуг снимки не запрашиваются вовсе. Ответ про штрихкод хранится 12 часов, а при необходимости его можно сбросить кнопкой.
Фотографии доступны на расширенном тарифе, а поиск по номенклатуре можно включить на любом; поиск по названию и артикулу входит в расширенный. Подробнее об интеграции: приложение и МойСклад.