API-documentatie · v1

Dealnote koppelen

Haal offertes en facturen op, zet facturen op betaald en houd je productcatalogus actueel. Voor je CRM, boekhouding, ERP, Zapier/Make/n8n of een AI-agent.

Snel starten

  1. De eigenaar maakt een API-sleutel in Dealnote › Instellingen › API-sleutels. Je ziet hem maar één keer.
  2. Stuur bij elk verzoek de header Authorization: Bearer dn_live_... mee.
  3. Basis-URL: https://app.dealnote.eu/api/v1. Alles is JSON. Bedragen in euro: subtotaal excl. btw, totaal incl. btw.
curl https://app.dealnote.eu/api/v1/offertes?status=geaccepteerd \
  -H "Authorization: Bearer dn_live_..."

Endpoints

Volledige beschrijving (OpenAPI 3.1): https://app.dealnote.eu/api/v1/openapi.json

GET/api/v1/offertes
Offertes ophalen (nieuwst gewijzigd eerst)Gebruik sinds om alleen gewijzigde offertes op te halen, bijvoorbeeld om je CRM periodiek bij te werken.Filters: status (Filter op status) · sinds (Alleen offertes gewijzigd na dit tijdstip (ISO 8601)) · zoek (Zoek op klant, onderwerp of offertenummer) · limiet (Max aantal (1-200, standaard 50))
POST/api/v1/offertes
Offerte maken uit notities (AI)Dealnote maakt met AI een conceptofferte uit vrije tekst (bijv. een aanvraag, notities of een formulier), met de productcatalogus en rekenregels van het bedrijf. Duurt 5 tot 20 seconden.
GET/api/v1/offertes/{nummer}
Eén offerte met regels, samenvatting en actiepunten
GET/api/v1/facturen
Facturen ophalen (nieuwste eerst)Filters: status (Filter op status) · sinds (Alleen facturen gemaakt na dit tijdstip (ISO 8601)) · limiet (Max aantal (1-200, standaard 50))
GET/api/v1/facturen/{nummer}
Eén factuur
PATCH/api/v1/facturen/{nummer}
Factuur op betaald, open of geannuleerd zetten (bijv. vanuit boekhouding of bank)
GET/api/v1/producten
Alle producten uit de catalogus
POST/api/v1/producten
Producten toevoegen of bijwerken op artikelnummer (sku)Bestaande artikelnummers worden bijgewerkt. Met vervang_alles: true worden producten die niet in de lijst staan verwijderd.
# Factuur op betaald zetten (bijv. vanuit je boekhouding)
curl -X PATCH https://app.dealnote.eu/api/v1/facturen/F-2026-0001 \
  -H "Authorization: Bearer dn_live_..." \
  -H "Content-Type: application/json" \
  -d '{"status":"betaald"}'

# Producten bijwerken vanuit je ERP
curl -X POST https://app.dealnote.eu/api/v1/producten \
  -H "Authorization: Bearer dn_live_..." \
  -H "Content-Type: application/json" \
  -d '{"producten":[{"sku":"BAT-10","naam":"Thuisbatterij 10 kWh","prijs":4295,"eenheid":"stuk"}]}'

Webhooks

Stel in Dealnote › Instellingen › Koppelingen een webhook-URL in. Dealnote stuurt dan direct een POST bij:

POST https://jouw-systeem.nl/dealnote
X-Dealnote-Event: offerte.getekend
X-Dealnote-Signature: sha256=4f1c...

{ "event": "offerte.getekend", "tijd": "2026-10-21T14:03:00Z",
  "data": { "offerte_id": "…", "offertenummer": "OF-2026-0042", "klant": "Fam. Jansen", "getekend_door": "P. Jansen" } }

Controleer de handtekening met je webhook-geheim:

// Node.js
import { createHmac, timingSafeEqual } from "crypto";
const verwacht = "sha256=" + createHmac("sha256", GEHEIM).update(ruweBody).digest("hex");
const ok = timingSafeEqual(Buffer.from(verwacht), Buffer.from(req.headers["x-dealnote-signature"]));

Haal na een webhook de volledige gegevens op via de API (bijv. GET /offertes/{offertenummer}).

Met AI koppelen

Voorbeeld: elk CRM bijwerken

HubSpot, Pipedrive, Zoho en Salesforce koppel je direct in Dealnote (Instellingen › Koppelingen). Voor elk ander CRM:

  1. Webhook offerte.getekend komt binnen in Zapier/Make/n8n.
  2. Haal de offerte op: GET /offertes/{offertenummer} (klant, bedrag, regels, samenvatting).
  3. Zoek of maak het contact in je CRM op e-mailadres, en maak of win de deal met subtotaal als bedrag.
  4. Zet de samenvatting en actiepunten als notitie bij de deal.

Liever periodiek? Vraag elke 15 minuten GET /offertes?sinds=… op met het tijdstip van je vorige ronde.

Formulieren en Excel

Recepten voor n8n, Make en Zapier

Fouten en limieten