Ordinavo Connect API v1

Changelog

Aenderungen an Ordinavo Connect, CRM-Anbindung, Importen und Webhooks fuer Integrationsplanung nachvollziehen.

2026-06-19 - Ordinavo Connect und Ordinavo CRM

Dieses Update erweitert Ordinavo Connect um CRM- und Customer-Operations-Kontext. Externe Systeme koennen Jobs jetzt mit Kunden-, Standort- und Kontaktinformationen importieren und die Ergebnisse ueber ImportJobs, Route Suggestions und Webhooks nachvollziehen.

Hinzugefuegt

  • Inbound Target Import und Batch Import akzeptieren customer, location und contact DTOs.
  • Customer Mapping ueber tenant- und quellsystembezogene External IDs.
  • Neue Customer-Scopes: customers.map, customers.write und customers.read.
  • Mapping-Status und Mapping-Warnings fuer ImportItems, ImportJobs und Monitoring-Antworten.
  • Route Suggestions koennen aus ImportJobs erstellt werden und den gemappten Customer-Kontext verwenden.
  • VisitReport-Webhook-Events mit CustomerContext, unter anderem visit_report.approved und visit_report.follow_up_required.
  • Billing-Webhook-Events als strukturierte Billing-Trigger, unter anderem billing.event_created. Ordinavo erstellt dabei keine Rechnungen.
  • Webhook Payload Options fuer Kundenkontext, Kontaktdetails, Summary Previews und Billing-Details.
  • Postman Collection, Beispiel-Payloads und oeffentliche OpenAPI-Schemas fuer die neuen Connect-DTOs.

Geaendert

  • Import-Antworten koennen customerMapping enthalten, wenn der API-Key die erforderlichen Customer-Scopes besitzt.
  • Webhook-Payloads koennen CustomerContext fuer das Quellsystem des Integrationsclients enthalten.
  • CustomerNumber wird aus dem Customer-Datensatz gelesen und nicht als operative Target-Kennung verwendet.

Integrationshinweis

Bestehende Clients sollten unbekannte Felder weiterhin ignorieren. Fuer Customer-aware Imports werden inbound.targets.write oder inbound.targets.batch.write zusammen mit customers.map benoetigt. Detail-Mapping-IDs werden nur mit customers.read zurueckgegeben.

Keine Breaking Changes

Die bestehenden v1-Endpunkte bleiben bestehen. Die neuen CRM-Felder und Webhook-Payload-Erweiterungen sind additive Erweiterungen fuer Integrationen, die Customer Mapping aktiv nutzen.

2026-06 - Ordinavo Connect v1

  • API key authentication
  • Inbound target import
  • Batch import
  • Import jobs
  • Smart route suggestions from imported targets
  • Outbound webhooks
Versioning

v1 is stable for current integration scenarios. Breaking changes will be introduced through new API versions.