Связь с Bitrix24
Как связаны
- Чтение и запись. Приложение работает с Bitrix24 через REST API: от имени сотрудника, который привязал Bitrix24, или через входящий вебхук.
- События. Bitrix24 сообщает приложению об изменениях сделок — смена стадии, ответственного, закрытие. Приложение обновляет ленту и резервы.
- Складской учёт. Остатки и документы — в Bitrix24. При успешной сделке Bitrix24 сам списывает товар отгрузкой.
- Снимки. Списки сделок, каталог, воронки и сотрудники кэшируются на несколько минут. Ещё → Обновить из Bitrix24 сбрасывает кэш.
«Bitrix24 не отвечает»
Связь с Bitrix24 оборвалась или Bitrix24 не успел ответить. Приложение само повторяет запрос один раз при обрыве соединения. Если ошибка не проходит:
- Откройте портал Bitrix24 в браузере — работает ли он.
- Повторите действие через минуту.
- Если не работает только приложение — посмотрите лог сервиса tgbot в админке.
Резерв и отправки при сбое Bitrix24 не теряются: приложение записывает их в свой журнал и догоняет сами, когда Bitrix24 снова доступен.
«Bitrix24 не принял действие: …»
Это отказ Bitrix24, его слова приложение показывает как есть. Частый — «Недостаточное количество товара»: на складе меньше, чем в сделке. См. Реализация и отмена сделки.
Чего не делать в Bitrix24
- Не закрывать сделки успехом вручную — используйте Реализация в приложении.
- Не создавать документы «Реализация по сделке» — товар спишется дважды. Сверка склада покажет такой документ как расхождение.
- Не удалять стадии воронок и свойства товаров без предупреждения разработчика.