1. Customer (Kunden)

1.1 Customer/Create – Kunden anlegen

API-Referenz (Swagger)

https://ortung.dedefleet.de/swagger/?url=https://ortung.dedefleet.de/swagger/data/api/2#/Customer/Customer_Create

Zweck

Legt einen oder mehrere Kunden in DeDeFleet an.
Kunden können anschließend bei Aufträgen referenziert werden (z. B. über location.type = 1).

Endpoint

POST /customer/create

Request Body (Beispiel, 1 Kunde)

{
  "customers": [
    {
      "customerNumber": "CUST-1000",
      "name": "Musterkunde GmbH",
      "location": {
        "type": 2,
        "street": "Hauptstraße 12",
        "postal": "37154",
        "city": "Northeim",
        "country": "DE"
      },
      "contact": "Max Mustermann",
      "phoneNumber": "+49 5551 12345",
      "email": "info@musterkunde.de",
      "notes": "Anlieferung über Rampe 2",
      "visitTimeWindows": [
        {
          "day": 1,
          "startTime": "08:00",
          "endTime": "16:00"
        }
      ],
      "archived": false
    }
  ]
}

Hinweise

• customers ist ein Array → Bulk-Anlage möglich

• customerNumber ist die externe/führende Kundennummer, auf die später referenziert wird

• location beschreibt den Kundenstandort (analog zu den Location-Typen aus Step 1)

1.2 Customer/Delete – Kunden löschen

API-Referenz (Swagger)

https://ortung.dedefleet.de/swagger/?url=https://ortung.dedefleet.de/swagger/data/api/2#/Customer/Customer_Delete

Zweck

Entfernt einen Kunden anhand der Kundennummer.

Endpoint

POST /customer/delete

Request Body

{
  "customerNumber": "CUST-1000"
}

Hinweis: Je nach Datenlage kann Löschen eingeschränkt sein (z. B. wenn der Kunde bereits in Aufträgen/Touren verwendet wurde). In solchen Fällen ist „archived“ oft der bessere Weg.

1.3 Customer/AddDocument – Dokumente an Kunden anhängen

API-Referenz (Swagger)

https://ortung.dedefleet.de/swagger/?url=https://ortung.dedefleet.de/swagger/data/api/2#/Customer/Customer_AddDocument

Zweck

Hängt ein Dokument an einen Kunden an (z. B. PDF, Anlieferhinweise, Sicherheitsunterweisung).
Das Dokument wird als Base64 übertragen.

Endpoint

POST /customer/adddocument

Request Body (Minimalbeispiel)

{
  "customerNumber": "CUST-1000",
  "name": "Anlieferhinweise.pdf",
  "data": "<BASE64_STRING>"
}

Feldbeschreibung (wichtig)

• customerNumber (string): Kundennummer

• name (string): Dateiname

• data (byte/Base64): Inhalt als Base64-String

Wichtige Wirkung im System

👉 Kundendokumente werden automatisch an Aufträge angehängt, wenn der Auftrag für diesen Kunden erstellt wird.

Das gilt insbesondere, wenn Aufträge mit folgender Location-Referenz angelegt werden:

• location.type = 1 (bekannte Kundennummer)

• location.id = customerNumber

Ergebnis:

• Fahrer erhält automatisch die relevanten Kundendokumente am Auftrag

• keine doppelte Dokumentenpflege pro Auftrag notwendig

1.4 Customer/DeleteDocument – Kundendokument löschen

API-Referenz (Swagger)

https://ortung.dedefleet.de/swagger/?url=https://ortung.dedefleet.de/swagger/data/api/2#/Customer/Customer_DeleteDocument

Zweck

Entfernt ein Dokument eines Kunden anhand von Kundennummer + Dateiname.

Endpoint

POST /customer/deletedocument

Request Body

{
  "customerNumber": "CUST-1000",
  "name": "Anlieferhinweise.pdf"
}

Best Practice (kurz & praxisnah)

• Für produktive Integrationen: Kundenstammdaten regelmäßig synchronisieren

• Dokumente nur verwenden, wenn sie wirklich fahrerrelevant sind (sonst „Datenmüll“ in der App)

• Bei Änderungen an Dokumenten: altes Dokument löschen und neu anlegen (mit gleichem oder neuem Namen)