﻿---
title: Портал поставщиков
description: "Портал на Laravel + Filament: подключение поставщиков по чек-листу, документы и сроки их действия, статус заказов, сверка счетов и показатели работы."
---

## Что это за сервис

Приложение для работы с поставщиками в две стороны. Внутри компании закупщики, юристы и финансы видят каждого поставщика, его документы, заказы и показатели. Снаружи поставщик заходит в свой кабинет, загружает документы и видит статус своих заказов.

Без такого сервиса подключение нового поставщика растягивается на недели: анкеты, документы и согласования лежат в разных почтовых ящиках. Заказы поставщикам ведут в таблице, которая устаревает к следующей отгрузке. Об истёкших договорах и недостающих документах узнают перед проверкой. Закупщик пишет четырём людям, чтобы понять, где застрял заказ, а финансы не могут сверить счета с заказами, потому что данные в двух несвязанных системах.

## Что он делает

- **Подключает поставщика по чек-листу.** Анкета, документы и согласования проходят по единому шаблону, прогресс виден в одной карточке.
- **Даёт поставщику свой кабинет.** Поставщик сам загружает реквизиты, сертификаты и другие документы и видит статус своих заказов, без переписки.
- **Показывает статус каждого заказа.** Видно, на каком шаге согласования или исполнения находится заказ и у кого он сейчас.
- **Следит за сроками документов.** Истекающие договоры, сертификаты и доверенности видны заранее, за 30 и 60 дней.
- **Сверяет счета с заказами.** Счёт поставщика сопоставляется с заказом и приёмкой, расхождения выводятся отдельно.
- **Копит показатели поставщика.** Доля поставок вовремя, брак и скорость ответа собираются с первого дня и нужны для решения о продлении.

## Нюансы и особенности

- **Документы только в карточке.** Все документы поставщика загружают в его запись, а переход в статус «Активен» блокируется, пока обязательные файлы не приложены.
- **Разные требования для разных поставщиков.** Стратегическому поставщику нужен полный пакет документов, разовому подрядчику — минимальный. Уровень поставщика задаёт свой шаблон чек-листа.
- **Проверка контрагента.** Для российских компаний в чек-лист обычно входит проверка по открытым реестрам и сервисам проверки контрагентов. Её результат и дату хранят в карточке.
- **Кабинет поставщика — отдельная панель.** Внешним пользователям дают отдельную панель Filament со своей авторизацией: поставщик видит только свою компанию, свои заказы и документы. Ограничение проверяется на сервере для каждого запроса и файла.
- **Зависшее согласование эскалируется.** Если заказ не трогали, например, двое суток, он переходит к следующему согласующему или руководителю.
- **Учётную систему не дублируют.** Если поставщики и закупки уже ведутся в 1С или ERP, портал читает оттуда справочники и заказы через API и возвращает только то, что создаётся на портале: документы, анкеты, подтверждения. Для электронного документооборота со счетами и актами обычно используют оператора ЭДО, а портал показывает статусы.
- **Согласование закупок живёт отдельно.** Сама заявка на закупку и её согласование внутри компании — отдельный процесс; портал начинается там, где заказ уже уходит поставщику.

## Как сгенерировать через ИИ-агентов

Промпты рассчитаны на AI-агента (Claude Code, Cursor и аналоги) в Laravel-проекте с установленным **Filament 4.x**. Отправляйте их по одному: каждый шаг даёт результат, который можно проверить до перехода к следующему.

### 1. Данные и модели

```text
Создай модели и миграции для портала поставщиков: Vendor (название,
ИНН, КПП, уровень, статус, дата проверки контрагента), VendorUser
(пользователь поставщика), OnboardingTemplate и OnboardingStep
(уровень, шаг, обязательный документ), VendorDocument (поставщик, тип,
файл, срок действия, проверен), PurchaseOrder (внешний id, поставщик,
сумма, статус, ожидаемая и фактическая дата поставки), VendorInvoice
(поставщик, заказ, сумма, статус сверки). Добавь фабрики с демо-данными.
```

### 2. Внутренняя карточка поставщика

```text
Сгенерируй Filament-ресурс для Vendor во внутренней панели. В карточке
покажи прогресс подключения по шаблону уровня, документы со сроками,
заказы и счета через relation managers. Блокируй перевод в статус
«Активен», пока не загружены все обязательные документы.
```

### 3. Кабинет поставщика

```text
Создай отдельную панель Filament для поставщиков со своей авторизацией.
Пользователь поставщика видит только свою компанию: загружает документы,
заполняет анкету, видит статус своих заказов и счетов. Проверь, что
чужие файлы недоступны даже по прямой ссылке.
```

Войдите под пользователем одного поставщика и попробуйте открыть заказ другого по адресу: должен быть отказ.

### 4. Сроки, эскалации и синхронизация

```text
Сделай фоновые задачи: за 60 и 30 дней до окончания срока документа
уведомляй закупщика и поставщика; заказы, которые не менялись двое
суток на шаге согласования, передавай следующему согласующему.
Добавь синхронизацию заказов и приёмок из API учётной системы
без дублей.
```

### 5. Сверка и показатели

```text
Добавь сверку счетов: сопоставляй счёт с заказом и приёмкой, выводи
расхождения по сумме и количеству в отдельную вкладку. Добавь виджеты
доли поставок вовремя и брака по поставщикам за квартал и экспорт
оценки поставщика.
```

## Похожие сценарии

- [Контроль продления договоров с поставщиками](https://wpcraft.ru/kb/stacks/filament/use-cases/operations/contract-renewal-tracker.md) — решение о продлении по показателям поставщика.
- [Отслеживание заказов на закупку](https://wpcraft.ru/kb/stacks/filament/use-cases/finance/purchase-order-tracker.md) — исполнение заказов со стороны финансов.
- [Согласование закупок](https://wpcraft.ru/kb/stacks/filament/use-cases/finance/procurement-approval-workflow.md) — внутренняя заявка и согласование до того, как заказ уйдёт поставщику.

## Материалы и источники

- [Refine: Vendor Portal](https://refine.dev/use-cases/operations/vendor-portal/)
- [Filament 4.x: ресурсы](https://filamentphp.com/docs/4.x/resources/overview)
- [Filament 4.x: загрузка файлов в формах](https://filamentphp.com/docs/4.x/forms/file-upload)
- [Filament 4.x: уведомления](https://filamentphp.com/docs/4.x/notifications/overview)
- [Filament 4.x: экспорт](https://filamentphp.com/docs/4.x/actions/export)