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-04-03 18:31 (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.

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

Supprimer un budget

Supprime un budget qui ne doit plus être suivi.

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

Mettre à jour un budget

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

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_budget_project.read

Champ	Type	Description
`id`	string	Identifiant unique du budget.
`name`	string	Nom du budget affiché aux utilisateurs.
`type`	string	Portée du budget (global ou employé).
`granularity`	string	Granularité de reporting, par exemple mensuelle.
`budgetGroup`	string \| null	Champ budgetGroup.
`attributeSet`	string \| null	Champ attributeSet.
`dateFrom`	string \| null	Champ dateFrom.
`dateTo`	string \| null	Champ dateTo.
`config`	array	Options activées comme les alertes de dépense.
`budgetEmployees`	array	Champ budgetEmployees.
`budgetProjects`	array	Champ budgetProjects.

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.

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

Supprimer une transaction budgétaire

Supprime un lien de transaction budgétaire incorrect.

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

Mettre à jour une transaction budgétaire

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

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`	string \| null	Montant imputé au budget.

Vue d’ensemble

Groupe budgétaire

Organiser les budgets en groupes logiques (départements, projets, centres de coûts) pour les rapports agrégés.

Endpoints

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

Lister les groupes budgétaires

Récupère la collection de ressources BudgetGroup.

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

Créer un groupe budgétaire

Crée une ressource BudgetGroup.

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

Obtenir un groupe budgétaire par ID

Récupérer une seule ressource par son identifiant.

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

Supprimer le groupe budgétaire

Supprime la ressource.

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

Mettre à jour un groupe budgétaire

Mettre à jour les champs de la ressource en utilisant JSON Merge Patch.

Cas d’usage

Reproduisez la hiérarchie de votre plan comptable dans les groupes budgétaires Flowtly.

Créez des groupes budgétaires par unité commerciale pour des tableaux de bord de dépenses consolidés.

Champs du schéma

BudgetGroup-budget_group.read_budget_group.projects.read

Champ	Type	Description
`id`	string	Champ id.
`name`	string	Champ nom.
`projects`	array	Champ projets.

Vue d’ensemble

Coûts et fournisseur

Suivre les coûts opérationnels, les grouper pour analyse et gérer les relations avec les sous-traitants/fournisseurs.

Endpoints

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

Lister les coûts et les fournisseurs

Récupère la collection de ressources CostGroup.

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

Créer un coût et un fournisseur

Crée une ressource CostGroup.

POST https://api.flowtly.eu/contractors/nip-validation

Créer une validation NIP

Crée une ressource de coût.

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

Lister la recherche

Récupère la collection de ressources de coût.

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

Obtenir le coût et le fournisseur par ID

Récupère une ressource unique par son identifiant.

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

Supprimer le coût et le fournisseur

Supprime la ressource.

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

Mettre à jour les coûts et le fournisseur

Met à jour les champs de ressource en utilisant JSON Merge Patch.

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

Lister les coûts et les fournisseurs

Récupère la collection de ressources CostGroup.

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

Créer un coût et un fournisseur

Crée une ressource CostGroup.

GET https://api.flowtly.eu/costs/payment-due/{date}

Obtenir le coût et le fournisseur par ID

Récupère une ressource unique par son identifiant.

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

Obtenir le coût et le fournisseur par ID

Récupère une ressource unique par son identifiant.

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

Mettre à jour les coûts et le fournisseur

Met à jour les champs de ressource en utilisant JSON Merge Patch.

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

Obtenir le coût et le fournisseur par ID

Récupère une ressource unique par son identifiant.

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

Lister les coûts et les fournisseurs

Récupère la collection de ressources CostGroup.

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

Créer un coût et un fournisseur

Crée une ressource CostGroup.

POST https://api.flowtly.eu/suppliers/nip-validation

Créer une validation NIP

Crée une ressource de coût.

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

Lister la recherche

Récupère la collection de ressources de coût.

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

Obtenir le coût et le fournisseur par ID

Récupère une ressource unique par son identifiant.

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

Supprimer le coût et le fournisseur

Supprime la ressource.

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

Mettre à jour les coûts et le fournisseur

Met à jour les champs de ressource en utilisant JSON Merge Patch.

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

Lister les coûts et les fournisseurs

Récupère la collection de ressources CostGroup.

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

Créer un coût et un fournisseur

Crée une ressource CostGroup.

POST https://api.flowtly.eu/cost-groups/assign-icons-ai

Créer des icônes d'attribution IA

Attribuer des icônes de groupe de coûts via l'IA

GET https://api.flowtly.eu/cost-groups/chart

Lister le graphique

Obtenir le graphique des groupes de coûts

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

Obtenir le coût et le fournisseur par ID

Récupère une ressource unique par son identifiant.

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

Mettre à jour les coûts et le fournisseur

Met à jour les champs de ressource en utilisant JSON Merge Patch.

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

Obtenir le coût et le fournisseur par ID

Récupère une ressource unique par son identifiant.

POST https://api.flowtly.eu/cost-groups/{id}/merge

Fusionner les groupes de coûts

Fusionne les groupes de coûts.

Cas d’usage

Synchroniser les factures des fournisseurs dans les enregistrements de coûts pour un suivi des marges en temps réel.

Importer les taux des sous-traitants des achats pour automatiser le calcul des coûts de projet.

Champs du schéma

Cost-cost.read_cost_group.read

Champ	Type	Description
`id`	integer	Champ id.
`costGroup`	object	Champ costGroup.
`ownerEmployee`	string \| null	Champ ownerEmployee.
`tinType`	string	Champ tinType.
`tin`	string \| null	Champ tin.
`tinCountry`	string \| null	Champ tinCountry.
`cyclic`	boolean	Champ cyclic.
`paymentDeadline`	integer \| null	Champ paymentDeadline.
`name`	string	Champ name.
`description`	string \| null	Champ description.
`matchRegex`	string \| null	Champ matchRegex.
`requireAttachment`	boolean \| null	Champ requireAttachment.
`taxAmount`	string \| null	Champ taxAmount.
`notIncludeInChart`	boolean	Champ notIncludeInChart.
`eInvoicingReferenceNumber`	string \| null	Champ eInvoicingReferenceNumber.
`eInvoicingSourceXmlUrl`	string \| null	—
`eInvoicingVisualUrl`	string \| null	—
`createdAt`	string	—
`costGroupIcon`	string \| null	—
`contractorGroup`	object	—

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.

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

Créer l'importation

Crée une ressource Transaction.

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

Lister les non-attribuées

Récupère la collection de ressources Transaction.

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

Lister avec problèmes

Récupère la collection de ressources Transaction.

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.

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

Supprimer la transaction

Supprime la ressource.

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

Mettre à jour une transaction

Modifiez classification, affectation ou champs de rapprochement.

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

Lire une transaction par ID

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

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

Crée une ressource TransactionAttachment.

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

Lire une transaction par ID

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

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

Crée une ressource TransactionAttachment.

POST https://api.flowtly.eu/transactions/{id}/allocation/preview

Crée une ressource TransactionAllocationPreviewInput.

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

Lister les transactions

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

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

Créer une transaction

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

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

Créer la création

Crée une ressource TransactionAttachment.

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

Lister la recherche

Récupère la collection de ressources TransactionAttachment.

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

Lire une transaction par ID

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

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

Supprimer la transaction

Supprime la ressource.

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

Mettre à jour une transaction

Modifiez classification, affectation ou champs de rapprochement.

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

Crée une ressource TransactionAttachment.

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

Crée une ressource TransactionAttachment.

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

Crée une ressource TransactionAttachment.

POST https://api.flowtly.eu/transaction-attachments/{id}/mark-manual-paid

Crée une ressource TransactionAttachment.

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

Lire une transaction par ID

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

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

Lire une transaction par ID

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

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

Crée une ressource TransactionAttachment.

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

Créer un zip

Télécharger les pièces jointes de transaction au format zip

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

Lister mt940

Récupère une ressource TransactionMt940Export.

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

Lister pdf

Récupère une ressource TransactionPdfExport.

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

TransactionAttachment-transaction.read_transaction_attachment.read_cost.read_storage.read

Champ	Type	Description
`id`	integer	Champ id.
`cost`	object	Champ coût.
`counterparty`	object	Champ contrepartie.
`currency`	string \| null	Champ devise.
`relatedMonth`	string \| null	Champ relatedMonth.
`externalId`	string	Champ externalId.
`employee`	string \| null	Champ employé.
`amount`	integer \| null	Champ montant.
`amountNet`	integer \| null	Champ amountNet.
`name`	string	Champ nom.
`description`	string	Champ description.
`note`	string \| null	Champ note.
`receivedAt`	string	Champ receivedAt.
`approvalsCount`	integer	Champ approvalsCount.
`suggestionsCount`	integer	Champ suggestionsCount.
`sourceType`	string	—
`type`	string	—
`paidAt`	string \| null	—
`transaction`	object	—
`invoiceLines`	array	—
`createdAt`	string	—
`counterpartyName`	string \| null	—
`status`	string	—

Vue d’ensemble

Compte bancaire

Gérez les enregistrements de comptes bancaires utilisés pour le routage des paiements, le rapprochement et les rapports de trésorerie.

Endpoints

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

Lister les comptes bancaires

Récupère la collection de ressources BankAccount.

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

Créer un compte bancaire

Crée une ressource BankAccount.

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

Obtenir un compte bancaire par ID

Récupère une ressource unique par son identifiant.

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

Mettre à jour le compte bancaire

Met à jour les champs de ressource en utilisant JSON Merge Patch.

GET https://api.flowtly.eu/bank-accounts

Lister les comptes bancaires

Récupère la collection de ressources BankAccount.

POST https://api.flowtly.eu/bank-accounts

Créer un compte bancaire

Crée une ressource BankAccount.

GET https://api.flowtly.eu/bank-accounts/{id}

Obtenir un compte bancaire par ID

Récupère une ressource unique par son identifiant.

PATCH https://api.flowtly.eu/bank-accounts/{id}

Mettre à jour le compte bancaire

Met à jour les champs de ressource en utilisant JSON Merge Patch.

Cas d’usage

Enregistrez de nouveaux comptes bancaires depuis votre système de trésorerie pour le rapprochement des paiements.

Synchronisez les soldes des comptes pour la prévision des flux de trésorerie au sein de Flowtly.

Champs du schéma

BankAccount-bank_account.read_bank.read

Champ	Type	Description
`id`	integer	Champ id.
`bank`	object	Champ banque.
`type`	string	Champ type.
`default`	boolean	Champ par défaut.
`hidden`	boolean	Champ masqué.
`name`	string	Champ nom.
`number`	string \| null	Champ numéro.
`prefix`	string \| null	Champ préfixe.
`currency`	string \| null	Champ devise.
`defaultImportFormat`	string	Champ defaultImportFormat.

Vue d’ensemble

Groupe et règle de taxe

Définissez des groupes de taxes avec des règles associées pour un calcul précis des taxes de facture et de transaction.

Endpoints

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

Lister les groupes et règles de taxes

Récupère la collection de ressources TaxRule.

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

Créer un groupe et une règle de taxe

Crée une ressource TaxRule.

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

Obtenir un groupe et une règle de taxe par ID

Récupère une ressource unique par son identifiant.

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

Mettre à jour un groupe et une règle de taxe

Met à jour les champs de ressource en utilisant JSON Merge Patch.

GET https://api.flowtly.eu/tax-rules

Lister les groupes et règles de taxes

Récupère la collection de ressources TaxRule.

POST https://api.flowtly.eu/tax-rules

Créer un groupe et une règle de taxe

Crée une ressource TaxRule.

GET https://api.flowtly.eu/tax-rules/{id}

Obtenir un groupe et une règle de taxe par ID

Récupère une ressource unique par son identifiant.

DELETE https://api.flowtly.eu/tax-rules/{id}

Supprimer un groupe et une règle de taxe

Supprime la ressource.

PATCH https://api.flowtly.eu/tax-rules/{id}

Mettre à jour un groupe et une règle de taxe

Met à jour les champs de ressource en utilisant JSON Merge Patch.

Cas d’usage

Importer des tables de taux de TVA depuis votre système comptable pour une facturation cohérente.

Configurer des règles fiscales spécifiques à chaque pays pour la facturation multi-juridictionnelle.

Champs du schéma

TaxGroup-tax_group.read_tax_rule.read

Champ	Type	Description
`id`	string	Champ id.
`name`	string	Champ nom.
`isDefault`	boolean	Champ isDefault.
`taxRules`	array	Champ taxRules.

Vue d’ensemble

Devise

Interroger les devises disponibles utilisées pour les factures, les budgets et les transactions.

Endpoints

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

Lister les devises

Récupère la collection de ressources Devises.

GET https://api.flowtly.eu/currencies/{!sourceCurrency}/rates/{!targetCurrency}/{date}

Obtenir une devise par ID

Récupérer une ressource unique par son identifiant.

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

Obtenir une devise par ID

Récupérer une ressource unique par son identifiant.

Cas d’usage

Rechercher les devises prises en charge avant de créer des factures multidevises.

Synchroniser les taux de change pour un reporting financier consolidé.

Champs du schéma

Currency-currency.read

Champ	Type	Description
`id`	string	Champ id.
`name`	string	Champ name.