Короткий ответ
Есть ли нормальная документация
Нужны endpoint-ы, схема авторизации, примеры запросов и ответов, коды ошибок, лимиты и правила тестового окружения. Если этого нет, оценка должна учитывать исследование API.
Кто источник истины
Для каждого поля определите владельца. Например, цена меняется в 1С, статус оплаты - в платёжной системе, комментарий менеджера - в CRM. Если обе системы одновременно «главные», синхронизация начинает конфликтовать.
Событие или опрос
Если сервис поддерживает webhooks, обычно лучше реагировать на событие. Если нет - нужен polling с расписанием и контролем повторов. В обоих случаях важно не создавать дубль при повторной доставке.
Ошибки должны быть видимы
Интеграция не должна молча терять заявку. Нужны лог, понятный статус, повторная попытка там, где она безопасна, и способ вручную переотправить проблемную запись.
Проверьте тестовый сценарий
До релиза стоит пройти минимум: успешный запрос, неверные данные, таймаут, повтор webhook, недоступность внешнего сервиса и восстановление после ошибки.
Минимальный пакет для оценки
- ссылка на документацию API и способ авторизации
- пример сущности или ответа, который нужно передать
- описание, что считать успешной синхронизацией и как обрабатывать ошибку
Если API внешней системы нестабилен или закрыт, это лучше выяснить до оценки основного интерфейса.