Fatturazione e pagamenti – 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à.

Fatturazione e pagamenti

Ciclo di vita delle fatture, righe, transazioni, fatturazione elettronica e metodi di pagamento.

Panoramica entità

Fattura

Esponi i dati del ciclo di vita delle fatture affinché finanza, operations e team cliente condividano un'unica fonte di verità sui ricavi fatturati.

Endpoint

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

Crea invio

Crea una risorsa Invoice.

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

Elenca fatture

Recupera la raccolta di risorse Invoice.

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

Crea fattura

Crea una risorsa Invoice.

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

Elenca bozze

Recupera la raccolta di risorse Invoice.

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

Ottieni fattura per ID

Recupera una singola risorsa tramite il suo identificatore.

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

Crea invio

Crea una risorsa Invoice.

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

Ottieni fattura per ID

Recupera una singola risorsa tramite il suo identificatore.

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

Elimina fattura

Rimuovi la risorsa.

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

Aggiorna fattura

Aggiorna i campi della risorsa tramite JSON Merge Patch.

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

Ottieni fattura per ID

Recupera una singola risorsa tramite il suo identificatore.

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

Crea una risorsa Invoice.

Crea una risorsa Invoice.

Casi d'uso

Sincronizza le fatture nei dashboard BI per monitorare i crediti scaduti e il rischio di cash flow.
Attiva workflow di promemoria ai clienti quando lo stato della fattura cambia in Flowtly.

Campi dello schema

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

Panoramica entità

Riga fattura

Gestisci le righe delle fatture con quantità, prezzo unitario, imposta e descrizione per un controllo granulare della fatturazione.

Endpoint

GET https://api.flowtly.eu/invoice-rows

Elenca righe fattura

Recupera la raccolta di risorse InvoiceRow.

POST https://api.flowtly.eu/invoice-rows

Crea riga fattura

Crea una risorsa InvoiceRow.

GET https://api.flowtly.eu/invoice-rows/{id}

Ottieni riga fattura per ID

Recupera una singola risorsa tramite il suo identificatore.

PATCH https://api.flowtly.eu/invoice-rows/{id}

Aggiorna riga fattura

Aggiorna i campi della risorsa tramite JSON Merge Patch.

Casi d'uso

Genera righe fattura dai fogli presenze approvati automaticamente.
Invia correzioni di singole voci dal tuo sistema contabile.

Campi dello schema

InvoiceRow-invoice.read_invoice_row.read_invoice_transaction.read_transaction.read_storage.read
Campo Tipo Descrizione
id integer Campo id.
classificationNumber string | null Campo classificationNumber.
unit string | null Campo unit.
quantity number Campo quantity.
vatRate string Campo vatRate.
netPrice string Campo netPrice.
netDiscountAmount string Campo netDiscountAmount.
productName string Campo productName.
project string | null Campo project.
parentInvoiceRow object Campo parentInvoiceRow.
invoiceChildrenRows array Campo invoiceChildrenRows.

Panoramica entità

Transazione fattura

Tieni traccia di quali transazioni bancarie saldano quali fatture per la riconciliazione automatica.

Endpoint

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

Elenca transazioni fattura

Recupera la raccolta di risorse InvoiceTransaction.

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

Crea transazione fattura

Crea una risorsa InvoiceTransaction.

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

Ottieni transazione fattura per ID

Recupera una singola risorsa tramite il suo identificatore.

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

Elimina transazione fattura

Rimuovi la risorsa.

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

Aggiorna transazione fattura

Aggiorna i campi della risorsa tramite JSON Merge Patch.

Casi d'uso

Abbina i pagamenti in entrata alle fatture aperte dal tuo feed bancario.
Riconcilia pagamenti parziali e sovrapagamenti su insiemi di fatture.

Campi dello schema

InvoiceTransaction-invoice.read_invoice_row.read_invoice_transaction.read_transaction.read_storage.read
Campo Tipo Descrizione
id integer Campo id.
invoice object Campo invoice.
transaction object Campo transaction.
amount number | null Campo amount.
date string Campo date.

Panoramica entità

E-invoicing (KSeF)

Invia, ricevi e interroga le fatture elettroniche tramite la piattaforma governativa KSeF per la conformità fiscale.

Endpoint

GET https://api.flowtly.eu/e-invoicing/invoices/inbound/download/xml

Elenca XML

Recupera la raccolta di risorse InvoiceDownload.

GET https://api.flowtly.eu/e-invoicing/invoices/inbound/{id}/download/upo

Ottieni e-invoicing (KSeF) per ID

Recupera una singola risorsa tramite il suo identificatore.

GET https://api.flowtly.eu/e-invoicing/invoices/inbound/{id}/download/xml

Ottieni e-invoicing (KSeF) per ID

Recupera una singola risorsa tramite il suo identificatore.

POST https://api.flowtly.eu/e-invoicing/invoices/inbound/queue

Crea coda

Crea una risorsa InboundInvoiceQueue.

POST https://api.flowtly.eu/e-invoicing/invoices/inbound/sync

Crea sincronizzazione

Crea una risorsa InboundInvoiceSync.

POST https://api.flowtly.eu/e-invoicing/invoices/{id}/correction

Crea una risorsa InvoiceCorrectionSend.

Crea una risorsa InvoiceCorrectionSend.

GET https://api.flowtly.eu/e-invoicing/invoices/download/xml

Elenca XML

Recupera la raccolta di risorse InvoiceDownload.

GET https://api.flowtly.eu/e-invoicing/invoices/{id}/download/pdf

Ottieni e-invoicing (KSeF) per ID

Recupera una singola risorsa tramite il suo identificatore.

GET https://api.flowtly.eu/e-invoicing/invoices/{id}/download/preview/pdf

Ottieni e-invoicing (KSeF) per ID

Recupera una singola risorsa tramite il suo identificatore.

GET https://api.flowtly.eu/e-invoicing/invoices/{id}/download/upo

Ottieni e-invoicing (KSeF) per ID

Recupera una singola risorsa tramite il suo identificatore.

GET https://api.flowtly.eu/e-invoicing/invoices/{id}/download/xml

Ottieni e-invoicing (KSeF) per ID

Recupera una singola risorsa tramite il suo identificatore.

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

Crea una risorsa InvoiceSend.

Crea una risorsa InvoiceSend.

POST https://api.flowtly.eu/e-invoicing/ksef/session

Crea sessione

Crea una risorsa KsefSession.

Casi d'uso

Invia automaticamente le fatture di vendita a KSeF e archivia la ricevuta UPO ufficiale.
Scarica le fatture di acquisto in entrata da KSeF nel tuo workflow AP.

Campi dello schema

InvoiceEInvoicing.jsonld-invoice.read_invoice_row.read_invoice_transaction.read_transaction.read_storage.read
Campo Tipo Descrizione
@context object —
@id string —
@type string —
id integer —
provider string —
status string —
referenceNumber string | null —
documentId string | null —
acquisitionTimestamp string | null —
upoUrl string | null —
verificationLink string | null —
rejectionReason string | null —
providerPayload array | null —
einvoicingNumber string | null —

Panoramica entità

Metodo di pagamento

Configura i metodi di pagamento (bonifico bancario, carta, ecc.) e tieni traccia delle transazioni di pagamento.

Endpoint

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

Elenca metodi di pagamento

Recupera la raccolta di risorse PaymentMethod.

GET https://api.flowtly.eu/payment-methods

Elenca metodi di pagamento

Recupera la raccolta di risorse PaymentMethod.

POST https://api.flowtly.eu/payment-methods/create-setup-intent

Crea setup intent

Crea una risorsa PaymentMethod.

GET https://api.flowtly.eu/payment-methods/{id}

Ottieni metodo di pagamento per ID

Recupera una singola risorsa tramite il suo identificatore.

DELETE https://api.flowtly.eu/payment-methods/{id}

Elimina metodo di pagamento

Rimuovi la risorsa.

PATCH https://api.flowtly.eu/payment-methods/{id}

Aggiorna metodo di pagamento

Aggiorna i campi della risorsa tramite JSON Merge Patch.

Casi d'uso

Imposta i termini di pagamento predefiniti per cliente per la generazione delle fatture.
Interroga lo storico dei pagamenti per gli estratti conto dei clienti.

Campi dello schema

PaymentMethod-payment_method.read
Campo Tipo Descrizione
id string Campo id.
type string Campo type.
ccBrand string Campo ccBrand.
ccLastDigits string Campo ccLastDigits.
ccExpMonth integer Campo ccExpMonth.
ccExpYear integer Campo ccExpYear.
externalId string Campo externalId.
Whatsapp