CRM-модель
Исходная инструкция упоминает:
- смарт-процесс «Документы СБИС» (
SBIS_DOCS); - смарт-процесс «УПД СБИС» (
SBIS_UPD); - счета;
- поле сделки «Статус отправки УПД»;
- вкладку «ЭДО» в карточке компании;
- пользовательские поля компании для реквизитов.
Entity type ID, category ID, stage ID и коды пользовательских полей должны обнаруживаться или сохраняться при установке конкретного портала. Нельзя предполагать их одинаковыми у разных клиентов.
После получения исходников здесь появятся проверенная схема сущностей, назначение полей, владельцы данных и правила миграции.
SBIS_DOCS
Используется для договоров, актов сверки и дополнительных соглашений. Содержит категории «Исходящие» и «Входящие».
| Поле | Назначение | Источник |
|---|---|---|
| ID документа в Saby | Устойчивое сопоставление и обновление. Перед отправкой должно быть пустым. | Приложение. |
| Ссылка на документ | Переход в Saby. Перед отправкой должно быть пустым. | Приложение. |
| Статус | Техническое состояние Saby. | Приложение. |
| Тип документа | Выбор шаблона и правил проверки. Обязательно. | Менеджер. |
| Вложения | Файл договора, акта или соглашения. | Менеджер. |
| Дополнительное соглашение к… | Связь с исходным договором. Только для типа «Дополнительное соглашение». | Менеджер. |
| Номер документа | Реквизит документа. Обязательно. | Менеджер. |
| Дата заключения | Реквизит документа. Обязательно. | Менеджер. |
| Срок действия | Реквизит документа. Обязательно. | Менеджер. |
Заполненные ID документа в Saby и Ссылка на документ служат для приложения
признаком того, что документ передан: повторная отправка не выполняется. Это
даёт тихий отказ при копировании элементов — ошибка не возникает, документ
просто не уходит.
Отдельно требует сверки по коду расхождение с прежней редакцией технической инструкции: там номер, дата заключения и срок действия описывались как необязательные со значениями по умолчанию (ID элемента и текущая дата). Практика показала, что они обязательны.
SBIS_UPD
Отдельный процесс УПД с теми же направлениями и стадиями, но более компактным набором полей. Содержимое формируется из товарных позиций и полей карточек компаний — не из комплектов реквизитов Битрикс24. Состояние дублируется в поле сделки «Статус отправки УПД», в том числе при нескольких воронках.
Счета
Используется стандартная сущность Битрикс24 со служебными полями внешнего ID, ссылки и статуса. Пустой счёт без товарных позиций не отправляется.
Компания
Приложение добавляет набор реквизитов UF_CRM_*_MA и вкладку «ЭДО». Конкретные коды полей фиксируются на каждом портале после установки; публичная документация не должна задавать их как глобальные константы.