Technische Documentatie
Deze pagina is de complete technische referentie van alle 150 MCP-tools waarmee Praat met je Boekhouding Exact Online aan AI-assistenten koppelt: parameters, voorbeeldprompts en categorieën per tool. De koppeling is standaard alleen-lezen; schrijven, zoals een factuur of journaalpost aanmaken, zet je zelf aan op Pro of Enterprise, per administratie, met een audit-log van elke actie.
Verdeeld naar type: 87 tools om te lezen, 4 voor bulk-synchronisatie en 59 om te schrijven. Schrijven staat standaard uit; je zet het zelf aan, per administratie, vanaf het Pro-plan (€49 per maand, 2.500 opdrachten).
Administratie
Basistoegang tot divisies en administraties
list_divisions
Lijst alle beschikbare Exact Online administraties (divisies)
Parameters
- Type:
- string
- Omschrijving
- Filter op regio (NL, BE, DE, UK, US, ES, FR)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| region | string | Nee | Filter op regio (NL, BE, DE, UK, US, ES, FR) |
Voorbeeldvraag
"Welke administraties heb ik?"
get_user_roles
Gebruikers en functierechten per administratie, alleen op een directe vraag. Standaard naam, gebruikerstype en aantal rechten per niveau; e-mailadres en de rechtenlijst alleen op verzoek. Let op: Exact kan via de API alleen de koppelingsgebruiker tonen; dan zegt het antwoord dat
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- boolean
- Omschrijving
- E-mailadres meenemen (default: false)
- Type:
- boolean
- Omschrijving
- Lijst functierechten per gebruiker meenemen (default: false)
- Type:
- boolean
- Omschrijving
- Alleen rechten zonder verstreken einddatum (default: true)
- Type:
- number
- Omschrijving
- Maximum aantal rechtenregels (1-1000, default 500)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| include_email | boolean | Nee | E-mailadres meenemen (default: false) |
| include_rights | boolean | Nee | Lijst functierechten per gebruiker meenemen (default: false) |
| active_only | boolean | Nee | Alleen rechten zonder verstreken einddatum (default: true) |
| limit | number | Nee | Maximum aantal rechtenregels (1-1000, default 500) |
Voorbeeldvraag
"Wie heeft toegang tot deze administratie en wat mag die?"
get_division_profile
Structuur van de administratie: dagboeken, rekeningschema-indeling, btw-codes, kostenplaatsen/-dragers en betaalcondities. Alleen structuurdata, nooit bedragen of transacties. Vereist dat je het administratieprofiel aanzet op je dashboard
Parameters
- Type:
- number
- Omschrijving
- Administratie code (optioneel bij één administratie)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code (optioneel bij één administratie) |
Voorbeeldvraag
"Welke dagboeken en btw-codes heeft deze administratie?"
Verbinding & Feedback
Connectiestatus controleren en feedback/analyses terugkoppelen
check_connection
Controleer de status van je Exact Online verbinding: token-status en eventueel een reconnect-URL
Voorbeeldvraag
"Is mijn boekhouding nog goed verbonden?"
submit_report
Sla een rapport of stuk feedback op zodat het team de kwaliteit kan verbeteren, bijvoorbeeld na een analyse of als iets niet werkt
Parameters
- Type:
- string
- Omschrijving
- profit_loss, trial_balance, cashflow, aging, vat, revenue, customer_360, snapshot, feedback of custom
- Type:
- string
- Omschrijving
- Korte titel van het rapport
- Type:
- string
- Omschrijving
- Korte samenvatting van de belangrijkste bevindingen
- Type:
- string
- Omschrijving
- Volledige rapportinhoud als tekst of JSON
- Type:
- string
- Omschrijving
- Extra context als JSON, bijv. gebruikte parameters of periode
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| report_type | string | Ja | profit_loss, trial_balance, cashflow, aging, vat, revenue, customer_360, snapshot, feedback of custom |
| title | string | Ja | Korte titel van het rapport |
| summary | string | Nee | Korte samenvatting van de belangrijkste bevindingen |
| content | string | Ja | Volledige rapportinhoud als tekst of JSON |
| metadata | string | Nee | Extra context als JSON, bijv. gebruikte parameters of periode |
Voorbeeldvraag
"Stuur deze analyse door als feedback naar het team"
Universeel zoeken (ChatGPT-interface)
Het search/fetch-toolpaar dat ChatGPT gebruikt voor deep research en gewone chatvragen. Zoekt in relaties, verkoopfacturen en boekingen; alleen-lezen
search
Doorzoek de administratie in één query over drie domeinen: relaties (bedrijfsnaam), verkoopfacturen (factuurnummer, referentie of klantnaam) en boekingen (boekstuknummer of omschrijving). Geeft resultaten met id, titel en url terug; alleen-lezen
Parameters
- Type:
- string
- Omschrijving
- Zoekterm: (deel van een) bedrijfsnaam, factuurnummer, referentie of woorden uit een boekingsomschrijving
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| query | string | Ja | Zoekterm: (deel van een) bedrijfsnaam, factuurnummer, referentie of woorden uit een boekingsomschrijving |
Voorbeeldvraag
"Zoek alles over Bakker"
fetch
Haal het volledige document op voor een resultaat-id uit search: relatieprofiel (incl. openstaande posten), verkoopfactuur (incl. regels) of boeking (incl. boekingsregels). Alleen-lezen
Parameters
- Type:
- string
- Omschrijving
- Document-id uit de search-resultaten: 'relation:<guid>', 'invoice:<guid>' of 'entry:<boekstuknummer>'
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| id | string | Ja | Document-id uit de search-resultaten: 'relation:<guid>', 'invoice:<guid>' of 'entry:<boekstuknummer>' |
Voorbeeldvraag
"Haal het volledige document op van dit zoekresultaat"
Relaties
Klanten, leveranciers en contactpersonen
get_relations
Haal klanten en/of leveranciers op met contactgegevens, KvK en BTW-nummers
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- customer, supplier, of both
- Type:
- boolean
- Omschrijving
- Alleen actieve relaties
- Type:
- number
- Omschrijving
- Max resultaten (1-1000)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| type | string | Nee | customer, supplier, of both |
| active_only | boolean | Nee | Alleen actieve relaties |
| limit | number | Nee | Max resultaten (1-1000) |
Voorbeeldvraag
"Toon alle actieve klanten"
search_relations
Zoek specifieke klant/leverancier op naam, code, KvK of BTW-nummer
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Zoekterm
- Type:
- string
- Omschrijving
- name, code, kvk, vat, of all
- Type:
- boolean
- Omschrijving
- true = ook alle adressen (post, bezoek, factuur, aflever) met adres-id voor delivery_address_id
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| query | string | Ja | Zoekterm |
| search_field | string | Nee | name, code, kvk, vat, of all |
| include_addresses | boolean | Nee | true = ook alle adressen (post, bezoek, factuur, aflever) met adres-id voor delivery_address_id |
Voorbeeldvraag
"Zoek klant Bakker" of "Vind leverancier met KvK 12345678"
get_communication_notes
Haal communicatie-/activiteitennotities (vrije tekst, datum, medewerker) van een specifieke relatie op
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Relatie-ID (GUID), uit search_relations of get_relations
- Type:
- string
- Omschrijving
- Relatiecode als alternatief voor relation_id
- Type:
- number
- Omschrijving
- Maximum aantal notities (default 50, max 200)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| relation_id | string | Nee | Relatie-ID (GUID), uit search_relations of get_relations |
| relation_code | string | Nee | Relatiecode als alternatief voor relation_id |
| limit | number | Nee | Maximum aantal notities (default 50, max 200) |
Voorbeeldvraag
"Wat is de laatste afspraak met klant Bakker?"
get_relation_bank_accounts
Haal de bankrekening(en)/IBAN van een specifieke relatie op, handig voor IBAN-controle tegen factuurgegevens
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Relatie-ID (GUID), uit search_relations of get_relations
- Type:
- string
- Omschrijving
- Relatiecode als alternatief voor relation_id
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| relation_id | string | Nee | Relatie-ID (GUID), uit search_relations of get_relations |
| relation_code | string | Nee | Relatiecode als alternatief voor relation_id |
Voorbeeldvraag
"Wat is het IBAN van leverancier De Vries?"
Facturen
Verkoop- en inkoopfacturen, openstaande posten
get_sales_invoices
Haal verkoopfacturen op met status, klant en bedragen
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- open, paid, of all
- Type:
- string
- Omschrijving
- Filter op klant
- Type:
- string
- Omschrijving
- Begindatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Einddatum (YYYY-MM-DD)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| status | string | Nee | open, paid, of all |
| customer_id | string | Nee | Filter op klant |
| from_date | string | Nee | Begindatum (YYYY-MM-DD) |
| to_date | string | Nee | Einddatum (YYYY-MM-DD) |
Voorbeeldvraag
"Toon openstaande verkoopfacturen van deze maand"
get_purchase_invoices
Haal inkoopfacturen (crediteurenfacturen) op
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Leverancier: ID (GUID), relatiecode of naam
- Type:
- string
- Omschrijving
- Begindatum op boekdatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Einddatum op boekdatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Factuurnummer van de leverancier
- Type:
- array
- Omschrijving
- Meerdere factuurnummers van leveranciers in één aanroep (max 20)
- Type:
- boolean
- Omschrijving
- Per factuur het openstaande bedrag en of hij betaald is
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| supplier_id | string | Nee | Leverancier: ID (GUID), relatiecode of naam |
| from_date | string | Nee | Begindatum op boekdatum (YYYY-MM-DD) |
| to_date | string | Nee | Einddatum op boekdatum (YYYY-MM-DD) |
| your_ref | string | Nee | Factuurnummer van de leverancier |
| your_refs | array | Nee | Meerdere factuurnummers van leveranciers in één aanroep (max 20) |
| include_payment_status | boolean | Nee | Per factuur het openstaande bedrag en of hij betaald is |
Voorbeeldvraag
"Welke inkoopfacturen moeten we nog betalen?"
get_outstanding_invoices
Haal alle openstaande facturen op (debiteuren én crediteuren)
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- receivable, payable, of both
- Type:
- boolean
- Omschrijving
- Alleen achterstallige facturen
- Type:
- number
- Omschrijving
- Minimum dagen achterstallig
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| type | string | Nee | receivable, payable, of both |
| overdue_only | boolean | Nee | Alleen achterstallige facturen |
| min_days_overdue | number | Nee | Minimum dagen achterstallig |
Voorbeeldvraag
"Welke facturen staan meer dan 30 dagen open?"
check_deposit_lines
Controleer of op de verkoopfacturen van een periode het statiegeld (emballage) als artikelregel is meegenomen: vindt facturen zonder statiegeldregel of met een afwijkend aantal
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string[]
- Omschrijving
- Artikelcode(s) van het statiegeldartikel, bijv. ["KRAT"]
- Type:
- string
- Omschrijving
- Begindatum factuurdatum (YYYY-MM-DD, default: 31 dagen geleden)
- Type:
- string
- Omschrijving
- Einddatum factuurdatum (YYYY-MM-DD, default: vandaag)
- Type:
- string
- Omschrijving
- Alleen facturen van deze klant (GUID of relatiecode)
- Type:
- object[]
- Omschrijving
- Expliciete regels {item_code, deposit_item_code?, per_unit?}; zonder rules worden ze uit de facturen in de periode afgeleid
- Type:
- number
- Omschrijving
- Maximum facturen (1-500, default: 200)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| deposit_item_codes | string[] | Ja | Artikelcode(s) van het statiegeldartikel, bijv. ["KRAT"] |
| from_date | string | Nee | Begindatum factuurdatum (YYYY-MM-DD, default: 31 dagen geleden) |
| to_date | string | Nee | Einddatum factuurdatum (YYYY-MM-DD, default: vandaag) |
| customer_id | string | Nee | Alleen facturen van deze klant (GUID of relatiecode) |
| rules | object[] | Nee | Expliciete regels {item_code, deposit_item_code?, per_unit?}; zonder rules worden ze uit de facturen in de periode afgeleid |
| limit | number | Nee | Maximum facturen (1-500, default: 200) |
Voorbeeldvraag
"Is op alle facturen van augustus statiegeld gerekend?"
Financieel
Banktransacties, grootboek, proefbalans, cashflow
get_bank_transactions
Haal banktransacties op met bedrag, omschrijving en tegenpartij
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Begindatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Einddatum (YYYY-MM-DD)
- Type:
- number
- Omschrijving
- Max resultaten
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| from_date | string | Nee | Begindatum (YYYY-MM-DD) |
| to_date | string | Nee | Einddatum (YYYY-MM-DD) |
| limit | number | Nee | Max resultaten |
Voorbeeldvraag
"Toon bankafschrijvingen van vorige week"
get_bank_statements
Haal de bankafschriften zelf op: afschriftnummer, dagboek, periode, begin- en eindsaldo
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- number
- Omschrijving
- Boekjaar van het afschrift
- Type:
- number
- Omschrijving
- Boekperiode (1-13)
- Type:
- string
- Omschrijving
- Code van het bankdagboek
- Type:
- string
- Omschrijving
- open, verwerkt of all
- Type:
- boolean
- Omschrijving
- Ook de afschriftregels meesturen
- Type:
- number
- Omschrijving
- Max resultaten
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| year | number | Nee | Boekjaar van het afschrift |
| period | number | Nee | Boekperiode (1-13) |
| journal | string | Nee | Code van het bankdagboek |
| status | string | Nee | open, verwerkt of all |
| include_lines | boolean | Nee | Ook de afschriftregels meesturen |
| limit | number | Nee | Max resultaten |
Voorbeeldvraag
"Klopt het eindsaldo van mijn laatste bankafschrift?"
get_gl_accounts
Haal grootboekrekeningen op met saldi
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Filter op rekeningtype
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| type | string | Nee | Filter op rekeningtype |
Voorbeeldvraag
"Toon alle grootboekrekeningen met hun saldo"
get_trial_balance
Haal proefbalans/saldibalans op
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- number
- Omschrijving
- Boekjaar
- Type:
- number
- Omschrijving
- Periode (maand)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| year | number | Nee | Boekjaar |
| period | number | Nee | Periode (maand) |
Voorbeeldvraag
"Geef de saldibalans van januari"
get_cashflow_forecast
Genereer cashflow prognose op basis van openstaande posten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- number
- Omschrijving
- Aantal dagen vooruit: 30 (default), 60 of 90
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| forecast_days | number | Nee | Aantal dagen vooruit: 30 (default), 60 of 90 |
Voorbeeldvraag
"Hoe ziet onze cashflow er de komende 30 dagen uit?"
Rapportage & Analyse
Winst/verlies, omzet, BTW, ouderdom, budget
get_profit_loss
Haal winst- en verliesrekening op
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- number
- Omschrijving
- Boekjaar
- Type:
- number
- Omschrijving
- Startperiode
- Type:
- number
- Omschrijving
- Eindperiode
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| year | number | Nee | Boekjaar |
| period_from | number | Nee | Startperiode |
| period_to | number | Nee | Eindperiode |
Voorbeeldvraag
"Toon de winst- en verliesrekening van Q1"
get_revenue
Omzet per grootboekrekening als jaartotaal, optioneel naast het totaal van vorig jaar. Omzet per maand staat in get_profit_loss
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- number
- Omschrijving
- Boekjaar (default: huidig jaar)
- Type:
- boolean
- Omschrijving
- Vergelijk met het totaal van vorig jaar
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| year | number | Nee | Boekjaar (default: huidig jaar) |
| compare_previous_year | boolean | Nee | Vergelijk met het totaal van vorig jaar |
Voorbeeldvraag
"Hoeveel omzet hebben we dit jaar gedraaid, vergeleken met vorig jaar?"
get_aging_analysis
Ouderdomsanalyse van openstaande posten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- receivable of payable
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| type | string | Nee | receivable of payable |
Voorbeeldvraag
"Geef een ouderdomsanalyse van onze debiteuren"
get_aging_receivables
Gedetailleerde ouderdomsanalyse debiteuren
Parameters
- Type:
- number
- Omschrijving
- Administratie code
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
Voorbeeldvraag
"Analyseer de ouderdom van openstaande vorderingen"
get_aging_payables
Gedetailleerde ouderdomsanalyse crediteuren
Parameters
- Type:
- number
- Omschrijving
- Administratie code
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
Voorbeeldvraag
"Analyseer de ouderdom van openstaande schulden"
get_transactions
Zoek in financiële transacties
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Begindatum
- Type:
- string
- Omschrijving
- Einddatum
- Type:
- string
- Omschrijving
- Filter op grootboekrekening
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| from_date | string | Nee | Begindatum |
| to_date | string | Nee | Einddatum |
| gl_account | string | Nee | Filter op grootboekrekening |
Voorbeeldvraag
"Toon alle transacties op rekening 8000"
get_vat_summary
Haal BTW-overzicht op voor aangifte
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- number
- Omschrijving
- Jaar
- Type:
- number
- Omschrijving
- Kwartaal of maand
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| year | number | Nee | Jaar |
| period | number | Nee | Kwartaal of maand |
Voorbeeldvraag
"Geef het BTW-overzicht van Q4"
get_budget_comparison
Vergelijk realisatie met budget
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- number
- Omschrijving
- Boekjaar
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| year | number | Nee | Boekjaar |
Voorbeeldvraag
"Hoe doen we het ten opzichte van budget?"
Journaalposten
Memoriaal en transacties zoeken
get_journal_entries
Haal memoriaal/dagboekposten op (handmatige boekingen, correcties, afschrijvingen)
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Begin op aanmaakdatum (YYYY-MM-DD); voor een maand: financial_period
- Type:
- string
- Omschrijving
- Einde op aanmaakdatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Dagboekcode (bijv. "90" voor memoriaal)
- Type:
- string
- Omschrijving
- Filter op grootboekrekening (GUID)
- Type:
- string
- Omschrijving
- draft, processed, of all
- Type:
- number
- Omschrijving
- Boekjaar
- Type:
- number
- Omschrijving
- Periode (1-12)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| created_from | string | Nee | Begin op aanmaakdatum (YYYY-MM-DD); voor een maand: financial_period |
| created_to | string | Nee | Einde op aanmaakdatum (YYYY-MM-DD) |
| journal_code | string | Nee | Dagboekcode (bijv. "90" voor memoriaal) |
| gl_account | string | Nee | Filter op grootboekrekening (GUID) |
| status | string | Nee | draft, processed, of all |
| financial_year | number | Nee | Boekjaar |
| financial_period | number | Nee | Periode (1-12) |
Voorbeeldvraag
"Toon alle memoriaalboekingen van deze maand"
search_transactions
Uitgebreid zoeken in transacties met alle Exact Online filters
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Begindatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Einddatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Dagboekcode (verschilt per administratie, vraag beschikbare codes op via Exact)
- Type:
- number
- Omschrijving
- Boekstuknummer (exacte match)
- Type:
- string
- Omschrijving
- Grootboekrekeningnummer
- Type:
- string
- Omschrijving
- all, debit, of credit
- Type:
- number
- Omschrijving
- Minimum bedrag
- Type:
- number
- Omschrijving
- Maximum bedrag
- Type:
- string
- Omschrijving
- Zoek in omschrijving
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| from_date | string | Nee | Begindatum (YYYY-MM-DD) |
| to_date | string | Nee | Einddatum (YYYY-MM-DD) |
| journal_code | string | Nee | Dagboekcode (verschilt per administratie, vraag beschikbare codes op via Exact) |
| entry_number | number | Nee | Boekstuknummer (exacte match) |
| gl_account | string | Nee | Grootboekrekeningnummer |
| amount_type | string | Nee | all, debit, of credit |
| min_amount | number | Nee | Minimum bedrag |
| max_amount | number | Nee | Maximum bedrag |
| description_contains | string | Nee | Zoek in omschrijving |
Voorbeeldvraag
"Zoek alle creditboekingen boven €1000 op rekening 1600"
get_journals
Haal de dagboeken van de administratie op (kas, bank, inkoop, verkoop, memoriaal) met code, type en gekoppelde grootboekrekening
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- number
- Omschrijving
- Maximum resultaten (1-200, default: 100)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| limit | number | Nee | Maximum resultaten (1-200, default: 100) |
Voorbeeldvraag
"Welke dagboeken zijn er en welke journal_code gebruik ik voor memoriaal?"
Orders & Offertes
Verkoop- en inkooporders, offertes
get_sales_orders
Haal verkooporders op met de volledige kop (PO-nummer, kopnotitie, afleveradres, magazijn, betaalconditie, lever- en factuurstatus), optioneel met regels
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- open, partial, complete, of all
- Type:
- string
- Omschrijving
- Filter op klant
- Type:
- string
- Omschrijving
- PO-nummer/klantreferentie; zoekt zonder datumfilter over alle orders (duplicaatcheck)
- Type:
- number
- Omschrijving
- Eén order op ordernummer
- Type:
- array
- Omschrijving
- Meerdere orders op ordernummer, tot 25 per aanroep; ontbrekende nummers worden genoemd
- Type:
- string
- Omschrijving
- Eén order op order-id (GUID)
- Type:
- boolean
- Omschrijving
- true = ook de regels (artikel, aantal, eenheid, prijs, btw), tot 25 orders
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| status | string | Nee | open, partial, complete, of all |
| customer_id | string | Nee | Filter op klant |
| your_ref | string | Nee | PO-nummer/klantreferentie; zoekt zonder datumfilter over alle orders (duplicaatcheck) |
| order_number | number | Nee | Eén order op ordernummer |
| order_numbers | array | Nee | Meerdere orders op ordernummer, tot 25 per aanroep; ontbrekende nummers worden genoemd |
| order_id | string | Nee | Eén order op order-id (GUID) |
| include_lines | boolean | Nee | true = ook de regels (artikel, aantal, eenheid, prijs, btw), tot 25 orders |
Voorbeeldvraag
"Welke verkooporders staan nog open?" of "Is er al een order met PO-nummer 4711?"
get_purchase_orders
Haal inkooporders op
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- open, partial, complete, of all
- Type:
- string
- Omschrijving
- Filter op leverancier
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| status | string | Nee | open, partial, complete, of all |
| supplier_id | string | Nee | Filter op leverancier |
Voorbeeldvraag
"Toon openstaande inkooporders"
get_quotations
Haal offertes op
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- open, accepted, rejected, of all
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| status | string | Nee | open, accepted, rejected, of all |
Voorbeeldvraag
"Welke offertes zijn nog niet geaccepteerd?"
Goederenstroom
Orderregels, leveringen, ontvangsten en retouren
search_sales_order_lines
Zoek orderregels over alle verkooporders heen: besteld, geleverd, gefactureerd en wat er nog uit moet. Met group_by "item" in één keer per artikel opgeteld
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- open, partial, complete, canceled of all
- Type:
- string
- Omschrijving
- Vroegste leverdatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Laatste leverdatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Filter op één artikelcode
- Type:
- array
- Omschrijving
- Meerdere artikelcodes in één aanroep (max 30)
- Type:
- string
- Omschrijving
- "item": telling per artikel (besteld, geleverd, nog te leveren, aantal orders)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| delivery_status | string | Nee | open, partial, complete, canceled of all |
| from_date | string | Nee | Vroegste leverdatum (YYYY-MM-DD) |
| to_date | string | Nee | Laatste leverdatum (YYYY-MM-DD) |
| item_code | string | Nee | Filter op één artikelcode |
| item_codes | array | Nee | Meerdere artikelcodes in één aanroep (max 30) |
| group_by | string | Nee | "item": telling per artikel (besteld, geleverd, nog te leveren, aantal orders) |
Voorbeeldvraag
"Wat staat er per artikel nog open om te leveren?"
search_purchase_order_lines
Zoek regels over alle inkooporders heen: besteld, ontvangen en nog te ontvangen, met ordernummer en leverancier erbij. Met group_by "item" in één keer per artikel opgeteld
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Filter op leverancier
- Type:
- string
- Omschrijving
- Vroegste verwachte ontvangstdatum (YYYY-MM-DD)
- Type:
- array
- Omschrijving
- Regels van meerdere inkooporders in één aanroep (max 30)
- Type:
- string
- Omschrijving
- Filter op één artikelcode
- Type:
- array
- Omschrijving
- Meerdere artikelcodes in één aanroep (max 30)
- Type:
- string
- Omschrijving
- "item": telling per artikel (besteld, ontvangen, nog te ontvangen, voorraad)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| supplier_id | string | Nee | Filter op leverancier |
| from_date | string | Nee | Vroegste verwachte ontvangstdatum (YYYY-MM-DD) |
| purchase_order_ids | array | Nee | Regels van meerdere inkooporders in één aanroep (max 30) |
| item_code | string | Nee | Filter op één artikelcode |
| item_codes | array | Nee | Meerdere artikelcodes in één aanroep (max 30) |
| group_by | string | Nee | "item": telling per artikel (besteld, ontvangen, nog te ontvangen, voorraad) |
Voorbeeldvraag
"Wat komt er per artikel nog binnen?"
get_goods_deliveries
Uitgaande leveringen (pakbonnen), optioneel met de regels erbij
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Begindatum leverdatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Filter op klant
- Type:
- boolean
- Omschrijving
- Regels meesturen (besteld versus geleverd)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| from_date | string | Nee | Begindatum leverdatum (YYYY-MM-DD) |
| customer_id | string | Nee | Filter op klant |
| include_lines | boolean | Nee | Regels meesturen (besteld versus geleverd) |
Voorbeeldvraag
"Wat is er deze week de deur uit gegaan?"
get_goods_receipts
Goederenontvangsten, optioneel met de regels erbij
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Begindatum ontvangstdatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Filter op leverancier
- Type:
- boolean
- Omschrijving
- Regels meesturen (besteld versus ontvangen)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| from_date | string | Nee | Begindatum ontvangstdatum (YYYY-MM-DD) |
| supplier_id | string | Nee | Filter op leverancier |
| include_lines | boolean | Nee | Regels meesturen (besteld versus ontvangen) |
Voorbeeldvraag
"Wat is er deze week binnengekomen?"
get_returns
Retouren aan beide kanten: type="sales" voor klantretouren, type="purchase" voor retouren naar de leverancier
Parameters
- Type:
- string
- Omschrijving
- sales of purchase
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Klant (sales) of leverancier (purchase)
- Type:
- boolean
- Omschrijving
- Retourregels meesturen
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| type | string | Ja | sales of purchase |
| division | number | Nee | Administratie code |
| relation_id | string | Nee | Klant (sales) of leverancier (purchase) |
| include_lines | boolean | Nee | Retourregels meesturen |
Voorbeeldvraag
"Welke retouren staan er open?"
Artikelen & Voorraad
Producten, artikelen en voorraadposities
get_items
Haal artikelen/producten op
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Zoek op naam of code
- Type:
- array
- Omschrijving
- Meerdere artikelcodes in één aanroep (max 20)
- Type:
- string
- Omschrijving
- all, stock, service, non_stock, serial of batch
- Type:
- string
- Omschrijving
- Artikelgroep: code of ID
- Type:
- boolean
- Omschrijving
- Alleen actieve verkoopartikelen binnen hun geldigheid (default: true)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| search | string | Nee | Zoek op naam of code |
| item_codes | array | Nee | Meerdere artikelcodes in één aanroep (max 20) |
| item_type | string | Nee | all, stock, service, non_stock, serial of batch |
| item_group | string | Nee | Artikelgroep: code of ID |
| active_only | boolean | Nee | Alleen actieve verkoopartikelen binnen hun geldigheid (default: true) |
Voorbeeldvraag
"Toon alle verkoopbare artikelen"
get_stock_positions
Haal voorraadposities op
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Filter op artikelcode
- Type:
- array
- Omschrijving
- Meerdere artikelcodes of artikel-ID's in één aanroep (max 20)
- Type:
- string
- Omschrijving
- Magazijn: ID of code uit get_warehouses
- Type:
- boolean
- Omschrijving
- Alleen artikelen onder de minimumvoorraad
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| item_code | string | Nee | Filter op artikelcode |
| item_codes | array | Nee | Meerdere artikelcodes of artikel-ID's in één aanroep (max 20) |
| warehouse | string | Nee | Magazijn: ID of code uit get_warehouses |
| below_minimum | boolean | Nee | Alleen artikelen onder de minimumvoorraad |
Voorbeeldvraag
"Wat is onze huidige voorraadpositie?"
get_item_groups
Haal artikelgroepen op, met de gekoppelde grootboekrekeningen (omzet, kosten, inkoop, voorraad)
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Zoek in code of omschrijving
- Type:
- number
- Omschrijving
- Max aantal artikelgroepen (1-500, default 200)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| search | string | Nee | Zoek in code of omschrijving |
| limit | number | Nee | Max aantal artikelgroepen (1-500, default 200) |
Voorbeeldvraag
"Welke grootboekrekening hangt aan artikelgroep Handelsgoederen?"
get_units
Haal eenheden op (stuks, uur, kg, doos, ...) zoals gebruikt bij artikelen en orderregels
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- boolean
- Omschrijving
- Alleen actieve eenheden (default true)
- Type:
- number
- Omschrijving
- Max aantal eenheden (1-500, default 200)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| active_only | boolean | Nee | Alleen actieve eenheden (default true) |
| limit | number | Nee | Max aantal eenheden (1-500, default 200) |
Voorbeeldvraag
"Welke eenheden gebruiken we in deze administratie?"
get_warehouses
Haal magazijnen op, met hoofdmagazijn-markering en of locatiebeheer actief is (vereist de voorraadmodule)
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- number
- Omschrijving
- Max aantal magazijnen (1-500, default 200)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| limit | number | Nee | Max aantal magazijnen (1-500, default 200) |
Voorbeeldvraag
"Welke magazijnen hebben we?"
get_stock_counts
Haal voorraadtellingen op, met per telling het verschil tussen administratie en werkelijkheid
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Teldatum vanaf (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Teldatum tot en met (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- all (default), concept of verwerkt
- Type:
- string
- Omschrijving
- Filter op magazijn (GUID)
- Type:
- boolean
- Omschrijving
- Getelde artikelen meesturen (default false)
- Type:
- number
- Omschrijving
- Max aantal tellingen (1-500, default 50)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| from_date | string | Nee | Teldatum vanaf (YYYY-MM-DD) |
| to_date | string | Nee | Teldatum tot en met (YYYY-MM-DD) |
| status | string | Nee | all (default), concept of verwerkt |
| warehouse | string | Nee | Filter op magazijn (GUID) |
| include_lines | boolean | Nee | Getelde artikelen meesturen (default false) |
| limit | number | Nee | Max aantal tellingen (1-500, default 50) |
Voorbeeldvraag
"Welk telverschil kwam er uit de laatste voorraadtelling?"
get_warehouse_transfers
Haal magazijnverplaatsingen op: welke voorraad gaat waarheen en wat staat nog open
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Invoerdatum vanaf (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Invoerdatum tot en met (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- all (default), open of verwerkt
- Type:
- string
- Omschrijving
- Herkomstmagazijn (GUID)
- Type:
- string
- Omschrijving
- Bestemmingsmagazijn (GUID)
- Type:
- boolean
- Omschrijving
- Verplaatste artikelen meesturen (default false)
- Type:
- number
- Omschrijving
- Max aantal verplaatsingen (1-500, default 50)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| from_date | string | Nee | Invoerdatum vanaf (YYYY-MM-DD) |
| to_date | string | Nee | Invoerdatum tot en met (YYYY-MM-DD) |
| status | string | Nee | all (default), open of verwerkt |
| warehouse_from | string | Nee | Herkomstmagazijn (GUID) |
| warehouse_to | string | Nee | Bestemmingsmagazijn (GUID) |
| include_lines | boolean | Nee | Verplaatste artikelen meesturen (default false) |
| limit | number | Nee | Max aantal verplaatsingen (1-500, default 50) |
Voorbeeldvraag
"Welke magazijnverplaatsingen staan nog open?"
get_storage_locations
Haal opslaglocaties op binnen een magazijn, optioneel met de voorraad per locatie (vereist locatiebeheer)
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Filter op magazijn (GUID)
- Type:
- boolean
- Omschrijving
- Voorraad per locatie meesturen (default false)
- Type:
- number
- Omschrijving
- Max aantal locaties (1-500, default 200)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| warehouse | string | Nee | Filter op magazijn (GUID) |
| include_stock | boolean | Nee | Voorraad per locatie meesturen (default false) |
| limit | number | Nee | Max aantal locaties (1-500, default 200) |
Voorbeeldvraag
"Op welke locatie ligt dit artikel?"
Projecten
Projecten, urenregistratie, WIP en projectfacturatie
get_projects
Haal projecten op met status, budget en manager
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- active, completed, archived, of all
- Type:
- string
- Omschrijving
- Filter op klant
- Type:
- string
- Omschrijving
- Zoek in code/omschrijving
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| status | string | Nee | active, completed, archived, of all |
| account_id | string | Nee | Filter op klant |
| search | string | Nee | Zoek in code/omschrijving |
Voorbeeldvraag
"Toon alle actieve projecten"
get_time_transactions
Haal urenregistraties op per project/medewerker
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Filter op project
- Type:
- string
- Omschrijving
- Filter op medewerker
- Type:
- string
- Omschrijving
- Startdatum
- Type:
- string
- Omschrijving
- Einddatum
- Type:
- string
- Omschrijving
- draft, submitted, approved, rejected, processed
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| project_id | string | Nee | Filter op project |
| employee_id | string | Nee | Filter op medewerker |
| date_from | string | Nee | Startdatum |
| date_to | string | Nee | Einddatum |
| status | string | Nee | draft, submitted, approved, rejected, processed |
Voorbeeldvraag
"Hoeveel uren zijn er geschreven op project X?"
get_project_invoices
Haal projectfacturen en factuurtermijnen op
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Filter op project
- Type:
- string
- Omschrijving
- Filter op klant
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| project_id | string | Nee | Filter op project |
| account_id | string | Nee | Filter op klant |
Voorbeeldvraag
"Wat is er al gefactureerd voor project Y?"
get_wip_overview
Onderhanden werk overzicht: budget vs. realisatie per project
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- active of all
- Type:
- string
- Omschrijving
- Filter op klant
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| status | string | Nee | active of all |
| account_id | string | Nee | Filter op klant |
Voorbeeldvraag
"Hoeveel onderhanden werk hebben we uitstaan?"
get_project_360
Eén project van alle kanten: het ingestelde budget, de werkelijk geboekte uren en kosten, en de werkstructuur (WBS)
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Project-ID (GUID)
- Type:
- string
- Omschrijving
- Projectcode, als alternatief voor het ID
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| project_id | string | Nee | Project-ID (GUID) |
| project_code | string | Nee | Projectcode, als alternatief voor het ID |
Voorbeeldvraag
"Blijft project PRJ-001 binnen het urenbudget?"
CRM & Sales
Verkoopkansen, pipeline en sales funnel
get_opportunities
Haal verkoopkansen (opportunities) op uit CRM
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- open, won, lost, of all
- Type:
- string
- Omschrijving
- Filter op klant
- Type:
- string
- Omschrijving
- Filter op eigenaar
- Type:
- string
- Omschrijving
- Zoek op naam
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| status | string | Nee | open, won, lost, of all |
| account_id | string | Nee | Filter op klant |
| owner_id | string | Nee | Filter op eigenaar |
| search | string | Nee | Zoek op naam |
Voorbeeldvraag
"Wat is onze sales pipeline? Toon verkoopkansen per fase"
get_sales_funnel
Sales funnel analyse met conversiepercentages
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Begin op aanmaakdatum van de verkoopkans (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Einde op aanmaakdatum van de verkoopkans (YYYY-MM-DD)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| created_from | string | Nee | Begin op aanmaakdatum van de verkoopkans (YYYY-MM-DD) |
| created_to | string | Nee | Einde op aanmaakdatum van de verkoopkans (YYYY-MM-DD) |
Voorbeeldvraag
"Hoe is onze conversie per sales fase?"
Contracten
Verkoopcontracten, recurring revenue
get_sales_contracts
Haal verkoopcontracten op
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- boolean
- Omschrijving
- Alleen lopende contracten (default: true)
- Type:
- string
- Omschrijving
- Filter op klant
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| active_only | boolean | Nee | Alleen lopende contracten (default: true) |
| account_id | string | Nee | Filter op klant |
Voorbeeldvraag
"Welke verkoopcontracten lopen er?"
get_recurring_revenue
Recurring revenue (MRR/ARR) overzicht uit contracten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
Voorbeeldvraag
"Wat is onze recurring revenue?"
Vaste Activa
Activa, afschrijvingen en boekwaarde
get_fixed_assets
Haal vaste activa op met aanschafwaarde en boekwaarde
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- active, sold, scrapped, of all
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| status | string | Nee | active, sold, scrapped, of all |
Voorbeeldvraag
"Welke vaste activa hebben we en wat is de boekwaarde?"
get_depreciation_schedule
Haal afschrijvingsschema op per activum
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Filter op specifiek activum
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| asset_id | string | Nee | Filter op specifiek activum |
Voorbeeldvraag
"Toon het afschrijvingsschema van onze activa"
Kostenplaatsen & Kostendragers
Kostenplaatsen, kostendragers en kostentoewijzing
get_cost_centers
Haal kostenplaatsen op
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- boolean
- Omschrijving
- Alleen actieve kostenplaatsen
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| active_only | boolean | Nee | Alleen actieve kostenplaatsen |
Voorbeeldvraag
"Welke kostenplaatsen gebruiken we?"
get_cost_center_report
Kosten per kostenplaats rapport
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- number
- Omschrijving
- Boekjaar
- Type:
- number
- Omschrijving
- Startperiode
- Type:
- number
- Omschrijving
- Eindperiode
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| year | number | Nee | Boekjaar |
| period_from | number | Nee | Startperiode |
| period_to | number | Nee | Eindperiode |
Voorbeeldvraag
"Wat zijn de kosten per afdeling dit jaar?"
get_cost_unit_report
Haal een rapport per kostendrager (cost unit) op: omzet, kosten en resultaat per product/project/dienst
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Filter op specifieke kostendrager code
- Type:
- number
- Omschrijving
- Boekjaar (default: huidig jaar)
- Type:
- number
- Omschrijving
- Startperiode (1-12, default: 1)
- Type:
- number
- Omschrijving
- Eindperiode (1-12, default: 12)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| cost_unit_code | string | Nee | Filter op specifieke kostendrager code |
| year | number | Nee | Boekjaar (default: huidig jaar) |
| period_from | number | Nee | Startperiode (1-12, default: 1) |
| period_to | number | Nee | Eindperiode (1-12, default: 12) |
Voorbeeldvraag
"Wat is het resultaat per kostendrager dit jaar?"
get_cost_units
Haal kostendragers op met id, code en omschrijving — ook codes die nog niet in transacties voorkomen
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Zoek in code of omschrijving
- Type:
- number
- Omschrijving
- Max aantal kostendragers (1-500, default 200)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| search | string | Nee | Zoek in code of omschrijving |
| limit | number | Nee | Max aantal kostendragers (1-500, default 200) |
Voorbeeldvraag
"Welke kostendragers hebben we?"
Prijzen & Marges
Prijslijsten, inkoop-/verkoopprijzen en margeanalyse
get_sales_prices
Haal verkoopprijzen en prijslijsten op
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Filter op artikel
- Type:
- string
- Omschrijving
- Filter op klant
- Type:
- string
- Omschrijving
- Zoek op artikelcode of omschrijving
- Type:
- array
- Omschrijving
- Meerdere artikelcodes in één aanroep (max 20)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| item_id | string | Nee | Filter op artikel |
| account_id | string | Nee | Filter op klant |
| search | string | Nee | Zoek op artikelcode of omschrijving |
| item_codes | array | Nee | Meerdere artikelcodes in één aanroep (max 20) |
Voorbeeldvraag
"Wat zijn onze verkoopprijzen?"
get_purchase_prices
Haal de standaard inkoop- en kostprijs per artikel op. Prijzen per leverancier staan in get_supplier_items
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Filter op artikel
- Type:
- string
- Omschrijving
- Zoek op artikelcode of omschrijving
- Type:
- array
- Omschrijving
- Meerdere artikelcodes in één aanroep (max 20)
- Type:
- boolean
- Omschrijving
- Alleen inkoopbare artikelen (standaard aan)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| item_id | string | Nee | Filter op artikel |
| search | string | Nee | Zoek op artikelcode of omschrijving |
| item_codes | array | Nee | Meerdere artikelcodes in één aanroep (max 20) |
| purchase_items_only | boolean | Nee | Alleen inkoopbare artikelen (standaard aan) |
Voorbeeldvraag
"Wat is de kostprijs van deze tien artikelen?"
get_supplier_items
Wie levert welk artikel: leverancier, leverancier-artikelcode, inkoopprijs, levertijd, minimale afname en hoofdleverancier. Zit niet in elke Exact-editie
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Filter op artikel (GUID)
- Type:
- string
- Omschrijving
- Filter op artikelcode (of een deel daarvan)
- Type:
- array
- Omschrijving
- Meerdere artikelcodes of artikel-ID's in één aanroep (max 20)
- Type:
- string
- Omschrijving
- Filter op leverancier (GUID)
- Type:
- string
- Omschrijving
- Filter op relatiecode van de leverancier
- Type:
- boolean
- Omschrijving
- Alleen de hoofdleverancier per artikel
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| item_id | string | Nee | Filter op artikel (GUID) |
| item_code | string | Nee | Filter op artikelcode (of een deel daarvan) |
| item_codes | array | Nee | Meerdere artikelcodes of artikel-ID's in één aanroep (max 20) |
| supplier_id | string | Nee | Filter op leverancier (GUID) |
| supplier_code | string | Nee | Filter op relatiecode van de leverancier |
| main_supplier_only | boolean | Nee | Alleen de hoofdleverancier per artikel |
Voorbeeldvraag
"Van wie kopen we artikel ART-001 in en tegen welke prijs?"
get_order_charges
Artikeltoeslagen: bedragen die Exact zelf aan een order of factuur toevoegt bovenop de artikelregels, zoals statiegeld. Met bedrag, grootboekrekening en btw-code. Zit niet in elke Exact-editie
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Zoek in code of omschrijving
- Type:
- boolean
- Omschrijving
- Alleen actieve toeslagen (default: true)
- Type:
- number
- Omschrijving
- Maximum aantal (1-500, default 100)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| search | string | Nee | Zoek in code of omschrijving |
| active_only | boolean | Nee | Alleen actieve toeslagen (default: true) |
| limit | number | Nee | Maximum aantal (1-500, default 100) |
Voorbeeldvraag
"Welke artikeltoeslagen staan er ingericht?"
get_gl_classifications
Grootboekclassificaties (RGS-/rapportagecodes) met hun hiërarchie en schemanaam
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Zoek op code of omschrijving
- Type:
- number
- Omschrijving
- Maximum aantal (default 200)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| search | string | Nee | Zoek op code of omschrijving |
| limit | number | Nee | Maximum aantal (default 200) |
Voorbeeldvraag
"Welke RGS-codes kent deze administratie?"
get_margin_analysis
Marge-analyse: vergelijk inkoop- en verkoopprijzen
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Filter op artikel (GUID)
- Type:
- number
- Omschrijving
- Minimum margepercentage
- Type:
- number
- Omschrijving
- Maximum margepercentage (voor artikelen met een lage marge)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| item_id | string | Nee | Filter op artikel (GUID) |
| min_margin_percentage | number | Nee | Minimum margepercentage |
| max_margin_percentage | number | Nee | Maximum margepercentage (voor artikelen met een lage marge) |
Voorbeeldvraag
"Welke artikelen hebben een marge onder de 20%?"
Valuta
Valutacodes en wisselkoersen
get_currencies
Haal beschikbare valutacodes op
Parameters
- Type:
- number
- Omschrijving
- Administratie code
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
Voorbeeldvraag
"Welke valuta's zijn beschikbaar?"
get_currency_rates
Haal actuele wisselkoersen op
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Bronvaluta (bijv. USD)
- Type:
- string
- Omschrijving
- Doelvaluta (bijv. EUR)
- Type:
- string
- Omschrijving
- Startdatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Einddatum (YYYY-MM-DD)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| source_currency | string | Nee | Bronvaluta (bijv. USD) |
| target_currency | string | Nee | Doelvaluta (bijv. EUR) |
| date_from | string | Nee | Startdatum (YYYY-MM-DD) |
| date_to | string | Nee | Einddatum (YYYY-MM-DD) |
Voorbeeldvraag
"Wat is de huidige EUR/USD koers?"
Documenten
Bijlagen en documenten bij transacties
get_document_attachments
Haal document-bijlagen op die gekoppeld zijn aan transacties
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Filter op één document (GUID)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| document_id | string | Nee | Filter op één document (GUID) |
Voorbeeldvraag
"Zijn de gescande bonnen al verwerkt tot een boekingsvoorstel?"
get_invoice_attachments
Haal de PDF-bijlage(n) van een (inkoop- of verkoop)factuur op, inclusief scan-status
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- GUID van de factuur
- Type:
- number
- Omschrijving
- Boekstuk-/factuurnummer als alternatief voor entry_id
- Type:
- string
- Omschrijving
- purchase (inkoop) of sales (verkoop), default purchase
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| entry_id | string | Nee | GUID van de factuur |
| entry_number | number | Nee | Boekstuk-/factuurnummer als alternatief voor entry_id |
| type | string | Nee | purchase (inkoop) of sales (verkoop), default purchase |
Voorbeeldvraag
"Laat de PDF van deze inkoopfactuur zien"
get_document_content
Lees de inhoud van een document/bijlage: voor PDF's de geëxtraheerde tekst, anders een download-URL
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- GUID van de bijlage, uit get_document_attachments of get_document_inbox (ook een gemailde bon)
- Type:
- string
- Omschrijving
- GUID van een document, als alternatief voor attachment_id: leest de bijlagen van dat document
- Type:
- array
- Omschrijving
- Meerdere bijlagen in één aanroep (max 50), ook gemailde bonnen uit de brievenbus
- Type:
- array
- Omschrijving
- Meerdere documenten in één aanroep (max 50), met per document zijn bijlagen
- Type:
- string
- Omschrijving
- "text" (default voor PDF) of "url"
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| attachment_id | string | Nee | GUID van de bijlage, uit get_document_attachments of get_document_inbox (ook een gemailde bon) |
| document_id | string | Nee | GUID van een document, als alternatief voor attachment_id: leest de bijlagen van dat document |
| attachment_ids | array | Nee | Meerdere bijlagen in één aanroep (max 50), ook gemailde bonnen uit de brievenbus |
| document_ids | array | Nee | Meerdere documenten in één aanroep (max 50), met per document zijn bijlagen |
| format | string | Nee | "text" (default voor PDF) of "url" |
Voorbeeldvraag
"Lees de tekst van deze factuur-PDF"
get_document_inbox
Toon het postvak van Exact: de digitale brievenbus (gemailde bonnen/facturen die nog niet verwerkt zijn) en documenten die nog niet aan een boeking gekoppeld zijn
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- number
- Omschrijving
- Documenttype-filter (default 20, inkoopfactuur/bon). Ook courant: 10 verkoopfactuur, 50 brief, 51 e-mail, 55 overig
- Type:
- boolean
- Omschrijving
- Toon ongekoppelde documenten van alle types, zonder type-filter (default false)
- Type:
- number
- Omschrijving
- Maximum aantal documenten (1-100, default 20)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| document_type | number | Nee | Documenttype-filter (default 20, inkoopfactuur/bon). Ook courant: 10 verkoopfactuur, 50 brief, 51 e-mail, 55 overig |
| include_all_types | boolean | Nee | Toon ongekoppelde documenten van alle types, zonder type-filter (default false) |
| limit | number | Nee | Maximum aantal documenten (1-100, default 20) |
Voorbeeldvraag
"Welke bonnen staan er nog open in de brievenbus?"
Productie (Manufacturing)
Gereedmeldingen, productieorders, recepturen en batchtracering
get_production_receipts
Haal gereedmeldingen van productieorders op en aggregeer de gereedgemelde hoeveelheid (bijv. kilo) per artikel/periode op realisatiedatum
Parameters
- Type:
- string
- Omschrijving
- Begindatum gereedmelding (YYYY-MM-DD), default: begin dit jaar
- Type:
- string
- Omschrijving
- Einddatum gereedmelding (YYYY-MM-DD), default: vandaag
- Type:
- string
- Omschrijving
- Filter op artikelcode (het gereedgemelde product)
- Type:
- number
- Omschrijving
- Max resultaten (1-500, default: 100)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| date_from | string | Nee | Begindatum gereedmelding (YYYY-MM-DD), default: begin dit jaar |
| date_to | string | Nee | Einddatum gereedmelding (YYYY-MM-DD), default: vandaag |
| item_code | string | Nee | Filter op artikelcode (het gereedgemelde product) |
| limit | number | Nee | Max resultaten (1-500, default: 100) |
Voorbeeldvraag
"Hoeveel kilo per maand gereedgemeld per mix?"
get_shop_orders
Haal productieorders (shop orders) op: open vs voltooid, achter op planning, gepland vs geproduceerd aantal
Parameters
- Type:
- string
- Omschrijving
- all, open (nog niet volledig gereed) of completed
- Type:
- boolean
- Omschrijving
- Alleen orders die achterlopen op de geplande datum
- Type:
- string
- Omschrijving
- Filter op artikelcode (het te produceren product)
- Type:
- string
- Omschrijving
- Geplande datum vanaf (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Geplande datum tot (YYYY-MM-DD)
- Type:
- number
- Omschrijving
- Max resultaten (1-500, default: 100)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| status | string | Nee | all, open (nog niet volledig gereed) of completed |
| behind_schedule | boolean | Nee | Alleen orders die achterlopen op de geplande datum |
| item_code | string | Nee | Filter op artikelcode (het te produceren product) |
| date_from | string | Nee | Geplande datum vanaf (YYYY-MM-DD) |
| date_to | string | Nee | Geplande datum tot (YYYY-MM-DD) |
| limit | number | Nee | Max resultaten (1-500, default: 100) |
Voorbeeldvraag
"Welke productieorders lopen achter op planning?"
get_bill_of_materials
Haal recepturen/stuklijsten (Bill of Materials) op: wat zit er in een (half)fabrikaat, in welke verhouding en met welke grondstofkostprijs
Parameters
- Type:
- string
- Omschrijving
- Artikelcode van het (half)fabrikaat (sterk aanbevolen, dan worden ook de materiaalregels meegeleverd)
- Type:
- number
- Omschrijving
- Max aantal receptuurversies (1-100, default: 25)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| item_code | string | Nee | Artikelcode van het (half)fabrikaat (sterk aanbevolen, dan worden ook de materiaalregels meegeleverd) |
| limit | number | Nee | Max aantal receptuurversies (1-100, default: 25) |
Voorbeeldvraag
"Wat is de receptuur en grondstofkost van mix MIX-001?"
get_batch_numbers
Haal batchnummers met houdbaarheidsdatum (THT) op voor batchtracering, beschikbare batchvoorraad en geblokkeerde batches
Parameters
- Type:
- string
- Omschrijving
- Filter op artikelcode
- Type:
- string
- Omschrijving
- Alleen batches met THT vóór deze datum (YYYY-MM-DD)
- Type:
- boolean
- Omschrijving
- Alleen batches met beschikbare voorraad (>0) die niet geblokkeerd zijn
- Type:
- number
- Omschrijving
- Max resultaten (1-500, default: 100)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| item_code | string | Nee | Filter op artikelcode |
| expiring_before | string | Nee | Alleen batches met THT vóór deze datum (YYYY-MM-DD) |
| only_available | boolean | Nee | Alleen batches met beschikbare voorraad (>0) die niet geblokkeerd zijn |
| limit | number | Nee | Max resultaten (1-500, default: 100) |
Voorbeeldvraag
"Welke batches van grondstof GRONDSTOF-Y verlopen deze maand?"
360°-overzicht
Samengestelde overzichten die meerdere API-calls combineren tot één antwoord
get_customer_360
Compleet klantoverzicht: basisgegevens, openstaande facturen, recente facturen en de huidige betaalachterstand in één call. Toont wat er nu openstaat, geen betaalhistorie
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Klant ID (GUID)
- Type:
- boolean
- Omschrijving
- Ook contactpersonen ophalen (default: false)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| customer_id | string | Ja | Klant ID (GUID) |
| include_contacts | boolean | Nee | Ook contactpersonen ophalen (default: false) |
Voorbeeldvraag
"Geef me een compleet overzicht van klant Bakker B.V."
get_financial_snapshot
Compleet financieel overzicht: balans samenvatting, cashpositie, debiteuren/crediteuren en cashflow prognose in één call
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- number
- Omschrijving
- Boekjaar (default: huidig jaar)
- Type:
- number
- Omschrijving
- Periode 1-12, cumulatief tot die maand (default: huidige maand)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Ja | Administratie code |
| year | number | Nee | Boekjaar (default: huidig jaar) |
| period | number | Nee | Periode 1-12, cumulatief tot die maand (default: huidige maand) |
Voorbeeldvraag
"Hoe staan we er financieel voor? Geef de financiële cockpit"
Boekjaren, BTW & Aangifte
Boekjaren/perioden, BTW-codes en aangiftestatus
get_financial_periods
Haal de boekjaren en perioden van de administratie op, inclusief start- en einddatum per periode
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- number
- Omschrijving
- Alleen dit boekjaar (default: alle boekjaren)
- Type:
- number
- Omschrijving
- Maximum perioden (1-500, default: 200)
- Type:
- boolean
- Omschrijving
- Ook boekingsstatus per dagboek per periode ophalen (extra API-call)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| year | number | Nee | Alleen dit boekjaar (default: alle boekjaren) |
| limit | number | Nee | Maximum perioden (1-500, default: 200) |
| include_status | boolean | Nee | Ook boekingsstatus per dagboek per periode ophalen (extra API-call) |
Voorbeeldvraag
"Welke perioden heeft boekjaar 2026 en zijn ze nog open?"
get_vat_codes
Haal de btw-codes van de administratie op: percentage, omschrijving, in-/verkoopkant en ICP-markering
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- boolean
- Omschrijving
- Ook geblokkeerde codes tonen (default: false)
- Type:
- number
- Omschrijving
- Maximum resultaten (1-500, default: 200)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| include_blocked | boolean | Nee | Ook geblokkeerde codes tonen (default: false) |
| limit | number | Nee | Maximum resultaten (1-500, default: 200) |
Voorbeeldvraag
"Welke btw-code gebruik ik voor een verlegde EU-levering?"
get_tax_returns
Haal de status en historie van belastingaangiften op: tijdvak, statuscode, bedrag en uiterste indiendatum
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- number
- Omschrijving
- Alleen aangiften van dit jaar
- Type:
- number
- Omschrijving
- Maximum resultaten (1-100, default: 20, nieuwste eerst)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| year | number | Nee | Alleen aangiften van dit jaar |
| limit | number | Nee | Maximum resultaten (1-100, default: 20, nieuwste eerst) |
Voorbeeldvraag
"Is onze btw-aangifte van dit kwartaal al ingediend?"
Betalingen
Betaallijst en uitgaande betalingen
get_payment_list
Haal de betaallijst/uitgaande betalingen op: wat staat klaar om te betalen, wat is geselecteerd en wat is al verricht (inclusief G-rekening-uitsplitsing)
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- open (default), betaallijst, verricht, afgeletterd, of all
- Type:
- string
- Omschrijving
- Vervaldatum vanaf (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Vervaldatum t/m (YYYY-MM-DD)
- Type:
- number
- Omschrijving
- Maximum resultaten (1-500, default: 100)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| status | string | Nee | open (default), betaallijst, verricht, afgeletterd, of all |
| from_due_date | string | Nee | Vervaldatum vanaf (YYYY-MM-DD) |
| to_due_date | string | Nee | Vervaldatum t/m (YYYY-MM-DD) |
| limit | number | Nee | Maximum resultaten (1-500, default: 100) |
Voorbeeldvraag
"Wat moet er deze week nog betaald worden?"
get_payment_match_candidates
Zoek welke openstaande factuurtermijn door welke bankontvangst betaald kan zijn, met per voorstel het bewijs: factuurnummer in de bankomschrijving, bedrag, relatie, datum. Lettert NIET af — dat doe je zelf in Exact onder Bank > Afschriften > Af te handelen
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Begindatum van het venster voor de bankontvangsten (YYYY-MM-DD, default: 60 dagen geleden)
- Type:
- string
- Omschrijving
- Einddatum van het venster (YYYY-MM-DD, default: vandaag)
- Type:
- string
- Omschrijving
- Beperk tot één klant (GUID uit get_relations)
- Type:
- string
- Omschrijving
- high (alleen met factuurnummer), medium (ook bedrag plus relatie) of low (default, alles)
- Type:
- number
- Omschrijving
- Maximum aantal voorstellen (1-200, default: 50)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| from_date | string | Nee | Begindatum van het venster voor de bankontvangsten (YYYY-MM-DD, default: 60 dagen geleden) |
| to_date | string | Nee | Einddatum van het venster (YYYY-MM-DD, default: vandaag) |
| relation_id | string | Nee | Beperk tot één klant (GUID uit get_relations) |
| min_strength | string | Nee | high (alleen met factuurnummer), medium (ook bedrag plus relatie) of low (default, alles) |
| limit | number | Nee | Maximum aantal voorstellen (1-200, default: 50) |
Voorbeeldvraag
"Welke betalingen van deze maand horen bij welke openstaande factuur?"
get_payment_conditions
Haal betaalcondities (betaaltermijnen) op: code, omschrijving, betaaltermijn in dagen en eventuele betalingskorting
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Zoek in code of omschrijving
- Type:
- number
- Omschrijving
- Max aantal betaalcondities (1-500, default 200)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| search | string | Nee | Zoek in code of omschrijving |
| limit | number | Nee | Max aantal betaalcondities (1-500, default 200) |
Voorbeeldvraag
"Welke betaaltermijnen kennen we in deze administratie?"
get_direct_debit_mandates
Haal SEPA-incassomandaten (machtigingen) op: referentie, type, ondertekeningsdatum en eventuele intrekkingsdatum per relatie
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Filter op relatie (GUID, uit search_relations)
- Type:
- boolean
- Omschrijving
- Alleen actieve (niet-ingetrokken) mandaten (default true)
- Type:
- number
- Omschrijving
- Max aantal mandaten (1-500, default 200)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| relation_id | string | Nee | Filter op relatie (GUID, uit search_relations) |
| active_only | boolean | Nee | Alleen actieve (niet-ingetrokken) mandaten (default true) |
| limit | number | Nee | Max aantal mandaten (1-500, default 200) |
Voorbeeldvraag
"Welke klanten hebben een actieve incassomachtiging?"
Schrijftools: Relaties & Artikelen (Pro/Enterprise)
Schrijftools — vereisen dat je schrijfrechten expliciet aanzet per administratie in je dashboard (Pro en Enterprise). Elke schrijfactie komt in een audit-log; verwijderen staat standaard uit, ook als schrijven aan staat.
create_account
Maak een nieuwe relatie (account) aan: klant, prospect of leverancier. Vereist schrijfrechten + CRM module actief
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Naam van de relatie
- Type:
- string
- Omschrijving
- A=Geen, S=Suspect, P=Prospect, C=Klant (default A)
- Type:
- boolean
- Omschrijving
- Markeer als leverancier (default false)
- Type:
- boolean
- Omschrijving
- Markeer als verkoopklant
- Type:
- string
- Omschrijving
- Relatiecode (anders automatisch toegekend)
- Type:
- string
- Omschrijving
- E-mailadres van de relatie
- Type:
- string
- Omschrijving
- Telefoonnummer van de relatie
- Type:
- string
- Omschrijving
- Website URL
- Type:
- string
- Omschrijving
- Adresregel 1 (straat + huisnummer)
- Type:
- string
- Omschrijving
- Postcode
- Type:
- string
- Omschrijving
- Taalcode van de relatie (NL, EN, DE)
- Type:
- string
- Omschrijving
- Standaard betalingsconditie verkoop (code, zie get_payment_conditions)
- Type:
- string
- Omschrijving
- Standaard betalingsconditie inkoop (code)
- Type:
- number
- Omschrijving
- Standaardkorting verkoop als fractie (0.1 = 10%)
- Type:
- number
- Omschrijving
- Standaardkorting inkoop als fractie
- Type:
- number
- Omschrijving
- Kredietlimiet verkoop in de administratievaluta
- Type:
- number
- Omschrijving
- Kredietlimiet inkoop in de administratievaluta
- Type:
- string
- Omschrijving
- GUID van de vaste accountmanager (zoals get_relations hem teruggeeft)
- Type:
- string
- Omschrijving
- GUID van de relatie die de facturen ontvangt (bijv. de holding)
- Type:
- string
- Omschrijving
- GUID van de contactpersoon die hoofdcontact wordt (enige route om te wisselen)
- Type:
- string
- Omschrijving
- Adresregel 2
- Type:
- string
- Omschrijving
- Adresregel 3
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| name | string | Ja | Naam van de relatie |
| status | string | Nee | A=Geen, S=Suspect, P=Prospect, C=Klant (default A) |
| is_supplier | boolean | Nee | Markeer als leverancier (default false) |
| is_sales | boolean | Nee | Markeer als verkoopklant |
| code | string | Nee | Relatiecode (anders automatisch toegekend) |
| string | Nee | E-mailadres van de relatie | |
| phone | string | Nee | Telefoonnummer van de relatie |
| website | string | Nee | Website URL |
| address_line_1 | string | Nee | Adresregel 1 (straat + huisnummer) |
| postcode | string | Nee | Postcode |
| language | string | Nee | Taalcode van de relatie (NL, EN, DE) |
| payment_condition_sales | string | Nee | Standaard betalingsconditie verkoop (code, zie get_payment_conditions) |
| payment_condition_purchase | string | Nee | Standaard betalingsconditie inkoop (code) |
| discount_sales | number | Nee | Standaardkorting verkoop als fractie (0.1 = 10%) |
| discount_purchase | number | Nee | Standaardkorting inkoop als fractie |
| credit_line_sales | number | Nee | Kredietlimiet verkoop in de administratievaluta |
| credit_line_purchase | number | Nee | Kredietlimiet inkoop in de administratievaluta |
| account_manager_id | string | Nee | GUID van de vaste accountmanager (zoals get_relations hem teruggeeft) |
| invoice_account_id | string | Nee | GUID van de relatie die de facturen ontvangt (bijv. de holding) |
| main_contact_id | string | Nee | GUID van de contactpersoon die hoofdcontact wordt (enige route om te wisselen) |
| address_line_2 | string | Nee | Adresregel 2 |
| address_line_3 | string | Nee | Adresregel 3 |
Voorbeeldvraag
"Maak een nieuwe klant aan: Acme B.V., info@acme.nl"
update_account
Werk een bestaande relatie (account) bij. Vereist schrijfrechten + CRM module actief
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Relatie ID (GUID), uit search_relations
- Type:
- string
- Omschrijving
- Nieuwe naam van de relatie
- Type:
- string
- Omschrijving
- Nieuw e-mailadres
- Type:
- string
- Omschrijving
- Nieuw telefoonnummer
- Type:
- string
- Omschrijving
- Nieuwe vestigingsplaats
- Type:
- string
- Omschrijving
- Nieuwe landcode (bijv. "NL")
- Type:
- string
- Omschrijving
- Taalcode van de relatie (NL, EN, DE)
- Type:
- string
- Omschrijving
- Standaard betalingsconditie verkoop (code, zie get_payment_conditions)
- Type:
- string
- Omschrijving
- Standaard betalingsconditie inkoop (code)
- Type:
- number
- Omschrijving
- Standaardkorting verkoop als fractie (0.1 = 10%)
- Type:
- number
- Omschrijving
- Standaardkorting inkoop als fractie
- Type:
- number
- Omschrijving
- Kredietlimiet verkoop in de administratievaluta
- Type:
- number
- Omschrijving
- Kredietlimiet inkoop in de administratievaluta
- Type:
- string
- Omschrijving
- GUID van de vaste accountmanager (zoals get_relations hem teruggeeft)
- Type:
- string
- Omschrijving
- GUID van de relatie die de facturen ontvangt (bijv. de holding)
- Type:
- string
- Omschrijving
- GUID van de contactpersoon die hoofdcontact wordt (enige route om te wisselen)
- Type:
- string
- Omschrijving
- Adresregel 2
- Type:
- string
- Omschrijving
- Adresregel 3
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| account_id | string | Ja | Relatie ID (GUID), uit search_relations |
| name | string | Nee | Nieuwe naam van de relatie |
| string | Nee | Nieuw e-mailadres | |
| phone | string | Nee | Nieuw telefoonnummer |
| city | string | Nee | Nieuwe vestigingsplaats |
| country | string | Nee | Nieuwe landcode (bijv. "NL") |
| language | string | Nee | Taalcode van de relatie (NL, EN, DE) |
| payment_condition_sales | string | Nee | Standaard betalingsconditie verkoop (code, zie get_payment_conditions) |
| payment_condition_purchase | string | Nee | Standaard betalingsconditie inkoop (code) |
| discount_sales | number | Nee | Standaardkorting verkoop als fractie (0.1 = 10%) |
| discount_purchase | number | Nee | Standaardkorting inkoop als fractie |
| credit_line_sales | number | Nee | Kredietlimiet verkoop in de administratievaluta |
| credit_line_purchase | number | Nee | Kredietlimiet inkoop in de administratievaluta |
| account_manager_id | string | Nee | GUID van de vaste accountmanager (zoals get_relations hem teruggeeft) |
| invoice_account_id | string | Nee | GUID van de relatie die de facturen ontvangt (bijv. de holding) |
| main_contact_id | string | Nee | GUID van de contactpersoon die hoofdcontact wordt (enige route om te wisselen) |
| address_line_2 | string | Nee | Adresregel 2 |
| address_line_3 | string | Nee | Adresregel 3 |
Voorbeeldvraag
"Wijzig het e-mailadres van klant Bakker B.V. naar info@bakker.nl"
create_address
Voeg een bezoek-, post-, factuur- of afleveradres toe aan een relatie. Het id dat terugkomt is de delivery_address_id voor create_sales_order en update_sales_order. Bestaat een gelijk adres al, dan geeft Exact het bestaande id terug (geen duplicaat); de tool leest het adres na het aanmaken terug. Vereist schrijfrechten + CRM module actief
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Relatie ID (GUID) waar het adres bij hoort
- Type:
- string
- Omschrijving
- visit (bezoek), postal (post), invoice (factuur) of delivery (aflever); het Exact-getal 1-4 mag ook
- Type:
- string
- Omschrijving
- Adresregel 1 (straat + huisnummer)
- Type:
- string
- Omschrijving
- Adresregel 2
- Type:
- string
- Omschrijving
- Adresregel 3
- Type:
- string
- Omschrijving
- Postcode
- Type:
- string
- Omschrijving
- Plaats
- Type:
- string
- Omschrijving
- Landcode (NL, BE, DE)
- Type:
- string
- Omschrijving
- Provinciecode, geldig voor het land; "" wist
- Type:
- string
- Omschrijving
- Telefoonnummer op dit adres
- Type:
- string
- Omschrijving
- Notitie, bijv. een afleverinstructie
- Type:
- boolean
- Omschrijving
- true = hoofdadres van zijn soort
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| account_id | string | Ja | Relatie ID (GUID) waar het adres bij hoort |
| type | string | Ja | visit (bezoek), postal (post), invoice (factuur) of delivery (aflever); het Exact-getal 1-4 mag ook |
| address_line_1 | string | Nee | Adresregel 1 (straat + huisnummer) |
| address_line_2 | string | Nee | Adresregel 2 |
| address_line_3 | string | Nee | Adresregel 3 |
| postcode | string | Nee | Postcode |
| city | string | Nee | Plaats |
| country | string | Nee | Landcode (NL, BE, DE) |
| state | string | Nee | Provinciecode, geldig voor het land; "" wist |
| phone | string | Nee | Telefoonnummer op dit adres |
| notes | string | Nee | Notitie, bijv. een afleverinstructie |
| is_main | boolean | Nee | true = hoofdadres van zijn soort |
Voorbeeldvraag
"Voeg voor Bakker B.V. een afleveradres toe: Loskade 12, 3011 AA Rotterdam"
update_address
Werk een bestaand adres van een relatie bij (adresregels, postcode, plaats, land, provincie, telefoon, notitie, type of hoofdadres-vlag) en lees het terug ter controle. Het id vind je met search_relations (include_addresses: true). Vereist schrijfrechten + CRM module actief
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- ID (GUID) van het adres
- Type:
- string
- Omschrijving
- visit (bezoek), postal (post), invoice (factuur) of delivery (aflever); het Exact-getal 1-4 mag ook
- Type:
- string
- Omschrijving
- Adresregel 1 (straat + huisnummer)
- Type:
- string
- Omschrijving
- Adresregel 2
- Type:
- string
- Omschrijving
- Adresregel 3
- Type:
- string
- Omschrijving
- Postcode
- Type:
- string
- Omschrijving
- Plaats
- Type:
- string
- Omschrijving
- Landcode (NL, BE, DE)
- Type:
- string
- Omschrijving
- Provinciecode, geldig voor het land; "" wist
- Type:
- string
- Omschrijving
- Telefoonnummer op dit adres
- Type:
- string
- Omschrijving
- Notitie, bijv. een afleverinstructie
- Type:
- boolean
- Omschrijving
- true = hoofdadres van zijn soort
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| address_id | string | Ja | ID (GUID) van het adres |
| type | string | Nee | visit (bezoek), postal (post), invoice (factuur) of delivery (aflever); het Exact-getal 1-4 mag ook |
| address_line_1 | string | Nee | Adresregel 1 (straat + huisnummer) |
| address_line_2 | string | Nee | Adresregel 2 |
| address_line_3 | string | Nee | Adresregel 3 |
| postcode | string | Nee | Postcode |
| city | string | Nee | Plaats |
| country | string | Nee | Landcode (NL, BE, DE) |
| state | string | Nee | Provinciecode, geldig voor het land; "" wist |
| phone | string | Nee | Telefoonnummer op dit adres |
| notes | string | Nee | Notitie, bijv. een afleverinstructie |
| is_main | boolean | Nee | true = hoofdadres van zijn soort |
Voorbeeldvraag
"Zet de afleverinstructie op het afleveradres van Bakker B.V. op: melden bij de portier"
create_contact
Maak een nieuwe contactpersoon aan bij een relatie. Vereist schrijfrechten + CRM module actief
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Relatie ID (GUID) waaraan de contactpersoon gekoppeld wordt
- Type:
- string
- Omschrijving
- Voornaam van de contactpersoon
- Type:
- string
- Omschrijving
- Achternaam van de contactpersoon
- Type:
- string
- Omschrijving
- E-mailadres van de contactpersoon
- Type:
- string
- Omschrijving
- Telefoonnummer van de contactpersoon
- Type:
- string
- Omschrijving
- Functietitel van de contactpersoon
- Type:
- string
- Omschrijving
- Mobiel nummer
- Type:
- boolean
- Omschrijving
- true = hoofdcontact; werkt alleen zolang de relatie er nog geen heeft (wisselen via update_account main_contact_id)
- Type:
- string
- Omschrijving
- Aanhefcode zoals Exact die kent (bijv. DHR, MEVR)
- Type:
- string
- Omschrijving
- Taalcode van de contactpersoon
- Type:
- string
- Omschrijving
- Notities bij de contactpersoon
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| account_id | string | Ja | Relatie ID (GUID) waaraan de contactpersoon gekoppeld wordt |
| first_name | string | Nee | Voornaam van de contactpersoon |
| last_name | string | Nee | Achternaam van de contactpersoon |
| string | Nee | E-mailadres van de contactpersoon | |
| phone | string | Nee | Telefoonnummer van de contactpersoon |
| job_title | string | Nee | Functietitel van de contactpersoon |
| mobile | string | Nee | Mobiel nummer |
| is_main_contact | boolean | Nee | true = hoofdcontact; werkt alleen zolang de relatie er nog geen heeft (wisselen via update_account main_contact_id) |
| title | string | Nee | Aanhefcode zoals Exact die kent (bijv. DHR, MEVR) |
| language | string | Nee | Taalcode van de contactpersoon |
| notes | string | Nee | Notities bij de contactpersoon |
Voorbeeldvraag
"Voeg Jan de Vries toe als contactpersoon bij klant Bakker B.V."
update_contact
Werk een bestaande contactpersoon bij: naam, e-mailadres, telefoonnummer of functietitel. Het id vind je met get_customer_360 (include_contacts). Vereist schrijfrechten + CRM module actief
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- ID (GUID) van de contactpersoon
- Type:
- string
- Omschrijving
- Nieuwe voornaam
- Type:
- string
- Omschrijving
- Nieuwe achternaam
- Type:
- string
- Omschrijving
- Nieuw e-mailadres
- Type:
- string
- Omschrijving
- Nieuw telefoonnummer
- Type:
- string
- Omschrijving
- Nieuwe functietitel
- Type:
- string
- Omschrijving
- Relatie ID (GUID) om de contactpersoon naar een andere relatie te verplaatsen
- Type:
- string
- Omschrijving
- Mobiel nummer
- Type:
- boolean
- Omschrijving
- true = hoofdcontact; werkt alleen zolang de relatie er nog geen heeft (wisselen via update_account main_contact_id)
- Type:
- string
- Omschrijving
- Aanhefcode zoals Exact die kent (bijv. DHR, MEVR)
- Type:
- string
- Omschrijving
- Taalcode van de contactpersoon
- Type:
- string
- Omschrijving
- Notities bij de contactpersoon
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| contact_id | string | Ja | ID (GUID) van de contactpersoon |
| first_name | string | Nee | Nieuwe voornaam |
| last_name | string | Nee | Nieuwe achternaam |
| string | Nee | Nieuw e-mailadres | |
| phone | string | Nee | Nieuw telefoonnummer |
| job_title | string | Nee | Nieuwe functietitel |
| account_id | string | Nee | Relatie ID (GUID) om de contactpersoon naar een andere relatie te verplaatsen |
| mobile | string | Nee | Mobiel nummer |
| is_main_contact | boolean | Nee | true = hoofdcontact; werkt alleen zolang de relatie er nog geen heeft (wisselen via update_account main_contact_id) |
| title | string | Nee | Aanhefcode zoals Exact die kent (bijv. DHR, MEVR) |
| language | string | Nee | Taalcode van de contactpersoon |
| notes | string | Nee | Notities bij de contactpersoon |
Voorbeeldvraag
"Corrigeer het e-mailadres van Jan de Vries bij Bakker B.V."
create_opportunity
Leg een nieuwe verkoopkans vast in CRM: naam, relatie, sluitdatum (alle drie verplicht), bedrag, fase, slagingskans, volgende actie. Raakt geen boeking; leest na het aanmaken terug. Vereist schrijfrechten + CRM module actief
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Naam van de verkoopkans
- Type:
- string
- Omschrijving
- Relatie ID (GUID), uit search_relations; of geef account_code
- Type:
- string
- Omschrijving
- Relatiecode of naam als alternatief voor account_id
- Type:
- string
- Omschrijving
- Verwachte sluitdatum (YYYY-MM-DD); Exact eist deze
- Type:
- number
- Omschrijving
- Verwachte waarde
- Type:
- string
- Omschrijving
- Valutacode (bijv. "EUR")
- Type:
- string
- Omschrijving
- Datum volgende actie (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Omschrijving volgende actie
- Type:
- string
- Omschrijving
- Fase: code, omschrijving of id uit de administratie (alleen een open fase)
- Type:
- number
- Omschrijving
- Slagingskans in procenten (0-100); zonder opgave de standaard van de fase
- Type:
- string
- Omschrijving
- Eigenaar (gebruikers-GUID)
- Type:
- string
- Omschrijving
- Contactpersoon (GUID)
- Type:
- string
- Omschrijving
- Notities
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| name | string | Ja | Naam van de verkoopkans |
| account_id | string | Nee | Relatie ID (GUID), uit search_relations; of geef account_code |
| account_code | string | Nee | Relatiecode of naam als alternatief voor account_id |
| close_date | string | Ja | Verwachte sluitdatum (YYYY-MM-DD); Exact eist deze |
| amount | number | Nee | Verwachte waarde |
| currency | string | Nee | Valutacode (bijv. "EUR") |
| action_date | string | Nee | Datum volgende actie (YYYY-MM-DD) |
| next_action | string | Nee | Omschrijving volgende actie |
| stage | string | Nee | Fase: code, omschrijving of id uit de administratie (alleen een open fase) |
| probability | number | Nee | Slagingskans in procenten (0-100); zonder opgave de standaard van de fase |
| owner_id | string | Nee | Eigenaar (gebruikers-GUID) |
| contact_id | string | Nee | Contactpersoon (GUID) |
| notes | string | Nee | Notities |
Voorbeeldvraag
"Leg een verkoopkans vast voor Bakker B.V.: nieuwe website, 7.500 euro, sluiten eind november"
update_opportunity
Werk een verkoopkans bij (naam, relatie, bedrag, fase, slagingskans, datums, eigenaar, notities) of zet hem op gewonnen of verloren. Exact leidt de status af uit de fase, dus status won/lost kiest de fase met die status. Won en lost vereisen confirm: true. Leest na de wijziging terug ter controle. Vereist schrijfrechten + CRM module actief
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- ID (GUID) van de verkoopkans, uit get_opportunities
- Type:
- string
- Omschrijving
- Nieuwe naam
- Type:
- string
- Omschrijving
- Relatie ID (GUID)
- Type:
- string
- Omschrijving
- Relatiecode of naam als alternatief voor account_id
- Type:
- number
- Omschrijving
- Verwachte waarde
- Type:
- string
- Omschrijving
- Valutacode
- Type:
- string
- Omschrijving
- Verwachte sluitdatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Datum volgende actie (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Omschrijving volgende actie
- Type:
- string
- Omschrijving
- Fase: code, omschrijving of id
- Type:
- number
- Omschrijving
- Slagingskans in procenten (0-100)
- Type:
- string
- Omschrijving
- Eigenaar (gebruikers-GUID)
- Type:
- string
- Omschrijving
- Contactpersoon (GUID)
- Type:
- string
- Omschrijving
- Notities
- Type:
- string
- Omschrijving
- open, won of lost; wordt gezet via de fase met die status
- Type:
- string
- Omschrijving
- Reden (code, omschrijving of id), vooral bij lost
- Type:
- boolean
- Omschrijving
- Verplicht true bij status won of lost
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| opportunity_id | string | Ja | ID (GUID) van de verkoopkans, uit get_opportunities |
| name | string | Nee | Nieuwe naam |
| account_id | string | Nee | Relatie ID (GUID) |
| account_code | string | Nee | Relatiecode of naam als alternatief voor account_id |
| amount | number | Nee | Verwachte waarde |
| currency | string | Nee | Valutacode |
| close_date | string | Nee | Verwachte sluitdatum (YYYY-MM-DD) |
| action_date | string | Nee | Datum volgende actie (YYYY-MM-DD) |
| next_action | string | Nee | Omschrijving volgende actie |
| stage | string | Nee | Fase: code, omschrijving of id |
| probability | number | Nee | Slagingskans in procenten (0-100) |
| owner_id | string | Nee | Eigenaar (gebruikers-GUID) |
| contact_id | string | Nee | Contactpersoon (GUID) |
| notes | string | Nee | Notities |
| status | string | Nee | open, won of lost; wordt gezet via de fase met die status |
| reason_code | string | Nee | Reden (code, omschrijving of id), vooral bij lost |
| confirm | boolean | Nee | Verplicht true bij status won of lost |
Voorbeeldvraag
"Zet de verkoopkans Nieuwe website Bakker B.V. op gewonnen"
create_item
Maak een nieuw artikel aan. Vereist schrijfrechten + Logistics module actief
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Unieke artikelcode (bijv. "ART-001")
- Type:
- string
- Omschrijving
- Omschrijving van het artikel
- Type:
- boolean
- Omschrijving
- Is dit een verkoopartikel? (default false)
- Type:
- boolean
- Omschrijving
- Is dit een inkoopartikel? (default false)
- Type:
- number
- Omschrijving
- Verkoopprijs excl. BTW (wordt als standaard-verkoopprijs vastgelegd)
- Type:
- number
- Omschrijving
- Inkoopprijs excl. BTW (kan alleen via een leverancierskoppeling; wordt niet standalone gezet)
- Type:
- string
- Omschrijving
- Eenheid (bijv. "stuk", "uur", "kg")
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| code | string | Ja | Unieke artikelcode (bijv. "ART-001") |
| description | string | Ja | Omschrijving van het artikel |
| is_sales_item | boolean | Nee | Is dit een verkoopartikel? (default false) |
| is_purchase_item | boolean | Nee | Is dit een inkoopartikel? (default false) |
| sales_price | number | Nee | Verkoopprijs excl. BTW (wordt als standaard-verkoopprijs vastgelegd) |
| purchase_price | number | Nee | Inkoopprijs excl. BTW (kan alleen via een leverancierskoppeling; wordt niet standalone gezet) |
| unit | string | Nee | Eenheid (bijv. "stuk", "uur", "kg") |
Voorbeeldvraag
"Maak een nieuw artikel aan: ART-001 Bureaulamp LED, verkoopprijs €49,95"
update_item
Werk een bestaand artikel bij (omschrijving, verkoopprijs, eenheid, artikelgroep, btw-code e.d.). Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Artikel-ID (GUID); geef dit of item_code
- Type:
- string
- Omschrijving
- Artikelcode; geef dit of item_id
- Type:
- string
- Omschrijving
- Nieuwe omschrijving
- Type:
- number
- Omschrijving
- Nieuwe standaard-verkoopprijs excl. BTW
- Type:
- boolean
- Omschrijving
- Verkoopartikel ja/nee
- Type:
- string
- Omschrijving
- Eenheidscode
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| item_id | string | Nee | Artikel-ID (GUID); geef dit of item_code |
| item_code | string | Nee | Artikelcode; geef dit of item_id |
| description | string | Nee | Nieuwe omschrijving |
| sales_price | number | Nee | Nieuwe standaard-verkoopprijs excl. BTW |
| is_sales_item | boolean | Nee | Verkoopartikel ja/nee |
| unit | string | Nee | Eenheidscode |
Voorbeeldvraag
"Wijzig de verkoopprijs van artikel ART-001 naar €59,95"
set_sales_price
Zet of wijzig een verkoopprijs: de standaardprijs van een artikel, of een klantspecifieke prijsafspraak (met klant). Werkt als upsert per ingangsdatum; oude regels blijven als historie staan. Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Artikel-ID (GUID); geef dit of item_code
- Type:
- string
- Omschrijving
- Artikelcode; geef dit of item_id
- Type:
- string
- Omschrijving
- Klant (GUID of relatiecode) voor een klantspecifieke afspraak; weglaten = standaardprijs
- Type:
- number
- Omschrijving
- Verkoopprijs excl. BTW
- Type:
- string
- Omschrijving
- Ingangsdatum YYYY-MM-DD (default vandaag)
- Type:
- string
- Omschrijving
- Einddatum YYYY-MM-DD waarna de afspraak vervalt
- Type:
- number
- Omschrijving
- Staffelondergrens: vanaf dit aantal geldt de prijs (default 1)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| item_id | string | Nee | Artikel-ID (GUID); geef dit of item_code |
| item_code | string | Nee | Artikelcode; geef dit of item_id |
| customer | string | Nee | Klant (GUID of relatiecode) voor een klantspecifieke afspraak; weglaten = standaardprijs |
| price | number | Ja | Verkoopprijs excl. BTW |
| start_date | string | Nee | Ingangsdatum YYYY-MM-DD (default vandaag) |
| end_date | string | Nee | Einddatum YYYY-MM-DD waarna de afspraak vervalt |
| quantity | number | Nee | Staffelondergrens: vanaf dit aantal geldt de prijs (default 1) |
Voorbeeldvraag
"Zet voor klant 1001 de prijs van artikel WATER-1L op 1,05 vanaf 1 september"
create_stock_count
Maak een voorraadtelling (inventarisatie) aan als CONCEPT, met per artikel de getelde voorraad of het telverschil. Er wordt niets geboekt; Exact vult de administratieve voorraad en het verschil in en de tool leest die terug, ook tegen kostprijs. Verwerken is een aparte stap (process_stock_count). Vereist schrijfrechten en de voorraadmodule
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Magazijncode uit get_warehouses; zonder code het hoofdmagazijn
- Type:
- string
- Omschrijving
- Magazijn-ID (GUID), alternatief voor warehouse_code
- Type:
- string
- Omschrijving
- Teldatum YYYY-MM-DD (default vandaag)
- Type:
- string
- Omschrijving
- Omschrijving van de telling
- Type:
- string
- Omschrijving
- Grootboekrekening voor het telverschil; zonder code de standaardrekening van de administratie
- Type:
- array
- Omschrijving
- Regels met item_code of item_id, en quantity_new (geteld) OF quantity_difference (verschil), max 200
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| warehouse_code | string | Nee | Magazijncode uit get_warehouses; zonder code het hoofdmagazijn |
| warehouse_id | string | Nee | Magazijn-ID (GUID), alternatief voor warehouse_code |
| date | string | Nee | Teldatum YYYY-MM-DD (default vandaag) |
| description | string | Nee | Omschrijving van de telling |
| gl_account_code | string | Nee | Grootboekrekening voor het telverschil; zonder code de standaardrekening van de administratie |
| lines | array | Ja | Regels met item_code of item_id, en quantity_new (geteld) OF quantity_difference (verschil), max 200 |
Voorbeeldvraag
"Leg de telling van magazijn 1 vast: 48 stuks ART-001 en 12 stuks ART-002"
process_stock_count
Verwerk een concept-voorraadtelling: de telverschillen worden definitief als voorraadcorrectie geboekt in voorraad en grootboek. Onomkeerbaar: Exact kent geen terugdraaiactie, alleen een nieuwe telling met het omgekeerde verschil. Standaard op proef (dry_run): je ziet eerst de regels, de verschillen in stuks en tegen kostprijs, de huidige voorraad en de tegenrekening. Na het verwerken leest de tool status en voorraadstand terug. Vereist schrijfrechten, verwijderen aan voor de administratie, dry_run: false en confirm: true
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Telling-ID (GUID) uit create_stock_count of get_stock_counts
- Type:
- boolean
- Omschrijving
- Default true: alleen tonen wat er geboekt zou worden
- Type:
- boolean
- Omschrijving
- Moet true zijn bij dry_run: false
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| stock_count_id | string | Ja | Telling-ID (GUID) uit create_stock_count of get_stock_counts |
| dry_run | boolean | Nee | Default true: alleen tonen wat er geboekt zou worden |
| confirm | boolean | Nee | Moet true zijn bij dry_run: false |
Voorbeeldvraag
"Verwerk de voorraadtelling van vandaag na mijn akkoord"
Schrijftools: Boekingen & Inkoop (Pro/Enterprise)
Schrijftools — vereisen dat je schrijfrechten expliciet aanzet per administratie in je dashboard (Pro en Enterprise). Elke schrijfactie komt in een audit-log; verwijderen staat standaard uit, ook als schrijven aan staat.
create_journal_entry
Maak een nieuwe memoriaalboeking aan: correctieboeking, storno of overlopende post. Debet en credit moeten in balans zijn. Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Dagboekcode (bijv. "90" voor memoriaal)
- Type:
- string
- Omschrijving
- Boekingsdatum (YYYY-MM-DD), bepaalt boekjaar en periode
- Type:
- number
- Omschrijving
- Boekjaar forceren (default afgeleid uit entry_date)
- Type:
- number
- Omschrijving
- Periode 1-12 (of 13) forceren (default afgeleid uit entry_date)
- Type:
- string
- Omschrijving
- Omschrijving van de boeking
- Type:
- string
- Omschrijving
- Eigen unieke sleutel per boeking; een herhaalde aanroep maakt dan geen dubbele boeking. Geef er description bij, anders kan een herhaling de boeking niet terugvinden. Sleutels vervallen na 90 dagen. Loopt de eerste aanroep nog (korter dan vijf minuten geleden gestart), dan krijg je een melding met retry_after_seconds; herhaal daarna met dezelfde sleutel.
- Type:
- array
- Omschrijving
- Boekingsregels (min. 2): gl_account_code, amount (positief=debet, negatief=credit), en optioneel description, cost_center, cost_unit, vat_code
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| journal_code | string | Ja | Dagboekcode (bijv. "90" voor memoriaal) |
| entry_date | string | Nee | Boekingsdatum (YYYY-MM-DD), bepaalt boekjaar en periode |
| financial_year | number | Nee | Boekjaar forceren (default afgeleid uit entry_date) |
| financial_period | number | Nee | Periode 1-12 (of 13) forceren (default afgeleid uit entry_date) |
| description | string | Nee | Omschrijving van de boeking |
| idempotency_key | string | Nee | Eigen unieke sleutel per boeking; een herhaalde aanroep maakt dan geen dubbele boeking. Geef er description bij, anders kan een herhaling de boeking niet terugvinden. Sleutels vervallen na 90 dagen. Loopt de eerste aanroep nog (korter dan vijf minuten geleden gestart), dan krijg je een melding met retry_after_seconds; herhaal daarna met dezelfde sleutel. |
| lines | array | Ja | Boekingsregels (min. 2): gl_account_code, amount (positief=debet, negatief=credit), en optioneel description, cost_center, cost_unit, vat_code |
Voorbeeldvraag
"Maak een correctieboeking: €100 van rekening 8000 naar 1300"
create_bank_entry
Maak een bankboeking (afschrift) aan in een bankdagboek, bijvoorbeeld voor een rekening zonder bankkoppeling, of een kasboeking in een kasdagboek voor contante ontvangsten en uitgaven. Het type van het dagboek beslist; een kasdagboek geef je altijd zelf op. Geef je begin- en eindsaldo mee, dan controleert de tool vooraf of de regels daarop uitkomen en boekt niets als dat niet klopt. Let op: een geboekte regel is in Exact niet meer te wijzigen — een correctie loopt via create_journal_entry. Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Code van het bank- of kasdagboek; het type bepaalt bank- of kasboeking. Bij meerdere bankdagboeken vraagt de tool welke; een kasdagboek moet je altijd zelf opgeven
- Type:
- string
- Omschrijving
- Afschriftdatum (YYYY-MM-DD), bepaalt boekjaar en periode
- Type:
- number
- Omschrijving
- Boekjaar forceren (default afgeleid uit entry_date)
- Type:
- number
- Omschrijving
- Periode 1-12 (of 13) forceren (default afgeleid uit entry_date)
- Type:
- number
- Omschrijving
- Beginsaldo; moet het eindsaldo van het vorige afschrift in dit dagboek zijn
- Type:
- number
- Omschrijving
- Eindsaldo; samen met opening_balance de controle op de regels
- Type:
- string
- Omschrijving
- Omschrijving van de boeking
- Type:
- array
- Omschrijving
- Afschriftregels (min. 1): gl_account_code, amount (positief=bijschrijving, negatief=afschrijving), en optioneel description, cost_center, cost_unit, vat_code, relation_code
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| journal_code | string | Nee | Code van het bank- of kasdagboek; het type bepaalt bank- of kasboeking. Bij meerdere bankdagboeken vraagt de tool welke; een kasdagboek moet je altijd zelf opgeven |
| entry_date | string | Nee | Afschriftdatum (YYYY-MM-DD), bepaalt boekjaar en periode |
| financial_year | number | Nee | Boekjaar forceren (default afgeleid uit entry_date) |
| financial_period | number | Nee | Periode 1-12 (of 13) forceren (default afgeleid uit entry_date) |
| opening_balance | number | Nee | Beginsaldo; moet het eindsaldo van het vorige afschrift in dit dagboek zijn |
| closing_balance | number | Nee | Eindsaldo; samen met opening_balance de controle op de regels |
| description | string | Nee | Omschrijving van de boeking |
| lines | array | Ja | Afschriftregels (min. 1): gl_account_code, amount (positief=bijschrijving, negatief=afschrijving), en optioneel description, cost_center, cost_unit, vat_code, relation_code |
Voorbeeldvraag
"Boek het kassa-afschrift van 11 augustus: €200 omzet op 8000 en €50 bankkosten op 4700"
reverse_journal_entry
Storneer een bestaande memoriaalboeking met een tegenboeking: dezelfde regels met omgekeerde bedragen, in hetzelfde dagboek. Dit is de aanbevolen manier om een memoriaalboeking te corrigeren, want Exact staat het wijzigen van een memoriaalboeking niet toe. De originele boeking blijft staan, dus het spoor blijft compleet. Werkt ook op een al verwerkte boeking. Staat standaard op proef: je ziet eerst wat er geboekt zou worden. Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- number
- Omschrijving
- Boekstuknummer van de boeking die gestorneerd wordt (of entry_id)
- Type:
- string
- Omschrijving
- GUID van de boeking; nodig als hetzelfde boekstuknummer in twee boekjaren voorkomt
- Type:
- string
- Omschrijving
- Datum van de tegenboeking (YYYY-MM-DD), niet die van het origineel
- Type:
- string
- Omschrijving
- Dagboek voor de tegenboeking (default: hetzelfde als het origineel)
- Type:
- string
- Omschrijving
- Omschrijving (default: "Storno boekstuk <nummer>")
- Type:
- boolean
- Omschrijving
- Standaard true: eerst het plan tonen, nog niets boeken
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| entry_number | number | Nee | Boekstuknummer van de boeking die gestorneerd wordt (of entry_id) |
| entry_id | string | Nee | GUID van de boeking; nodig als hetzelfde boekstuknummer in twee boekjaren voorkomt |
| entry_date | string | Nee | Datum van de tegenboeking (YYYY-MM-DD), niet die van het origineel |
| journal_code | string | Nee | Dagboek voor de tegenboeking (default: hetzelfde als het origineel) |
| description | string | Nee | Omschrijving (default: "Storno boekstuk <nummer>") |
| dry_run | boolean | Nee | Standaard true: eerst het plan tonen, nog niets boeken |
Voorbeeldvraag
"Storneer memoriaalboeking 55 per 14 augustus"
update_journal_entry
Vervang een openstaande memoriaalboeking door een nieuwe regelset. Verwijderen staat standaard uit, ook als schrijven aan staat. Zet je het per administratie apart aan, dan kunnen er twee dingen: een memoriaalboeking die nog openstaat vervangen door een nieuwe versie, waarbij de oude verdwijnt, en een open verkooporder zonder levering of factuur verwijderen (cancel_sales_order). Let op: dit is geen wijziging. Exact staat het wijzigen van een memoriaalboeking niet toe, dus deze tool boekt eerst de nieuwe versie en verwijdert daarna de oude. Het boekstuknummer verandert daardoor. Een al verwerkte boeking weigert de tool. Gebruik bij voorkeur reverse_journal_entry, want die gooit niets weg. Staat standaard op proef: je ziet eerst de verschillen. Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- number
- Omschrijving
- Boekstuknummer van de boeking die vervangen wordt (of entry_id)
- Type:
- string
- Omschrijving
- GUID van de boeking; nodig bij hetzelfde nummer in twee boekjaren
- Type:
- array
- Omschrijving
- De volledige nieuwe regelset (min. 2): gl_account_code, amount, en optioneel description, cost_center, cost_unit, vat_code, relation_code
- Type:
- string
- Omschrijving
- Boekdatum van de nieuwe boeking (default: die van de oude)
- Type:
- string
- Omschrijving
- Dagboek (default: hetzelfde als het origineel)
- Type:
- boolean
- Omschrijving
- Standaard true: eerst de verschillen tonen, nog niets schrijven of verwijderen
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| entry_number | number | Nee | Boekstuknummer van de boeking die vervangen wordt (of entry_id) |
| entry_id | string | Nee | GUID van de boeking; nodig bij hetzelfde nummer in twee boekjaren |
| lines | array | Ja | De volledige nieuwe regelset (min. 2): gl_account_code, amount, en optioneel description, cost_center, cost_unit, vat_code, relation_code |
| entry_date | string | Nee | Boekdatum van de nieuwe boeking (default: die van de oude) |
| journal_code | string | Nee | Dagboek (default: hetzelfde als het origineel) |
| dry_run | boolean | Nee | Standaard true: eerst de verschillen tonen, nog niets schrijven of verwijderen |
Voorbeeldvraag
"Vervang memoriaalboeking 55: dezelfde bedragen, maar op kostenplaats 500"
create_purchase_entry
Maak een nieuwe inkoopboeking aan, met optionele kostenplaats, btw-code en kostenspreiding per regel. Vereist schrijfrechten + Purchase module actief
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Leverancier ID (GUID), uit search_relations
- Type:
- string
- Omschrijving
- Inkoopdagboek-code (bijv. "60")
- Type:
- string
- Omschrijving
- Omschrijving van de inkoopboeking
- Type:
- string
- Omschrijving
- Boekingsdatum (YYYY-MM-DD), meestal de factuurdatum
- Type:
- number
- Omschrijving
- Boekjaar forceren (default afgeleid uit entry_date)
- Type:
- number
- Omschrijving
- Periode forceren (default afgeleid uit entry_date)
- Type:
- string
- Omschrijving
- Vervaldatum (YYYY-MM-DD)
- Type:
- number
- Omschrijving
- Bedrag g-rekening (WKA) dat naar de geblokkeerde rekening van de leverancier moet
- Type:
- string
- Omschrijving
- Eigen unieke sleutel per factuur; een herhaalde aanroep maakt dan geen dubbele boeking. Kies iets dat twee facturen nooit delen, bijv. het document-id of relatiecode + factuurnummer, en geef er your_ref of description bij, anders kan een herhaling na een time-out de boeking niet terugvinden. Sleutels vervallen na 90 dagen. Loopt de eerste aanroep nog (korter dan vijf minuten geleden gestart), dan krijg je een melding met retry_after_seconds; herhaal daarna met dezelfde sleutel.
- Type:
- array
- Omschrijving
- Boekingsregels (min. 1): gl_account_code, amount, en optioneel description, cost_center, cost_unit, vat_code, from/to voor kostenspreiding
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| supplier_id | string | Ja | Leverancier ID (GUID), uit search_relations |
| journal_code | string | Nee | Inkoopdagboek-code (bijv. "60") |
| description | string | Nee | Omschrijving van de inkoopboeking |
| entry_date | string | Nee | Boekingsdatum (YYYY-MM-DD), meestal de factuurdatum |
| financial_year | number | Nee | Boekjaar forceren (default afgeleid uit entry_date) |
| financial_period | number | Nee | Periode forceren (default afgeleid uit entry_date) |
| due_date | string | Nee | Vervaldatum (YYYY-MM-DD) |
| g_account_amount | number | Nee | Bedrag g-rekening (WKA) dat naar de geblokkeerde rekening van de leverancier moet |
| idempotency_key | string | Nee | Eigen unieke sleutel per factuur; een herhaalde aanroep maakt dan geen dubbele boeking. Kies iets dat twee facturen nooit delen, bijv. het document-id of relatiecode + factuurnummer, en geef er your_ref of description bij, anders kan een herhaling na een time-out de boeking niet terugvinden. Sleutels vervallen na 90 dagen. Loopt de eerste aanroep nog (korter dan vijf minuten geleden gestart), dan krijg je een melding met retry_after_seconds; herhaal daarna met dezelfde sleutel. |
| lines | array | Ja | Boekingsregels (min. 1): gl_account_code, amount, en optioneel description, cost_center, cost_unit, vat_code, from/to voor kostenspreiding |
Voorbeeldvraag
"Boek een inkoopfactuur van kantoorartikelen voor €250 bij leverancier X"
update_purchase_entry
Corrigeer een BESTAANDE, nog niet verwerkte inkoopboeking: een verkeerd geboekte kostendrager, kostenplaats, grootboekrekening of omschrijving op een regel, een bedrag dat tussen regels verplaatst moet worden, een kopveld als het leveranciersfactuurnummer, of het bedrag g-rekening (WKA). Regels die je niet noemt blijven ongemoeid. Bij een regel- of kopcorrectie staat dry_run standaard aan: je ziet eerst wat er zou veranderen. Alleen op een boeking met status Open. Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- EntryID van de boeking (GUID). Geef entry_id óf entry_number
- Type:
- number
- Omschrijving
- Boekstuknummer, bijv. 26600123. De tool zoekt het EntryID er zelf bij
- Type:
- string
- Omschrijving
- Verplicht bij lines/header. 'reclassify' (alleen dimensies en tekst), 'regroup' (ook bedragen, maar totaal én btw per code blijven gelijk) of 'rewrite' (alles mag)
- Type:
- boolean
- Omschrijving
- Standaard true bij lines/header: toont de diff zonder Exact aan te raken. Zet op false om door te voeren. Bij alleen g_account_amount standaard false; true geeft daar een proef
- Type:
- array
- Omschrijving
- Alleen de regels die je raakt. Per regel line_id óf line_number, plus gl_account_code, amount, vat_code, description, cost_center, cost_unit, quantity of project_id
- Type:
- object
- Omschrijving
- Kopvelden: description, your_ref, entry_date, due_date, payment_condition, financial_year, financial_period
- Type:
- number
- Omschrijving
- Nieuw bedrag g-rekening. Positief bij een gewone factuur, negatief bij een creditnota. 0 verwijdert een bestaande splitsing. Deze route schrijft zonder dry_run direct; met dry_run: true krijg je eerst een proef zonder wijziging
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| entry_id | string | Nee | EntryID van de boeking (GUID). Geef entry_id óf entry_number |
| entry_number | number | Nee | Boekstuknummer, bijv. 26600123. De tool zoekt het EntryID er zelf bij |
| mode | string | Nee | Verplicht bij lines/header. 'reclassify' (alleen dimensies en tekst), 'regroup' (ook bedragen, maar totaal én btw per code blijven gelijk) of 'rewrite' (alles mag) |
| dry_run | boolean | Nee | Standaard true bij lines/header: toont de diff zonder Exact aan te raken. Zet op false om door te voeren. Bij alleen g_account_amount standaard false; true geeft daar een proef |
| lines | array | Nee | Alleen de regels die je raakt. Per regel line_id óf line_number, plus gl_account_code, amount, vat_code, description, cost_center, cost_unit, quantity of project_id |
| header | object | Nee | Kopvelden: description, your_ref, entry_date, due_date, payment_condition, financial_year, financial_period |
| g_account_amount | number | Nee | Nieuw bedrag g-rekening. Positief bij een gewone factuur, negatief bij een creditnota. 0 verwijdert een bestaande splitsing. Deze route schrijft zonder dry_run direct; met dry_run: true krijg je eerst een proef zonder wijziging |
Voorbeeldvraag
"Boek de 2.419 euro op deze factuur over van event 6604 naar 5172"
create_purchase_order
Maak een nieuwe inkooporder aan bij een leverancier, met orderregels. Vereist schrijfrechten + Purchase Orders module actief
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Leverancier ID (GUID), uit search_relations. Geef supplier_id óf supplier_code
- Type:
- string
- Omschrijving
- Relatiecode van de leverancier, alternatief voor supplier_id
- Type:
- string
- Omschrijving
- Orderdatum (YYYY-MM-DD), default vandaag
- Type:
- string
- Omschrijving
- Eigen referentie/ordernummer
- Type:
- string
- Omschrijving
- Omschrijving van de inkooporder
- Type:
- string
- Omschrijving
- Verwachte ontvangstdatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Code van de betalingsconditie, uit get_payment_conditions
- Type:
- string
- Omschrijving
- Magazijncode waarin ontvangen wordt, uit get_warehouses
- Type:
- string
- Omschrijving
- Opmerkingen op de orderkop
- Type:
- string
- Omschrijving
- Eigen unieke sleutel per bestelling; een herhaalde aanroep maakt dan geen dubbele order. Kies iets dat twee bestellingen nooit delen, bijv. een id uit je bestelsysteem of leverancierscode + eigen volgnummer, en geef er your_ref of description bij, anders kan een herhaling na een time-out de order niet terugvinden. Sleutels vervallen na 90 dagen. Loopt de eerste aanroep nog (korter dan vijf minuten geleden gestart), dan krijg je een melding met retry_after_seconds; herhaal daarna met dezelfde sleutel.
- Type:
- array
- Omschrijving
- Orderregels (min. 1): item_id of item_code, quantity (in inkoopeenheden), en optioneel unit_price, description, cost_center, cost_unit, project
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| supplier_id | string | Nee | Leverancier ID (GUID), uit search_relations. Geef supplier_id óf supplier_code |
| supplier_code | string | Nee | Relatiecode van de leverancier, alternatief voor supplier_id |
| order_date | string | Nee | Orderdatum (YYYY-MM-DD), default vandaag |
| your_ref | string | Nee | Eigen referentie/ordernummer |
| description | string | Nee | Omschrijving van de inkooporder |
| receipt_date | string | Nee | Verwachte ontvangstdatum (YYYY-MM-DD) |
| payment_condition | string | Nee | Code van de betalingsconditie, uit get_payment_conditions |
| warehouse_code | string | Nee | Magazijncode waarin ontvangen wordt, uit get_warehouses |
| remarks | string | Nee | Opmerkingen op de orderkop |
| idempotency_key | string | Nee | Eigen unieke sleutel per bestelling; een herhaalde aanroep maakt dan geen dubbele order. Kies iets dat twee bestellingen nooit delen, bijv. een id uit je bestelsysteem of leverancierscode + eigen volgnummer, en geef er your_ref of description bij, anders kan een herhaling na een time-out de order niet terugvinden. Sleutels vervallen na 90 dagen. Loopt de eerste aanroep nog (korter dan vijf minuten geleden gestart), dan krijg je een melding met retry_after_seconds; herhaal daarna met dezelfde sleutel. |
| lines | array | Ja | Orderregels (min. 1): item_id of item_code, quantity (in inkoopeenheden), en optioneel unit_price, description, cost_center, cost_unit, project |
Voorbeeldvraag
"Maak een inkooporder bij leverancier X: 20x artikel B, verwachte ontvangst 1 oktober"
update_purchase_order
Werk de kopvelden van een bestaande inkooporder bij: omschrijving, referentie, orderdatum, verwachte ontvangstdatum, betalingsconditie, magazijn en opmerkingen. Leest de order na de wijziging terug en meldt per veld of Exact het doorvoerde. Regels en leverancier niet; annuleren kan niet via de API (Exact negeert OrderStatus 40 stil). Vereist schrijfrechten + Purchase Orders module actief
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Inkooporder ID (GUID) uit get_purchase_orders. Geef order_id óf order_number
- Type:
- number
- Omschrijving
- Ordernummer, alternatief voor order_id
- Type:
- string
- Omschrijving
- Nieuwe omschrijving
- Type:
- string
- Omschrijving
- Nieuwe eigen referentie ("" maakt leeg)
- Type:
- string
- Omschrijving
- Nieuwe orderdatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Nieuwe verwachte ontvangstdatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Nieuwe betalingsconditiecode
- Type:
- string
- Omschrijving
- Nieuwe magazijncode
- Type:
- string
- Omschrijving
- Nieuwe opmerkingen ("" maakt leeg)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| order_id | string | Nee | Inkooporder ID (GUID) uit get_purchase_orders. Geef order_id óf order_number |
| order_number | number | Nee | Ordernummer, alternatief voor order_id |
| description | string | Nee | Nieuwe omschrijving |
| your_ref | string | Nee | Nieuwe eigen referentie ("" maakt leeg) |
| order_date | string | Nee | Nieuwe orderdatum (YYYY-MM-DD) |
| receipt_date | string | Nee | Nieuwe verwachte ontvangstdatum (YYYY-MM-DD) |
| payment_condition | string | Nee | Nieuwe betalingsconditiecode |
| warehouse_code | string | Nee | Nieuwe magazijncode |
| remarks | string | Nee | Nieuwe opmerkingen ("" maakt leeg) |
Voorbeeldvraag
"Verzet de verwachte ontvangst van inkooporder 42 naar 1 oktober en zet er betalingsconditie 14 op"
link_supplier_item
Koppel een leverancier aan een artikel (leveranciersartikel) met inkoopprijs, inkoopeenheid en factor, levertijd en hoofdleverancier. Dit is de koppeling die Exact eist voordat create_purchase_order een regel voor dat artikel bij die leverancier accepteert. Weigert een dubbele koppeling en leest de koppeling terug. Niet in elke Exact-editie (403 = module ontbreekt). Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Artikel ID (GUID). Geef item_id óf item_code
- Type:
- string
- Omschrijving
- Artikelcode, alternatief voor item_id
- Type:
- string
- Omschrijving
- Leverancier ID (GUID). Geef supplier_id óf supplier_code
- Type:
- string
- Omschrijving
- Relatiecode van de leverancier
- Type:
- number
- Omschrijving
- Inkoopprijs per inkoopeenheid
- Type:
- string
- Omschrijving
- Code van de inkoopeenheid (standaard de artikeleenheid)
- Type:
- number
- Omschrijving
- Artikeleenheden per inkoopeenheid; bepaalt het aantal op inkooporders. Alleen bij een eigen inkoopeenheid (Exact eist factor 1 op de artikeleenheid zelf)
- Type:
- string
- Omschrijving
- Artikelcode van de leverancier
- Type:
- number
- Omschrijving
- Levertijd in dagen
- Type:
- number
- Omschrijving
- Minimale afname
- Type:
- boolean
- Omschrijving
- true = hoofdleverancier van het artikel
- Type:
- string
- Omschrijving
- Btw-code voor de inkoop
- Type:
- string
- Omschrijving
- Valutacode van de prijs
- Type:
- string
- Omschrijving
- Ingangsdatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Einddatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Notitie bij de koppeling
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| item_id | string | Nee | Artikel ID (GUID). Geef item_id óf item_code |
| item_code | string | Nee | Artikelcode, alternatief voor item_id |
| supplier_id | string | Nee | Leverancier ID (GUID). Geef supplier_id óf supplier_code |
| supplier_code | string | Nee | Relatiecode van de leverancier |
| purchase_price | number | Ja | Inkoopprijs per inkoopeenheid |
| purchase_unit | string | Nee | Code van de inkoopeenheid (standaard de artikeleenheid) |
| purchase_unit_factor | number | Nee | Artikeleenheden per inkoopeenheid; bepaalt het aantal op inkooporders. Alleen bij een eigen inkoopeenheid (Exact eist factor 1 op de artikeleenheid zelf) |
| supplier_item_code | string | Nee | Artikelcode van de leverancier |
| lead_time_days | number | Nee | Levertijd in dagen |
| minimum_quantity | number | Nee | Minimale afname |
| main_supplier | boolean | Nee | true = hoofdleverancier van het artikel |
| vat_code | string | Nee | Btw-code voor de inkoop |
| currency | string | Nee | Valutacode van de prijs |
| start_date | string | Nee | Ingangsdatum (YYYY-MM-DD) |
| end_date | string | Nee | Einddatum (YYYY-MM-DD) |
| notes | string | Nee | Notitie bij de koppeling |
Voorbeeldvraag
"Koppel leverancier 54321 aan artikel ART-001 voor 4,50 per doos van 12"
update_supplier_item
Werk een bestaande leverancier-artikelkoppeling bij: inkoopprijs, inkoopeenheid en factor, leverancier-artikelcode, levertijd, minimale afname, btw-code, geldigheid, notitie, of maak deze leverancier de hoofdleverancier. Leest de koppeling terug en meldt per veld of Exact het doorvoerde. Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- ID van de koppeling uit get_supplier_items; alternatief: artikel én leverancier
- Type:
- string
- Omschrijving
- Artikel ID (GUID), samen met een leverancier
- Type:
- string
- Omschrijving
- Artikelcode, samen met een leverancier
- Type:
- string
- Omschrijving
- Leverancier ID (GUID), samen met een artikel
- Type:
- string
- Omschrijving
- Relatiecode van de leverancier, samen met een artikel
- Type:
- number
- Omschrijving
- Nieuwe inkoopprijs
- Type:
- string
- Omschrijving
- Nieuwe inkoopeenheid
- Type:
- number
- Omschrijving
- Nieuwe factor (artikeleenheden per inkoopeenheid)
- Type:
- string
- Omschrijving
- Nieuwe leverancier-artikelcode
- Type:
- number
- Omschrijving
- Nieuwe levertijd in dagen
- Type:
- number
- Omschrijving
- Nieuwe minimale afname
- Type:
- boolean
- Omschrijving
- true = maak dit de hoofdleverancier (de vorige verliest het)
- Type:
- string
- Omschrijving
- Nieuwe btw-code voor de inkoop
- Type:
- string
- Omschrijving
- Nieuwe valutacode
- Type:
- string
- Omschrijving
- Nieuwe ingangsdatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Nieuwe einddatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Nieuwe notitie ("" maakt leeg)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| supplier_item_id | string | Nee | ID van de koppeling uit get_supplier_items; alternatief: artikel én leverancier |
| item_id | string | Nee | Artikel ID (GUID), samen met een leverancier |
| item_code | string | Nee | Artikelcode, samen met een leverancier |
| supplier_id | string | Nee | Leverancier ID (GUID), samen met een artikel |
| supplier_code | string | Nee | Relatiecode van de leverancier, samen met een artikel |
| purchase_price | number | Nee | Nieuwe inkoopprijs |
| purchase_unit | string | Nee | Nieuwe inkoopeenheid |
| purchase_unit_factor | number | Nee | Nieuwe factor (artikeleenheden per inkoopeenheid) |
| supplier_item_code | string | Nee | Nieuwe leverancier-artikelcode |
| lead_time_days | number | Nee | Nieuwe levertijd in dagen |
| minimum_quantity | number | Nee | Nieuwe minimale afname |
| main_supplier | boolean | Nee | true = maak dit de hoofdleverancier (de vorige verliest het) |
| vat_code | string | Nee | Nieuwe btw-code voor de inkoop |
| currency | string | Nee | Nieuwe valutacode |
| start_date | string | Nee | Nieuwe ingangsdatum (YYYY-MM-DD) |
| end_date | string | Nee | Nieuwe einddatum (YYYY-MM-DD) |
| notes | string | Nee | Nieuwe notitie ("" maakt leeg) |
Voorbeeldvraag
"Zet de inkoopprijs van ART-001 bij leverancier 54321 op 4,75"
update_payment
Zet een openstaande betaling klaar voor de betaalronde: betaalwijze, betalingskenmerk en omschrijving. De betaling wordt na de wijziging uit Exact teruggelezen, per veld. Nooit bedrag, leverancier of eigen bankrekening. Selecteren voor de betaallijst en de batch verwerken kan Exact via de API niet (gemeten); dat blijft in Exact Online zelf. Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- ID (GUID) van de betaling, uit get_payment_list
- Type:
- string
- Omschrijving
- Betaalwijze: B = bankoverschrijving, I = incasso, K = kas
- Type:
- string
- Omschrijving
- Betalingskenmerk dat op de overschrijving meegaat ("" maakt leeg)
- Type:
- string
- Omschrijving
- Omschrijving van de betaling (max. 60 tekens)
- Type:
- boolean
- Omschrijving
- Niet mogelijk via de API: de tool legt uit hoe het in Exact Online kan
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| payment_id | string | Ja | ID (GUID) van de betaling, uit get_payment_list |
| payment_method | string | Nee | Betaalwijze: B = bankoverschrijving, I = incasso, K = kas |
| payment_reference | string | Nee | Betalingskenmerk dat op de overschrijving meegaat ("" maakt leeg) |
| description | string | Nee | Omschrijving van de betaling (max. 60 tekens) |
| select_for_payment | boolean | Nee | Niet mogelijk via de API: de tool legt uit hoe het in Exact Online kan |
Voorbeeldvraag
"Zet het betalingskenmerk van de betaling aan Jansen op factuur 2026-118"
create_goods_receipt
Ontvang een inkooporder geheel of gedeeltelijk: maakt een goederenontvangst aan, boekt de voorraad bij en zet de inkooporder(regels) op ontvangen. Niet terug te draaien via de koppeling, dus zonder confirm: true toont de tool alleen wat er ontvangen zou worden. Aantallen in de inkoopeenheid van de orderregel (een doos van 12 is quantity 1). Zonder lines ontvangt hij alles wat open staat; nooit meer dan besteld. Leest ontvangst, orderregels en voorraadstand terug. Vereist schrijfrechten en Groothandel & Distributie of Productie
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Inkooporder ID (GUID); of order_number
- Type:
- number
- Omschrijving
- Ordernummer van de inkooporder
- Type:
- string
- Omschrijving
- Ontvangstdatum (YYYY-MM-DD), default vandaag
- Type:
- array
- Omschrijving
- Regels: line_number of purchase_order_line_id, en optioneel quantity in de inkoopeenheid (zonder quantity ontvangt Exact de rest van die regel)
- Type:
- string
- Omschrijving
- Opmerkingen op de ontvangst
- Type:
- string
- Omschrijving
- Omschrijving (max. 60 tekens)
- Type:
- boolean
- Omschrijving
- true = alleen tonen, niets sturen
- Type:
- boolean
- Omschrijving
- Moet true zijn om echt te ontvangen
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| order_id | string | Nee | Inkooporder ID (GUID); of order_number |
| order_number | number | Nee | Ordernummer van de inkooporder |
| receipt_date | string | Nee | Ontvangstdatum (YYYY-MM-DD), default vandaag |
| lines | array | Nee | Regels: line_number of purchase_order_line_id, en optioneel quantity in de inkoopeenheid (zonder quantity ontvangt Exact de rest van die regel) |
| remarks | string | Nee | Opmerkingen op de ontvangst |
| description | string | Nee | Omschrijving (max. 60 tekens) |
| dry_run | boolean | Nee | true = alleen tonen, niets sturen |
| confirm | boolean | Nee | Moet true zijn om echt te ontvangen |
Voorbeeldvraag
"Boek de ontvangst van bestelling 1234 in"
Schrijftools: Inrichting (Pro/Enterprise)
Kostenplaatsen, kostendragers en projecten aanmaken of bijwerken. Vereisen dat je schrijfrechten expliciet aanzet per administratie in je dashboard (Pro en Enterprise). Elke schrijfactie komt in een audit-log; verwijderen staat standaard uit, ook als schrijven aan staat.
create_cost_center
Maak een nieuwe kostenplaats aan. Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Unieke code van de kostenplaats (max. 8 tekens, Exact-limiet)
- Type:
- string
- Omschrijving
- Omschrijving (bijv. "Afdeling Verkoop")
- Type:
- boolean
- Omschrijving
- Is de kostenplaats actief?
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| code | string | Ja | Unieke code van de kostenplaats (max. 8 tekens, Exact-limiet) |
| description | string | Ja | Omschrijving (bijv. "Afdeling Verkoop") |
| active | boolean | Nee | Is de kostenplaats actief? |
Voorbeeldvraag
"Maak een kostenplaats VERKOOP aan"
update_cost_center
Werk een bestaande kostenplaats bij (omschrijving, actief/inactief). Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- ID (GUID) van de kostenplaats, uit get_cost_centers. Geef id óf code
- Type:
- string
- Omschrijving
- Code van de kostenplaats, alternatief voor id
- Type:
- string
- Omschrijving
- Nieuwe omschrijving
- Type:
- boolean
- Omschrijving
- Activeer (true) of deactiveer (false)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| id | string | Nee | ID (GUID) van de kostenplaats, uit get_cost_centers. Geef id óf code |
| code | string | Nee | Code van de kostenplaats, alternatief voor id |
| description | string | Nee | Nieuwe omschrijving |
| active | boolean | Nee | Activeer (true) of deactiveer (false) |
Voorbeeldvraag
"Hernoem kostenplaats VERKOOP naar Sales"
create_cost_unit
Maak een nieuwe kostendrager aan. Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Unieke code van de kostendrager (max. 8 tekens, Exact-limiet)
- Type:
- string
- Omschrijving
- Omschrijving (bijv. "Project Website")
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| code | string | Ja | Unieke code van de kostendrager (max. 8 tekens, Exact-limiet) |
| description | string | Ja | Omschrijving (bijv. "Project Website") |
Voorbeeldvraag
"Maak een kostendrager PROJ-001 aan"
update_cost_unit
Werk een bestaande kostendrager bij. Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- ID (GUID) van de kostendrager. Geef id óf code
- Type:
- string
- Omschrijving
- Code van de kostendrager, alternatief voor id
- Type:
- string
- Omschrijving
- Nieuwe omschrijving
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| id | string | Nee | ID (GUID) van de kostendrager. Geef id óf code |
| code | string | Nee | Code van de kostendrager, alternatief voor id |
| description | string | Nee | Nieuwe omschrijving |
Voorbeeldvraag
"Wijzig de omschrijving van kostendrager PROJ-001"
create_project
Maak een nieuw project aan, optioneel gekoppeld aan een klant. Vereist schrijfrechten + Projects module actief
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Unieke projectcode (bijv. "PRJ-001")
- Type:
- string
- Omschrijving
- Omschrijving/naam van het project
- Type:
- string
- Omschrijving
- Projecttype: vaste_prijs, nacalculatie, niet_facturabel, vooruitbetaald of campagne
- Type:
- string
- Omschrijving
- Klant ID (GUID), uit search_relations. Geef account_id óf account_code
- Type:
- string
- Omschrijving
- Relatiecode van de klant, alternatief voor account_id
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| code | string | Ja | Unieke projectcode (bijv. "PRJ-001") |
| description | string | Ja | Omschrijving/naam van het project |
| type | string | Ja | Projecttype: vaste_prijs, nacalculatie, niet_facturabel, vooruitbetaald of campagne |
| account_id | string | Nee | Klant ID (GUID), uit search_relations. Geef account_id óf account_code |
| account_code | string | Nee | Relatiecode van de klant, alternatief voor account_id |
Voorbeeldvraag
"Maak een nacalculatie-project aan voor klant X"
update_project
Werk een bestaand project bij (omschrijving, looptijd, notities). Vereist schrijfrechten + Projects module actief
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- ID (GUID) van het project. Geef id óf code
- Type:
- string
- Omschrijving
- Projectcode, alternatief voor id
- Type:
- string
- Omschrijving
- Nieuwe omschrijving/naam
- Type:
- string
- Omschrijving
- Nieuwe startdatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Nieuwe einddatum (YYYY-MM-DD); in het verleden = project "Afgerond"
- Type:
- string
- Omschrijving
- Nieuwe notities bij het project
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| id | string | Nee | ID (GUID) van het project. Geef id óf code |
| code | string | Nee | Projectcode, alternatief voor id |
| description | string | Nee | Nieuwe omschrijving/naam |
| start_date | string | Nee | Nieuwe startdatum (YYYY-MM-DD) |
| end_date | string | Nee | Nieuwe einddatum (YYYY-MM-DD); in het verleden = project "Afgerond" |
| notes | string | Nee | Nieuwe notities bij het project |
Voorbeeldvraag
"Zet de einddatum van project PRJ-001 op 31 december"
Schrijftools: Verkoop (Pro/Enterprise)
Schrijftools — vereisen dat je schrijfrechten expliciet aanzet per administratie in je dashboard (Pro en Enterprise). Elke schrijfactie komt in een audit-log; verwijderen staat standaard uit, ook als schrijven aan staat.
create_sales_invoice
Maak een nieuwe verkoopfactuur aan, standaard als concept. Zet process=true om direct te verwerken, of gebruik later process_sales_invoice. Vereist schrijfrechten + Sales Invoices module actief
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Klant ID (GUID), uit search_relations
- Type:
- string
- Omschrijving
- Omschrijving van de factuur
- Type:
- string
- Omschrijving
- Dagboekcode voor de factuur (default: standaard verkoopboek)
- Type:
- string
- Omschrijving
- Factuurdatum/boekdatum (YYYY-MM-DD), default vandaag
- Type:
- string
- Omschrijving
- Code van de betalingsconditie (bijv. "14" voor 14 dagen)
- Type:
- string
- Omschrijving
- Referentie/PO-nummer van de klant
- Type:
- string
- Omschrijving
- Opmerkingen op de kop (Remarks)
- Type:
- string
- Omschrijving
- Afwijkende factuurrelatie (GUID); of invoice_to_code met de relatiecode
- Type:
- string
- Omschrijving
- Afwijkende afleverrelatie (GUID); of deliver_to_code met de relatiecode
- Type:
- number
- Omschrijving
- Korting op het hele document in procenten (10 = 10%)
- Type:
- string
- Omschrijving
- Verkoper (gebruikers-GUID uit salesperson_id van een bestaand document)
- Type:
- string
- Omschrijving
- Verkoopkanaalcode (Stamgegevens > Verkoopkanalen)
- Type:
- array
- Omschrijving
- Factuurregels (min. 1): item_id, quantity, en optioneel unit_price, description, vat_code, cost_center, cost_unit, discount_percent, notes, project_code
- Type:
- boolean
- Omschrijving
- Direct verwerken naar het grootboek? Default false = concept (onomkeerbaar bij true)
- Type:
- string
- Omschrijving
- Eigen unieke sleutel per factuur; een herhaalde aanroep maakt dan geen dubbele factuur en verwerkt niets opnieuw. Kies iets dat twee facturen nooit delen, bijv. relatiecode + ordernummer, en geef er your_ref of description bij, anders kan een herhaling na een time-out de factuur niet terugvinden. Een zo teruggevonden concept wordt niet alsnog verwerkt; dat doet process_sales_invoice. Sleutels vervallen na 90 dagen. Loopt de eerste aanroep nog (korter dan vijf minuten geleden gestart), dan krijg je een melding met retry_after_seconds; herhaal daarna met dezelfde sleutel.
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| customer_id | string | Ja | Klant ID (GUID), uit search_relations |
| description | string | Nee | Omschrijving van de factuur |
| journal | string | Nee | Dagboekcode voor de factuur (default: standaard verkoopboek) |
| invoice_date | string | Nee | Factuurdatum/boekdatum (YYYY-MM-DD), default vandaag |
| payment_condition | string | Nee | Code van de betalingsconditie (bijv. "14" voor 14 dagen) |
| your_ref | string | Nee | Referentie/PO-nummer van de klant |
| remarks | string | Nee | Opmerkingen op de kop (Remarks) |
| invoice_to_id | string | Nee | Afwijkende factuurrelatie (GUID); of invoice_to_code met de relatiecode |
| deliver_to_id | string | Nee | Afwijkende afleverrelatie (GUID); of deliver_to_code met de relatiecode |
| discount_percent | number | Nee | Korting op het hele document in procenten (10 = 10%) |
| salesperson_id | string | Nee | Verkoper (gebruikers-GUID uit salesperson_id van een bestaand document) |
| sales_channel_code | string | Nee | Verkoopkanaalcode (Stamgegevens > Verkoopkanalen) |
| lines | array | Ja | Factuurregels (min. 1): item_id, quantity, en optioneel unit_price, description, vat_code, cost_center, cost_unit, discount_percent, notes, project_code |
| process | boolean | Nee | Direct verwerken naar het grootboek? Default false = concept (onomkeerbaar bij true) |
| idempotency_key | string | Nee | Eigen unieke sleutel per factuur; een herhaalde aanroep maakt dan geen dubbele factuur en verwerkt niets opnieuw. Kies iets dat twee facturen nooit delen, bijv. relatiecode + ordernummer, en geef er your_ref of description bij, anders kan een herhaling na een time-out de factuur niet terugvinden. Een zo teruggevonden concept wordt niet alsnog verwerkt; dat doet process_sales_invoice. Sleutels vervallen na 90 dagen. Loopt de eerste aanroep nog (korter dan vijf minuten geleden gestart), dan krijg je een melding met retry_after_seconds; herhaal daarna met dezelfde sleutel. |
Voorbeeldvraag
"Maak een verkoopfactuur voor klant X: 5x artikel A à €100"
create_sales_entry
Maak een verkoopboeking aan in een verkoopdagboek zónder factuurdocument: de boeking van een factuur die buiten Exact is gemaakt (kassasysteem, eventsoftware, uitgevallen koppeling). Jij geeft klant, factuurdatum, factuurnummer en de omzetregels met btw-code; Exact maakt de debiteur- en btw-regels zelf. Bestaat het boekstuknummer al, dan boekt de tool niets. Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Klant: ID (GUID) of relatiecode, uit search_relations (of customer_code)
- Type:
- string
- Omschrijving
- Verkoopdagboek-code (bijv. "71"); bij meerdere verkoopdagboeken vraagt de tool welke
- Type:
- string
- Omschrijving
- Factuurdatum = boekdatum (YYYY-MM-DD); de tool vraagt erom als je hem weglaat
- Type:
- number
- Omschrijving
- Boekstuknummer = factuurnummer van het voorsysteem; bestaat het al in dit dagboek en boekjaar, dan weigert de tool
- Type:
- string
- Omschrijving
- Referentie van de klant, bijvoorbeeld het factuurnummer uit het voorsysteem
- Type:
- string
- Omschrijving
- Omschrijving van de boeking
- Type:
- string
- Omschrijving
- Vervaldatum (YYYY-MM-DD); anders afgeleid uit de betalingsconditie
- Type:
- string
- Omschrijving
- Code van de betalingsconditie
- Type:
- string
- Omschrijving
- Eigen unieke sleutel per boeking; een herhaalde aanroep maakt dan geen dubbele boeking. Kies iets dat twee facturen nooit delen, bijv. dagboek + factuurnummer, en geef er entry_number, your_ref of description bij, anders kan een herhaling na een time-out de boeking niet terugvinden. Sleutels vervallen na 90 dagen. Loopt de eerste aanroep nog (korter dan vijf minuten geleden gestart), dan krijg je een melding met retry_after_seconds; herhaal daarna met dezelfde sleutel.
- Type:
- array
- Omschrijving
- Omzetregels (min. 1): gl_account_code, amount (excl. btw), vat_code (verplicht), en optioneel vat_amount, description, cost_center, cost_unit, project_id, quantity, from/to
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| customer_id | string | Ja | Klant: ID (GUID) of relatiecode, uit search_relations (of customer_code) |
| journal_code | string | Nee | Verkoopdagboek-code (bijv. "71"); bij meerdere verkoopdagboeken vraagt de tool welke |
| entry_date | string | Nee | Factuurdatum = boekdatum (YYYY-MM-DD); de tool vraagt erom als je hem weglaat |
| entry_number | number | Nee | Boekstuknummer = factuurnummer van het voorsysteem; bestaat het al in dit dagboek en boekjaar, dan weigert de tool |
| your_ref | string | Nee | Referentie van de klant, bijvoorbeeld het factuurnummer uit het voorsysteem |
| description | string | Nee | Omschrijving van de boeking |
| due_date | string | Nee | Vervaldatum (YYYY-MM-DD); anders afgeleid uit de betalingsconditie |
| payment_condition | string | Nee | Code van de betalingsconditie |
| idempotency_key | string | Nee | Eigen unieke sleutel per boeking; een herhaalde aanroep maakt dan geen dubbele boeking. Kies iets dat twee facturen nooit delen, bijv. dagboek + factuurnummer, en geef er entry_number, your_ref of description bij, anders kan een herhaling na een time-out de boeking niet terugvinden. Sleutels vervallen na 90 dagen. Loopt de eerste aanroep nog (korter dan vijf minuten geleden gestart), dan krijg je een melding met retry_after_seconds; herhaal daarna met dezelfde sleutel. |
| lines | array | Ja | Omzetregels (min. 1): gl_account_code, amount (excl. btw), vat_code (verplicht), en optioneel vat_amount, description, cost_center, cost_unit, project_id, quantity, from/to |
Voorbeeldvraag
"Boek factuur 26600123 uit het kassasysteem in dagboek 70: €1.000 omzet 21% en €400 horeca 9% op kostendrager 100"
update_sales_entry
Corrigeer de kopvelden van een bestaande, nog niet verwerkte verkoopboeking: omschrijving, referentie van de klant, boekdatum, vervaldatum, betalingsconditie, betalingskenmerk, boekjaar en periode. Klant, dagboek, bedragen en regels blijven bewust buiten bereik. Standaard een proef (dry_run); na het schrijven leest de tool terug of elk veld echt staat. Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- EntryID van de verkoopboeking (GUID); geef entry_id of entry_number
- Type:
- number
- Omschrijving
- Boekstuknummer van de verkoopboeking; bij meerdere dagboeken ook journal_code meegeven
- Type:
- string
- Omschrijving
- Verkoopdagboek-code om een boekstuknummer eenduidig te maken
- Type:
- object
- Omschrijving
- Kopvelden: description, your_ref, entry_date, due_date, payment_condition, payment_reference, financial_year en financial_period
- Type:
- boolean
- Omschrijving
- Standaard true: alleen tonen wat er zou veranderen; false om door te voeren
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| entry_id | string | Nee | EntryID van de verkoopboeking (GUID); geef entry_id of entry_number |
| entry_number | number | Nee | Boekstuknummer van de verkoopboeking; bij meerdere dagboeken ook journal_code meegeven |
| journal_code | string | Nee | Verkoopdagboek-code om een boekstuknummer eenduidig te maken |
| header | object | Ja | Kopvelden: description, your_ref, entry_date, due_date, payment_condition, payment_reference, financial_year en financial_period |
| dry_run | boolean | Nee | Standaard true: alleen tonen wat er zou veranderen; false om door te voeren |
Voorbeeldvraag
"Zet de vervaldatum van verkoopboeking 26700022 op 15 oktober"
delete_sales_entry
Verwijder een verkoopboeking die nog niet verwerkt is (status 20), bijvoorbeeld eentje die per ongeluk dubbel is aangemaakt. Een verwerkte boeking is een fiscaal document en gaat hier nooit weg; die corrigeer je met een creditnota of een memoriaalboeking. Hangt er een bijlage aan de boeking, dan weigert de tool. Na het verwijderen leest hij terug of de boeking echt weg is. Vereist schrijfrechten (categorie Verkoop) én de verwijderschakelaar op het dashboard
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- EntryID van de verkoopboeking (GUID); geef entry_id of entry_number
- Type:
- number
- Omschrijving
- Boekstuknummer van de verkoopboeking; bij meerdere dagboeken ook journal_code meegeven
- Type:
- string
- Omschrijving
- Verkoopdagboek-code om een boekstuknummer eenduidig te maken
- Type:
- boolean
- Omschrijving
- Moet true zijn; bevestigt dat de boeking definitief verwijderd mag worden
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| entry_id | string | Nee | EntryID van de verkoopboeking (GUID); geef entry_id of entry_number |
| entry_number | number | Nee | Boekstuknummer van de verkoopboeking; bij meerdere dagboeken ook journal_code meegeven |
| journal_code | string | Nee | Verkoopdagboek-code om een boekstuknummer eenduidig te maken |
| confirm | boolean | Ja | Moet true zijn; bevestigt dat de boeking definitief verwijderd mag worden |
Voorbeeldvraag
"Verwijder verkoopboeking 4521 uit dagboek 70, die is per ongeluk dubbel geboekt"
process_sales_invoice
Verwerk een bestaande conceptfactuur naar het grootboek (debiteur + omzet). Onomkeerbaar. Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- InvoiceID (GUID) van de conceptfactuur
- Type:
- string
- Omschrijving
- Boekdatum voor verwerking (default: factuurdatum van het concept)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| invoice_id | string | Ja | InvoiceID (GUID) van de conceptfactuur |
| invoice_date | string | Nee | Boekdatum voor verwerking (default: factuurdatum van het concept) |
Voorbeeldvraag
"Verwerk deze conceptfactuur naar het grootboek"
credit_sales_invoice
Maak een verkoopcreditnota aan die een eerdere verkoop terugboekt. Vereist schrijfrechten + Sales Invoices module actief
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Klant ID (GUID); geef dit of customer_code
- Type:
- string
- Omschrijving
- Relatiecode van de klant
- Type:
- string
- Omschrijving
- Opmerkingen op de kop (Remarks)
- Type:
- string
- Omschrijving
- Afwijkende factuurrelatie (GUID); of invoice_to_code met de relatiecode
- Type:
- string
- Omschrijving
- Afwijkende afleverrelatie (GUID); of deliver_to_code met de relatiecode
- Type:
- number
- Omschrijving
- Korting op het hele document in procenten (10 = 10%)
- Type:
- string
- Omschrijving
- Verkoper (gebruikers-GUID uit salesperson_id van een bestaand document)
- Type:
- string
- Omschrijving
- Verkoopkanaalcode (Stamgegevens > Verkoopkanalen)
- Type:
- array
- Omschrijving
- Creditnotaregels (positieve aantallen; de tool boekt het als terugboeking), discount_percent, notes, project_code
- Type:
- string
- Omschrijving
- Verwijzing naar de originele factuur (aanrader voor traceerbaarheid)
- Type:
- boolean
- Omschrijving
- Direct verwerken naar het grootboek? Default false (concept)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| customer_id | string | Nee | Klant ID (GUID); geef dit of customer_code |
| customer_code | string | Nee | Relatiecode van de klant |
| remarks | string | Nee | Opmerkingen op de kop (Remarks) |
| invoice_to_id | string | Nee | Afwijkende factuurrelatie (GUID); of invoice_to_code met de relatiecode |
| deliver_to_id | string | Nee | Afwijkende afleverrelatie (GUID); of deliver_to_code met de relatiecode |
| discount_percent | number | Nee | Korting op het hele document in procenten (10 = 10%) |
| salesperson_id | string | Nee | Verkoper (gebruikers-GUID uit salesperson_id van een bestaand document) |
| sales_channel_code | string | Nee | Verkoopkanaalcode (Stamgegevens > Verkoopkanalen) |
| lines | array | Ja | Creditnotaregels (positieve aantallen; de tool boekt het als terugboeking), discount_percent, notes, project_code |
| your_ref | string | Nee | Verwijzing naar de originele factuur (aanrader voor traceerbaarheid) |
| process | boolean | Nee | Direct verwerken naar het grootboek? Default false (concept) |
Voorbeeldvraag
"Maak een creditnota voor klant X bij factuur 2026-042: 5x artikel A à €100"
send_sales_invoice
Verstuur een nog niet verwerkte verkoopfactuur naar de klant (e-mail, Peppol of digitaal postvak). Standaard een proef (dry_run): niets verstuurd of geboekt; bij e-mail zie je de adressen van factuurcontact, klantkaart en hoofdcontactpersoon (bij een contactpersoon ook een afwijkend zakelijk adres). Echt versturen vereist dry_run: false en confirm: true; zo kost een verzending normaal twee aanroepen. Blijft het toch bij een proef, ververs dan de tools van de koppeling. Versturen verwerkt de factuur ook onomkeerbaar naar het grootboek. Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- InvoiceID (GUID) van de factuur. Een al verwerkte factuur verstuur je vanuit Exact Online zelf
- Type:
- string
- Omschrijving
- Verzendkanaal: email, peppol, postbox (digitaal postvak) of account_default (Exact kiest het kanaal dat bij de klant is ingesteld)
- Type:
- boolean
- Omschrijving
- Standaard true, bij elk kanaal: alleen tonen wat er zou gebeuren, niets versturen of boeken
- Type:
- boolean
- Omschrijving
- Moet true zijn bij dry_run: false; zonder confirm weigert de tool en wordt er niets verstuurd of geboekt
- Type:
- string
- Omschrijving
- Verkoopsjabloon als naam of GUID; zonder layout kiest Exact zijn eigen standaard. Bij geen of meerdere treffers krijg je de lijst en wordt er niets verstuurd
- Type:
- string
- Omschrijving
- Afzenderadres, alleen van belang bij e-mail; standaard het bedrijfs-e-mailadres van de administratie
- Type:
- string
- Omschrijving
- Extra tekst op het document en in de e-mail
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| invoice_id | string | Ja | InvoiceID (GUID) van de factuur. Een al verwerkte factuur verstuur je vanuit Exact Online zelf |
| method | string | Ja | Verzendkanaal: email, peppol, postbox (digitaal postvak) of account_default (Exact kiest het kanaal dat bij de klant is ingesteld) |
| dry_run | boolean | Nee | Standaard true, bij elk kanaal: alleen tonen wat er zou gebeuren, niets versturen of boeken |
| confirm | boolean | Nee | Moet true zijn bij dry_run: false; zonder confirm weigert de tool en wordt er niets verstuurd of geboekt |
| layout | string | Nee | Verkoopsjabloon als naam of GUID; zonder layout kiest Exact zijn eigen standaard. Bij geen of meerdere treffers krijg je de lijst en wordt er niets verstuurd |
| sender_email | string | Nee | Afzenderadres, alleen van belang bij e-mail; standaard het bedrijfs-e-mailadres van de administratie |
| extra_text | string | Nee | Extra tekst op het document en in de e-mail |
Voorbeeldvraag
"Stuur factuur 2026-042 per e-mail naar de klant"
send_sales_order
Stuur een orderbevestiging naar de klant, of maak alleen het orderdocument aan. Bij e-mail standaard een proef (dry_run): niets verstuurd; je ziet de adressen van contactpersonen op de order, klantkaart en hoofdcontactpersoon (bij een contactpersoon ook een afwijkend zakelijk adres). Echt versturen vereist dry_run: false en confirm: true; zo kost een verzending per e-mail normaal twee aanroepen. Blijft het toch bij een proef, ververs dan de tools van de koppeling. Raakt de boekhouding en de orderstatus niet. Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- OrderID (GUID) van de verkooporder
- Type:
- string
- Omschrijving
- Verzendkanaal: email (naar de klant) of print (Exact maakt alleen het orderdocument aan en hangt het aan de order)
- Type:
- boolean
- Omschrijving
- Standaard true bij e-mail en false bij print, dus print blijft één aanroep. Met true alleen tonen wat er zou gebeuren
- Type:
- boolean
- Omschrijving
- Moet true zijn bij e-mail en dry_run: false; zonder confirm weigert de tool en wordt er niets verstuurd
- Type:
- string
- Omschrijving
- Afzenderadres; standaard het bedrijfs-e-mailadres van de administratie. Het adres moet in Exact gevalideerd zijn, anders weigert Exact
- Type:
- string
- Omschrijving
- Extra tekst op het document en in de e-mail
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| order_id | string | Ja | OrderID (GUID) van de verkooporder |
| method | string | Ja | Verzendkanaal: email (naar de klant) of print (Exact maakt alleen het orderdocument aan en hangt het aan de order) |
| dry_run | boolean | Nee | Standaard true bij e-mail en false bij print, dus print blijft één aanroep. Met true alleen tonen wat er zou gebeuren |
| confirm | boolean | Nee | Moet true zijn bij e-mail en dry_run: false; zonder confirm weigert de tool en wordt er niets verstuurd |
| sender_email | string | Nee | Afzenderadres; standaard het bedrijfs-e-mailadres van de administratie. Het adres moet in Exact gevalideerd zijn, anders weigert Exact |
| extra_text | string | Nee | Extra tekst op het document en in de e-mail |
Voorbeeldvraag
"Stuur de orderbevestiging van order 32 per e-mail naar de klant"
create_quotation
Maak een offerte aan inclusief alle offerteregels in één call. De offerte blijft concept; er gaat niets naar de klant. Afdrukken, versturen, accepteren en afwijzen doe je in Exact zelf: de Exact API laat dat niet toe (gemeten op 15 september 2026). Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Klant ID (GUID); geef dit of customer_code
- Type:
- string
- Omschrijving
- Relatiecode van de klant
- Type:
- string
- Omschrijving
- Omschrijving van de offerte
- Type:
- string
- Omschrijving
- Offertedatum (YYYY-MM-DD), default vandaag
- Type:
- string
- Omschrijving
- Geldig tot (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Referentie van de klant
- Type:
- string
- Omschrijving
- Opmerkingen bij de offerte
- Type:
- string
- Omschrijving
- Code van de betalingsconditie
- Type:
- string
- Omschrijving
- Afwijkende factuurrelatie (GUID); of invoice_to_code met de relatiecode
- Type:
- string
- Omschrijving
- Afwijkende afleverrelatie (GUID); of deliver_to_code met de relatiecode
- Type:
- string
- Omschrijving
- Verkoper (gebruikers-GUID uit salesperson_id van een bestaand document)
- Type:
- string
- Omschrijving
- Verkoopkanaalcode (Stamgegevens > Verkoopkanalen)
- Type:
- string
- Omschrijving
- Gewenste leverdatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Verkoopkans (GUID uit get_opportunities)
- Type:
- string
- Omschrijving
- Projectcode (get_projects); het project staat op de kop
- Type:
- array
- Omschrijving
- Offerteregels: item_id, quantity, en optioneel unit_price, description, vat_code, discount, cost_center, cost_unit (fractie) of discount_percent, notes
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| customer_id | string | Nee | Klant ID (GUID); geef dit of customer_code |
| customer_code | string | Nee | Relatiecode van de klant |
| description | string | Nee | Omschrijving van de offerte |
| quotation_date | string | Nee | Offertedatum (YYYY-MM-DD), default vandaag |
| due_date | string | Nee | Geldig tot (YYYY-MM-DD) |
| your_ref | string | Nee | Referentie van de klant |
| remarks | string | Nee | Opmerkingen bij de offerte |
| payment_condition | string | Nee | Code van de betalingsconditie |
| invoice_to_id | string | Nee | Afwijkende factuurrelatie (GUID); of invoice_to_code met de relatiecode |
| deliver_to_id | string | Nee | Afwijkende afleverrelatie (GUID); of deliver_to_code met de relatiecode |
| salesperson_id | string | Nee | Verkoper (gebruikers-GUID uit salesperson_id van een bestaand document) |
| sales_channel_code | string | Nee | Verkoopkanaalcode (Stamgegevens > Verkoopkanalen) |
| delivery_date | string | Nee | Gewenste leverdatum (YYYY-MM-DD) |
| opportunity_id | string | Nee | Verkoopkans (GUID uit get_opportunities) |
| project_code | string | Nee | Projectcode (get_projects); het project staat op de kop |
| lines | array | Ja | Offerteregels: item_id, quantity, en optioneel unit_price, description, vat_code, discount, cost_center, cost_unit (fractie) of discount_percent, notes |
Voorbeeldvraag
"Maak een offerte voor klant X: 2x advies à €150, geldig tot eind augustus"
update_quotation
Werk de kopvelden van een bestaande offerte bij zolang hij concept, open of afgedrukt is: omschrijving, datums, referentie, opmerkingen, betalingsconditie, leverdatum, verkoper, verkoopkanaal, verkoopkans en project. Geen status en geen regels. De factuur- en afleverrelatie liggen na het aanmaken vast; Exact weigert een wijziging, dus daarvoor maak je een nieuwe offerte. De offerte wordt teruggelezen en per veld vergeleken. Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Offerte-id (GUID) uit get_quotations
- Type:
- string
- Omschrijving
- Nieuwe omschrijving (max. 60 tekens)
- Type:
- string
- Omschrijving
- Nieuwe offertedatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Nieuwe vervaldatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Nieuwe klantreferentie ("" maakt leeg)
- Type:
- string
- Omschrijving
- Nieuwe opmerkingen ("" maakt leeg)
- Type:
- string
- Omschrijving
- Nieuwe betalingsconditiecode
- Type:
- string
- Omschrijving
- Nieuwe leverdatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Verkoper (gebruikers-GUID)
- Type:
- string
- Omschrijving
- Verkoopkanaalcode
- Type:
- string
- Omschrijving
- Verkoopkans (GUID)
- Type:
- string
- Omschrijving
- Projectcode (get_projects)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| quotation_id | string | Ja | Offerte-id (GUID) uit get_quotations |
| description | string | Nee | Nieuwe omschrijving (max. 60 tekens) |
| quotation_date | string | Nee | Nieuwe offertedatum (YYYY-MM-DD) |
| due_date | string | Nee | Nieuwe vervaldatum (YYYY-MM-DD) |
| your_ref | string | Nee | Nieuwe klantreferentie ("" maakt leeg) |
| remarks | string | Nee | Nieuwe opmerkingen ("" maakt leeg) |
| payment_condition | string | Nee | Nieuwe betalingsconditiecode |
| delivery_date | string | Nee | Nieuwe leverdatum (YYYY-MM-DD) |
| salesperson_id | string | Nee | Verkoper (gebruikers-GUID) |
| sales_channel_code | string | Nee | Verkoopkanaalcode |
| opportunity_id | string | Nee | Verkoopkans (GUID) |
| project_code | string | Nee | Projectcode (get_projects) |
Voorbeeldvraag
"Verleng offerte 12 tot 15 oktober en koppel hem aan project Verbouwing"
create_sales_invoices_from_orders
Maak in één keer concept-facturen uit verkooporders. De facturen zijn nog niet geboekt en gaan niet naar de klant. Vereist schrijfrechten; zit niet in elke Exact-editie
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- array
- Omschrijving
- Order-IDs (GUIDs) uit get_sales_orders, maximaal 100 per aanroep
- Type:
- string
- Omschrijving
- Dagboekcode voor de facturen; zoek op met get_journals
- Type:
- string
- Omschrijving
- per_order (default) of per_customer (orders van dezelfde klant op één factuur)
- Type:
- string
- Omschrijving
- delivered (default, alleen het geleverde) of ordered (het volledige bestelde aantal)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| sales_order_ids | array | Ja | Order-IDs (GUIDs) uit get_sales_orders, maximaal 100 per aanroep |
| journal | string | Ja | Dagboekcode voor de facturen; zoek op met get_journals |
| create_mode | string | Nee | per_order (default) of per_customer (orders van dezelfde klant op één factuur) |
| invoice_mode | string | Nee | delivered (default, alleen het geleverde) of ordered (het volledige bestelde aantal) |
Voorbeeldvraag
"Factureer de geleverde orders van deze week in dagboek 70"
create_sales_order
Maak een nieuwe verkooporder aan. Vereist schrijfrechten + Sales Orders module actief
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Klant ID (GUID), uit search_relations
- Type:
- string
- Omschrijving
- Omschrijving van de verkooporder
- Type:
- string
- Omschrijving
- Orderdatum (YYYY-MM-DD), default vandaag
- Type:
- string
- Omschrijving
- Gewenste leverdatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Code van de betalingsconditie
- Type:
- string
- Omschrijving
- Referentie/PO-nummer van de klant
- Type:
- string
- Omschrijving
- Kopnotitie/opmerkingen op de order
- Type:
- string
- Omschrijving
- Afleveradres-id (GUID) uit search_relations met include_addresses
- Type:
- string
- Omschrijving
- Magazijncode (get_warehouses); zonder = standaardmagazijn
- Type:
- string
- Omschrijving
- Eigen unieke sleutel per bestelling; een herhaalde aanroep maakt dan geen dubbele order. Kies iets dat twee bestellingen nooit delen, bijv. het mail-id of relatiecode + PO-nummer. Sleutels vervallen na 90 dagen. Loopt de eerste aanroep nog (korter dan vijf minuten geleden gestart), dan krijg je een melding met retry_after_seconds; herhaal daarna met dezelfde sleutel.
- Type:
- string
- Omschrijving
- Afwijkende factuurrelatie (GUID); of invoice_to_code met de relatiecode
- Type:
- string
- Omschrijving
- Afwijkende afleverrelatie (GUID); of deliver_to_code met de relatiecode
- Type:
- number
- Omschrijving
- Korting op het hele document in procenten (10 = 10%)
- Type:
- string
- Omschrijving
- Verkoper (gebruikers-GUID uit salesperson_id van een bestaand document)
- Type:
- string
- Omschrijving
- Verkoopkanaalcode (Stamgegevens > Verkoopkanalen)
- Type:
- array
- Omschrijving
- Orderregels (min. 1): item_id of item_code, quantity, en optioneel unit_price, description, unit_code, cost_center, cost_unit, vat_code, discount_percent, notes, project_code
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| customer_id | string | Ja | Klant ID (GUID), uit search_relations |
| description | string | Nee | Omschrijving van de verkooporder |
| order_date | string | Nee | Orderdatum (YYYY-MM-DD), default vandaag |
| delivery_date | string | Nee | Gewenste leverdatum (YYYY-MM-DD) |
| payment_condition | string | Nee | Code van de betalingsconditie |
| your_ref | string | Nee | Referentie/PO-nummer van de klant |
| remarks | string | Nee | Kopnotitie/opmerkingen op de order |
| delivery_address_id | string | Nee | Afleveradres-id (GUID) uit search_relations met include_addresses |
| warehouse_code | string | Nee | Magazijncode (get_warehouses); zonder = standaardmagazijn |
| idempotency_key | string | Nee | Eigen unieke sleutel per bestelling; een herhaalde aanroep maakt dan geen dubbele order. Kies iets dat twee bestellingen nooit delen, bijv. het mail-id of relatiecode + PO-nummer. Sleutels vervallen na 90 dagen. Loopt de eerste aanroep nog (korter dan vijf minuten geleden gestart), dan krijg je een melding met retry_after_seconds; herhaal daarna met dezelfde sleutel. |
| invoice_to_id | string | Nee | Afwijkende factuurrelatie (GUID); of invoice_to_code met de relatiecode |
| deliver_to_id | string | Nee | Afwijkende afleverrelatie (GUID); of deliver_to_code met de relatiecode |
| discount_percent | number | Nee | Korting op het hele document in procenten (10 = 10%) |
| salesperson_id | string | Nee | Verkoper (gebruikers-GUID uit salesperson_id van een bestaand document) |
| sales_channel_code | string | Nee | Verkoopkanaalcode (Stamgegevens > Verkoopkanalen) |
| lines | array | Ja | Orderregels (min. 1): item_id of item_code, quantity, en optioneel unit_price, description, unit_code, cost_center, cost_unit, vat_code, discount_percent, notes, project_code |
Voorbeeldvraag
"Maak een verkooporder aan voor klant X: 10x artikel B"
update_sales_order
Werk een bestaande verkooporder bij op orderniveau (geen regels; daarvoor is update_sales_order_line). Factuur- en afleverrelatie zijn na aanmaken niet meer te wijzigen. Vereist schrijfrechten + Sales Orders module actief
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Verkooporder ID (GUID), uit get_sales_orders
- Type:
- string
- Omschrijving
- Nieuwe omschrijving van de verkooporder
- Type:
- string
- Omschrijving
- Nieuwe gewenste leverdatum (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Nieuw PO-nummer van de klant ("" maakt leeg)
- Type:
- string
- Omschrijving
- Nieuwe betalingsconditiecode
- Type:
- string
- Omschrijving
- Nieuwe kopnotitie ("" maakt leeg)
- Type:
- string
- Omschrijving
- Nieuw afleveradres-id (GUID) uit search_relations met include_addresses
- Type:
- string
- Omschrijving
- Nieuwe magazijncode (get_warehouses)
- Type:
- number
- Omschrijving
- Korting op het hele document in procenten (10 = 10%)
- Type:
- string
- Omschrijving
- Verkoper (gebruikers-GUID uit salesperson_id van een bestaand document)
- Type:
- string
- Omschrijving
- Verkoopkanaalcode (Stamgegevens > Verkoopkanalen)
- Type:
- number
- Omschrijving
- Nieuwe status: 12=open, 20=deels geleverd, 21=afgerond. 45 (annuleren) voert Exact via de API niet door; de tool leest de status terug en meldt dat
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| order_id | string | Ja | Verkooporder ID (GUID), uit get_sales_orders |
| description | string | Nee | Nieuwe omschrijving van de verkooporder |
| delivery_date | string | Nee | Nieuwe gewenste leverdatum (YYYY-MM-DD) |
| your_ref | string | Nee | Nieuw PO-nummer van de klant ("" maakt leeg) |
| payment_condition | string | Nee | Nieuwe betalingsconditiecode |
| remarks | string | Nee | Nieuwe kopnotitie ("" maakt leeg) |
| delivery_address_id | string | Nee | Nieuw afleveradres-id (GUID) uit search_relations met include_addresses |
| warehouse_code | string | Nee | Nieuwe magazijncode (get_warehouses) |
| discount_percent | number | Nee | Korting op het hele document in procenten (10 = 10%) |
| salesperson_id | string | Nee | Verkoper (gebruikers-GUID uit salesperson_id van een bestaand document) |
| sales_channel_code | string | Nee | Verkoopkanaalcode (Stamgegevens > Verkoopkanalen) |
| status | number | Nee | Nieuwe status: 12=open, 20=deels geleverd, 21=afgerond. 45 (annuleren) voert Exact via de API niet door; de tool leest de status terug en meldt dat |
Voorbeeldvraag
"Wijzig de leverdatum van deze verkooporder"
update_sales_order_line
Werk één regel van een bestaande verkooporder bij: aantal, prijs, korting, omschrijving, leverdatum of notitie. De regel wordt na de wijziging teruggelezen en per veld vergeleken. Aantal, prijs en korting niet meer op een regel waar al van geleverd of gefactureerd is. Vereist schrijfrechten + Sales Orders module actief
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Regel-id (GUID) uit get_sales_orders met include_lines of search_sales_order_lines
- Type:
- number
- Omschrijving
- Nieuw aantal (niet 0)
- Type:
- number
- Omschrijving
- Nieuwe prijs per eenheid, exclusief btw
- Type:
- number
- Omschrijving
- Nieuwe regelkorting in procenten; 0 haalt hem weg
- Type:
- string
- Omschrijving
- Nieuwe regelomschrijving (max. 60 tekens)
- Type:
- string
- Omschrijving
- Nieuwe leverdatum van de regel (YYYY-MM-DD)
- Type:
- string
- Omschrijving
- Nieuwe regelnotitie ("" maakt leeg)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| line_id | string | Ja | Regel-id (GUID) uit get_sales_orders met include_lines of search_sales_order_lines |
| quantity | number | Nee | Nieuw aantal (niet 0) |
| unit_price | number | Nee | Nieuwe prijs per eenheid, exclusief btw |
| discount_percent | number | Nee | Nieuwe regelkorting in procenten; 0 haalt hem weg |
| description | string | Nee | Nieuwe regelomschrijving (max. 60 tekens) |
| delivery_date | string | Nee | Nieuwe leverdatum van de regel (YYYY-MM-DD) |
| notes | string | Nee | Nieuwe regelnotitie ("" maakt leeg) |
Voorbeeldvraag
"Zet regel 2 van verkooporder 53 op 3 stuks"
cancel_sales_order
Verwijder een open verkooporder uit Exact Online (DELETE). De enige annuleerroute via de API; de order verdwijnt, hij komt niet als geannuleerd in de lijst. Vereist schrijfrechten, verwijderen aan voor de administratie en confirm: true. Alleen als er nog niets van geleverd of gefactureerd is
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Verkooporder ID (GUID), uit create_sales_order of get_sales_orders
- Type:
- boolean
- Omschrijving
- Moet true zijn; bevestigt het definitief verwijderen
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| order_id | string | Ja | Verkooporder ID (GUID), uit create_sales_order of get_sales_orders |
| confirm | boolean | Ja | Moet true zijn; bevestigt het definitief verwijderen |
Voorbeeldvraag
"Verwijder de dubbele verkooporder 53"
complete_sales_order
Sluit een verkooporder af: de resterende levering, het nog te factureren deel, of allebei. Voor een deels geleverde order waarvan de rest niet meer komt. Exact zegt letterlijk dat dit niet ongedaan te maken is. Standaard een proef (dry_run): je ziet per regel besteld, geleverd, gefactureerd en wat er dicht gaat. Echt afsluiten vereist dry_run: false en confirm: true. Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Verkooporder ID (GUID), uit get_sales_orders
- Type:
- boolean
- Omschrijving
- true = de resterende levering afsluiten (niets wordt meer nageleverd)
- Type:
- boolean
- Omschrijving
- true = het nog te factureren deel afsluiten. Minstens één van beide moet true zijn
- Type:
- boolean
- Omschrijving
- Standaard true: alleen tonen wat er dicht zou gaan
- Type:
- boolean
- Omschrijving
- Moet true zijn bij dry_run: false; bevestigt dat afsluiten niet terug kan
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| order_id | string | Ja | Verkooporder ID (GUID), uit get_sales_orders |
| complete_delivery | boolean | Nee | true = de resterende levering afsluiten (niets wordt meer nageleverd) |
| complete_invoice | boolean | Nee | true = het nog te factureren deel afsluiten. Minstens één van beide moet true zijn |
| dry_run | boolean | Nee | Standaard true: alleen tonen wat er dicht zou gaan |
| confirm | boolean | Nee | Moet true zijn bij dry_run: false; bevestigt dat afsluiten niet terug kan |
Voorbeeldvraag
"Sluit order 1645264 af, de rest wordt niet nageleverd"
complete_sales_order_line
Sluit één regel van een verkooporder af (resterende levering en/of te factureren deel); de andere regels blijven open. Niet ongedaan te maken. Standaard een proef (dry_run); echt afsluiten vereist dry_run: false en confirm: true. Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- ID (GUID) van de orderregel, uit search_sales_order_lines
- Type:
- boolean
- Omschrijving
- true = de resterende levering van deze regel afsluiten
- Type:
- boolean
- Omschrijving
- true = het te factureren deel van deze regel afsluiten. Minstens één van beide moet true zijn
- Type:
- boolean
- Omschrijving
- Standaard true: alleen tonen wat er dicht zou gaan
- Type:
- boolean
- Omschrijving
- Moet true zijn bij dry_run: false
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| line_id | string | Ja | ID (GUID) van de orderregel, uit search_sales_order_lines |
| complete_delivery | boolean | Nee | true = de resterende levering van deze regel afsluiten |
| complete_invoice | boolean | Nee | true = het te factureren deel van deze regel afsluiten. Minstens één van beide moet true zijn |
| dry_run | boolean | Nee | Standaard true: alleen tonen wat er dicht zou gaan |
| confirm | boolean | Nee | Moet true zijn bij dry_run: false |
Voorbeeldvraag
"Regel 3 van deze order wordt niet meer geleverd, sluit die regel af"
create_goods_delivery
Lever een verkooporder geheel of gedeeltelijk: maakt een goederenlevering (pakbon) aan, boekt de voorraad af en zet de order(regels) op geleverd. Niet terug te draaien via de koppeling, dus zonder confirm: true toont de tool alleen wat er geleverd zou worden. Zonder lines levert hij alles wat open staat; nooit meer dan besteld. Batch- en serienummerartikelen weigert hij. Leest levering, orderregels en voorraadstand terug. Vereist schrijfrechten en Groothandel & Distributie of Productie
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Verkooporder ID (GUID); of order_number
- Type:
- number
- Omschrijving
- Ordernummer van de verkooporder
- Type:
- string
- Omschrijving
- Leverdatum (YYYY-MM-DD), default vandaag
- Type:
- array
- Omschrijving
- Regels: line_number of sales_order_line_id, en quantity (max. wat open staat). Zonder lines: alles wat open staat
- Type:
- string
- Omschrijving
- Code van de verzendwijze
- Type:
- string
- Omschrijving
- Track & trace-nummer
- Type:
- string
- Omschrijving
- Opmerkingen op de levering
- Type:
- string
- Omschrijving
- Omschrijving (max. 60 tekens)
- Type:
- boolean
- Omschrijving
- true = alleen tonen, niets sturen
- Type:
- boolean
- Omschrijving
- Moet true zijn om echt te leveren
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| order_id | string | Nee | Verkooporder ID (GUID); of order_number |
| order_number | number | Nee | Ordernummer van de verkooporder |
| delivery_date | string | Nee | Leverdatum (YYYY-MM-DD), default vandaag |
| lines | array | Nee | Regels: line_number of sales_order_line_id, en quantity (max. wat open staat). Zonder lines: alles wat open staat |
| shipping_method_code | string | Nee | Code van de verzendwijze |
| tracking_number | string | Nee | Track & trace-nummer |
| remarks | string | Nee | Opmerkingen op de levering |
| description | string | Nee | Omschrijving (max. 60 tekens) |
| dry_run | boolean | Nee | true = alleen tonen, niets sturen |
| confirm | boolean | Nee | Moet true zijn om echt te leveren |
Voorbeeldvraag
"Lever verkooporder 42 volledig uit"
update_goods_delivery
Werk een bestaande levering bij: track & trace-nummer, opmerkingen of documentkoppeling. Dat zijn de enige velden die Exact op een levering laat wijzigen. Leest terug en meldt per veld of Exact het heeft overgenomen. Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Levering ID (GUID); of delivery_number
- Type:
- number
- Omschrijving
- Leveringsnummer (pakbonnummer)
- Type:
- string
- Omschrijving
- Nieuw track & trace-nummer
- Type:
- string
- Omschrijving
- Nieuwe opmerkingen
- Type:
- string
- Omschrijving
- Document-ID (GUID) om te koppelen
- Type:
- boolean
- Omschrijving
- true = alleen tonen wat er zou wijzigen
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| delivery_id | string | Nee | Levering ID (GUID); of delivery_number |
| delivery_number | number | Nee | Leveringsnummer (pakbonnummer) |
| tracking_number | string | Nee | Nieuw track & trace-nummer |
| remarks | string | Nee | Nieuwe opmerkingen |
| document_id | string | Nee | Document-ID (GUID) om te koppelen |
| dry_run | boolean | Nee | true = alleen tonen wat er zou wijzigen |
Voorbeeldvraag
"Zet track & trace 3SABC123 op levering 12"
delete_draft_sales_invoice
Verwijder een CONCEPT-verkoopfactuur uit Exact Online (DELETE). Alleen een factuur die nog niet is verwerkt naar het grootboek; een verwerkte factuur is een fiscaal document en wordt geweigerd (corrigeer die met credit_sales_invoice). Handig om een concept op te ruimen dat je maakte om iets te controleren. Vereist schrijfrechten, verwijderen aan voor de administratie en confirm: true
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Factuur-ID (GUID) van de conceptfactuur, uit create_sales_invoice of get_sales_invoices
- Type:
- boolean
- Omschrijving
- Moet true zijn; bevestigt het definitief verwijderen
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| invoice_id | string | Ja | Factuur-ID (GUID) van de conceptfactuur, uit create_sales_invoice of get_sales_invoices |
| confirm | boolean | Ja | Moet true zijn; bevestigt het definitief verwijderen |
Voorbeeldvraag
"Gooi die conceptfactuur weg, de toeslagen kloppen niet"
create_subscription
Maak een abonnement aan, met de regels in één keer; daarna leest de tool het terug en meldt wat Exact zelf invulde, zoals een einddatum. Facturen maakt de tool niet; of en wanneer die ontstaan, hangt af van de abonnementsvoorwaarde en de facturatie in Exact. Elk artikel op een regel moet een tijdseenheid hebben (maand, kwartaal, halfjaar of jaar). Een startdatum in het verleden vraagt een extra bevestiging: Exact factureert verstreken periodes dan mogelijk alsnog. Wijzigen en opzeggen doe je in Exact zelf. Vereist schrijfrechten (categorie Verkoop) + Subscription module actief
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- Klant ID (GUID); geef dit of customer_code
- Type:
- string
- Omschrijving
- Relatiecode van de klant
- Type:
- string
- Omschrijving
- Omschrijving van het abonnement (max. 60 tekens)
- Type:
- string
- Omschrijving
- Abonnementsvoorwaarde: code, omschrijving of id. Bij een onbekende weigert de tool en toont de voorwaarden die wel bestaan
- Type:
- string
- Omschrijving
- Startdatum (YYYY-MM-DD); vóór vandaag alleen met confirm
- Type:
- string
- Omschrijving
- Einddatum (YYYY-MM-DD). Zonder einddatum zet Exact er zelf een bij een voorwaarde zonder automatische verlenging; de tool meldt die
- Type:
- string
- Omschrijving
- Factureringsstartdatum (YYYY-MM-DD), als die afwijkt van de startdatum; vóór vandaag alleen met confirm
- Type:
- number
- Omschrijving
- Factuurdag: dag van de maand (1 tot en met 31). Zonder deze waarde neemt Exact de dag van de startdatum
- Type:
- string
- Omschrijving
- Code van de betalingsconditie; zonder deze vult Exact er zelf een in en meldt de tool welke
- Type:
- string
- Omschrijving
- Afwijkende factuurrelatie (GUID); of invoice_to_code met de relatiecode
- Type:
- array
- Omschrijving
- Abonnementsregels (min. 1): item_id of item_code, quantity, en optioneel unit_price, discount_percent, vat_code, from_date, to_date, description. Zonder unit_price of vat_code bepaalt Exact de prijs en de btw-code zelf; de tool meldt wat er op de regel staat
- Type:
- string
- Omschrijving
- Eigen unieke sleutel per abonnement; een herhaalde aanroep maakt dan geen tweede abonnement. Kies iets dat twee abonnementen nooit delen, bijv. relatiecode + omschrijving + startdatum. Sleutels vervallen na 90 dagen. Loopt de eerste aanroep nog (korter dan vijf minuten geleden gestart), dan krijg je een melding met retry_after_seconds; herhaal daarna met dezelfde sleutel.
- Type:
- boolean
- Omschrijving
- Bevestiging voor een start- of factureringsdatum in het verleden
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| customer_id | string | Nee | Klant ID (GUID); geef dit of customer_code |
| customer_code | string | Nee | Relatiecode van de klant |
| description | string | Ja | Omschrijving van het abonnement (max. 60 tekens) |
| subscription_type | string | Ja | Abonnementsvoorwaarde: code, omschrijving of id. Bij een onbekende weigert de tool en toont de voorwaarden die wel bestaan |
| start_date | string | Ja | Startdatum (YYYY-MM-DD); vóór vandaag alleen met confirm |
| end_date | string | Nee | Einddatum (YYYY-MM-DD). Zonder einddatum zet Exact er zelf een bij een voorwaarde zonder automatische verlenging; de tool meldt die |
| invoicing_start_date | string | Nee | Factureringsstartdatum (YYYY-MM-DD), als die afwijkt van de startdatum; vóór vandaag alleen met confirm |
| invoice_day | number | Nee | Factuurdag: dag van de maand (1 tot en met 31). Zonder deze waarde neemt Exact de dag van de startdatum |
| payment_condition | string | Nee | Code van de betalingsconditie; zonder deze vult Exact er zelf een in en meldt de tool welke |
| invoice_to_id | string | Nee | Afwijkende factuurrelatie (GUID); of invoice_to_code met de relatiecode |
| lines | array | Ja | Abonnementsregels (min. 1): item_id of item_code, quantity, en optioneel unit_price, discount_percent, vat_code, from_date, to_date, description. Zonder unit_price of vat_code bepaalt Exact de prijs en de btw-code zelf; de tool meldt wat er op de regel staat |
| idempotency_key | string | Nee | Eigen unieke sleutel per abonnement; een herhaalde aanroep maakt dan geen tweede abonnement. Kies iets dat twee abonnementen nooit delen, bijv. relatiecode + omschrijving + startdatum. Sleutels vervallen na 90 dagen. Loopt de eerste aanroep nog (korter dan vijf minuten geleden gestart), dan krijg je een melding met retry_after_seconds; herhaal daarna met dezelfde sleutel. |
| confirm | boolean | Nee | Bevestiging voor een start- of factureringsdatum in het verleden |
Voorbeeldvraag
"Maak voor klant 1001 een maandabonnement hosting aan per 1 oktober: 1x HOSTING-MND à €49,50"
Schrijftools: Productie (Pro/Enterprise)
Gereedmelden en materiaal afgeven op een productieorder, elk met een omkeerroute
create_production_receipt
Meld een hoeveelheid gereed op een productieorder. Boekt het gemaakte artikel de voorraad in en zet de order op "in bewerking" of "gereed". Met dry_run zie je eerst order, artikel, hoeveelheden en voorraadstand. Terugdraaien kan met reverse_production_receipt. Vereist de Manufacturing-module, schrijfrechten en confirm: true
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- number
- Omschrijving
- Nummer van de productieorder, uit get_shop_orders
- Type:
- number
- Omschrijving
- Gereedgemelde hoeveelheid in de eenheid van het artikel
- Type:
- string
- Omschrijving
- Boekdatum (YYYY-MM-DD), default vandaag
- Type:
- boolean
- Omschrijving
- Nodig als de hoeveelheid boven het geplande restant uitkomt; Exact zet de order dan op gereed
- Type:
- boolean
- Omschrijving
- Proef: laat zien wat er zou gebeuren zonder te boeken
- Type:
- boolean
- Omschrijving
- Moet true zijn, behalve bij dry_run
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| shop_order_number | number | Ja | Nummer van de productieorder, uit get_shop_orders |
| quantity | number | Ja | Gereedgemelde hoeveelheid in de eenheid van het artikel |
| transaction_date | string | Nee | Boekdatum (YYYY-MM-DD), default vandaag |
| allow_over_planned | boolean | Nee | Nodig als de hoeveelheid boven het geplande restant uitkomt; Exact zet de order dan op gereed |
| dry_run | boolean | Nee | Proef: laat zien wat er zou gebeuren zonder te boeken |
| confirm | boolean | Ja | Moet true zijn, behalve bij dry_run |
Voorbeeldvraag
"Meld 40 kilo gereed op productieorder 12"
reverse_production_receipt
Draai een gereedmelding terug. Boekt het gemaakte artikel weer de voorraad uit en verlaagt de gereedgemelde hoeveelheid; zonder quantity gaat alles terug wat nog omkeerbaar is. Een al volledig teruggedraaide gereedmelding weigert de tool
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- GUID van de gereedmelding, uit create_production_receipt of get_production_receipts
- Type:
- number
- Omschrijving
- Terug te draaien hoeveelheid; weglaten = alles wat nog omkeerbaar is
- Type:
- string
- Omschrijving
- Boekdatum (YYYY-MM-DD), default vandaag
- Type:
- string
- Omschrijving
- Toelichting bij de omkering
- Type:
- boolean
- Omschrijving
- Proef: laat zien wat er zou gebeuren zonder te boeken
- Type:
- boolean
- Omschrijving
- Moet true zijn, behalve bij dry_run
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| receipt_id | string | Ja | GUID van de gereedmelding, uit create_production_receipt of get_production_receipts |
| quantity | number | Nee | Terug te draaien hoeveelheid; weglaten = alles wat nog omkeerbaar is |
| transaction_date | string | Nee | Boekdatum (YYYY-MM-DD), default vandaag |
| note | string | Nee | Toelichting bij de omkering |
| dry_run | boolean | Nee | Proef: laat zien wat er zou gebeuren zonder te boeken |
| confirm | boolean | Ja | Moet true zijn, behalve bij dry_run |
Voorbeeldvraag
"Draai die gereedmelding van gisteren op order 12 terug"
create_material_issue
Geef materiaal af aan een productieorder. Boekt het onderdeel de voorraad uit op de materiaalregel van de order. De regel kies je met de artikelcode van het onderdeel. Let op: Exact boekt ook af als de voorraad daardoor negatief wordt; de tool meldt de stand ervoor en erna. Terugdraaien kan met reverse_material_issue
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- number
- Omschrijving
- Nummer van de productieorder, uit get_shop_orders
- Type:
- string
- Omschrijving
- Artikelcode van het onderdeel zoals het op de materiaalregels staat
- Type:
- string
- Omschrijving
- GUID van de materiaalregel; nodig als de artikelcode twee keer op de order staat
- Type:
- number
- Omschrijving
- Afgegeven hoeveelheid in de eenheid van het onderdeel
- Type:
- string
- Omschrijving
- Boekdatum (YYYY-MM-DD), default vandaag
- Type:
- string
- Omschrijving
- Toelichting bij de afgifte
- Type:
- boolean
- Omschrijving
- Nodig als de hoeveelheid boven het restant van de regel uitkomt
- Type:
- boolean
- Omschrijving
- Proef: laat zien wat er zou gebeuren zonder te boeken
- Type:
- boolean
- Omschrijving
- Moet true zijn, behalve bij dry_run
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| shop_order_number | number | Ja | Nummer van de productieorder, uit get_shop_orders |
| item_code | string | Nee | Artikelcode van het onderdeel zoals het op de materiaalregels staat |
| material_plan_id | string | Nee | GUID van de materiaalregel; nodig als de artikelcode twee keer op de order staat |
| quantity | number | Ja | Afgegeven hoeveelheid in de eenheid van het onderdeel |
| transaction_date | string | Nee | Boekdatum (YYYY-MM-DD), default vandaag |
| note | string | Nee | Toelichting bij de afgifte |
| allow_over_planned | boolean | Nee | Nodig als de hoeveelheid boven het restant van de regel uitkomt |
| dry_run | boolean | Nee | Proef: laat zien wat er zou gebeuren zonder te boeken |
| confirm | boolean | Ja | Moet true zijn, behalve bij dry_run |
Voorbeeldvraag
"Er is 20 kilo suiker gebruikt voor order 12"
reverse_material_issue
Draai een materiaalafgifte terug. Boekt het onderdeel weer de voorraad in en verlaagt de afgegeven hoeveelheid op de materiaalregel. Een backflush-afgifte (die Exact zelf bij de gereedmelding boekt) en een al teruggedraaide afgifte weigert de tool
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- GUID van de afgifte, uit create_material_issue
- Type:
- number
- Omschrijving
- Terug te draaien hoeveelheid; weglaten = alles wat nog omkeerbaar is
- Type:
- string
- Omschrijving
- Boekdatum (YYYY-MM-DD), default vandaag
- Type:
- string
- Omschrijving
- Toelichting bij de omkering
- Type:
- boolean
- Omschrijving
- Proef: laat zien wat er zou gebeuren zonder te boeken
- Type:
- boolean
- Omschrijving
- Moet true zijn, behalve bij dry_run
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| material_issue_id | string | Ja | GUID van de afgifte, uit create_material_issue |
| quantity | number | Nee | Terug te draaien hoeveelheid; weglaten = alles wat nog omkeerbaar is |
| transaction_date | string | Nee | Boekdatum (YYYY-MM-DD), default vandaag |
| note | string | Nee | Toelichting bij de omkering |
| dry_run | boolean | Nee | Proef: laat zien wat er zou gebeuren zonder te boeken |
| confirm | boolean | Ja | Moet true zijn, behalve bij dry_run |
Voorbeeldvraag
"Die 20 kilo suiker ging naar de verkeerde order, draai hem terug"
Schrijftools: Documenten (Pro/Enterprise)
Documenten en bijlagen koppelen aan bestaande in- en verkoopboekingen. Schrijftools — vereisen dat je schrijfrechten expliciet aanzet per administratie in je dashboard (Pro en Enterprise). Elke schrijfactie komt in een audit-log; verwijderen staat standaard uit, ook als schrijven aan staat.
attach_document_to_purchase_entry
Hang een bijlage uit de digitale brievenbus als document aan een bestaande inkoopboeking, na het boeken van een bon uit get_document_inbox. Staat het stuk al als document in Exact, geef dan document_id in plaats van mail_attachment_id: de tool koppelt dat bestaande document aan de boeking, zonder kopie. Een document dat al aan een andere boeking hangt wordt niet overgezet. Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- EntryID (GUID) van de inkoopboeking waar de bijlage aan gehangen moet worden
- Type:
- string
- Omschrijving
- GUID van de brievenbus-bijlage (attachment_id uit de mailbox_items van get_document_inbox). Geef mail_attachment_id OF document_id
- Type:
- string
- Omschrijving
- GUID van een document dat al in Exact staat (documents[].document_id uit get_document_inbox, of uit get_document_attachments); wordt aan de boeking gekoppeld zonder kopie. Geef mail_attachment_id OF document_id
- Type:
- string
- Omschrijving
- Onderwerp van het document (default: de bestandsnaam van de bijlage; alleen bij mail_attachment_id)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| entry_id | string | Ja | EntryID (GUID) van de inkoopboeking waar de bijlage aan gehangen moet worden |
| mail_attachment_id | string | Nee | GUID van de brievenbus-bijlage (attachment_id uit de mailbox_items van get_document_inbox). Geef mail_attachment_id OF document_id |
| document_id | string | Nee | GUID van een document dat al in Exact staat (documents[].document_id uit get_document_inbox, of uit get_document_attachments); wordt aan de boeking gekoppeld zonder kopie. Geef mail_attachment_id OF document_id |
| subject | string | Nee | Onderwerp van het document (default: de bestandsnaam van de bijlage; alleen bij mail_attachment_id) |
Voorbeeldvraag
"Hang de bon uit de brievenbus aan deze inkoopboeking"
attach_document_to_sales_entry
Koppel een bestand (meestal de factuur-PDF) als document aan een bestaande verkoopboeking, bijvoorbeeld wanneer een factuur vanuit een ander systeem als journaalpost in Exact is geboekt zonder onderliggend stuk. Wijs de boeking aan met entry_id of invoice_number. Het bestand geef je mee via mail_attachment_id: een bijlage die al in de digitale brievenbus van Exact staat. Dat is de normale route, ook voor een PDF die je zelf hebt gemaakt — mail hem dan eerst naar het brievenbusadres van de administratie. De variant file_base64 + file_name is er alleen voor kleine bestanden van een paar KB. Staat het stuk al als document in Exact, geef dan document_id: de tool koppelt dat bestaande document aan de boeking, zonder kopie; een document dat al aan een andere boeking hangt wordt niet overgezet. Een bestand met dezelfde naam wordt nooit twee keer gekoppeld. Voor inkoopboekingen gebruik je attach_document_to_purchase_entry. Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- string
- Omschrijving
- EntryID (GUID) van de verkoopboeking. Gebruik dit óf invoice_number, niet allebei
- Type:
- string
- Omschrijving
- Factuurnummer van de verkoopboeking; er wordt gezocht op referentie, factuurnummer en boekstuknummer. Alleen bij precies één treffer wordt gekoppeld
- Type:
- string
- Omschrijving
- Dagboekcode om de zoekactie op invoice_number te beperken, bijvoorbeeld als hetzelfde nummer in meerdere dagboeken voorkomt
- Type:
- string
- Omschrijving
- Bron van het bestand: GUID van een bijlage uit de digitale brievenbus (attachment_id uit de mailbox_items van get_document_inbox). Geef precies één bron: mail_attachment_id, document_id of file_base64
- Type:
- string
- Omschrijving
- Bron zonder bestand: GUID van een document dat al in Exact staat (documents[].document_id uit get_document_inbox, of uit get_document_attachments); wordt aan de boeking gekoppeld zonder kopie
- Type:
- string
- Omschrijving
- Bron van het bestand: de inhoud zelf, base64-gecodeerd. Alleen voor kleine bestanden van een paar KB — een factuur-PDF gaat via de digitale brievenbus. Geef file_name erbij
- Type:
- string
- Omschrijving
- Bestandsnaam inclusief extensie. Verplicht bij file_base64; bij mail_attachment_id standaard de naam uit de brievenbus
- Type:
- string
- Omschrijving
- Onderwerp van het document (default: de bestandsnaam)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| entry_id | string | Nee | EntryID (GUID) van de verkoopboeking. Gebruik dit óf invoice_number, niet allebei |
| invoice_number | string | Nee | Factuurnummer van de verkoopboeking; er wordt gezocht op referentie, factuurnummer en boekstuknummer. Alleen bij precies één treffer wordt gekoppeld |
| journal | string | Nee | Dagboekcode om de zoekactie op invoice_number te beperken, bijvoorbeeld als hetzelfde nummer in meerdere dagboeken voorkomt |
| mail_attachment_id | string | Nee | Bron van het bestand: GUID van een bijlage uit de digitale brievenbus (attachment_id uit de mailbox_items van get_document_inbox). Geef precies één bron: mail_attachment_id, document_id of file_base64 |
| document_id | string | Nee | Bron zonder bestand: GUID van een document dat al in Exact staat (documents[].document_id uit get_document_inbox, of uit get_document_attachments); wordt aan de boeking gekoppeld zonder kopie |
| file_base64 | string | Nee | Bron van het bestand: de inhoud zelf, base64-gecodeerd. Alleen voor kleine bestanden van een paar KB — een factuur-PDF gaat via de digitale brievenbus. Geef file_name erbij |
| file_name | string | Nee | Bestandsnaam inclusief extensie. Verplicht bij file_base64; bij mail_attachment_id standaard de naam uit de brievenbus |
| subject | string | Nee | Onderwerp van het document (default: de bestandsnaam) |
Voorbeeldvraag
"Hang de PDF van factuur 2026-042 aan de boeking"
attach_documents_to_sales_entries
Koppel in één aanroep meerdere bestanden (meestal factuur-PDF's) aan meerdere verkoopboekingen, bijvoorbeeld bij een inhaalslag van facturen die als journaalpost zijn binnengekomen zonder onderliggend stuk. Voor één factuur gebruik je attach_document_to_sales_entry, die ook op factuurnummer kan zoeken; hier wijs je elke boeking aan met entry_id. Elk item krijgt een eigen uitkomst en één mislukking houdt de rest niet tegen; raakt het minuutbudget van Exact op, dan stopt de tool netjes en geef je de rest in een volgende aanroep opnieuw mee. Voor inkoopboekingen gebruik je attach_document_to_purchase_entry (één tegelijk). Vereist schrijfrechten
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- array
- Omschrijving
- De te koppelen bestanden, één item per bestand (max. 50 per aanroep): entry_id (verplicht, GUID van de verkoopboeking) plus mail_attachment_id als bestandsbron, en optioneel subject. De 50 geldt voor de brievenbus-route; file_base64 kan er alleen een handvol kleine bestanden door en is niet geschikt voor factuur-PDF's
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| items | array | Ja | De te koppelen bestanden, één item per bestand (max. 50 per aanroep): entry_id (verplicht, GUID van de verkoopboeking) plus mail_attachment_id als bestandsbron, en optioneel subject. De 50 geldt voor de brievenbus-route; file_base64 kan er alleen een handvol kleine bestanden door en is niet geschikt voor factuur-PDF's |
Voorbeeldvraag
"Koppel de facturen die nog een document missen aan hun boekingen"
Synchronisatie (bulk)
Incrementele bulk-ophaal-tools via de Exact Sync API: geen aparte schrijfactie, ze lezen en cachen alleen. Eerste call is een full sync, vervolgcalls leveren enkel nieuwe/gewijzigde records (tot 1000 per call) — handig voor grote administraties of multi-administratie reads.
sync_relations
Incrementele bulk read van relaties (klanten/prospects/leveranciers) via de Exact Sync API
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- number
- Omschrijving
- Maximum aantal records (default 1000, max 5000)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| max_records | number | Nee | Maximum aantal records (default 1000, max 5000) |
Voorbeeldvraag
"Synchroniseer alle relaties van deze administratie"
sync_transactions
Incrementele bulk read van financiële mutaties (TransactionLines) via de Exact Sync API
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- number
- Omschrijving
- Maximum aantal records (default 1000, max 5000)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| max_records | number | Nee | Maximum aantal records (default 1000, max 5000) |
Voorbeeldvraag
"Synchroniseer de nieuwste transacties"
sync_items
Incrementele bulk read van artikelen via de Exact Sync API
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- number
- Omschrijving
- Maximum aantal records (default 1000, max 5000)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| max_records | number | Nee | Maximum aantal records (default 1000, max 5000) |
Voorbeeldvraag
"Synchroniseer alle artikelen"
sync_gl_accounts
Incrementele bulk read van grootboekrekeningen via de Exact Sync API
Parameters
- Type:
- number
- Omschrijving
- Administratie code
- Type:
- number
- Omschrijving
- Maximum aantal records (default 1000, max 5000)
| Parameter | Type | Verplicht | Omschrijving |
|---|---|---|---|
| division | number | Nee | Administratie code |
| max_records | number | Nee | Maximum aantal records (default 1000, max 5000) |
Voorbeeldvraag
"Synchroniseer alle grootboekrekeningen"
Klaar om te starten?
Verbind je Exact Online administratie en begin direct met AI-vragen over je boekhouding. Gratis proberen, geen creditcard nodig.
Technische Details
Protocol
MCP (Model Context Protocol) - compatible met Claude Desktop, Cursor, Windsurf en andere MCP-clients.
Authenticatie
OAuth 2.0 via Exact Online. Eenmaal verbinden, daarna automatische token refresh.
Rate Limits
Respecteert de limieten van Exact Online: 60 requests per minuut en 5.000 per dag, per administratie. Automatische throttling ingebouwd.
Data Veiligheid
Wat je opvraagt slaan we niet op — dat gaat direct naar de AI-provider die jij kiest (verwerking afhankelijk van die provider). Standaard alleen-lezen; zet je schrijven aan, dan leggen we de verstuurde en ontvangen boekingsgegevens wél vast in je schrijflog. Verbindingsgegevens versleuteld (AES-256-GCM); bijlagen in EU.
⚠️ Welke Exact Online modules heb ik nodig?
De meeste tools werken met elke Exact Online editie. Sommige geavanceerde functies vereisen specifieke modules:
| Functie / Tool | Vereiste Module |
|---|---|
| get_sales_orders | Sales Orders (Verkooporders) |
| get_purchase_orders | Purchase Orders (Inkooporders) |
| get_quotations | Quotations (Offertes) |
| get_projects, get_time_transactions, get_project_invoices | Project Management (Projectbeheer) |
| get_sales_contracts, get_recurring_revenue, create_subscription | Subscription (Abonnementen) |
| get_production_receipts, get_shop_orders, get_bill_of_materials, create_production_receipt, reverse_production_receipt, create_material_issue, reverse_material_issue | Manufacturing (Productie) |
| get_batch_numbers | Inventory met batchregistratie (Voorraad) |
💡 Tip: Als een tool "Toegang geweigerd" geeft, controleer dan of de benodigde module actief is in je Exact Online abonnement. Neem contact op met je accountant of Exact Online beheerder om modules te activeren.
Laatst bijgewerkt: