Aller au contenu

Facturation & paiements – 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.

Facturation & paiements

Cycle de vie des factures, lignes, transactions, facturation électronique et méthodes de paiement.

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

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

Créer et envoyer

Crée une ressource Facture.

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/draft

Lister les brouillons

Récupère la collection de ressources Invoice.

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

Lire une facture par ID

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

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

Créer et envoyer

Crée une ressource Facture.

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

Lire une facture par ID

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

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

Supprimer la facture

Supprime la ressource.

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/{id}/send

Lire une facture par ID

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

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

Crée une ressource Facture.

Crée une ressource Facture.

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 champ de l'ID.
name string champ du nom.
type string champ du type.
parent object champ du parent.
childrenInvoices array champ des factures enfants.
client string champ du client.
tinType string champ du type de TIN.
tinCountry string | null champ du pays du TIN.
tin string | null champ du TIN.
bankAccount string champ du compte bancaire.
amountNet number champ du montant net.
amount number champ du montant.
currency string | null champ de la devise.
conversionRate number | null champ du taux de conversion.
generatedPdfExternalId string | null champ de l'ID externe du PDF généré.
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

Vue d’ensemble

Ligne de facture

Gérez les lignes de facture avec la quantité, le prix unitaire, la taxe et la description pour un contrôle granulaire de la facturation.

Endpoints

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

Lister les lignes de facture

Récupère la collection de ressources Ligne de facture.

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

Créer une ligne de facture

Crée une ressource Ligne de facture.

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

Obtenir une ligne de facture par ID

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

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

Mettre à jour une ligne de facture

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

Cas d’usage

Générer automatiquement des lignes de facture à partir de feuilles de temps approuvées.
Pousser les corrections de postes depuis votre système comptable.

Champs du schéma

InvoiceRow-invoice.read_invoice_row.read_invoice_transaction.read_transaction.read_storage.read
Champ Type Description
id integer champ de l'ID.
classificationNumber string | null champ du numéro de classification.
unit string | null champ de l'unité.
quantity number champ de la quantité.
vatRate string Champ vatRate.
netPrice string champ du prix net.
netDiscountAmount string champ du montant net de la réduction.
productName string champ du nom du produit.
project string | null champ du projet.
parentInvoiceRow object champ de la ligne de facture parente.
invoiceChildrenRows array champ des lignes de facture enfants.

Vue d’ensemble

Transaction de facture

Suivre quelles transactions bancaires règlent quelles factures pour une réconciliation automatisée.

Endpoints

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

Lister les transactions de facture

Récupère la collection de ressources InvoiceTransaction.

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

Créer une transaction de facture

Crée une ressource InvoiceTransaction.

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

Obtenir une transaction de facture par ID

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

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

Supprimer la transaction de facture

Supprimer la ressource.

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

Mettre à jour la transaction de facture

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

Cas d’usage

Faire correspondre les paiements entrants aux factures ouvertes depuis votre flux bancaire.
Réconcilier les paiements partiels et les trop-payés sur l'ensemble des factures.

Champs du schéma

InvoiceTransaction-invoice.read_invoice_row.read_invoice_transaction.read_transaction.read_storage.read
Champ Type Description
id integer Champ id.
invoice object Champ facture.
transaction object Champ transaction.
amount number | null Champ montant.
date string Champ date.

Vue d’ensemble

Facturation électronique (KSeF)

Envoyez, recevez et interrogez des factures électroniques via la plateforme gouvernementale KSeF pour la conformité fiscale.

Endpoints

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

Lister les xml

Récupère la collection de ressources InvoiceDownload.

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

Obtenir la facturation électronique (KSeF) par ID

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

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

Obtenir la facturation électronique (KSeF) par ID

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

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

Créer une file d'attente

Crée une ressource InboundInvoiceQueue.

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

Créer une synchronisation

Crée une ressource InboundInvoiceSync.

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

Crée une ressource InvoiceCorrectionSend.

Crée une ressource InvoiceCorrectionSend.

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

Lister les xml

Récupère la collection de ressources InvoiceDownload.

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

Obtenir la facturation électronique (KSeF) par ID

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

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

Obtenir la facturation électronique (KSeF) par ID

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

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

Obtenir la facturation électronique (KSeF) par ID

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

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

Obtenir la facturation électronique (KSeF) par ID

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

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

Crée une ressource InvoiceSend.

Crée une ressource InvoiceSend.

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

Créer une session

Crée une ressource KsefSession.

Cas d’usage

Soumettez automatiquement les factures de vente à KSeF et stockez le reçu officiel UPO.
Téléchargez les factures d'achat entrantes de KSeF dans votre flux de travail de comptabilité fournisseurs.

Champs du schéma

InvoiceEInvoicing.jsonld-invoice.read_invoice_row.read_invoice_transaction.read_transaction.read_storage.read
Champ Type Description
@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

Vue d’ensemble

Méthode de paiement

Configurez les méthodes de paiement (virement bancaire, carte, etc.) et suivez les transactions de paiement.

Endpoints

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

Lister les méthodes de paiement

Récupère la collection de ressources PaymentMethod.

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

Lister les méthodes de paiement

Récupère la collection de ressources PaymentMethod.

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

Créer créer un setup intent

Crée une ressource PaymentMethod.

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

Obtenir la méthode de paiement par ID

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

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

Supprimer la méthode de paiement

Supprime la ressource.

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

Mettre à jour la méthode de paiement

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

Cas d’usage

Définir les conditions de paiement par défaut par client pour la génération de factures.
Interroger l'historique des paiements pour les relevés de compte client.

Champs du schéma

PaymentMethod-payment_method.read
Champ Type Description
id string champ id.
type string champ type.
ccBrand string champ ccBrand.
ccLastDigits string champ ccLastDigits.
ccExpMonth integer champ ccExpMonth.
ccExpYear integer champ ccExpYear.
externalId string champ externalId.
Whatsapp