API en koppelingen

Kant-en-klaar

• Pipedrive: nieuwe aanvragen worden een deal, een verstuurde offerte zet de waarde, een akkoord zet de deal op gewonnen.
• Moneybird: facturen aan klanten (aanbetaling en termijnen) komen als concept in je administratie.
• Make, Zapier en n8n: via webhooks en de API met elk ander systeem, zoals HubSpot, Teamleader, Odoo of je planning.

Instellen in Taiyoken onder Instellingen → Geavanceerd → Koppelingen.

Authenticatie

Maak een API-sleutel onder Koppelingen en stuur hem mee als Bearer-token. Maximaal 120 verzoeken per minuut per sleutel.

curl https://taiyoken.nl/api/v1/projects \
  -H "Authorization: Bearer tyk_…"

Endpoints

• GET /api/v1/projects?updated_since=…&limit=50: projecten met adres, panelen, kWp en opbrengst.
• GET /api/v1/projects/{id}: één project met schouw, oplevering en offertes.
• GET /api/v1/customers?updated_since=…: klanten.
• GET /api/v1/quotes?status=geaccepteerd en GET /api/v1/quotes/{id}: offertes met opties, regels en bedragen.
• POST /api/v1/leads: nieuwe aanvraag; Taiyoken zoekt het adres en dak op.

updated_since is een tijdstip in milliseconden of een datum (2026-10-01). Elke lijst geeft next_updated_since terug om verder te bladeren.

curl -X POST https://taiyoken.nl/api/v1/leads \
  -H "Authorization: Bearer tyk_…" -H "Content-Type: application/json" \
  -d '{"name":"Jan de Vries","email":"jan@example.com","phone":"0612345678",
       "street":"Kerklaan","houseNumber":"12","postcode":"2282AB","city":"Rijswijk",
       "interest":"zonnepanelen en batterij","notes":"Graag een offerte"}'

Lead-inbox

Voor leadplatforms en formulieren die geen sleutel kunnen meesturen: een geheime URL per installateur. Velden worden herkend op naam (naam, email, telefoon, straat of adres, huisnummer, postcode, plaats, opmerking), als JSON of formulier.

POST https://taiyoken.nl/api/inbound/leads/{jouw-token}?bron=Solvari

Webhooks

Taiyoken stuurt een POST bij quote.accepted, quote.declined en lead.created. Controleer de afzender met X-Taiyoken-Signature: sha256= plus de HMAC-SHA256 van {X-Taiyoken-Timestamp}.{body} met je geheim.

{
  "id": "evt_…",
  "event": "quote.accepted",
  "createdAt": "2026-10-18T09:30:00.000Z",
  "organization": { "id": 12, "name": "Zonvast Installaties" },
  "data": {
    "quote": { "number": "OF-2026-0042", "url": "…/o/…", "option": { "name": "Zonnepanelen", "totalInclVat": 6450, "lines": [ … ] } },
    "customer": { "name": "…", "email": "…", "phone": "…" },
    "project": { "address": { … }, "panels": 12, "kwp": 5.28, "yieldKwh": 4650 }
  }
}