Клієнти & контрагенти – будуйте на Flowtly

Використовуйте цей добірний знімок OpenAPI-схеми Flowtly, щоб планувати інтеграції, автоматизувати процеси та синхронізувати дані, на які спираються ваші команди.

Статус документації

Остання синхронізація: 2026-04-03 18:31 (версія застосунку 2.0.0)

Публікується лише частина сутностей. Запускайте обидві команди синхронізації, щоб оновити цю документацію після виходу нових можливостей Flowtly.

Клієнти & контрагенти

Основні дані клієнтів, контакти, нотатки та управління контрагентами.

Огляд сутності

Клієнт

Підтримуйте узгодженість CRM і delivery з профілями клієнтів, контактами та документами у Flowtly.

Ендпоїнти

GET https://api.flowtly.eu/clients

Список клієнтів

Отримуйте клієнтів із пагінацією для рев’ю та сегментації акаунтів.

POST https://api.flowtly.eu/clients

Створити клієнта

Створіть картку клієнта з юридичними та контактними даними.

GET https://api.flowtly.eu/clients/search

Пошук у списку

Отримує колекцію ресурсів клієнта.

GET https://api.flowtly.eu/clients/{id}

Отримати клієнта за ID

Перегляньте профіль клієнта та пов’язані контакти.

PATCH https://api.flowtly.eu/clients/{id}

Оновити клієнта

Оновіть дані клієнта після онбордингу або змін в акаунті.

GET https://api.flowtly.eu/clients/{id}/documents

Отримати клієнта за ID

Перегляньте профіль клієнта та пов’язані контакти.

Сценарії використання

Синхронізуйте кваліфіковані CRM-акаунти у Flowtly перед стартом проєкту.
Використовуйте оновлення клієнтів для узгодження рахунків, угод і власників акаунтів.

Поля схеми

Client-client.read_client_contact.read_storage.read
Поле Тип Опис
id integer Поле id.
country string Поле country.
currency string Поле currency.
defaultCost string | null Поле defaultCost.
status string Поле status.
attributeSet string | null Поле attributeSet.
name string Поле name.
dueDays integer Поле dueDays.
tinType string Поле tinType.
tinCountry string | null Поле tinCountry.
tin string | null Поле tin.
externalPaymentCustomerId string | null Поле externalPaymentCustomerId.
invoiceComment string | null Поле invoiceComment.
defaultTaxRate string | null Поле defaultTaxRate.
documentsLanguage string Поле documentsLanguage.
addressPhoneNumber string | null —
addressCity string | null —
addressPostCode string | null —
addressStreetLine string | null —
addressBuildingNumber string | null —
addressLocaleNumber string | null —
addressCountry string | null —
clientContacts array —
costGroup array | null —
costGroupIcon string | null —
vatNumber string | null —

Огляд сутності

Контакт клієнта

Зберігайте та керуйте кількома контактами для кожного клієнта для зв'язку, виставлення рахунків та координації проєктів.

Ендпоїнти

GET https://api.flowtly.eu/client-contacts

Список контактів клієнтів

Отримує колекцію ресурсів ClientContact.

POST https://api.flowtly.eu/client-contacts

Створити контакт клієнта

Створює ресурс ClientContact.

GET https://api.flowtly.eu/client-contacts/{id}

Отримати контакт клієнта за ідентифікатором

Отримати окремий ресурс за його ідентифікатором.

DELETE https://api.flowtly.eu/client-contacts/{id}

Видалити контакт клієнта

Видалити ресурс.

PATCH https://api.flowtly.eu/client-contacts/{id}

Оновити контакт клієнта

Оновити поля ресурсу за допомогою JSON Merge Patch.

Сценарії використання

Імпортувати контакти осіб, що приймають рішення, з вашої CRM для мапування зацікавлених сторін проєкту.
Синхронізувати контактні дані для виставлення рахунків, щоб переконатися, що рахунки надходять потрібній особі.

Поля схеми

ClientContact-client.read_client_contact.read_storage.read
Поле Тип Опис
id integer Поле id.
type string Поле type.
position integer Поле position.
email string Поле email.
name string Поле name.
title string | null Поле title.
phone string | null Поле phone.

Огляд сутності

Нотатка клієнта

Відстежуйте інформацію про продажі, історію облікових записів та контекст взаємовідносин разом із записами клієнтів.

Ендпоїнти

GET https://api.flowtly.eu/client-notes

Список нотаток клієнтів

Отримує колекцію ресурсів ClientNote.

POST https://api.flowtly.eu/client-notes

Створити нотатку клієнта

Створює ресурс ClientNote.

GET https://api.flowtly.eu/client-notes/{id}

Отримати нотатку клієнта за ID

Отримати один ресурс за його ідентифікатором.

DELETE https://api.flowtly.eu/client-notes/{id}

Видалити нотатку клієнта

Видалити ресурс.

PATCH https://api.flowtly.eu/client-notes/{id}

Оновити нотатку клієнта

Оновити поля ресурсу за допомогою JSON Merge Patch.

Сценарії використання

Передавати нотатки про активність CRM до Flowtly для крос-командної видимості.
Записувати ключові рішення щодо облікових записів для аудиту та передачі справ.

Поля схеми

ClientNote-client_note.read
Поле Тип Опис
id string Поле id.
client string Поле клієнта.
employee string Поле співробітника.
note string Поле нотатки.
updatedAt string Поле updatedAt.

Огляд сутності

Контрагент

Керування основними даними контрагентів з юридичними ідентифікаторами, банківськими рахунками та адресами для транзакцій та дотримання вимог.

Ендпоїнти

GET https://api.flowtly.eu/counterparties

Список контрагентів

Отримує колекцію ресурсів Контрагента.

POST https://api.flowtly.eu/counterparties

Створити контрагента

Створює ресурс Контрагента.

POST https://api.flowtly.eu/counterparties/enrich-branding-ai

Створити покращене брендування за допомогою ШІ

Поставити контрагентів у чергу для покращення брендування за допомогою ШІ

GET https://api.flowtly.eu/counterparties/{id}

Отримати контрагента за ID

Отримати окремий ресурс за його ідентифікатором.

DELETE https://api.flowtly.eu/counterparties/{id}

Видалити контрагента

Видалити ресурс.

PATCH https://api.flowtly.eu/counterparties/{id}

Оновити контрагента

Оновити поля ресурсу за допомогою JSON Merge Patch.

POST https://api.flowtly.eu/counterparties/{id}/enrich-branding-ai

Поставити окремого контрагента у чергу для покращення брендування за допомогою ШІ

Поставити окремого контрагента у чергу для покращення брендування за допомогою ШІ

POST https://api.flowtly.eu/counterparties/{id}/merge

Об'єднати контрагентів

Об'єднати контрагентів

Сценарії використання

Усунення дублікатів постачальників та клієнтів шляхом синхронізації записів контрагентів з вашою ERP.
Перевірка податкових ідентифікаторів контрагентів за державними реєстрами.

Поля схеми

Counterparty-counterparty.read_counterparty.item.read
Поле Тип Опис
id integer Поле id.
type string Поле type.
supplier string | null Поле supplier.
client string | null Поле client.
requireAttachment boolean Поле requireAttachment.
cyclic boolean Поле cyclic.
budgetNeutral boolean Поле budgetNeutral.
logoUrl string | null Поле logoUrl.
corporateWebsiteUrl string | null Поле corporateWebsiteUrl.
defaultProject string | null Поле defaultProject.
bankAccounts array Поле bankAccounts.
transactionsCount integer Поле transactionsCount.
tin string | null Поле tin.
supplierTin string | null Поле supplierTin.
clientTin string | null —
displayName string —
costGroup array | null —
costGroupIcon string | null —
Whatsapp