Как приложение обрабатывает ошибки при синхронизации

Общие правила

1. Сначала пробуем починить запрос сами

Перед отправкой в Битрикс24 приложение часто «подчищает» данные: убирает пустые поля, исправляет формат телефона и e-mail, подставляет значения по умолчанию для обязательных свойств товара и т.п. Если после этого запрос всё равно не проходит — пробуем повторить (например, при истёкшем токене, перегрузке API или дубле номера счёта).

2. Не всегда выгружаем «как получится»

Для заказов есть важное правило: товарные строки в сделку либо уходят все корректно, либо не уходят целиком. Частичная выгрузка строк специально запрещена — иначе при обратной синхронизации позиции могли бы исчезнуть из заказа в МойСклад.

3. Заметка в заказе — это не паника, а подсказка

Если проблема касается конкретного заказа, в карточке заказа МойСклад может появиться заметка с объяснением. Обычно там есть ссылка на сделку в Битрикс24 и, при необходимости, номер события в журнале синхронизации.

4. Одна и та же ошибка не спамит каждую минуту

Технические записи в журнале ошибок для одного и того же случая — не чаще одного раза в сутки на портал (или на заказ, где это уместно). Заметка в заказе про лимит каталога — один раз на заказ, даже если заказ правят снова.

5. Есть ошибки, после которых синхронизация портала останавливается

Это редкие и серьёзные случаи: блокировка портала лицензией, закончилось место на диске Битрикс24. Обычные проблемы с товарами, телефонами или одним заказом портал целиком не отключают.

Что останавливает обмен целиком, а что нет

Ситуация	Обмен портала
Закончилось место на диске Битрикс24	Останавливается
Портал заблокирован проверкой лицензии Битрикс24	Останавливается
Лимит товаров в каталоге CRM (обычно 3000)	Работает, но каталог и строки заказов ограничены
Складской учёт в CRM, нет привязки товара, пустое количество	Работает, страдает конкретный заказ
Лимит запросов API, перегрузка REST	Временная пауза, потом сами продолжаем
Опечатка в телефоне / e-mail	Контрагент уходит без этого поля

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

Остановка обмена: диск и лицензия

Закончилось место на диске Битрикс24

Когда: Битрикс24 отвечает, что исчерпан выделенный дисковый ресурс.

Что делает интеграция: выключает обмен по этому порталу, очищает очереди событий, отписывается от событий Битрикс24 и снимает свои вебхуки в МойСклад. Это тяжёлое выключение не повторяет каждый запрос — не чаще одного раза в сутки.

Что видит пользователь: «Закончилось место на диске Битрикс24. Обмен приостановлен на 1 час, затем проверка повторится сама. Если место есть — блок снимается, если нет — ещё на час.»

Как часто проверяем: ориентир для клиента — раз в час. Пока диск полный, пауза продлевается.

Что делать: в Битрикс24 освободить диск (корзина Диска, файлы, почта). Если место уже есть, а статус «обмен выключен» остался — написать в поддержку: вебхуки уже сняты, обмен нужно включить снова.

Лицензия портала Битрикс24

Когда: Битрикс24 блокирует REST проверкой лицензии (неоплата, блокировка, истёкший тариф).

Что делает интеграция: то же полное выключение, что и при диске. Повтор этой процедуры — не чаще раза в сутки.

Что делать: проверить оплату и статус портала в Битрикс24. После восстановления лицензии обмен сам не обязан ожить — часто нужно снова включить синхронизацию (или поддержка).

Временные лимиты API (не ошибка данных)

Это не проблема заказа. Интеграция сама ждёт и повторяет. Пользователю обычно ничего делать не нужно.

Что случилось	Пауза / повтор	Портал
Перегрузка REST Битрикс24	Локальная пауза 1 час	Не выключается насовсем
Слишком частые запросы	Сон и повтор (обычно до нескольких попыток)	Не выключается
Тяжёлый запрос	Не долбим тот же вызов около 10 минут	Не выключается
Лимит МойСклад (HTTP 429)	Ждём «повторить через…», не дольше 1 минуты за паузу	Не выключается
Истёк токен	Обновляем токен и повторяем	Не выключается

Заметки в заказе МойСклад

Главный способ сообщить пользователю о проблеме с выгрузкой конкретного заказа.

Лимит товаров в каталоге Битрикс24

Когда: на портале слишком много товаров в каталоге CRM (типичный лимит — несколько тысяч), и для части позиций заказа нет привязки к товару в B24.

Что делает приложение: заказ в сделку выгружается без товарных строк. Новые товары и услуги в этот день не создаются в каталоге.

Заметка в заказе: пометка [moysklad24-sync] лимит каталога CRM, объяснение, что строки пропущены, ссылка на сделку. Повторно не дублируется на тот же заказ.

Что делать: разобраться с каталогом в B24 (лишние товары, тариф, привязка позиций МС к существующим товарам). После исправления — дождаться следующей синхронизации или обновить заказ.

Товар из заказа не найден в каталоге Битрикс24

Когда: у позиции заказа нет привязки к товару/услуге в CRM (нет PRODUCT_ID).

Что делает приложение: не отправляет товарные строки в сделку (все строки, не часть). Заказ при этом может выгрузиться «шапкой» без состава.

Заметка в заказе: что заказ ушёл без товарных строк, список проблемных позиций, ссылка на сделку, код события в журнале.

Что делать: проверить синхронизацию каталога и привязку товаров/услуг МойСклад к карточкам в B24.

У позиции не указано количество

Когда: в данных для выгрузки у строки пустое количество.

Что делает приложение: не отправляет товарные строки в сделку (все строки, не часть). Частичная выгрузка запрещена: иначе обратная синхронизация удалила бы эти позиции из заказа МойСклад. Заказ при этом может выгрузиться «шапкой» без состава.

Заметка в заказе: что заказ ушёл без товарных строк, список позиций без количества, ссылка на сделку, код события в журнале.

Что делать: проверить количество в заказе МойСклад и пересохранить/синхронизировать.

В Битрикс24 включён складской учёт CRM

Когда: при сохранении товарных строк B24 отвечает, что недостаточно товара на складе (складской учёт в CRM).

Заметка в заказе: что товары не выгрузились из‑за складского учёта, рекомендация отключить складской учёт в настройках Битрикс24 (он несовместим с логикой приложения), текст ответа B24, ссылка на сделку и документация.

Что делать: отключить складской учёт в CRM или согласовать процесс с поддержкой интеграции. После отключения заказ подтянется при следующей синхронизации.

Не удалось обновить сделку (стадия, склад, услуги)

Когда: при обновлении сделки Битрикс24 возвращает ошибку — часто про невозможность закрыть сделку, склад, услуги.

Заметка в заказе:

• блок «Ответ Битрикс24» — дословный текст ошибки;

• блок «Совет разработчиков интеграции» — что проверить (остатки, состав сделки, складской учёт), ссылка на сделку.

Что делать: открыть сделку по ссылке, прочитать ответ B24, проверить настройки склада и состав сделки.

Клиент в сделке есть, а заказ в МойСклад не уходит

Когда: МойСклад не принимает документ без контрагента. В сделке компания или контакт выбраны, но карточка клиента не выгрузилась (или в сделке никого нет).

Что делать: если клиент указан — открыть карточку компании/контакта, а не только сделку. Если в сделке никого нет — указать клиента и сохранить.

Заметка в счёте МойСклад

Дублируется номер счёта в Битрикс24

Когда: при выгрузке счёта номер уже занят в B24.

Что делает приложение: автоматически меняет номер на вариант с префиксом MS_ и повторяет выгрузку.

Заметка в счёте МойСклад: что исходный номер был занят и счёт выгружен с новым номером.

Телефон и e-mail (компании, контакты, лиды)

Это не заметки в заказе, но частая причина «странного» поведения при выгрузке контрагентов.

Что делает приложение перед отправкой в B24:

• Пустой телефон или e-mail — просто не отправляет это поле.

• Некорректный телефон или e-mail (не распознался как нормальный) — поле убирается из запроса; контакт, компания или лид всё равно создаётся или обновляется без этого телефона или почты.

• Нормальный номер — приводится к виду, который принимает Битрикс24.

• Нормальный e-mail — приводится к нижнему регистру и проверяется на корректность.

Что видит пользователь: контрагент в B24 появился, но телефона или почты нет — хотя в МойСклад они были записаны с опечаткой или в нестандартном формате. Исправьте данные в МойСклад — при следующей синхронизации подтянутся.

Пустые поля в сделках и счетах: если в CRM уходит, например, пустой комментарий или «не назначен» ответственный — такие поля вообще не отправляются, чтобы B24 не ругался на пустые значения.

Другие типичные ситуации (без заметки в заказе)

Ситуация	Что происходит
Картинка товара в формате .jfif	Картинка не грузится, товар синхронизируется без неё
Сложные свойства товара (списки, привязки)	Такие поля из настроек синхронизации пропускаются, чтобы не ломать выгрузку каталога
Значение из МойСклад «справочник» в простое текстовое поле	Преобразуется в текст (например, «3 месяца» вместо технического объекта)
Временная ошибка API («повторите позже», лимит запросов)	Приложение само повторяет запрос
Лимит товаров в каталоге (глобально)	Очищается очередь выгрузки товаров; портал не отключается

Что делать, если увидели заметку в заказе

1. Прочитайте текст заметки — там обычно уже сказано что не выгрузилось и почему.

2. Откройте сделку по ссылке из заметки.

3. Исправьте причину в МойСклад или Битрикс24 (каталог, количество, складской учёт, привязка товаров).

4. Сохраните заказ или дождитесь следующего цикла синхронизации.

Если после исправления заметка остаётся, а заказ не обновляется — передайте в поддержку номер заказа МойСклад, ссылку на сделку и код события из заметки (если есть).

Памятка: сроки

Событие	Как часто / как долго
Запись одного типа ошибки в журнал	1 раз в сутки на портал
Заметка «лимит каталога» в заказе	1 раз на заказ
Повтор полного выключения (диск / лицензия)	не чаще 1 раза в сутки
Проверка после «диск кончился» (текст для клиента)	каждый час
Пауза при перегрузке REST B24	1 час
Пауза после тяжёлого запроса B24	около 10 минут
Очистка очереди товаров при лимите каталога	при каждом таком ответе API
Автоповтор лимита запросов / 429	сразу, сами

Обновлено: 2026-09-18.