ТЗ на обмен: 24 поля, у каждого — правило и поведение при ошибке

Агент сопоставляет поля двух систем, пишет правила обработки, считает пиковую нагрузку против лимита приёмника и собирает ТЗ по структуре ГОСТ 34.602. Что считать обязательным и кто отвечает за ошибку — решаете вы.

  • Работает в ваших сервисах: учётная система, база, задачи и сделки, почта, файлы
  • По умолчанию чтение и расчёт: запись в вашу систему — по вашей команде
  • Данные кейса сконструированы; нормы, формулы и структура документов — настоящие

Задача

Что за работа

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

Что за обмен в кейсе

Вход

Заказы клиента из учётной системы: 1 240 документов в сутки

  • Приёмник

    Система задач и сделок, лимит 60 запросов в минуту

  • Боль

    Повторный пакет создавал второй заказ, а ненайденный код контрагента терял документ без следа

Как это выглядит

Три источника — поле, правило, журнал — сходятся в один документ ТЗ.

Путь в системах: что берём на входе и что отдаём

  1. 1

    Вход: метаданные и справочники

    Из учётной системы берём состав реквизитов и справочники. 1С — чтение, ключ или выгрузка конфигурации; срок 1 день

  2. 2

    Шаг 1: карта полей

    24 строки «источник → приёмник → тип → правило». Google Таблицы — доступ к папке

  3. 3

    Шаг 2: правила обработки

    Пять правил R1–R5: обязательность, справочник, идемпотентность по ключу Ref_Key + версия, формат, контроль суммы

  4. 4

    Шаг 3: нагрузка и запас

    1 240 документов в сутки, пик втрое выше среднего — 2,6 сообщения в минуту против лимита 60: запас ×23

  5. 5

    Шаг 4: журнал обмена

    12 пакетов кейса: 10 приняты, 2 ушли в очередь с кодами E01 и E02

  6. 6

    Выход: три файла

    ТЗ в PDF, расчёт и журнал в XLSX, лист расчёта кадром — всё открывается

Агент делает · человек решает

АгентСопоставляет поля, выводит правила, считает пик и запас, пишет ТЗ по структуре ГОСТ 34.602 и помечает нерешённые правила
ЧеловекРешает, что обязательно, кто чинит ненайденный код и что делать с документом, который не прошёл проверку
Приёмка1 000 документов подряд: 24 поля совпали построчно, три класса ошибок воспроизводятся по журналу
ГраницаКод интеграции пишет разработчик; агент отвечает за документ и расчёт

Что открывается

Лист ТЗ: поля, правила, классы ошибок и вывод по нагрузке.

Открыть артефакт

Подключения

Что подключим

Сервис · что читаем и пишем · что нужно от вас · срок

Границы

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

Интеграционный код агент не пишет — он пишет документ, по которому код пишут. ТЗ не считается согласованным, пока владельцы систем не закрыли открытые правила. Совпадение справочников не гарантируется: расхождение — работа, а не сбой. Персональные данные в обмене — только по поручению и по 152-ФЗ.

Возражения

Что может остановить

  • У нас нет API, только файлы

    Тогда первый шаг — не обмен, а выгрузка: ТЗ описывает файл, его состав и правила проверки. Приёмка та же — построчное совпадение.

  • У нас не 24 поля, а двести

    Кейс показывает метод: карта, правила, классы ошибок. В работе столько полей, сколько в вашей системе, — растёт таблица, а не срок обсуждения.

  • Кто отвечает, если документ потерялся

    Правило R1 и R2 фиксируют: документ не передаётся частично и уходит в очередь с кодом. Ответственность за очередь назначается в ТЗ, а не в переписке.

Вопросы

Это ТЗ или описание интеграции?

ТЗ: структура по ГОСТ 34.602 — общие сведения, состав обмена, правила, ошибки, нагрузка, приёмка. Описание интеграции отвечает «что связано», ТЗ — «что считается правильной работой».

Сколько времени занимает такая работа?

В кейсе — три дня на карту и правила при готовой выгрузке метаданных. Срок зависит от числа справочников: каждый новый справочник добавляет правило поиска кода.

Что если приёмник не принимает часть полей?

Поле остаётся в карте с пометкой «не передаётся» и причиной. Удалить строку — значит потерять знание о том, что данные есть, но не нужны приёмнику.

Соседние работы

Рядом

Пришлите состав обмена — соберу карту полей

Нужен список полей или выгрузка метаданных. Дальше — правила, ошибки и ТЗ файлом.

Telegram
MAX
Спросить здесь