Интеграция ЭДО Saby (СБИС) с Битрикс24: двусторонний обмен

1. ДОКУМЕНТЫ РАЗДЕЛЕНЫ НА ВХОДЯЩИЕ И ИСХОДЯЩИЕ

   В смарт-процессах «Документы СБИС» и «УПД СБИС» появились две
   воронки:
     • «Входящие» - документы, которые контрагент прислал нам;
     • «Исходящие» - документы, которые мы отправляем контрагенту.

   Приложение само определяет направление документа и кладёт его в нужную
   воронку.

   Что будет при обновлении: ваша текущая воронка «Документы» станет
   воронкой «Входящие» - все документы, которые в ней лежат, останутся на
   месте. Воронка «Исходящие» будет создана дополнительно.

2. НОВЫЕ СТАДИИ И ПОНЯТНЫЕ НАЗВАНИЯ

   Все стадии, которые создаёт приложение, теперь подписаны пометкой
   «(СБИС)» - их сразу видно среди стандартных стадий портала и ваших
   собственных.

   Исходящие документы (Документы СБИС и УПД СБИС):
     • Черновик (раньше - «Новый»)
     • На согласовании - новая стадия
     • Клиент должен принять роуминг
     • Ошибка интеграции
     • Отправлен в ЭДО (подписан нашей компанией)
       - эта стадия заменила две прежние: «Отправлен в СБИС» и
         «Отправлен клиенту»
     • Подписан клиентом
     • В Архив - новая финальная успешная стадия
     • Неуспешные финальные стадии: «Удалён/аннулирован нашей компанией»,
       «Аннулирован клиентом», а также две новые - «Частично подписан
       клиентом» и «Ошибочный документ»

   Входящие документы - свой, более короткий набор стадий:
     Новый документ → На согласовании → Подписан → В Архив,
     плюс «Ошибка интеграции» и неуспешные финальные стадии.

   Счета:
     • Клиент должен принять роуминг
     • Ошибка интеграции
     • Отправлен в ЭДО (подписан нашей компанией)
     • Подписан клиентом
     • Удалён нашей компанией / Аннулирован клиентом
     Лишние стадии («Новый», «Отправлен клиенту») убраны, чтобы приложение
     не мешало вашим собственным стадиям в счетах.

3. ВАШИ СОБСТВЕННЫЕ СТАДИИ БОЛЬШЕ НЕ УДАЛЯЮТСЯ

   Было: приложение считало «правильными» только свои стадии, и при каждом
   сохранении настроек все остальные стадии воронки удалялись - в том
   числе те, которые вы добавили сами под свои процессы.

   Стало: вы можете свободно добавлять в воронки свои стадии - приложение
   их не трогает. Оно следит только за своими стадиями, помеченными
   «(СБИС)».


4. УДАЛЁННЫЕ СТАДИИ И ПОЛЯ ВОССТАНАВЛИВАЮТСЯ САМИ

   Если стадию, поле или воронку приложения случайно удалили, они будут
   созданы заново. Раньше это происходило только при сохранении настроек,
   теперь - ещё и перед каждым запуском синхронизации. Интеграция не
   «ломается» из-за случайного удаления.

   При удалении самого приложения всё, что оно создало (смарт-процессы,
   воронки, стадии, поля) и все документы остаются на портале.


5. РЕКВИЗИТЫ КОМПАНИЙ ЗАПОЛНЯЮТСЯ АВТОМАТИЧЕСКИ

   Раньше поля «(МА СБИС)» в карточке компании приходилось заполнять
   руками: при входящем документе приложение подставляло только название,
   ИНН, КПП и код страны. Всё остальное (адрес, регион, ОГРН, банковские
   реквизиты) - вручную. Именно из-за этого документы чаще всего зависали
   в черновиках.

   Что изменилось:

   5.1. Данные подтягиваются по ИНН из справочника (сервис DaData)
        При обработке документа приложение по ИНН контрагента получает
        полное наименование, ОГРН, КПП и подробный адрес (город, регион и
        его код, населённый пункт, улица, дом, корпус, квартира, индекс,
        код страны) и заполняет ими поля «(МА СБИС)».
        Это работает и когда компания уже есть в CRM, и когда приложение
        создаёт её впервые по входящему документу.

   5.2. Массовое заполнение по всем компаниям (служебная кнопка)
        На экране настроек есть блок «Поля в компаниях» с кнопкой
        «Заполнить поля в компаниях». Она проходит по всем компаниям без
        заполненного ИНН и переносит данные из их реквизитов и адресов
        Битрикс24 в поля «(МА СБИС)». Если у компании несколько реквизитов,
        берётся первый. Прогон показывает прогресс (сколько компаний уже
        обработано) и идёт с паузами, чтобы не перегружать портал.
        Кнопка служебная и по умолчанию доступна только на техническом
        портале - включается по запросу.

   5.3. Два важных правила безопасности
        • Приложение никогда не затирает то, что уже заполнено: оно
          дополняет только пустые поля.
        • Если ИНН, полученный из справочника или реквизита, не совпадает
          с ИНН в карточке компании, обновление отменяется целиком -
          чтобы данные одной компании не попали в карточку другой.

6. ОТПЕЧАТОК СЕРТИФИКАТА СКРЫТ ЗВЁЗДОЧКАМИ

   Было: значение отпечатка (данные сертификата электронной подписи) было
   видно на экране настроек открытым текстом.

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


7. ЧТО ОСТАЛОСЬ БЕЗ ИЗМЕНЕНИЙ

   • Выбор типов документов (УПД, Договор, Акт сверки, Счёт,
     Доп. соглашение) и направления синхронизации.
   • Подключение к СБИС (Saby) кнопкой «Войти» / «Переподключить».
   • Автоподписывание документов, а если оно выключено - постановка задачи
     менеджеру «Подписать документ в ЭДО…».
   • Тип товара по умолчанию (Услуга / Товар).
   • Вкладка «ЭДО» в карточке компании со списком документов.
   • Поле сделки «Статус отправки УПД».
   • Виджет «Основной реквизит» - выбор ИНН, если у компании их несколько
     (после выбора подтягиваются КПП и ОГРН).
   • Сообщения об ошибках в комментарии к документу и в служебном чате
     портала.