enFact.be
  • Bienvenue
  • Tutoriel 1 : Le début
    • 1. Créer un compte
    • 2. Créer un client
    • 3. Créer un produit
    • 4. Créer une facture
    • 5. Définir la mise en page
    • 6. Suivi des paiements
    • 7. Démarrer avec enFact
  • Tutoriel 2 : Automatiser et gagner du temps
  • Tutoriel 3 : Traiter vos achats
  • MODULES DE BASE
    • Clients
    • Produits
      • Comment mettre à jour ma liste de produits (p.e. en cas de changement de prix) ?
    • Offres
      • Comment convertir une offre en facture ?
    • Factures
    • Notes de crédit
    • Paiements
      • Traitement des paiements
      • Comptes
        • Livre de caisse (transactions en espèces)
      • Code QR sur les factures
  • APPS - MODULES
    • ! Activer les apps et connexions
      • Toutes les apps et connexions dans enFact sont-ils gratuits ?
    • Abonnements (factures récurrentes)
    • Achats
      • Saisir les achats
        • Entrer une marge bénéficiaire pour calculer automatiquement le prix de vente
        • Puis-je saisir facilement des documents papier à traiter ?
      • Traiter les achats
      • Payer les achats
      • Exporter les achats pour la comptabilité
    • Adresses de livraison
    • Adresses de chantier
    • Agenda
    • Autres devises
    • Bons de livraison
    • Bordereaux d'achat
    • Champs de texte supplémentaires
      • Comment insérer un ou plusieurs intertitres dans les documents ?
    • Clients de langue étrangère
    • Climapulse
    • Comptes grand livre
    • Confirmations de commande
    • Courriels standard
    • Date de livraison
    • Demandes d'offre
    • Demandes de paiement
    • Emballage consigné
    • Enregistrement du temps
    • Gestion des stocks
    • Journal des recettes
    • Lecteur de code-barres
    • MailChimp
    • Maintenance périodique
    • Ordres d'achat
    • Ordres de travail
    • Photo de produit
    • Produits composites
    • Projets
    • Prospects
    • Recouvrement de créances
    • Référence de commande
    • Remises
    • Sélection d'une date par ligne
    • Tableaux de prix
    • Tâches
    • Tickets de caisse
    • Twikey
    • Unités de mesure
  • PARAMÈTRES
    • Tableau de bord
    • Paramètres personnels
      • Comment changer mon adresse e-mail de connexion ?
    • Mon abonnement
      • La forme de mon entreprise a changé, que faire ?
      • Recommandez enFact !
    • Informations sur l'entreprise
    • Valeurs par défaut
    • Paramètres du courriel
      • Options d'expédition
        • Adresse générale enFact
        • Votre nom de domaine (serveur 1)
        • Votre nom de domaine (serveur 2)
        • Par adresse Microsoft
        • Par adresse Google
        • Adresse serveur SMTP
      • Textes de courriel
      • Addresses cc: et bcc:
      • Modèles du courriel
    • Annexes
      • Comment ajouter mes conditions générales ?
    • Journaux
    • Des rappels automatiques
    • Utilisateurs
    • Champs personnalisés pour les contacts
    • Avis légaux
    • GDPR
    • Importer des données
      • Comment migrer mes clients, produits, factures, etc. existants vers enFact ?
      • Comment créer un fichier csv ?
    • Thème
    • Numérotation
      • Puis-je utiliser mes propres numéros de produits dans enFact ?
      • Ma dernière facture portait le numéro 115, comment commencer dans enFact avec la facture n°116?
    • Support / Assistance
  • CONNEXIONS
    • Connexion à votre banque
      • CodaBox
      • Ponto
    • Connexion à votre comptable
      • Accowin
      • Acta-B LEXAct
      • Adix
      • Admisol
      • Adsolut
      • Allegro
      • Basecone
      • BillToBox
      • Briljant Account
      • ClearFacts
      • CodaBox comptabilité
      • ExactOnline
        • ExactOnline pour les comptables
      • Exact ProAcc
      • Expert/M
      • Horus
      • Octopus
      • OfficeM (Intradev)
      • Sage BOB (50) / Ciel
      • Tax Advisor
      • Top Account
      • Twinfield
      • Venice
      • Vero Count
      • WinAuditor
      • Winbooks Connect
      • Wings
      • Yuki
      • Zenvoices
    • Connexion boutique en ligne
      • Shopify
        • Numéros de tva dans Shopify
      • WooCommerce
    • Connexions fournisseurs
      • APOK
      • Cebeo
      • Desco
      • Facq
      • Rexel
      • STG
      • Van Marcke
    • Connexion paiement en ligne
      • Mollie
        • Mollie terminal de paiement
        • Mollie code QR sur la facture
      • Payconiq
      • SEPA EPC QR
    • Documents d'entreprise
      • E-Box Enterprise
    • Synchronisation et sauvegarde
      • enFact Drive
      • Google Drive
      • DropBox
      • SFTP (votre propre serveur)
      • OneDrive
  • AUTRES FONCTIONS
    • PEPPOL
      • Inscription et vérification PEPPOL
      • Expédition par PEPPOL
      • Réception via PEPPOL
    • API
    • Rechercher le numéro de TVA
    • Signature en ligne
    • Balises
      • Comment placer une communication structurée sur mes documents ?
    • Exportation des données
    • Envoi par courriel
    • Envoi par courrier postale
    • Filtres
    • Listes de traitement
    • Rapports
    • Utilisation mobile
      • Comment télécharger une photo d'un document d'achat?
      • Comment ajouter un raccourci à mon écran d'accueil ?
  • MODÈLES
    • Utiliser les modèles enFact
      • Comment modifier l'ordre par défaut de mes modèles ?
    • Adapter les modèles à votre identité visuelle
      • Modèle de document
        • Comment ajouter un deuxième numéro de compte à mes documents ?
      • Modèle du courriel
        • Comment ajouter un logo aux e-mails sortants?
      • Personnalisation via code interne
  • QUESTIONS FRÉQUENTES (F.A.Q.)
    • Aperçu des F.A.Q.
Powered by GitBook
On this page
  • Authentification
  • Récupérer des factures
  • Extensions URL
  • Récupérer les détails de la facture
  • Fonctions spéciales
  • Créer une facture
  1. AUTRES FONCTIONS

API

PreviousRéception via PEPPOLNextRechercher le numéro de TVA

Last updated 2 years ago

L'API enFact permet à un programme externe d'accéder aux fonctions d'enFact de manière automatisée. Par exemple, un programme externe peut récupérer des listes de clients, créer de nouveaux clients ou créer des documents de manière sécurisée.

Une "API" est une interface technique qui peut être utilisée par une application tierce. Pour appeler l'API, des connaissances techniques sont nécessaires et vous devrez programmer de nouvelles fonctions à partir du programme externe pour appeler l'API.

L'API suit l'architecture REST classique. Les informations détaillées de chaque fonction API peuvent être trouvées via le lien swagger suivant :

Authentification

Authentification API-Key

Le moyen le plus simple d'authentifier le lien est d'utiliser une clé API. Cette méthode est destinée aux liens développés spécifiquement pour une entreprise, par cette entreprise. Si vous développez un lien multi-utilisateurs avec enFact, vous devez utiliser l'authentification 'oAuth 2.0'.

Pour l'authentification par clé API, vous devez ajouter deux en-têtes à chaque demande : l'en-tête X-SESSION-KEY et l'en-tête X-COMPANY-UUID. Vous pouvez les trouver dans enFact via le menu supérieur droit "Paramètres personnels".

Récupérer des factures

GET https://api5.onfact.be/v1/invoices.json

Obtenez une liste de factures

Headers

Name
Type
Description

X-COMPANY-UUID

String

UUID de l'entreprise

X-SESSION-KEY

String

API Key

{
    // Response
}

Extensions URL

L'API REST décrit les 'resource endpoints' sans extension, celle-ci doit être ajoutée à l'URL. L'extension détermine le format dans lequel les ressources sont affichées. Dans presque tous les cas, vous devrez ajouter l'extension .json à l'URL. Pour les documents, vous pouvez également utiliser l'extension .pdf, .html ou .xml.

Pour récupérer une facture au format json, vous devrez utiliser la requête suivante :

Récupérer les détails de la facture

GET https://api5.onfact.be/v1/invoices/:id.json

Obtenez les informations d'une facture

Path Parameters

Name
Type
Description

String

ID de facture

Headers

Name
Type
Description

X-SESSION-KEY

String

API Key

X-COMPANY-UUID

String

UUID de l'entreprise

{
    // Response
}

Fonctions spéciales

Pour simplifier l'utilisation de l'API, certaines fonctions spéciales sont intégrées lors de la création de documents. Lors de la création d'un document, vous pouvez immédiatement ajouter une action afin qu'enFact lie le document créé à un enregistrement client ou crée un nouvel enregistrement client s'il n'en existe pas. Pour ce faire, vous ajoutez le header X-ACTIONS avec la valeur FIND-OR-CREATE-CUSTOMER.

Les valeurs possibles sont :

  • CREATE-CUSTOMER

  • FIND-OR-CREATE-CUSTOMER

  • UPDATE-CUSTOMER

  • FIND-PRODUCTS

  • USE-FIRST-DESCRIPTION

  • USE-FIRST-TOPTEXT-DESCRIPTION

Plusieurs actions peuvent être combinées en les séparant par une virgule.

Créer une facture

POST https://api5.onfact.be/v1/invoices/:id.json

Path Parameters

Name
Type
Description

String

ID Facture

Headers

Name
Type
Description

X-ACTIONS

String

FIND-OR-CREATE-CUSTOMER

X-SESSION-KEY

String

API Key

X-COMPANY-UUID

String

UUID de l'entreprise

{
    // Response
}
API Reference
onfact | Stoplight
Logo