# Бриф интеграции или доработки — пустой шаблон

Версия шаблона: 1.0, 31.10.2026. Методический документ, не спецификация API Skirbo. Заполните поля на своих данных. Секреты, реальные токены и персональные данные в бриф не вставлять.

## 1. Рабочий результат

- Какую операцию выполняет сотрудник сейчас: ___
- Что запускает операцию, кто её выполняет и как часто: ___
- Проверяемый результат для сотрудника: ___
- Как результат подтверждается независимо от сообщения «успешно»: ___
- Почему недостаточно изменения инструкции или настройки: ___
- В scope: ___
- За границами scope: ___

## 2. Текущее состояние

| Часть сценария | Работает и проверено / нужна настройка / нужна разработка / неизвестно | Версия, кабинет, дата, доказательство | Владелец проверки |
|---|---|---|---|
| ___ | ___ | ___ | ___ |

Описание в каталоге и наличие API не заменяют проверку конкретной операции.

## 3. Границы обмена и ответственность

- Система-источник и версия API/формата: ___
- Система-получатель и версия API/формата: ___
- Направление обмена: ___
- Клиент/владелец товара, кабинет и склад в scope: ___
- Кто владеет товарным справочником: ___
- Кто вправе менять заказ, резерв, физический остаток, документ: ___
- Как обнаруживаются два писателя одного поля: ___
- Что происходит при отключении обмена и с уже созданными объектами: ___

## 4. Контракт события

- Условие запуска: ___
- Идентификатор события: ___
- Ключ бизнес-объекта с областью уникальности: ___
- Версия/ревизия объекта и правила устаревших событий: ___
- Время события, часовой пояс; время получения отдельно: ___
- Условие подтверждения приёма: ___
- Условие завершения бизнес-операции: ___
- Где хранится результат и как его сверить: ___

## 5. Словарь полей

| Поле источника | Смысл и тип | Поле получателя | Обязательность | Преобразование/единица | Если пусто, неизвестно или конфликт |
|---|---|---|---|---|---|
| ___ | ___ | ___ | ___ | ___ | ___ |

Артикул, вариант, штрихкод, идентификатор заказа и код маркировки — разные поля. Укажите сопоставления и владельца исправления.

## 6. Исключения и восстановление

| Ситуация | Допустимое действие | Запрещённое действие | Кто решает | Как подтверждаем восстановление |
|---|---|---|---|---|
| Неизвестный товар/владелец | ___ | ___ | ___ | ___ |
| Дубль события с тем же содержимым | ___ | ___ | ___ | ___ |
| Тот же идентификатор, другое содержимое | ___ | ___ | ___ | ___ |
| Новый ID, та же бизнес-ревизия: одинаковое / другое содержимое | ___ | ___ | ___ | ___ |
| Более старая ревизия пришла позже | ___ | ___ | ___ | ___ |
| Истёк тайм-аут, результат записи неизвестен | ___ | ___ | ___ | ___ |
| Часть пакета принята, часть нет | ___ | ___ | ___ | ___ |
| Отмена до начала / после начала работы | ___ | ___ | ___ | ___ |
| Недостаточные права / отозван доступ | ___ | ___ | ___ | ___ |

## 7. Правила повтора и контроль нагрузки

- Какие ошибки временные по документации конкретного API: ___
- Какие ошибки требуют исправления данных/прав: ___
- Гарантия безопасного повтора и её доказательство: ___
- Предел попыток/времени, пауза и ответственный за исчерпание: ___
- Поддержка Retry-After/лимитов поставщика: ___
- Как проверить неизвестный результат до повторной записи: ___
- Срок хранения ключей повторов и окно возможных повторных доставок: ___
- Кто запускает восстановление очереди, как исключает повторный эффект: ___
- Как различаются повтор неизменного непринятого события после устранения внешней причины и новое содержимое с новым событием/ревизией: ___

## 8. Приёмка

Для каждого теста заполнить вход, ожидание до исполнения, затем факт и доказательство. «Не проверено» не превращать в PASS.

| ID | Вход/действие | Ожидаемый объект/количество/статус | Недопустимый эффект | Факт и доказательство | Итог |
|---|---|---|---|---|---|
| A01 Обычная операция | ___ | ___ | ___ | ___ | ___ |
| A02 Повтор | ___ | ___ | ___ | ___ | ___ |
| A03 Конфликт/невалидные данные | ___ | ___ | ___ | ___ | ___ |
| A04 Неизвестный результат | ___ | ___ | ___ | ___ | ___ |
| A05 Другая область клиента | ___ | ___ | ___ | ___ | ___ |
| A06 Устаревшее событие | ___ | ___ | ___ | ___ | ___ |
| A07 Частичный пакет | ___ | ___ | ___ | ___ | ___ |
| A08 Отключение и восстановление | ___ | ___ | ___ | ___ | ___ |
| A09 Та же бизнес-ревизия с другим ID | ___ | ___ | ___ | ___ | ___ |
| A10 Новая ревизия до начала работы | ___ | ___ | ___ | ___ | ___ |
| A11 Отмена до начала работы | ___ | ___ | ___ | ___ | ___ |
| A12 Изменение/отмена после начала | ___ | ___ | ___ | ___ | ___ |

## 9. Выпуск и решение

- Владелец бизнес-процесса / технический исполнитель / принимающий: ___
- Разрешённая тестовая среда и обезличенные данные: ___
- Кто разрешает ограниченный рабочий запуск: ___
- Что остановит запись: ___
- Что делаем с незавершёнными объектами при остановке: ___
- Как проверим версию в рабочем кабинете: ___
- Что остаётся ручным: ___
- Отдельные условия стоимости, сроков и сопровождения: ___
- Решение: уточнить / настроить / разработать / ограничить / отказаться.
- Основание решения и следующий проверяемый шаг: ___

Отключение кода не отменяет уже созданные резервы, документы, начисления и физические действия. Для них нужен отдельный план сверки и восстановления.