--- title: Stap voor stap aan de slag met de Minox API description: Hoe zet ik een API koppeling op tussen onze software en Minox? --- [Overslaan naar inhoud](https://klanten.minox.nl/nl/wiki/stap-voor-stap-aan-de-slag-met-de-minox-api#main-content) Nederlands Submenu tonen voor vertalingen [Klantenportal](https://klanten.minox.nl/support?hsLang=nl) ![Middel 1@3x.png\]](https://klanten.minox.nl/hs-fs/hubfs/Middel%201@3x.png?height=40&name=Middel%201@3x.png) Hoofdnavigatie openen Hoofdnavigatie sluiten - Nederlands Submenu tonen voor vertalingen - [Klantenportal](https://klanten.minox.nl/support) Hoe kunnen we je helpen? - Er zijn geen suggesties want het zoekveld is leeg. 1. [Helpcentrum](https://klanten.minox.nl/nl/wiki?hsLang=nl) 2. [FAQ](https://klanten.minox.nl/nl/wiki/faq?hsLang=nl) 3. [Overig](https://klanten.minox.nl/nl/wiki/faq?hsLang=nl#overig) # Stap voor stap aan de slag met de Minox API ## Hoe zet ik een API koppeling op tussen onze software en Minox? #### Snel een Minox koppeling realiseren met de meest gebruikte endpoints in logische volgorde: 1. Oauth: een voorbeeldproject hoe je connectie maakt met Oauth van Minox vind je hier: [Minox client demo](https://github.com/jtinbergen/minox-client-demo) 2. Token: Admin | /inspect/{token} kun je bekijken tot welke tenants de token je toegang geeft (een token van een accountantstenant geeft ook toegang tot de bedrijven met een eigen licentie waar de accountant toegang toe heeft) 3. Lijst met administraties: Administration | /tenant/{tenant\_id}/administration (geeft ook informatie over boekjaren, perioden en startdatum / einddatum) 4. Lijst met grootboekrekeningen: Ledger| get /tenant/{tenant\_id}/administration/{administration\_id}/ledger\_account 5. Dagboek waar de journaalposten in moeten komen: Journal | Get 6. Klant aanmaken: Master data - customer (zie voorbeeld create customer.json) 7. Klant opvragen op emailadres of externalID of andere zoekcriteria: Master data - customer | Get 8. Journaalpost boeken: transaction\_line\_batch | Put (zie voorbeeld Batch transaction\_new.json voor een verkoopjournaalpost. Bij Minox kun je het beste niet werken met btw codes. De accountant / klant moet deze zelf goed instellen bij de grootboekrekeningen en dan werkt het voor jouw als koppelpartner automatisch goed) 9. Openstaandeposten opvragen: financial - receivable | Get (status open) 10. Openstaandeposten continue up-2-date houden: third party - webhook | Post → enige wat nodig is {"description": "string", "enabled": true, "url": "string", "retry\_in\_minutes": 120, "notifications": {"receivable": true, "payable": false}}. Hierna ontvang je op opgegeven url een update van de openstaande post als er een betaling in Minox wordt verwerkt. #### Stap voor stap aan de slag met de Swagger Minox API documentatie: 1. Ga naar [![](https://www.minox.nl/wp-content/uploads/2019/10/favicon-1.ico?v=4)Minox API Specification](https://app.minox.nl/docs/api/rest)  ![](https://klanten.minox.nl/hubfs/image-png-Nov-08-2022-08-50-21-5885-AM.png) 2. Klik op Authorize (OAuth). 3. Vink de voor de koppeling vereiste scopes aan en login als partner met uw partner client\_id en client\_secret. 4. Log vervolgens in als klant met de Minox credentials om toestemming te geven voor gevraagde "scopes". #### Na toestemming kun je eenvoudig de werking van de API proberen en bekijken hoe transacties in de Minox administratie landen. Hieronder laten we een voorbeeld zien: ![](https://klanten.minox.nl/hubfs/image-png-Nov-08-2022-08-51-11-0221-AM.png) - Klik op het administration endpoint en klik op "Try it out". - Geef in dit geval het Minox klantnummer op en je krijgt een lijst van administraties waar toegang toe nodig is terug. Je kunt op deze manier ieder endpoint uitproberen en bijvoorbeeld bekijken hoe een journaalpost in Minox wordt weergegeven op basis van de input in de JSON.  Voor het genereren van journaalposten zijn een aantal best practices opgesteld die je als ontwikkelaar helpen eenvoudig en onafhankelijk van de inrichting van Minox journaalposten in te schieten. Deze lichten we graag toe in het kennismakingsgesprek.   #### Voorbeeld batch transaction JSON: ![](https://klanten.minox.nl/hubfs/image-png-Nov-08-2022-08-53-34-3126-AM.png) #### Voorbeeld create customer JSON:![](https://klanten.minox.nl/hubfs/image-png-Nov-08-2022-08-54-55-3327-AM.png) - [Alles over de jaarovergang in Minox!](https://klanten.minox.nl/nl/wiki/alles-over-de-jaarovergang-in-minox?hsLang=nl#main-content) - [Aanmaken nieuw boekjaar](https://klanten.minox.nl/nl/wiki/alles-over-de-jaarovergang-in-minox?hsLang=nl#aanmaken-nieuw-boekjaar) - [Snel van start!](https://klanten.minox.nl/nl/wiki/snel-van-start?hsLang=nl#main-content) - [Algemeen](https://klanten.minox.nl/nl/wiki/snel-van-start?hsLang=nl#algemeen) - [Verkoop](https://klanten.minox.nl/nl/wiki/verkoop?hsLang=nl#main-content) - [Debiteuren](https://klanten.minox.nl/nl/wiki/verkoop?hsLang=nl#debiteuren) - [Offertes en facturen](https://klanten.minox.nl/nl/wiki/verkoop?hsLang=nl#offertes-en-facturen) - [Abonnementen](https://klanten.minox.nl/nl/wiki/verkoop?hsLang=nl#abonnementen) - [Orders](https://klanten.minox.nl/nl/wiki/verkoop?hsLang=nl#orders) - [Incasso](https://klanten.minox.nl/nl/wiki/verkoop?hsLang=nl#incasso) - [Inkoop](https://klanten.minox.nl/nl/wiki/inkoop?hsLang=nl#main-content) - [Betalen](https://klanten.minox.nl/nl/wiki/inkoop?hsLang=nl#betalen) - [Inkoopfacturen](https://klanten.minox.nl/nl/wiki/inkoop?hsLang=nl#inkoopfacturen) - [Bank](https://klanten.minox.nl/nl/wiki/bank?hsLang=nl#main-content) - [Bankenkoppeling](https://klanten.minox.nl/nl/wiki/bank?hsLang=nl#bankenkoppeling) - [Betalen](https://klanten.minox.nl/nl/wiki/bank?hsLang=nl#betalen) - [Bankbestanden](https://klanten.minox.nl/nl/wiki/bank?hsLang=nl#bankbestanden) - [Instellingen](https://klanten.minox.nl/nl/wiki/bank?hsLang=nl#instellingen) - [Boekhouden](https://klanten.minox.nl/nl/wiki/boekhouden?hsLang=nl#main-content) - [Boeken](https://klanten.minox.nl/nl/wiki/boekhouden?hsLang=nl#boeken) - [Vaste activa](https://klanten.minox.nl/nl/wiki/boekhouden?hsLang=nl#vaste-activa) - [Spreiden (Transitorische posten)](https://klanten.minox.nl/nl/wiki/boekhouden?hsLang=nl#spreiden-transitorische-posten) - [Belastingaangifte](https://klanten.minox.nl/nl/wiki/boekhouden?hsLang=nl#belastingaangifte) - [Marge](https://klanten.minox.nl/nl/wiki/boekhouden?hsLang=nl#marge) - [Documenten](https://klanten.minox.nl/nl/wiki/documenten?hsLang=nl#main-content) - [Layouts](https://klanten.minox.nl/nl/wiki/documenten?hsLang=nl#layouts) - [Dossier](https://klanten.minox.nl/nl/wiki/documenten?hsLang=nl#dossier) - [Rapporten](https://klanten.minox.nl/nl/wiki/documenten?hsLang=nl#rapporten) - [scan en herken](https://klanten.minox.nl/nl/wiki/documenten?hsLang=nl#scan-en-herken) - [Gebruikersaccount](https://klanten.minox.nl/nl/wiki/gebruikersaccount?hsLang=nl#main-content) - [Abonnement](https://klanten.minox.nl/nl/wiki/gebruikersaccount?hsLang=nl#abonnement) - [Rapportages](https://klanten.minox.nl/nl/wiki/rapportages?hsLang=nl#main-content) - [Extern](https://klanten.minox.nl/nl/wiki/rapportages?hsLang=nl#extern) - [Algemeen](https://klanten.minox.nl/nl/wiki/rapportages?hsLang=nl#algemeen) - [Grootboek](https://klanten.minox.nl/nl/wiki/rapportages?hsLang=nl#grootboek) - [Debiteuren](https://klanten.minox.nl/nl/wiki/rapportages?hsLang=nl#debiteuren) - [Activa](https://klanten.minox.nl/nl/wiki/rapportages?hsLang=nl#activa) - [Signaleringsoverzichten](https://klanten.minox.nl/nl/wiki/rapportages?hsLang=nl#signaleringsoverzichten) - [Verkoopstatistieken](https://klanten.minox.nl/nl/wiki/rapportages?hsLang=nl#verkoopstatistieken) - [Artikelen](https://klanten.minox.nl/nl/wiki/rapportages?hsLang=nl#artikelen) - [Facturering](https://klanten.minox.nl/nl/wiki/rapportages?hsLang=nl#facturering) - [Kostensoorten/plaatsen](https://klanten.minox.nl/nl/wiki/rapportages?hsLang=nl#kostensoorten-plaatsen) - [Crediteuren](https://klanten.minox.nl/nl/wiki/rapportages?hsLang=nl#crediteuren) - [Overstapservice](https://klanten.minox.nl/nl/wiki/overstapservice?hsLang=nl) - [Modules](https://klanten.minox.nl/nl/wiki/modules?hsLang=nl#main-content) - [BTW aangifte](https://klanten.minox.nl/nl/wiki/modules?hsLang=nl#btw-aangifte) - [Koppelingen](https://klanten.minox.nl/nl/wiki/koppelingen?hsLang=nl) - [Partner](https://klanten.minox.nl/nl/wiki/partner?hsLang=nl) - [FAQ](https://klanten.minox.nl/nl/wiki/faq?hsLang=nl#main-content) - [FAQ's : Scan en Herken](https://klanten.minox.nl/nl/wiki/faq?hsLang=nl#faqs-scan-en-herken) - [Scan en Herken](https://klanten.minox.nl/nl/wiki/faq?hsLang=nl#scan-en-herken) - [Jaarovergang](https://klanten.minox.nl/nl/wiki/faq?hsLang=nl#jaarovergang) - [Bankmutaties](https://klanten.minox.nl/nl/wiki/faq?hsLang=nl#bankmutaties) - [Bankenkoppeling](https://klanten.minox.nl/nl/wiki/faq?hsLang=nl#bankenkoppeling) - [Overig](https://klanten.minox.nl/nl/wiki/faq?hsLang=nl#overig) - [Toegang](https://klanten.minox.nl/nl/wiki/faq?hsLang=nl#toegang) - [Boeken](https://klanten.minox.nl/nl/wiki/faq?hsLang=nl#boeken) - [Rapportage](https://klanten.minox.nl/nl/wiki/faq?hsLang=nl#rapportage) - [Facturatie](https://klanten.minox.nl/nl/wiki/faq?hsLang=nl#facturatie) - [BTW](https://klanten.minox.nl/nl/wiki/faq?hsLang=nl#btw) - [Activa](https://klanten.minox.nl/nl/wiki/faq?hsLang=nl#activa) - [Documenten](https://klanten.minox.nl/nl/wiki/faq?hsLang=nl#documenten) - [Betalen](https://klanten.minox.nl/nl/wiki/faq?hsLang=nl#betalen) - [Help](https://klanten.minox.nl/nl/wiki/help?hsLang=nl#main-content) - [Administratie](https://klanten.minox.nl/nl/wiki/help?hsLang=nl#administratie) - [Onderhoud](https://klanten.minox.nl/nl/wiki/help?hsLang=nl#onderhoud) - [Taken](https://klanten.minox.nl/nl/wiki/help?hsLang=nl#taken) - [Beheer](https://klanten.minox.nl/nl/wiki/help?hsLang=nl#beheer) - [Opvragen](https://klanten.minox.nl/nl/wiki/help?hsLang=nl#opvragen) - [Tools & Tips](https://klanten.minox.nl/nl/wiki/help?hsLang=nl#tools-tips) - [Minox voor Windows](https://klanten.minox.nl/nl/wiki/minox-voor-windows?hsLang=nl#main-content) - [update-installatie](https://klanten.minox.nl/nl/wiki/minox-voor-windows?hsLang=nl#update-installatie) - [Onderhoud](https://klanten.minox.nl/nl/wiki/onderhoud?hsLang=nl#main-content) - [Bankenkoppeling](https://klanten.minox.nl/nl/wiki/onderhoud?hsLang=nl#bankenkoppeling) - [BTW](https://klanten.minox.nl/nl/wiki/onderhoud?hsLang=nl#btw) - [Release Notes](https://klanten.minox.nl/nl/wiki/release-notes?hsLang=nl#main-content) - [2026](https://klanten.minox.nl/nl/wiki/release-notes?hsLang=nl#2026) - [2025](https://klanten.minox.nl/nl/wiki/release-notes?hsLang=nl#2025) - [2024](https://klanten.minox.nl/nl/wiki/release-notes?hsLang=nl#2024) - [2023](https://klanten.minox.nl/nl/wiki/release-notes?hsLang=nl#2023) [![Chill listening crop-3](https://klanten.minox.nl/hs-fs/hubfs/icon.jpg?width=40&height=40&name=icon.jpg "Chill listening crop-3")](http://minox.nl) Wij doen ons uiterste best om alle relevante informatie voor onze klanten hier te delen. Mis je toch het antwoord op een vraag? Maak dan gelijk een ticket aan via het Klantenportaal. Copyright © 2026, Minox