SnelStart MCP Server

# SnelStart B2B API v2 - Complete Endpoint Reference > Bron: https://b2bapi-developer.snelstart.nl/ > Laatst bijgewerkt: 24 januari 2026 ## Alle Endpoints Overzicht ### Actieprijzen | Endpoint | Method | OData | Beschrijving | |----------|--------|-------|--------------| | `/v2/actieprijzen` | GET | ✅ | Alle beschikbare actieprijzen | ### Artikelen | Endpoint | Method | OData | Beschrijving | |----------|--------|-------|--------------| | `/v2/artikelen` | GET | ✅ | Alle artikelen | | `/v2/artikelen` | POST | - | Nieuw artikel aanmaken | | `/v2/artikelen/{id}` | GET | - | Specifiek artikel ophalen | | `/v2/artikelen/{id}` | PUT | - | Artikel wijzigen | | `/v2/artikelen/{id}` | DELETE | - | Artikel verwijderen | | `/v2/artikelen/{id}/customFields` | GET | - | Custom fields van artikel | | `/v2/artikelen/{id}/customFields` | PUT | - | Custom fields wijzigen | | `/v2/artikelen/prijsafspraken` | GET | ✅ | Prijsafspraken voor artikelen | ### Artikelomzetgroepen | Endpoint | Method | OData | Beschrijving | |----------|--------|-------|--------------| | `/v2/artikelomzetgroepen` | GET | - | Alle artikelomzetgroepen | | `/v2/artikelomzetgroepen/{id}` | GET | - | Specifieke artikelomzetgroep | ### Authorization | Endpoint | Method | OData | Beschrijving | |----------|--------|-------|--------------| | `/v2/authorization/HasUserAccessToAdministration` | GET | - | Check toegang tot administratie | ### Bankafschriftbestanden | Endpoint | Method | OData | Beschrijving | |----------|--------|-------|--------------| | `/v2/bankafschriftbestanden` | POST | - | Upload bankafschrift | ### Bankboekingen | Endpoint | Method | OData | Beschrijving | |----------|--------|-------|--------------| | `/v2/bankboekingen` | GET | ✅ | Alle bankboekingen | | `/v2/bankboekingen` | POST | - | Nieuwe bankboeking | | `/v2/bankboekingen/{id}` | GET | - | Specifieke bankboeking | | `/v2/bankboekingen/{id}` | PUT | - | Bankboeking wijzigen | | `/v2/bankboekingen/{id}` | DELETE | - | Bankboeking verwijderen | ### BTW Aangiftes | Endpoint | Method | OData | Beschrijving | |----------|--------|-------|--------------| | `/v2/btwaangiftes` | GET | ✅ | Alle BTW aangiftes | | `/v2/btwaangiftes/{id}` | GET | - | Specifieke BTW aangifte | | `/v2/btwaangiftes/{id}/externAangeven` | PUT | - | Extern aangeven markeren | ### BTW Tarieven | Endpoint | Method | OData | Beschrijving | |----------|--------|-------|--------------| | `/v2/btwtarieven` | GET | - | Alle BTW tarieven | ### Company Info | Endpoint | Method | OData | Beschrijving | |----------|--------|-------|--------------| | `/v2/companyInfo` | GET | - | Bedrijfsinformatie ophalen | | `/v2/companyInfo` | PUT | - | Bedrijfsinformatie wijzigen | ### Dagboeken | Endpoint | Method | OData | Beschrijving | |----------|--------|-------|--------------| | `/v2/dagboeken` | GET | - | Alle dagboeken | ### Documenten | Endpoint | Method | OData | Beschrijving | |----------|--------|-------|--------------| | `/v2/documenten/{documenttype}` | POST | - | Document uploaden | | `/v2/documenten/{documenttype}/{pid}` | GET | - | Document by type en pid | | `/v2/documenten/{id}` | GET | - | Document ophalen | | `/v2/documenten/{id}` | PUT | - | Document wijzigen | | `/v2/documenten/{id}` | DELETE | - | Document verwijderen | ### Echo (Test) | Endpoint | Method | OData | Beschrijving | |----------|--------|-------|--------------| | `/v2/echo/{input}` | GET | - | Echo test endpoint | ### Grootboeken | Endpoint | Method | OData | Beschrijving | |----------|--------|-------|--------------| | `/v2/grootboeken` | GET | ✅ | Alle grootboekrekeningen | | `/v2/grootboeken` | POST | - | Nieuwe grootboekrekening | | `/v2/grootboeken/{id}` | GET | - | Specifieke grootboekrekening | ### Grootboekmutaties | Endpoint | Method | OData | Beschrijving | |----------|--------|-------|--------------| | `/v2/grootboekmutaties` | GET | ✅ | Alle grootboekmutaties | | `/v2/grootboekmutaties/{id}` | GET | - | Specifieke grootboekmutatie | ### Inkoopboekingen | Endpoint | Method | OData | Beschrijving | |----------|--------|-------|--------------| | `/v2/inkoopboekingen` | POST | - | Nieuwe inkoopboeking | | `/v2/inkoopboekingen/{id}` | GET | - | Specifieke inkoopboeking | | `/v2/inkoopboekingen/{id}` | PUT | - | Inkoopboeking wijzigen | | `/v2/inkoopboekingen/{id}` | DELETE | - | Inkoopboeking verwijderen | | `/v2/inkoopboekingen/CreateFromAttachment` | POST | - | Inkoopboeking van bijlage | | `/v2/inkoopboekingen/GetCreateFromAttachmentStatus` | GET | - | Status bijlage verwerking | | `/v2/inkoopboekingen/ubl` | POST | - | UBL factuur importeren | ### Inkoopfacturen | Endpoint | Method | OData | Beschrijving | |----------|--------|-------|--------------| | `/v2/inkoopfacturen` | GET | ✅ | Alle inkoopfacturen | ### Kasboekingen | Endpoint | Method | OData | Beschrijving | |----------|--------|-------|--------------| | `/v2/kasboekingen` | GET | ✅ | Alle kasboekingen | | `/v2/kasboekingen` | POST | - | Nieuwe kasboeking | | `/v2/kasboekingen/{id}` | GET | - | Specifieke kasboeking | | `/v2/kasboekingen/{id}` | PUT | - | Kasboeking wijzigen | | `/v2/kasboekingen/{id}` | DELETE | - | Kasboeking verwijderen | ### Kostenplaatsen | Endpoint | Method | OData | Beschrijving | |----------|--------|-------|--------------| | `/v2/kostenplaatsen` | GET | - | Alle kostenplaatsen | ### Landen | Endpoint | Method | OData | Beschrijving | |----------|--------|-------|--------------| | `/v2/landen` | GET | - | Alle landen (252 items) | ### Offertes | Endpoint | Method | OData | Beschrijving | |----------|--------|-------|--------------| | `/v2/offertes` | GET | ✅ | Alle offertes | | `/v2/offertes/{id}` | GET | - | Specifieke offerte | ### Prijsafspraken | Endpoint | Method | OData | Beschrijving | |----------|--------|-------|--------------| | `/v2/prijsafspraken` | GET | ✅ | Alle prijsafspraken | ### Relaties | Endpoint | Method | OData | Beschrijving | |----------|--------|-------|--------------| | `/v2/relaties` | GET | ✅ | Alle relaties (klanten/leveranciers) | | `/v2/relaties/{id}` | GET | - | Specifieke relatie | ### Verkoopfacturen | Endpoint | Method | OData | Beschrijving | |----------|--------|-------|--------------| | `/v2/verkoopfacturen` | GET | ✅ | Alle verkoopfacturen | ### Verkooporders | Endpoint | Method | OData | Beschrijving | |----------|--------|-------|--------------| | `/v2/verkooporders` | GET | ✅ | Alle verkooporders | | `/v2/verkooporders/{id}` | GET | - | Specifieke verkooporder | ### Verkoopordersjablonen | Endpoint | Method | OData | Beschrijving | |----------|--------|-------|--------------| | `/v2/verkoopordersjablonen` | GET | - | Alle verkooporder templates | --- ## OData Query Parameters Endpoints met OData ondersteuning accepteren: | Parameter | Type | Beschrijving | |-----------|------|--------------| | `$skip` | integer | Aantal resultaten overslaan | | `$top` | integer | Maximum aantal resultaten | | `$filter` | string | OData filter expressie | ### Filter Voorbeelden ``` # Facturen na bepaalde datum $filter=datum ge 2024-01-01 # Relaties met naam $filter=contains(naam, 'Strakt') # Openstaande facturen $filter=openstaandSaldo gt 0 ``` Volledige OData specificatie: http://docs.oasis-open.org/odata/odata/v4.01/cs01/part2-url-conventions/odata-v4.01-cs01-part2-url-conventions.html --- ## Response Models ### ActieprijzenModel ```json { "omschrijving": "string", "startdatum": "2024-01-01T00:00:00", "einddatum": "2024-12-31T00:00:00", "status": "Verlopen | Actief | Gepland", "artikelPrijzen": [{ "artikelcode": "string", "artikelOmschrijving": "string", "prijsIngave": "Bedrag | Korting", "prijzen": [{ "vanaf": 0, "korting": 0, "verkoopprijs": 0, "basisprijs": 0 }] }] } ``` ### ArtikelModel ```json { "id": "uuid", "artikelcode": "string", "omschrijving": "string", "verkoopprijs": 0, "inkoopprijs": 0, "eenheid": "string", "artikelOmzetgroep": { "id": "uuid" }, "isNonActief": false } ``` ### RelatieModel ```json { "id": "uuid", "modifiedOn": "2024-01-01T00:00:00", "relatiesoort": ["Klant", "Leverancier"], "relatiecode": 0, "naam": "string", "email": "string", "btwnummer": "string", "factuurkorting": 0, "kredietlimiet": 0, "vestigingsAdres": { "straat": "string", "postcode": "string", "plaats": "string", "land": { "id": "uuid", "naam": "string" } } } ``` ### FactuurModel (Verkoop/Inkoop) ```json { "id": "uuid", "factuurnummer": "string", "relatie": { "id": "uuid" }, "factuurdatum": "2024-01-01", "vervalDatum": "2024-02-01", "factuurbedrag": 0, "openstaandSaldo": 0, "regels": [{ "artikel": { "id": "uuid" }, "omschrijving": "string", "aantal": 1, "stuksprijs": 0, "totaal": 0, "btwSoort": { "id": "uuid" } }] } ``` ### GrootboekModel ```json { "id": "uuid", "modifiedOn": "2024-01-01T00:00:00", "rekeningCode": "string", "omschrijving": "string", "kostenplaatsVerplicht": false, "rgsCode": "string", "grootboekfunctie": "string", "grootboekRubriek": { "id": "uuid" }, "nonactief": false } ``` ### BankboekingModel ```json { "id": "uuid", "modifiedOn": "2024-01-01T00:00:00", "boekstuk": "string", "gepiketDoor": "string", "datum": "2024-01-01", "omschrijving": "string", "boekingsregels": [{ "omschrijving": "string", "grootboek": { "id": "uuid" }, "debet": 0, "credit": 0 }] } ``` --- ## Required Scopes | Scope | Endpoints | |-------|-----------| | `settings:read` | actieprijzen, artikelomzetgroepen, btwtarieven, dagboeken, kostenplaatsen, landen | | `artikelen` | artikelen, artikelen/prijsafspraken | | `relaties` | relaties | | `boekingen:lezen` | bankboekingen, kasboekingen, inkoopboekingen, grootboekmutaties | | `facturen:lezen` | verkoopfacturen, inkoopfacturen | | `offertes` | offertes | | `orders` | verkooporders, verkoopordersjablonen | | `btw:lezen` | btwaangiftes | --- ## API Base Info - **Base URL:** `https://b2bapi.snelstart.nl/v2` - **Auth URL:** `https://auth.snelstart.nl/b2b/token` - **Token Validity:** 1 hour ### Required Headers ``` Ocp-Apim-Subscription-Key: {subscriptionKey} Authorization: Bearer {accessToken} Content-Type: application/json ``` --- ## Test Results (24 jan 2026) Alle GET endpoints getest met Strakt Holding BV administratie: | Endpoint | Status | Items | |----------|--------|-------| | /actieprijzen | ✅ OK | 0 | | /artikelen | ✅ OK | 1 | | /artikelen/prijsafspraken | ✅ OK | 0 | | /artikelomzetgroepen | ✅ OK | 4 | | /bankboekingen | ✅ OK | 1+ | | /btwaangiftes | ✅ OK | varies | | /btwtarieven | ✅ OK | 19 | | /companyInfo | ✅ OK | - | | /dagboeken | ✅ OK | 6 | | /grootboeken | ✅ OK | varies | | /grootboekmutaties | ✅ OK | varies | | /inkoopfacturen | ✅ OK | varies | | /kasboekingen | ✅ OK | varies | | /kostenplaatsen | ✅ OK | 0 | | /landen | ✅ OK | 252 | | /offertes | ✅ OK | varies | | /prijsafspraken | ✅ OK | varies | | /relaties | ✅ OK | varies | | /verkoopfacturen | ✅ OK | varies | | /verkooporders | ✅ OK | varies | | /verkoopordersjablonen | ✅ OK | varies |