BadVogel API & integratie

Hoe krijgt u toegang?

API- en AI/MCP-toegang wordt op aanvraag door BadVogel ingericht, waar mogelijk met self-service, altijd afgebakend tot uw eigen account.

Vraag een sleutel aan

Neem contact op met uw accountmanager (of open in uw portal de pagina API) en laat ons weten:

• wat u wilt automatiseren (bijv. "elke ochtend mijn openstaande orders ophalen");
• of u alleen-lezen nodig heeft (gebruikelijk) of een specifieke actie;
• welk systeem u wilt koppelen (ERP, script, spreadsheet).

Koppel met uw sleutel

Wij geven een afgebakende, intrekbare sleutel uit die aan uw account is gekoppeld. Die sleutel fungeert als login voor de standaard Odoo-API en ziet uitsluitend de data die uw portalaccount mag zien. Het endpoint is:

https://badvogel.nl/jsonrpc

Is self-service inschakelen op uw account toegestaan, dan kunt u de sleutel ook zelf aanmaken via Accountbeveiliging → Nieuwe API-sleutel.

Wat kunt u lezen?

Dezelfde API, twee profielen. U leest alleen de gegevens van uw eigen account.

Voor dealers (verkoopzijde)

• Offertes & orders (sale.order): uw concept-offertes en bevestigde orders, regels, aantallen, datums, status en totalen.
• Leveringen (stock.picking): referenties, geplande datums en status van uw zendingen.
• Facturen (account.move): bedragen, vervaldatums, openstaand saldo en betaalstatus.
• Voorraadkaarten: de model-/voorraadkaarten die aan uw account zijn gepubliceerd.

Voor partners / leveranciers (inkoopzijde)

• Inkooporders (purchase.order): uw bevestigde en concept-PO's, regels, aantallen en datums.
• Leveranciersfacturen: bedragen, vervaldatums, openstaand en betaalstatus.
• Inkomende ontvangsten: ontvangststatus en geplande datums voor uw PO's.
• Verkoop & voorraad: sell-through en actuele voorraad van uw eigen producten bij BadVogel.

Code-voorbeeld

Standaard Odoo externe API (JSON-RPC) met de sleutel die wij uitgeven. DATABASE, UID en API_KEY ontvangt u van uw accountmanager.

Dealer: uw bevestigde orders

POST https://badvogel.nl/jsonrpc
{
  "jsonrpc": "2.0", "method": "call",
  "params": {
    "service": "object", "method": "execute_kw",
    "args": ["DATABASE", UID, "API_KEY",
      "sale.order", "search_read",
      [[["state", "=", "sale"]]],
      {"fields": ["name", "date_order", "amount_total", "state"]}]
  }
}

Partner: uw open inkooporders

POST https://badvogel.nl/jsonrpc
{
  "jsonrpc": "2.0", "method": "call",
  "params": {
    "service": "object", "method": "execute_kw",
    "args": ["DATABASE", UID, "API_KEY",
      "purchase.order", "search_read",
      [[["state", "=", "purchase"]]],
      {"fields": ["name", "date_order", "amount_total", "state"]}]
  }
}

De record-rechten van uw account gelden ook via de API: u krijgt alleen uw eigen records terug.

AI-assistenten (MCP)

BadVogel stelt ook alleen-lezen AI-tools beschikbaar (uw orders, leveringen, facturen, sell-through en voorraad opvragen) via een beheerde MCP-integratie. Omdat deze onder een door ons beheerde, afgebakende sleutel draaien, richten wij ze op aanvraag in. Er is geen self-service AI-sleutel.