Проєкти та delivery – будуйте на Flowtly

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

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

Остання синхронізація: 2025-12-11 09:43 (версія застосунку 2.0.0)

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

Проєкти та delivery

Відкривайте метадані проєктів, учасників і контекст білінгу.

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

Атрибут

Створюйте та керуйте кастомними атрибутами, щоб розширювати моделі даних Flowtly.

Ендпоїнти

GET /api/attributes

Список атрибутів

Отримуйте атрибути з пагінацією та фільтрами.

POST /api/attributes

Створити атрибут

Визначте новий атрибут зі slug, назвою та типом.

GET /api/attributes/{id}

Отримати атрибут за ID

Прочитайте визначення конкретного атрибута.

PATCH /api/attributes/{id}

Оновити атрибут

Патчте деталі атрибута, наприклад назву або опис.

DELETE /api/attributes/{id}

Видалити атрибут

Видаліть визначення атрибута.

GET /api/attribute-entity-values

List attribute-entity-values

Retrieves the collection of AttributeValue resources.

POST /api/attribute-entity-values

Create attribute-entity-value

Creates a AttributeValue resource.

GET /api/attribute-entity-values/{id}

Get attribute-entity-value

Retrieves a AttributeValue resource.

PATCH /api/attribute-entity-values/{id}

Update attribute-entity-value

Updates the AttributeValue resource.

DELETE /api/attribute-entity-values/{id}

Delete attribute-entity-value

Removes the AttributeValue resource.

GET /api/attribute-set-attributes

List attribute-set-attributes

Retrieves the collection of AttributeSetAttribute resources.

POST /api/attribute-set-attributes

Create attribute-set-attribute

Creates a AttributeSetAttribute resource.

GET /api/attribute-set-attributes/{id}

Get attribute-set-attribute

Retrieves a AttributeSetAttribute resource.

PATCH /api/attribute-set-attributes/{id}

Update attribute-set-attribute

Updates the AttributeSetAttribute resource.

DELETE /api/attribute-set-attributes/{id}

Delete attribute-set-attribute

Removes the AttributeSetAttribute resource.

GET /api/attribute-sets

List attribute-sets

Retrieves the collection of AttributeSet resources.

POST /api/attribute-sets

Create attribute-set

Creates a AttributeSet resource.

GET /api/attribute-sets/{id}

Get attribute-set

Retrieves a AttributeSet resource.

PATCH /api/attribute-sets/{id}

Update attribute-set

Updates the AttributeSet resource.

DELETE /api/attribute-sets/{id}

Delete attribute-set

Removes the AttributeSet resource.

GET /api/attribute-values

List attribute-values

Retrieves the collection of AttributeValue resources.

POST /api/attribute-values

Create attribute-value

Creates a AttributeValue resource.

GET /api/attribute-values/{id}

Get attribute-value

Retrieves a AttributeValue resource.

PATCH /api/attribute-values/{id}

Update attribute-value

Updates the AttributeValue resource.

DELETE /api/attribute-values/{id}

Delete attribute-value

Removes the AttributeValue resource.

Поля схеми

Attribute-attribute.read
Поле Тип Опис
id string Ідентифікатор атрибута.
name string Відображувана назва атрибута.
type string Тип даних атрибута.
shift integer —
required boolean —
multiple boolean —
defaultValue string | null —
formatPattern string | null —

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

Проєкт

Використовуйте проєкти Flowtly як канонічний референс для delivery, щоб PMO-інструменти були узгоджені за учасниками й графіками.

Ендпоїнти

GET /api/projects

Список проєктів

Отримуйте проєкти з фільтрами за клієнтом, статусом або типом контракту.

POST /api/projects

Створити проєкт

Створіть проєкт із моделлю білінгу, референсами клієнта та опціональним графіком.

GET /api/projects/{id}

Отримати проєкт за ID

Перегляньте конкретний проєкт, щоб прочитати учасників, валюту та ключові поля.

PATCH /api/projects/{id}

Оновити проєкт

Патчте метадані проєкту, дати або тип білінгу.

GET /api/projects/preview

Preview projects

Preview project data before creation.

GET /api/projects/search

Search projects

Search projects by filters.

GET /api/projects/{id}/profitability

Get project profitability

Inspect profitability metrics for a project.

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

Створюйте проєкти з CRM, коли угода закривається, для підготовки staffing-процесів.
Оновлюйте життєвий цикл проєкту з зовнішніх інструментів, щоб прогнози витрат Flowtly були точними.

Поля схеми

Project-project.read
Поле Тип Опис
id integer Внутрішній ідентифікатор проєкту Flowtly.
client string | null IRI організації клієнта.
currency string | null Референс валюти для білінгу та бюджетів.
dateFrom string | null Запланована дата старту проєкту.
dateTo string | null Запланована дата завершення проєкту.
name string Назва проєкту в інтерфейсі.
publicDescription string | null Опис проєкту для клієнтів.
type string Модель білінгу, наприклад fixed-price або time-and-material.
clientHash string Хешований ідентифікатор, який Flowtly використовує для дедуплікації.
notes string | null Внутрішні нотатки для користувачів Flowtly.
color string Hex-колір для UI-бейджів.
priceNet string | null Нетто-ціна, налаштована для проєкту.
taxGroup string | null IRI податкової групи, застосованої до проєкту.
projectMembers array Список IRI учасників, призначених до проєкту.
status string Системний статус життєвого циклу (active, archived тощо).
flattenType string Внутрішній нормалізований тип у Flowtly.

Приклади

POST /api/projects

Створити проєкт Aurora rollout

Додає time-and-material проєкт, привʼязаний до CRM-клієнта, із запланованими датами старту та завершення.

Пейлоад запиту 
{
    "name": "Aurora Rollout",
    "type": "time-and-material",
    "currency": "/api/currencies/EUR",
    "client": "/api/clients/cl_901",
    "dateFrom": "2024-06-01T00:00:00+00:00",
    "dateTo": "2024-12-31T00:00:00+00:00",
    "notes": "Expansion to Germany and France"
}
Пейлоад відповіді 
{
    "@id": "/api/projects/prj_aurora",
    "@type": "Project",
    "id": 9821,
    "name": "Aurora Rollout",
    "type": "time-and-material",
    "currency": "/api/currencies/EUR",
    "client": "/api/clients/cl_901",
    "dateFrom": "2024-06-01T00:00:00+00:00",
    "dateTo": "2024-12-31T00:00:00+00:00",
    "status": "active"
}
Whatsapp