Budget e spese – costruisci su Flowtly

Usa questo snapshot curato dello schema OpenAPI di Flowtly per pianificare integrazioni, automatizzare workflow e sincronizzare i dati su cui i tuoi team fanno affidamento.

Stato della documentazione

Ultima sincronizzazione il 2026-04-03 18:31 (versione app 2.0.0)

Solo un sottoinsieme di entità è reso pubblico. Esegui entrambi i comandi di sincronizzazione per aggiornare questa documentazione quando l'app Flowtly introduce nuove funzionalità.

Budget e spese

Piani finanziari, allocazioni, gruppi di costo e transazioni.

Panoramica entità

Budget

Esponi i budget di Flowtly agli strumenti finanziari per garantire che allocazioni, avvisi e approvazioni rimangano sincronizzati.

Endpoint

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

Elenca budget

Recupera la raccolta di risorse Budget.

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

Crea budget

Crea una risorsa Budget.

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

Ottieni budget per ID

Recupera una singola risorsa tramite il suo identificatore.

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

Elimina budget

Rimuovi la risorsa.

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

Aggiorna budget

Aggiorna i campi della risorsa tramite JSON Merge Patch.

Casi d'uso

Provisiona i centri di costo annuali dal tuo ERP e mantieni Flowtly aggiornato con i limiti più recenti.

Sincronizza i budget delle campagne marketing affinché gli strumenti di performance possano bloccare la spesa quando Flowtly segnala sforamenti.

Campi dello schema

Budget-budget.read_budget_employee.read_budget_project.read

Campo	Tipo	Descrizione
`id`	string	Campo id.
`name`	string	Campo name.
`type`	string	Campo type.
`granularity`	string	Campo granularity.
`budgetGroup`	string \| null	Campo budgetGroup.
`attributeSet`	string \| null	Campo attributeSet.
`dateFrom`	string \| null	Campo dateFrom.
`dateTo`	string \| null	Campo dateTo.
`config`	array	Campo config.
`budgetEmployees`	array	Campo budgetEmployees.
`budgetProjects`	array	Campo budgetProjects.

Panoramica entità

Transazione di budget

Condividi i dati di spesa in modo bidirezionale affinché le suite di approvvigionamento e Flowtly concordino sugli importi impegnati più recenti.

Endpoint

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

Elenca transazioni di budget

Recupera la raccolta di risorse BudgetTransaction.

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

Crea transazione di budget

Crea una risorsa BudgetTransaction.

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

Ottieni transazione di budget per ID

Recupera una singola risorsa tramite il suo identificatore.

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

Elimina transazione di budget

Rimuovi la risorsa.

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

Aggiorna transazione di budget

Aggiorna i campi della risorsa tramite JSON Merge Patch.

Casi d'uso

Invia i pagamenti di fatture dal tuo sistema contabile affinché Flowtly rifletta la spesa aggiornata.

Collega le spese HR o fornitore ai budget nel momento in cui vengono approvate nel tuo stack finanziario.

Campi dello schema

BudgetTransaction-budget_transaction.read_transaction.read

Campo	Tipo	Descrizione
`budget`	string	Campo budget.
`transaction`	object	Campo transaction.
`employee`	string \| null	Campo employee.
`amount`	string \| null	Campo amount.

Panoramica entità

Gruppo di budget

Organizza i budget in gruppi logici (reparti, progetti, centri di costo) per il reporting consolidato.

Endpoint

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

Elenca gruppi di budget

Recupera la raccolta di risorse BudgetGroup.

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

Crea gruppo di budget

Crea una risorsa BudgetGroup.

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

Ottieni gruppo di budget per ID

Recupera una singola risorsa tramite il suo identificatore.

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

Elimina gruppo di budget

Rimuovi la risorsa.

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

Aggiorna gruppo di budget

Aggiorna i campi della risorsa tramite JSON Merge Patch.

Casi d'uso

Rispecchia la gerarchia del piano dei conti in gruppi di budget Flowtly.

Crea gruppi di budget per unità di business per dashboard di spesa consolidate.

Campi dello schema

BudgetGroup-budget_group.read_budget_group.projects.read

Campo	Tipo	Descrizione
`id`	string	Campo id.
`name`	string	Campo name.
`projects`	array	Campo projects.

Panoramica entità

Costo e fornitore

Tieni traccia dei costi operativi, raggruppali per l'analisi e gestisci i rapporti con collaboratori e fornitori.

Endpoint

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

Elenca costi e fornitori

Recupera la raccolta di risorse CostGroup.

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

Crea costo e fornitore

Crea una risorsa CostGroup.

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

Crea validazione NIP

Crea una risorsa Cost.

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

Elenca ricerca

Recupera la raccolta di risorse Cost.

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

Ottieni costo e fornitore per ID

Recupera una singola risorsa tramite il suo identificatore.

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

Elimina costo e fornitore

Rimuovi la risorsa.

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

Aggiorna costo e fornitore

Aggiorna i campi della risorsa tramite JSON Merge Patch.

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

Elenca costi e fornitori

Recupera la raccolta di risorse CostGroup.

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

Crea costo e fornitore

Crea una risorsa CostGroup.

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

Ottieni costo e fornitore per ID

Recupera una singola risorsa tramite il suo identificatore.

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

Ottieni costo e fornitore per ID

Recupera una singola risorsa tramite il suo identificatore.

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

Aggiorna costo e fornitore

Aggiorna i campi della risorsa tramite JSON Merge Patch.

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

Ottieni costo e fornitore per ID

Recupera una singola risorsa tramite il suo identificatore.

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

Elenca costi e fornitori

Recupera la raccolta di risorse CostGroup.

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

Crea costo e fornitore

Crea una risorsa CostGroup.

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

Crea validazione NIP

Crea una risorsa Cost.

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

Elenca ricerca

Recupera la raccolta di risorse Cost.

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

Ottieni costo e fornitore per ID

Recupera una singola risorsa tramite il suo identificatore.

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

Elimina costo e fornitore

Rimuovi la risorsa.

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

Aggiorna costo e fornitore

Aggiorna i campi della risorsa tramite JSON Merge Patch.

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

Elenca costi e fornitori

Recupera la raccolta di risorse CostGroup.

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

Crea costo e fornitore

Crea una risorsa CostGroup.

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

Crea assegnazione icone AI

Assegna icone ai gruppi di costo tramite AI.

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

Elenca grafico

Ottieni il grafico dei gruppi di costo.

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

Ottieni costo e fornitore per ID

Recupera una singola risorsa tramite il suo identificatore.

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

Aggiorna costo e fornitore

Aggiorna i campi della risorsa tramite JSON Merge Patch.

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

Ottieni costo e fornitore per ID

Recupera una singola risorsa tramite il suo identificatore.

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

Unisci gruppi di costo

Unisci gruppi di costo.

Casi d'uso

Sincronizza le fatture fornitore in record di costo per il monitoraggio in tempo reale dei margini.

Importa le tariffe dei collaboratori dall'approvvigionamento per automatizzare il costing dei progetti.

Campi dello schema

Cost-cost.read_cost_group.read

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

Panoramica entità

Transazione

Integra i dati delle transazioni tra sistemi bancari ed ERP per mantenere aggiornati il controllo delle spese e il reporting sui margini.

Endpoint

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

Elenca transazioni

Recupera la raccolta di risorse TransactionAttachment.

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

Crea transazione

Crea una risorsa TransactionAttachment.

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

Crea importazione

Crea una risorsa Transaction.

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

Elenca non assegnate

Recupera la raccolta di risorse Transaction.

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

Elenca con problemi

Recupera la raccolta di risorse Transaction.

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

Ottieni transazione per ID

Recupera una singola risorsa tramite il suo identificatore.

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

Elimina transazione

Rimuovi la risorsa.

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

Aggiorna transazione

Aggiorna i campi della risorsa tramite JSON Merge Patch.

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

Ottieni transazione per ID

Recupera una singola risorsa tramite il suo identificatore.

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

Crea una risorsa TransactionAttachment.

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

Ottieni transazione per ID

Recupera una singola risorsa tramite il suo identificatore.

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

Crea una risorsa TransactionAttachment.

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

Crea una risorsa TransactionAllocationPreviewInput.

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

Elenca transazioni

Recupera la raccolta di risorse TransactionAttachment.

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

Crea transazione

Crea una risorsa TransactionAttachment.

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

Crea creazione

Crea una risorsa TransactionAttachment.

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

Elenca ricerca

Recupera la raccolta di risorse TransactionAttachment.

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

Ottieni transazione per ID

Recupera una singola risorsa tramite il suo identificatore.

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

Elimina transazione

Rimuovi la risorsa.

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

Aggiorna transazione

Aggiorna i campi della risorsa tramite JSON Merge Patch.

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

Crea una risorsa TransactionAttachment.

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

Crea una risorsa TransactionAttachment.

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

Crea una risorsa TransactionAttachment.

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

Crea una risorsa TransactionAttachment.

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

Ottieni transazione per ID

Recupera una singola risorsa tramite il suo identificatore.

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

Ottieni transazione per ID

Recupera una singola risorsa tramite il suo identificatore.

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

Crea una risorsa TransactionAttachment.

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

Crea zip

Scarica gli allegati delle transazioni come zip.

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

Elenca MT940

Recupera una risorsa TransactionMt940Export.

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

Elenca PDF

Recupera una risorsa TransactionPdfExport.

Casi d'uso

Sincronizza le transazioni registrate con gli strumenti di chiusura mensile per una riconciliazione più rapida.

Alimenta i flussi di transazioni negli avvisi di budget e nelle visualizzazioni di redditività in tempo reale.

Campi dello schema

TransactionAttachment-transaction.read_transaction_attachment.read_cost.read_storage.read

Campo	Tipo	Descrizione
`id`	integer	Campo id.
`cost`	object	Campo cost.
`counterparty`	object	Campo counterparty.
`currency`	string \| null	Campo currency.
`relatedMonth`	string \| null	Campo relatedMonth.
`externalId`	string	Campo externalId.
`employee`	string \| null	Campo employee.
`amount`	integer \| null	Campo amount.
`amountNet`	integer \| null	Campo amountNet.
`name`	string	Campo name.
`description`	string	Campo description.
`note`	string \| null	Campo note.
`receivedAt`	string	Campo receivedAt.
`approvalsCount`	integer	Campo approvalsCount.
`suggestionsCount`	integer	Campo suggestionsCount.
`sourceType`	string	—
`type`	string	—
`paidAt`	string \| null	—
`transaction`	object	—
`invoiceLines`	array	—
`createdAt`	string	—
`counterpartyName`	string \| null	—
`status`	string	—

Panoramica entità

Conto bancario

Gestisci i record dei conti bancari utilizzati per l'instradamento dei pagamenti, la riconciliazione e il reporting della tesoreria.

Endpoint

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

Elenca conti bancari

Recupera la raccolta di risorse BankAccount.

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

Crea conto bancario

Crea una risorsa BankAccount.

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

Ottieni conto bancario per ID

Recupera una singola risorsa tramite il suo identificatore.

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

Aggiorna conto bancario

Aggiorna i campi della risorsa tramite JSON Merge Patch.

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

Elenca conti bancari

Recupera la raccolta di risorse BankAccount.

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

Crea conto bancario

Crea una risorsa BankAccount.

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

Ottieni conto bancario per ID

Recupera una singola risorsa tramite il suo identificatore.

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

Aggiorna conto bancario

Aggiorna i campi della risorsa tramite JSON Merge Patch.

Casi d'uso

Registra nuovi conti bancari dal tuo sistema di tesoreria per l'abbinamento dei pagamenti.

Sincronizza i saldi dei conti per le previsioni di cash flow in Flowtly.

Campi dello schema

BankAccount-bank_account.read_bank.read

Campo	Tipo	Descrizione
`id`	integer	Campo id.
`bank`	object	Campo bank.
`type`	string	Campo type.
`default`	boolean	Campo default.
`hidden`	boolean	Campo hidden.
`name`	string	Campo name.
`number`	string \| null	Campo number.
`prefix`	string \| null	Campo prefix.
`currency`	string \| null	Campo currency.
`defaultImportFormat`	string	Campo defaultImportFormat.

Panoramica entità

Gruppo fiscale e regola

Definisci gruppi fiscali con regole associate per un calcolo accurato delle imposte su fatture e transazioni.

Endpoint

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

Elenca gruppi fiscali e regole

Recupera la raccolta di risorse TaxRule.

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

Crea gruppo fiscale e regola

Crea una risorsa TaxRule.

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

Ottieni gruppo fiscale e regola per ID

Recupera una singola risorsa tramite il suo identificatore.

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

Aggiorna gruppo fiscale e regola

Aggiorna i campi della risorsa tramite JSON Merge Patch.

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

Elenca gruppi fiscali e regole

Recupera la raccolta di risorse TaxRule.

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

Crea gruppo fiscale e regola

Crea una risorsa TaxRule.

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

Ottieni gruppo fiscale e regola per ID

Recupera una singola risorsa tramite il suo identificatore.

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

Elimina gruppo fiscale e regola

Rimuovi la risorsa.

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

Aggiorna gruppo fiscale e regola

Aggiorna i campi della risorsa tramite JSON Merge Patch.

Casi d'uso

Importa le tabelle delle aliquote IVA dal tuo sistema contabile per una fatturazione coerente.

Configura regole fiscali specifiche per paese per la fatturazione multi-giurisdizione.

Campi dello schema

TaxGroup-tax_group.read_tax_rule.read

Campo	Tipo	Descrizione
`id`	string	Campo id.
`name`	string	Campo name.
`isDefault`	boolean	Campo isDefault.
`taxRules`	array	Campo taxRules.

Panoramica entità

Valuta

Interroga le valute disponibili utilizzate in fatture, budget e transazioni.

Endpoint

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

Elenca valute

Recupera la raccolta di risorse Currency.

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

Ottieni valuta per ID

Recupera una singola risorsa tramite il suo identificatore.

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

Ottieni valuta per ID

Recupera una singola risorsa tramite il suo identificatore.

Casi d'uso

Cerca le valute supportate prima di creare fatture multi-valuta.

Sincronizza i tassi di cambio per il reporting finanziario consolidato.

Campi dello schema

Currency-currency.read

Campo	Tipo	Descrizione
`id`	string	Campo id.
`name`	string	Campo name.