API Reference

Kunden-API

Kundendaten und Adressen verwalten

Die Kunden-API ermöglicht das Erstellen, Aktualisieren und Verwalten von Kundendatensätzen. Kunden sind mit Aufträgen verknüpft und enthalten Adressdaten für die Routenoptimierung.

Endpunkte

Kunden auflisten

GET
/api/customers

Alle Kunden Ihres Unternehmens abrufen

Kunde abrufen

GET
/api/customers/:id

Einen bestimmten Kunden per ID abrufen

Kunde erstellen

POST
/api/customers

Einen neuen Kundendatensatz erstellen

Kunde aktualisieren

PATCH
/api/customers/:id

Einen bestehenden Kunden aktualisieren

Kunde löschen

DELETE
/api/customers/:id

Einen Kunden löschen

Adresse geokodieren

POST
/api/customers/:id/geocode

Adresse in Koordinaten umwandeln

Kundenfelder

Verfügbare Felder beim Erstellen oder Aktualisieren von Kunden

nameKundenname (erforderlich)
addressVollständige Straßenadresse
cityStadt
zipPostleitzahl
phoneTelefonnummer
emailE-Mail-Adresse
contactPersonPrimärer Ansprechpartner
notesInterne Notizen

Adress-Geokodierung

ManoPlan konvertiert Adressen automatisch in Koordinaten für die Routenoptimierung. Die Koordinaten werden mit dem Kundendatensatz gespeichert.

Automatische Geokodierung beim Erstellen/Aktualisieren
Manuelle Geokodierung über API-Endpunkt
Koordinaten für Performance zwischengespeichert

Best Practices

  • Geben Sie immer eine vollständige Adresse für genaues Routing an
  • Nutzen Sie das externalId-Feld zur Verknüpfung mit Ihrem ERP-System
  • Überprüfen Sie die Geokodierungsergebnisse für neue Kunden
  • Halten Sie die Kontaktinformationen aktuell

Weitere API-Dokumentation

Kunden verwalten

Nutzen Sie die Customers API für Ihre Kundenverwaltung