Реестры, снабжение и счета Operations
Эта страница дополняет общий обзор Operations и покрывает маршруты, которые не являются карточкой обязательства или основным процессом исполнения.
Если в строке вместо понятного названия или кода позиции виден технический ID, не принимайте его за бизнес-данные. Обновите карточку или сообщите ответственному; такой кадр не используйте в публичной документации.
В текущей версии некоторые подписи списков и модуля (включая фильтры, статусы и действия) могут оставаться на английском, пока переводы выбранной локали не полностью готовы. Описанные ниже правила данных и процессов от этого не меняются.
Сводка и обязательства
Сводка Operations объединяет обязательства к контролю, приближающиеся сроки, права на услуги и счета, требующие внимания. Это ориентир для первичного разбора, а не бухгалтерский баланс. Число без строки, периода или статуса нельзя трактовать как подтверждённый итог; при ошибке загрузки повторите чтение после проверки прав и готовности данных.
Если один из источников сводки ещё не готов, карточки могут не загрузиться целиком. Повторите сводку через минуту и не принимайте отсутствующие значения или нули за итог; при обычной ошибке загрузки повторите весь снимок, а не отдельную метрику.
Услуги и entitlement
Реестр услуг /operations/services по умолчанию показывает права, доступные сотруднику во всём портале. Выбор клиента — локальное сужение списка, а не постоянный фильтр; первая загрузка возвращает до 25 строк, Показать ещё продолжает ту же выборку. Можно открыть карточку права по /operations/services/:entitlementId. Пустой результат после фильтра по клиенту не равен пустому глобальному реестру и не означает нулевое право. Не обещайте выдачу или списание, если нужное действие не показано.
В карточке права портал при наличии связей добавляет ссылки на клиента и исходное обязательство. Если обогащение не загрузилось, карточка остаётся доступной с нейтральной подписью; это не означает, что связь отсутствует. Журнал использования и его состояния требуют отдельной проверки прав и текущей версии.
В карточке также есть периоды с выданным, использованным, зарезервированным и доступным количеством и журнал использования со статусами pending_approval, captured, allocated, approved, posted, rejected, reversed. Зафиксировать использование, Утвердить и Провести — разные действия с отдельными правами; автор записи не может утвердить её сам. Проверяйте доступный остаток перед вводом, но не обещайте мгновенный отказ при превышении: запись может сохраниться, а превышение выявится при утверждении или проведении другим проверяющим. Повторяйте чтение после каждого перехода и не показывайте технические коды в публичном кадре.
Отображение времени может пересказывать точное количество в купленной единице: например, 480 минут и 390 минут будут показаны в одной или нескольких единицах, выбранных для этого права. Это только формат отображения — в форму вводите значение в единице, подписанной у поля. Дробные или отрицательные величины не округляйте по догадке.
Если текущий период и доступный остаток разрешены, форма Зафиксировать использование находится прямо на карточке права рядом с журналом. Введите положительное целое количество в единице, подписанной у поля (например, минуты), и при необходимости добавьте основание — заявку, задачу или заметку. Сохранение создаёт запись использования и не заменяет отдельные действия Утвердить и Провести; если форма или единица не показаны, не угадывайте их и не повторяйте запрос.
В текущем frontend подписи услуг и деталей за пределами русского и английского могут оставаться английскими; не считайте их локализованным screenshot evidence, пока не выкатаны нативные переводы и не пройдена визуальная проверка.
Supply, склады и закупки
/operations/supply разделён на вкладки закупок и складов. Складовая строка ведёт в /operations/supply/warehouses/:warehouseId, где видны тип, состояние, часовой пояс, локации и остатки. Переходы «черновик → активен → приостановлен» требуют прав; при приостановке прекращаются приёмка, резервы и движения, а возобновление не должно менять остатки задним числом.
В текущем интерфейсе lifecycle склада ограничен переходами «черновик → активен → приостановлен ⇄ активен»: кнопки активации, приостановки и возобновления доступны администратору и требуют непустого основания с актуальной ревизией. Локацию можно добавить только у активного склада; операции вывода из эксплуатации или закрытия не обещайте, пока их кнопки не видны на этом экране.
Создание склада открывает модальное окно: код и название обязательны, а тип и часовой пояс нужно выбрать явно. Если не хватает прав администратора, код уже используется или поле не принято, исправьте данные либо запросите доступ; не повторяйте создание вслепую. Для проверки используйте синтетический склад, не реальные адреса.
Списки складов и счетов загружаются страницами до 25 строк. Кнопка Показать ещё загружает следующую страницу, не пересчитывая уже показанные строки. В закупочной вкладке заявки и заказы поставщика запрашиваются до 50 строк без кнопки продолжения. Фильтр клиента сужает список до выбранного клиента; без него показываются все доступные записи.
Закупочная вкладка показывает заявки и заказы поставщика. Заявка может появиться автоматически из подтверждённого заказа при профиле, который закупает дефицит, или быть создана вручную. Детальная заявка доступна по /operations/procurement/requisitions/:requisitionId; на этапе поиска поставщика она показывает неизменяемую строку потребности с точным количеством и блок выбора поставщика. Согласование, отклонение, начало поиска поставщика и отмена требуют основания и актуальной ревизии. После назначения поставщика заявка готова к заказу, но заказ поставщика намеренно ещё не построен: если связь или следующий шаг ещё не готовы, он не появится автоматически. Проверьте состояние заявки и обратитесь к администратору; пустой список может быть честным результатом текущих данных.
На этапе поиска поставщика можно выбрать или заменить поставщика и назначить его на конкретную строку потребности. Если строка или её количество не загрузились, поиск поставщика недоступен, результатов нет или компания не может быть поставщиком, назначение блокируется с понятным сообщением; сначала обновите карточку и проверьте состояние, а не повторяйте действие вслепую.
Если в текущей версии доступна кнопка Новая заявка, ручной вход открывается по /operations/procurement/requisitions/new. Укажите товарную позицию и количество; единица, версия позиции и точность берутся из каталога, покупатель — из доступного юридического лица, а срок потребности и примечание необязательны. Поставщик, цена и склад определяются позже. Если прав недостаточно, такая заявка уже есть или поле отклонено, проверьте состояние и исправьте данные перед повтором.
Billing и счета
/operations/billing — реестр счетов с необязательным фильтром клиента; /operations/billing/invoices/:invoiceId — паспорт счёта. Проверяйте номер, статус, даты выпуска/оплаты, итог и outstanding. Счёт появляется после решения клиента по приёмке: пока приёмка лишь готова, но ещё не отправлена клиенту, список счетов может оставаться пустым. В таком состоянии переходите через Открыть приёмку, а не в каталог; пустой список не означает нулевую задолженность.
На том же маршруте вкладка Начисления показывает ещё не выставленные суммы по услугам. Это не список счетов: строка относится к начислению и его периоду, а не подтверждает, что счёт уже существует. У ожидающего начисления сумма может быть неизвестна, а не равна нулю; если период, понятное название или сумма не показаны, не додумывайте их и не делайте вывод о задолженности. Выставить счёт меняет данные — в read-only проверке можно лишь открыть вкладку и сверить понятные названия, период, статус и валюту без выбора строк, создания или отправки счёта.
Паспорт счёта — режим чтения: выпуск, утверждение и другие изменения выполняет отдельная роль с нужными правами. Статусы могут быть «черновик», «на согласовании», «согласован», «выставлен», «отправлен», «оплачен частично», «оплачен», «просрочен», «аннулирован» или «отменён». Сверяйте total, paid, credited и outstanding, затем проверьте строки с описанием, количеством и суммой и связанные документы. Ошибку загрузки повторяйте после проверки состояния; пустой счёт или пустые строки отличайте от недоступного объекта.
На /operations/billing/invoices/:invoiceId паспорт загружает счёт и строки параллельно: загрузка, ошибка с Повторить, отсутствующий или недоступный счёт и пустые строки — разные состояния. В успешном синтетическом кадре покажите номер, статус, даты, total/paid/credited/outstanding в валюте выбранной локали, строки и связанные документы. Это read-only экран: не выпускайте, не оплачивайте и не изменяйте счёт; не используйте реальные реквизиты и данные клиентов.
Любая сумма требует проверки отображаемой валюты, источника расчёта и округления. Не переносите финансовые примеры между языками без проверки местной валюты.
Настройки и work order
/operations/settings определяет, какие юридические лица могут выступать нашей стороной в заказах, счетах и документах поставки. До выбора хотя бы одного лица портал может честно блокировать создание, чтобы не угадывать issuer. Сохранение может быть запрещено из-за прав, устаревшей версии или временной недоступности; проверьте доступ, обновите страницу и повторите позже.
/operations/work-orders/:workOrderId — адресуемая карточка рабочего пакета, обычно открываемая из fulfillment. Отдельного списка work orders нет: отсутствие ссылки означает, что пакет ещё не создан или недоступен по правам, а не что он потерян.
Карточка наряда может показать переходы «Запланировать → Готов к работе → В работе» и блок задач. Но в текущем интерфейсе в этом блоке нет команды создать или назначить компонент задачи: статус наряда сам по себе не доказывает, что исполнителю поставлена задача или она закрыта. Если процесс требует задания по наряду, остановите передачу или поставку и согласуйте следующий шаг с ответственным за Operations; не обходите это прямым API или техническим идентификатором.
Ошибки и безопасная проверка
Различайте пустой список, список без результатов после фильтра, отсутствие доступа, недоступный объект, конфликт, отклонённые поля и временную ошибку. После частично успешной операции сначала перечитайте реестр и историю, затем повторяйте действие с актуальной ревизией. Для плановых read-only примеров услуг используйте одну связку: клиент Demo Client North, право Support package — test, исходная позиция Support hours — test. Не подменяйте типы этих сущностей и не показывайте банковские реквизиты, реальные счета, договоры или данные клиентов. Перед рабочим запуском проверьте, что названия разделов, статусов и действий отображаются на выбранном языке портала.
Связанные страницы