Quickstart для поставщиков¶
Вас пригласили присылать данные в проект на Expecto. Вся задача — за пять минут: загрузить файлы, прочитать обратную связь, исправить отмеченное и перезалить. Вам не нужно понимать, как настроена принимающая сторона.
Что нужно
- Ссылка-приглашение (или логин) из письма.
- Ваш файл(ы) в формате, согласованном с получателем — обычно CSV- или Excel-выгрузка из вашей системы.
Шаг 1 — Войти¶
Откройте ссылку из приглашения и войдите. Вы попадаете сразу в submission view, ограниченный ровно той поставкой, на которую вас пригласили — чужих проектов и настроек вы не увидите.
Шаг 2 — Начать поставку и загрузить файлы¶
Создайте новую поставку (session) за текущий период и загрузите по файлу на каждую запрошенную роль. Типичная FIBU-поставка, например, просит два файла — Buchungsdatei и Saldendatei; загрузите каждый в свой подписанный слот.
Как только файлы на месте, платформа автоматически прогоняет их через пайплайн:
uploaded → parsed → transformed → validated
Эти стадии запускать вручную не нужно — они отрабатывают сами.
Шаг 3 — Прочитать результат¶
После обработки session показывает индикатор health и список violations (нарушений):
- Зелёный / нет нарушений — данные прошли. Готово; дальше работает получатель.
- Есть нарушения — каждое указывает на строки и провалившееся правило, с сообщением, что не так (например, «Konto должен быть 6-значным»).
Ошибки (ERROR) блокируют поставку; предупреждения показываются для сведения и могут не блокировать.
Шаг 4 — Исправить и перезалить¶
Если что-то отмечено:
- Прочитайте сообщение нарушения — в нём названо поле и ожидание.
- Исправьте данные в исходном файле.
- Загрузите исправленный файл в ту же session и дайте ей перезапуститься.
Повторяйте, пока поставка не станет чистой. Никакой переписки по почте — вы получаете ту же валидацию, что и получатель, сразу.
Шаг 5 — Готово¶
Как только поставка прошла и получатель её одобрил, ваша задача выполнена. Прошлые сессии можно посмотреть в любой момент из той же view.
Если термин непонятен¶
Сообщения валидации иногда упоминают правила, entity или контракты. Для отправки они не нужны, но если интересно — раздел Концепции объясняет словарь; начните с жизненного цикла Session.