Documentatie
onFact.BE
onFact.BE
  • Welkom
  • Tutorial 1: start met de basis
    • 1. Account aanmaken
    • 2. Klant aanmaken
    • 3. Product/dienst aanmaken
    • 4. Factuur aanmaken
    • 5. Lay-out instellen
    • 6. Betalingsopvolging
    • 7. Aan de slag met onFact
  • Tutorial 2: automatiseer en win tijd
  • Tutorial 3: verwerk je aankopen
  • Basismodules
  • Klanten
  • Producten
    • Hoe kan ik mijn productlijst updaten (bv. prijswijzigingen)?
  • Offertes
  • Facturen
  • Creditnota's
  • Betalingen
    • Betalingen verwerken
    • Rekeningen
      • Kasboek (overzicht cash transacties)
    • QR-code op facturen
  • Apps - Uitbreidingen
    • ! Apps en koppelingen activeren
      • Zijn alle apps en koppelingen in onFact gratis?
    • Abonnementen (periodieke facturen)
    • Aankoopborderellen
    • Aankopen
      • Aankopen invoeren
        • Hoe kan ik een foto uploaden van een aankoopdocument?
        • Kan je de productwinstmarge invoeren om verkoopprijs automatisch te berekenen?
      • Aankopen verwerken
      • Aankopen betalen
      • Aankopen exporteren voor boekhouding
    • Agenda
    • Andere munteenheden
    • Anderstalige klanten
    • Barcode scanner
    • Betalingsverzoeken
    • Bestelbonnen
    • Climapulse
    • Dagontvangstenboek
    • Datumselectie per lijn
    • Extra tekstvelden
      • Hoe kan ik (een) tussentitel(s) invoegen in documenten?
    • Grootboekrekeningen
    • Incassodienst
    • Inkooporders
    • Kassatickets
    • Kortingen
    • Leeggoed
    • Leveringsadressen
    • Leveringsbonnen
    • Leveringsdatum
    • Maateenheden
    • MailChimp
    • Offerteaanvragen
    • Orderreferentie
    • Periodieke onderhouden
    • Productfoto's
    • Projecten
    • Prospecten
    • Samengestelde producten
    • Staffelprijzen
    • Standaard e-mails
    • Stockbeheer
    • Taken
    • Tijdsregistratie
    • Twikey
    • Werfadressen
    • Werkbonnen
  • Instellingen
    • Dashboard
    • Persoonlijke instellingen
      • Hoe kan ik mijn login e-mailadres aanpassen?
    • Mijn abonnement
      • Mijn bedrijfsvorm is gewijzigd, wat nu?
      • Beveel onFact aan
    • Bedrijfsinformatie
    • Standaardwaarden
    • E-mailinstellingen
      • Verzendopties
        • Via algemeen onFact-adres
        • Via e-mailadres eigen domeinnaam (server 1)
        • Via e-mailadres eigen domeinnaam (server 2)
        • Verzenden via Microsoft
        • Verzenden via Google
        • Via e-mailadres bij andere provider (SMTP)
          • Verzenden via Telenet
          • Verzenden via Skynet
      • E-mailteksten
      • Standaard CC en BCC
      • E-mailtemplates
    • Bijlagen
      • Hoe kan ik mijn algemene voorwaarden toevoegen?
    • Dagboeken
    • Automatische herinneringen
    • Gebruikers
    • Aangepaste velden bij contacten
    • Wettelijke vermeldingen
    • GDPR
    • Gegevens importeren
      • Hoe kan ik mijn bestaande klanten, producten, facturen, ... naar onFact migreren?
      • Hoe maak ik een CSV bestand?
    • Thema
    • Nummering
      • Kan ik mijn eigen productnummers gebruiken in onFact?
      • Mijn laatste factuur had nr.115, hoe kan ik in onFact starten met factuur nr. 116?
  • Koppelingen
    • Koppeling met de bank
      • CodaBox
      • Ponto
    • Koppeling met de boekhouder
      • Accowin
      • Acta-B LEXAct
      • Admisol
      • Adix
      • Adsolut
      • Allegro
      • Basecone
      • BillToBox
      • Briljant Account
      • ClearFacts
      • CodaBox boekhouding
      • ExactOnline
        • Meerdere onFact accounts koppelen met ExactOnline
        • Foutcodes
      • Exact ProAcc
      • Expert/M
      • Horus
      • Lyanthe
      • Octopus
      • OfficeM (Intradev)
      • Pingwin 5
      • Sage BOB (50)
      • SnelStart
      • Syscom Silicon Financial
      • Tax Advisor
      • Top Account
      • Twinfield
      • Venice
      • VeroCount
      • WinAuditor
      • WinBooks Connect
      • Wings
      • Yuki
      • Zenvoices
    • Koppeling voor online betaling
      • Mollie
        • Mollie betaalterminal
        • Mollie QR code op factuur
      • Payconiq
      • SEPA EPC QR
    • Koppeling met leveranciers
      • APOK
      • Cebeo
      • Desco
      • Facq
      • Rexel
      • STG
      • Van Marcke
    • Koppeling met een webshop
      • Shopify
        • Btw-nummers in Shopify
      • WooCommerce
    • Back-up & synchronisatie
      • onFact Drive
      • Google Drive
      • DropBox
      • SFTP (eigen server)
      • OneDrive
    • Bedrijfsdocumenten
      • E-Box Enterprise
  • Overige functies
    • PEPPOL
      • Aanmelding & verificatie PEPPOL
      • Verzenden via PEPPOL
      • Ontvangen via PEPPOL
    • API
    • Btw-nummer opzoeken
    • Filters
      • Hoe maak ik een extra kolom in overzicht documenten?
      • Hoe zie ik welke documenten ik al doorgestuurd heb naar de boekhouder?
    • Gegevens exporteren
    • Mobiele app
      • Hoe kan ik een foto uploaden van een aankoopdocument?
      • Hoe voeg ik een snelkoppeling toe aan mijn startscherm?
    • Online ondertekenen
    • Rapporten
    • Tags
      • Hoe vermeld ik een gestructureerde mededeling op mijn facturen?
    • Verwerklijsten
    • Verzending via e-mail
    • Verzending via post
  • TEMPLATES
    • Gebruik van templates in onFact
      • Hoe verander ik de standaard volgorde van mijn templates?
      • Kan ik een standaard template instellen per dagboek?
    • Templates afstemmen op je huisstijl
      • Documenttemplates
        • Hoe kan ik een tweede rekeningnummer op mijn documenten plaatsen?
      • E-mailtemplates
        • Hoe kan ik een logo toevoegen aan mijn uitgaande e-mails?
      • Templates aanpassen via interne code
  • VEELGESTELDE VRAGEN (F.A.Q.)
    • Overzicht veelgestelde vragen
Powered by GitBook
On this page
  • Authenticatie
  • Facturen ophalen
  • URL Extensies
  • Factuurdetails ophalen
  • Speciale functies
  • Factuur maken

Was this helpful?

Export as PDF
  1. Overige functies

API

PreviousOntvangen via PEPPOLNextBtw-nummer opzoeken

Last updated 2 years ago

Was this helpful?

Met de onFact API is het mogelijk om via een extern programma op een geautomatiseerde manier functies binnen onFact aan te spreken. Zo kan een extern programma bijvoorbeeld, op een beveiligde manier, klantenlijsten ophalen, nieuwe klanten aanmaken of documenten aanmaken.

Een "API" is een technische interface die aangesproken kan worden vanuit een extern programma. Om de API aan te spreken is technische kennis vereist en zal je vanuit het externe programma nieuwe functies moeten programmeren om deze API aan te spreken.

De "API" volgt de klassieke REST-architectuur. De gedetailleerde informatie van elke API-functie is te vinden via volgende link:

Authenticatie

API-Key authenticatie

De eenvoudigste manier om de koppeling the authenticeren is via een API-Key. Deze methode is bedoeld voor koppelingen die specifiek voor 1 bedrijf, door het bedrijf ontwikkeld zijn. Indien u een koppeling ontwikkeld met onFact voor meerdere gebruikers, dan gebruikt u best de 'oAuth 2.0 authenticatie'.

Voor authenticatie via API-key moet u twee headers toevoegen aan elke request: de X-SESSION-KEY en de X-COMPANY-UUID header. Deze zijn te vinden in onFact via het menu rechtsboven 'Persoonlijke instellingen'.

Facturen ophalen

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

Haal een lijst op met facturen

Headers

Name
Type
Description

X-COMPANY-UUID

string

UUID van het bedrijf

X-SESSION-KEY

string

API Key

{...}

URL Extensies

De REST API beschrijft de resource endpoints zonder extensie, deze moet nog toegevoegd worden aan de URL. De extensie bepaalt het formaat waarin de resources worden weergegeven. In vrijwel alle gevallen zal u de .json extensie moeten toevoegen aan de URL. Voor documenten kunt u ook de .pdf, .html of .xml extentie gebruiken.

Om een factuur op te halen in json formaat zal je dus volgende request moeten gebruiken:

Factuurdetails ophalen

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

Haal de informatie op van 1 factuur

Path Parameters

Name
Type
Description

id

string

Factuur ID

Headers

Name
Type
Description

X-SESSION-KEY

string

API Key

X-COMPANY-UUID

string

UUID Van het bedrijf

Speciale functies

Om het API gebruik te vereenvoudigen, zijn er enkele speciale functies ingebouwd bij het aanmaken van documenten. Zo kan je onmiddellijk bij het aanmaken van een document een actie meegeven zodat onFact het aangemaakte document koppelt aan een klantenfiche of een nieuwe klantenfiche aanmaakt wanneer er geen bestaat. Hiervoor geef je de header X-ACTIONS mee met de waardeFIND-OR-CREATE-CUSTOMER.

Mogelijke waarden zijn:

  • CREATE-CUSTOMER

  • FIND-OR-CREATE-CUSTOMER

  • UPDATE-CUSTOMER

  • FIND-PRODUCTS

  • USE-FIRST-DESCRIPTION

  • USE-FIRST-TOPTEXT-DESCRIPTION

Meerdere acties kunnen gecombineerd worden door deze te scheiden met een komma.

Factuur maken

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

Path Parameters

Name
Type
Description

id

string

Factuur ID

Headers

Name
Type
Description

X-ACTIONS

string

FIND-OR-CREATE-CUSTOMER

X-SESSION-KEY

string

API Key

X-COMPANY-UUID

string

UUID Van het bedrijf

{
    "id": 123,
    "code": "Created"
}
API Reference
onfact | Stoplight
Logo