Операции

Раздел Операции связывает коммерческую договорённость с тем, что нужно поставить, принять и проконтролировать. Это контур для владельца процесса, исполнителя и руководителя, а не бухгалтерская система, складской WMS или юридически значимый ERP без дополнительной настройки.

Основные маршруты

• /operations/commitments — обязательства и их карточки;
• /operations/agreements — договоры и условия;
• /operations/orders — коммерческие заказы, включая создание нового;
• /operations/catalog — предложения и спецификации каталога;
• /operations/connect — одноэкранное подключение опубликованной позиции клиенту;
• /operations/fulfillment — очередь исполнения;
• /operations/acceptance — случаи приёмки и их карточки;
• /operations/services — услуги и entitlement-карточки;
• /operations/supply — поставки и склады;
• /operations/billing — счета и расчётный контур;
• /operations/summary и /operations/settings — сводка и настройки модуля.

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

Сводка /operations/summary отдаёт либо полный набор чисел, либо ошибку целиком: если хотя бы один источник ещё не готов или неполон, портал сообщает, что сводка пока недоступна, и не показывает частичные карточки. Не трактуйте отсутствие числа как ноль. Когда сообщение называет источник, оно объясняет, что источник ещё готовится, и предлагает повторить через минуту; обычный сбой загрузки имеет отдельное сообщение. Часть доступных метрик — ссылки на соответствующий реестр: портал переносит в адрес имя серверной рабочей выборки (worklist) и область (scope), не подменяя их локальным фильтром. Если для метрики нет честного маршрута (например, для разбирательств по платежам) или сервер не дал переход, строка остаётся обычным текстом — не воспринимайте число как ссылку на несуществующий экран.

Рекомендуемый рабочий цикл

1. Зафиксируйте клиента, поставщика или другой коммерческий контур.
2. Выберите опубликованный профиль исполнения и проверьте его человекочитаемое имя.
3. Создайте или откройте договор и обязательство, не меняя условия вслепую.
4. Подготовьте заказ с позициями каталога, количеством, ответственным и ожидаемым результатом.
5. Передайте позиции в исполнение или снабжение.
6. Зафиксируйте приёмку, отклонение или остаток как отдельное событие.
7. Проверьте связанные документы, задачи, счета и историю переходов.

Карточка должна объяснять, кто отвечает за следующий шаг, что именно передаётся и по какому условию работа считается принятой. Если действие требует внешнего согласования или доказательства, прикрепите документ или ссылку в рабочем контексте.

Каталог и профили исполнения

Позиция каталога использует опубликованный профиль исполнения. Не выводите тип обязательства из ключа профиля заменой дефиса или из случайного текста: используйте имя и тип, которые возвращает текущий контракт. Если справочник профилей временно недоступен, дождитесь восстановления и не создавайте позицию вслепую.

Редактор условий договора показывает текущие строки и профиль исполнения. Тип обязательства выбирается из опубликованного профиля, поэтому его не нужно вводить вручную. При наличии права записи изменяйте условия из draft; изменение из review возвращает договор в draft. Отдельного возврата к старой версии нет. Если каталог или профиль пуст либо недоступен, дождитесь восстановления и не перезаписывайте договор вслепую.

Деньги, счета и валюта

Операции могут показывать цены, скидки, налоги, суммы заказа и счета. Перед сравнением сумм проверьте валюту, источник расчёта, округление и статус данных. Не считайте пустое поле нулём и не пересчитывайте итог в браузере: используйте отображённую системой сумму.

В обучающих материалах используйте синтетические суммы и явно указывайте валюту организации. Не переносите примеры с деньгами между языками без повторной проверки расчёта и обозначения валюты.

Ошибки и права

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

Безопасные демонстрации

Для документации используйте тестовую организацию, синтетических клиентов, поставщиков, товары, суммы и документы. Не показывайте реальные номера, банковские реквизиты, счета, договоры, токены или данные клиентов. Перед демонстрацией проверьте язык интерфейса, валюту и отсутствие лишних персональных данных.

Связанные разделы

• Каталог Operations
• Реестры, снабжение и счета
• Карточки обязательств и договоров
• CRM
• Документы
• Задачи
• Диск и файлы
• Безопасность и права

Подключение клиента

На /operations/connect портал проводит одно подключение от выбора клиента и опубликованной позиции до заказа, подтверждения, подготовки исполнения и (если это услуга) включения первого периода. Это отдельный поток от действия Подключить в строке /operations/fulfillment: там подключают уже подготовленное исполнение, а здесь собирают коммерческое подключение. Если у клиента есть действующий договор, вместо позиции можно выбрать его строку для режима «клиент берёт сам»; во всех остальных случаях выбирайте опубликованную позицию каталога.

Форма и последствия

Сначала выберите синтетического клиента Demo Client North и позицию Support hours — test либо строку Support package — test. Профиль и замороженная цена позиции сами показывают единицу объёма, перенос остатка, превышение лимита, необходимость приёмки и источник поставки; эти последствия не настраиваются в форме. Частота бывает разовой, ежемесячной или по действующей строке договора. Итог выводится как объём позиции, умноженный на предоставляемый объём; не вводите сумму вручную.

Основание счёта также не выбирается вручную. Портал показывает одно из четырёх оснований — принятое количество, период, подтверждение заказа или выдачу объёма — и объясняет, почему остальные недоступны. При необходимости выберите синтетические юрлица LadVen Demo LLC и Demo Client LLC; включённое разделение обязанностей может потребовать второго сотрудника.

Ошибки, цепочка и безопасная проверка

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

Для документации используйте только эти человекочитаемые синтетические сущности, не отправляйте форму и не показывайте реальную валюту, реквизиты, PII, токены или сырые ID. Если суммы видимы, зафиксируйте currency.expected и currency.observed; успех цепочки без контролируемой мутации не объявляйте доказанным.

Заказ из обращения CRM

Пункт «Создать заказ» в меню карточки активен только для воронки с разрешённым превращением в заказ и указанной компанией. При другом назначении воронки или без компании выключенный пункт объясняет причину; не обходите её прямым URL. Юрлицо клиента обычно подставлено из обращения; если его нет, форма может предложить варианты компании и сохранить выбор обратно в обращение, а при отсутствии вариантов нужно исправить карточку клиента.

Из карточки обращения можно открыть /operations/orders/new?opportunityId=<opportunityId>. Портал читает обращение и заранее подставляет человекочитаемые клиент, проект, название и — если оно указано — юрлицо клиента; на форме остаются выбор позиции, количества и юрлица поставщика. Пока форма открыта, можно вернуться в воронку. После создания карточка заказа не обещает обратную ссылку на обращение: DTO заказа её не содержит, поэтому связь подтверждайте в исходном обращении или ленте, а не по техническому ID. Факт «Заказ создан» может появиться в ленте асинхронно; если сразу после создания лента пуста, это не доказывает сбой, и SLA доставки факта не заявляйте. Если обращение изменилось, недоступно, не имеет клиента/юрлица или количество не проходит проверку, форма блокирует отправку и объясняет, что исправить; не повторяйте POST вслепую. Для примера используйте только синтетические Demo Client North, Rebranding — demo, Support hours — test, Demo Provider LLC, Demo Client LLC; форму не отправляйте, реальные суммы/PII/raw ID не показывайте.