Заметки и вложения
Сущности note и attachment - опциональны. Обогащают контекст разбора сделки.
Бета. Контракт может меняться. Доступ к боевому API открывается после подключения (оплаты).
Заметки - note
Комментарии сотрудников по сделке. Новая заметка от живого сотрудника триггерит пересчёт сделки (дельта-модель). Заливается на POST /v1/notes (массив).
Поля: external_id, deal_external_id, employee_external_id, text, created_at.
Пересчёт триггерит заметка живого сотрудника, а не запись, созданная интеграцией автоматически.
Вложения - attachment
Документы и изображения по сделке: КП, счета, скрины переписок. Филин распарсит PDF, DOCX, XLS и опишет изображения. Заливается на POST /v1/attachments (массив).
Поля: external_id, deal_external_id, file_url, filename.
Ссылка file_url должна быть доступна Филину на скачивание (прямой или подписанный URL; учитывайте TTL).
Дальше
- Коммуникации - ядро скоринга.
- Батчи и идемпотентность - как догружать вторым проходом.