Budgets & dépenses – plateforme développeur Flowtly

Utilisez cet instantané du schéma OpenAPI de Flowtly pour préparer vos intégrations, automatiser des workflows et synchroniser les données critiques.

Statut de la documentation

Dernière synchronisation : 2026-02-23 12:40 (version de l’app 2.0.0)

Seule une partie des entités est publique. Exécutez les deux commandes de synchronisation lorsque Flowtly publie de nouvelles fonctions.

Budgets & dépenses

Pilotez plans financiers, allocations et transactions.

Vue d’ensemble

Budget

Exposez les budgets Flowtly à vos outils financiers pour garder les limites et alertes alignées.

Endpoints

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

Lister les budgets

Récupère des budgets paginés avec filtres par type ou période.

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

Créer un budget

Crée un budget avec fenêtre temporelle, groupe et options.

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

Obtenir un budget par ID

Consulte les détails et allocations d’un budget.

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

Mettre à jour un budget

Ajuste les dates, la granularité ou la configuration d’un budget.

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

Supprimer un budget

Supprime un budget qui ne doit plus être suivi.

GET https://api.flowtly.eu/budget-contractors

List budget-contractors

Retrieve budget-contractor records.

POST https://api.flowtly.eu/budget-contractors

Create budget-contractor

Create a new budget-contractor mapping.

GET https://api.flowtly.eu/budget-contractors/{id}

Get budget-contractor

Fetch a budget-contractor by ID.

DELETE https://api.flowtly.eu/budget-contractors/{id}

Delete budget-contractor

Remove a budget-contractor mapping.

GET https://api.flowtly.eu/budget-employees

List budget-employees

Retrieve employee budget allocations.

POST https://api.flowtly.eu/budget-employees

Create budget-employee

Create a new budget-employee allocation.

GET https://api.flowtly.eu/budget-employees/{id}

Get budget-employee

Fetch a budget-employee allocation.

DELETE https://api.flowtly.eu/budget-employees/{id}

Delete budget-employee

Remove a budget-employee allocation.

GET https://api.flowtly.eu/budget-groups

List budget-groups

Retrieve budget groups.

POST https://api.flowtly.eu/budget-groups

Create budget-group

Create a new budget group.

GET https://api.flowtly.eu/budget-groups/{id}

Get budget-group

Fetch a budget group by ID.

PATCH https://api.flowtly.eu/budget-groups/{id}

Update budget-group

Patch a budget group.

DELETE https://api.flowtly.eu/budget-groups/{id}

Delete budget-group

Remove a budget group.

GET https://api.flowtly.eu/budget-invoices

List budget-invoices

Retrieve budget-linked invoices.

POST https://api.flowtly.eu/budget-invoices

Create budget-invoice

Create a budget invoice mapping.

GET https://api.flowtly.eu/budget-invoices/{id}

Get budget-invoice

Fetch a budget invoice mapping.

DELETE https://api.flowtly.eu/budget-invoices/{id}

Delete budget-invoice

Remove a budget invoice mapping.

GET https://api.flowtly.eu/budget-projects

List budget-projects

Retrieve project allocations under budgets.

POST https://api.flowtly.eu/budget-projects

Create budget-project

Create a budget-project allocation.

GET https://api.flowtly.eu/budget-projects/{id}

Get budget-project

Fetch a budget-project allocation.

DELETE https://api.flowtly.eu/budget-projects/{id}

Delete budget-project

Remove a budget-project allocation.

Cas d’usage

Créez des centres de coûts annuels dans l’ERP et synchronisez les limites vers Flowtly.
Synchronisez les budgets marketing afin d’arrêter la dépense quand Flowtly déclenche une alerte.

Champs du schéma

Budget-budget.read_budget_employee.read
Champ Type Description
id string Identifier of the budget.
name string Human-readable label (e.g. EMEA Marketing FY25).
type string Either global or employee-level budget.
granularity string Aggregation interval for reporting (month, quarter).
budgetGroup string | null Optional reference to a budget group.
dateFrom string | null Start of the validity window.
dateTo string | null End of the validity window.
config array Feature flags such as spend alerts.
budgetEmployees array Employee allocations tied to the budget.

Exemples

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

Créer un budget marketing global

Met en place le budget FY25 lié à son groupe avec alertes automatiques.

Charge utile de la requête 
{
    "name": "EMEA Marketing FY25",
    "type": "global",
    "granularity": "month",
    "dateFrom": "2024-01-01T00:00:00+00:00",
    "dateTo": "2024-12-31T00:00:00+00:00",
    "budgetGroup": "/api/budget-groups/emarketing",
    "config": [
        "spend_alerts",
        "auto-freeze"
    ]
}
Charge utile de la réponse 
{
    "@id": "/api/budgets/bgt_fy25",
    "@type": "Budget",
    "id": "bgt_fy25",
    "name": "EMEA Marketing FY25",
    "type": "global",
    "granularity": "month",
    "dateFrom": "2024-01-01T00:00:00+00:00",
    "dateTo": "2024-12-31T00:00:00+00:00",
    "budgetGroup": "/api/budget-groups/emarketing",
    "config": [
        "spend_alerts",
        "auto-freeze"
    ]
}

Vue d’ensemble

Transaction budgétaire

Partagez les données de dépense pour que achats et Flowtly utilisent les mêmes montants.

Endpoints

GET https://api.flowtly.eu/budget-transactions

Lister les transactions budgétaires

Récupère le journal des événements financiers d’un budget.

POST https://api.flowtly.eu/budget-transactions

Créer une transaction budgétaire

Lie une transaction externe et, si besoin, le collaborateur responsable.

GET https://api.flowtly.eu/budget-transactions/{id}

Obtenir une transaction budgétaire

Consulte une transaction liée à un budget pour vérifier son impact.

PATCH https://api.flowtly.eu/budget-transactions/{id}

Mettre à jour une transaction budgétaire

Ajuste le budget lié, le collaborateur ou le montant enregistré.

DELETE https://api.flowtly.eu/budget-transactions/{id}

Supprimer une transaction budgétaire

Supprime un lien de transaction budgétaire incorrect.

GET https://api.flowtly.eu/income-transactions

List income-transactions

Retrieve income transactions.

POST https://api.flowtly.eu/income-transactions

Create income-transaction

Create an income transaction entry.

GET https://api.flowtly.eu/income-transactions/{id}

Get income-transaction

Fetch an income transaction by ID.

PATCH https://api.flowtly.eu/income-transactions/{id}

Update income-transaction

Patch an income transaction entry.

DELETE https://api.flowtly.eu/income-transactions/{id}

Delete income-transaction

Delete an income transaction entry.

GET https://api.flowtly.eu/project-transactions

List project-transactions

Retrieve project transactions.

POST https://api.flowtly.eu/project-transactions

Create project-transaction

Create a project transaction entry.

PATCH https://api.flowtly.eu/project-transactions/{id}

Update project-transaction

Patch a project transaction entry.

DELETE https://api.flowtly.eu/project-transactions/{id}

Delete project-transaction

Delete a project transaction entry.

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

List transactions

Retrieve generic transactions.

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

Create transaction

Create a generic transaction.

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

Get transaction

Fetch a transaction by ID.

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

Update transaction

Patch a transaction.

POST https://api.flowtly.eu/transactions/import

Import transactions

Bulk import transactions.

GET https://api.flowtly.eu/transactions/unassigned

List unassigned transactions

Retrieve transactions not yet linked to a budget.

GET https://api.flowtly.eu/transaction-attachments

List transaction-attachments

Retrieve transaction attachments.

POST https://api.flowtly.eu/transaction-attachments

Create transaction-attachment

Create a transaction attachment.

GET https://api.flowtly.eu/transaction-attachments/{id}

Get transaction-attachment

Fetch a transaction attachment by ID.

PATCH https://api.flowtly.eu/transaction-attachments/{id}

Update transaction-attachment

Patch a transaction attachment.

DELETE https://api.flowtly.eu/transaction-attachments/{id}

Delete transaction-attachment

Delete a transaction attachment.

POST https://api.flowtly.eu/transaction-attachments/create

Upload transaction-attachment

Upload a new transaction attachment.

GET https://api.flowtly.eu/transaction-attachments/search

Search transaction-attachments

Search transaction attachments by query.

POST https://api.flowtly.eu/transaction-attachments/{id}/apply-suggestion

Creates a TransactionAttachment resource.

Creates a TransactionAttachment resource.

POST https://api.flowtly.eu/transaction-attachments/{id}/apply-supplier-suggestion

Creates a TransactionAttachment resource.

Creates a TransactionAttachment resource.

POST https://api.flowtly.eu/transaction-attachments/{id}/detach

Creates a TransactionAttachment resource.

Creates a TransactionAttachment resource.

GET https://api.flowtly.eu/transaction-attachments/{id}/suggestions

Retrieves the collection of TransactionAttachment resources.

Retrieves the collection of TransactionAttachment resources.

GET https://api.flowtly.eu/transaction-attachments/{id}/suggestions-debug

Retrieves a TransactionAttachment resource.

Retrieves a TransactionAttachment resource.

POST https://api.flowtly.eu/transaction-attachments/{id}/suggestions/{suggestionId}/apply

Creates a TransactionAttachment resource.

Creates a TransactionAttachment resource.

POST https://api.flowtly.eu/transactions/attachments/zip

Download transaction attachments as zip

Creates a TransactionAttachmentsZipExport resource.

GET https://api.flowtly.eu/transactions/export/mt940

Retrieves a TransactionMt940Export resource.

Retrieves a TransactionMt940Export resource.

GET https://api.flowtly.eu/transactions/with-problems

Retrieves the collection of Transaction resources.

Retrieves the collection of Transaction resources.

GET https://api.flowtly.eu/transactions/{id}/suggestions

Retrieves the collection of Transaction resources.

Retrieves the collection of Transaction resources.

POST https://api.flowtly.eu/transactions/{id}/suggestions/{suggestionId}/apply

Creates a Transaction resource.

Creates a Transaction resource.

Cas d’usage

Poussez les paiements de factures depuis la compta afin que Flowtly reflète la dépense réelle.
Associez les coûts RH ou fournisseurs au budget dès leur approbation.

Champs du schéma

BudgetTransaction-budget_transaction.read_transaction.read
Champ Type Description
budget string IRI du budget concerné.
transaction object IRI de la transaction ERP d’origine.
employee string | null Collaborateur associé à la dépense (facultatif).
amount integer | null Montant imputé au budget.

Exemples

POST https://api.flowtly.eu/budget-transactions

Lier une transaction ERP à un budget

Associe une facture fournisseur au budget FY25 et enregistre le propriétaire.

Charge utile de la requête 
{
    "budget": "/api/budgets/bgt_fy25",
    "transaction": "/api/transactions/txn_904",
    "employee": "/api/employees/emp_777",
    "amount": 125000
}
Charge utile de la réponse 
{
    "@id": "/api/budget-transactions/btr_11",
    "@type": "BudgetTransaction",
    "id": "btr_11",
    "budget": "/api/budgets/bgt_fy25",
    "transaction": "/api/transactions/txn_904",
    "employee": "/api/employees/emp_777",
    "amount": 125000
}

Vue d’ensemble

Facture

Exposez le cycle de vie des factures pour aligner finance, opérations et équipes client sur une seule source de revenu.

Endpoints

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

Lister les factures

Récupérez une collection de factures avec pagination et filtres de statut.

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

Créer une facture

Créez une facture avec client, lignes et métadonnées de paiement.

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

Lire une facture par ID

Consultez une facture avec ses lignes et transactions liées.

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

Mettre à jour une facture

Modifiez statut, échéance ou métadonnées après validation.

GET https://api.flowtly.eu/invoices/draft

Retrieves the collection of Invoice resources.

Retrieves the collection of Invoice resources.

GET https://api.flowtly.eu/invoices/name/{date}

Retrieves the collection of Invoice resources.

Retrieves the collection of Invoice resources.

POST https://api.flowtly.eu/invoices/send

Creates a Invoice resource.

Creates a Invoice resource.

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

Removes the Invoice resource.

Removes the Invoice resource.

GET https://api.flowtly.eu/invoices/{id}/send

Retrieves a Invoice resource.

Retrieves a Invoice resource.

POST https://api.flowtly.eu/invoices/{id}/send

Creates a Invoice resource.

Creates a Invoice resource.

Cas d’usage

Synchronisez les factures vers vos dashboards BI pour suivre les retards de paiement et le risque de trésorerie.
Déclenchez des relances clients quand le statut de facture change dans Flowtly.

Champs du schéma

Invoice-invoice.read_invoice_row.read_invoice_transaction.read_transaction.read_storage.read
Champ Type Description
id integer —
name string —
type string —
parent object —
childrenInvoices array —
client string —
tinType string —
tinCountry string | null —
tin string | null —
bankAccount string —
amountNet number —
amount number —
currency string | null —
conversionRate number | null —
generatedPdfExternalId string | null —
issueDate string —
saleDate string —
dueDate string —
targetAmount number | null —
paymentMethod string —
notes string | null —
invoiceRows array —
eInvoicing object —
invoiceTransactions array —
internalComment string —
targetAmountNet number | null —
status string —

Vue d’ensemble

Transaction

Intégrez les flux de transactions entre banque et ERP pour garder le contrôle des dépenses et des marges.

Endpoints

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

Lister les transactions

Récupérez les transactions avec filtres d’affectation et de statut.

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

Créer une transaction

Créez une transaction avec montant, devise et références de compte.

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

Lire une transaction par ID

Consultez une transaction avec ses pièces jointes et liens de coûts.

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

Mettre à jour une transaction

Modifiez classification, affectation ou champs de rapprochement.

POST https://api.flowtly.eu/transactions/attachments/zip

Download transaction attachments as zip

Creates a TransactionAttachmentsZipExport resource.

GET https://api.flowtly.eu/transactions/export/mt940

Retrieves a TransactionMt940Export resource.

Retrieves a TransactionMt940Export resource.

POST https://api.flowtly.eu/transactions/import

Creates a Transaction resource.

Creates a Transaction resource.

GET https://api.flowtly.eu/transactions/unassigned

Retrieves the collection of Transaction resources.

Retrieves the collection of Transaction resources.

GET https://api.flowtly.eu/transactions/with-problems

Retrieves the collection of Transaction resources.

Retrieves the collection of Transaction resources.

GET https://api.flowtly.eu/transactions/{id}/suggestions

Retrieves the collection of Transaction resources.

Retrieves the collection of Transaction resources.

POST https://api.flowtly.eu/transactions/{id}/suggestions/{suggestionId}/apply

Creates a Transaction resource.

Creates a Transaction resource.

Cas d’usage

Synchronisez les transactions comptabilisées vers les outils de clôture mensuelle.
Alimentez les alertes budgétaires et vues de rentabilité en temps réel.

Champs du schéma

Transaction-transaction.read
Champ Type Description
id string —
bankAccount string —
employeeOwner string | null —
cost string | null —
counterparty object —
counterpartyRole string | null —
statementNumber integer —
operationNumber string | null —
description string —
amount number —
endingBalance number —
orderDate string —
execDate string —
relatedDate string | null —
ignored integer —
note string | null —
transactionAttachments array —
budgetTransactions array —
projectTransactions array —
connectedMonth string —
Whatsapp