Zum Hauptinhalt springen

Create new address

POST 
/company/address/

Erstelle eine neue Adresse, die mit dem Unternehmen des authentifizierten Benutzers verknüpft ist.
Dieser Endpunkt ermöglicht die Registrierung physischer Standorte wie Lager, Büros oder Lade-/Entladepunkte.

Ablauf der Operation:

  1. Authentifizierung über gültiges JWT
  2. Validierung der Pflichtfelder und Formate
  3. Verarbeitung der Google Maps-Daten (Reverse-Geocodierung)
  4. Wenn isDefault=true, wird jede bestehende Hauptadresse deaktiviert
  5. Speicherung in der Datenbank
  6. Rückgabe der erstellten Adresse mit ihrer ID

Wichtige Validierungen:

  • Erfordert gültiges JWT mit Admin-/Editor-Berechtigungen
  • Pflichtfeld 'name' (3–100 Zeichen)
  • Google Maps-Daten müssen enthalten:
    • formatted_address: Vollständig formatierte Adresse
    • geometry.location: Koordinaten {lat, lng}
  • Wenn isDefault=true, wird jede bestehende Hauptadresse deaktiviert

Typische Anwendungsfälle:

  • Neue Unternehmensniederlassung registrieren
  • Logistiklager hinzufügen
  • Abholpunkt für Sendungen einrichten

Wichtiger Hinweis zu Telefonnummern:

  • Telefonnummern (phone) müssen ein gültiges Format für Spanien, Frankreich oder Portugal haben

Erfordert aktives Abonnement (validiert durch Middleware isPaymentUpdate)

Timestamps werden in UTC konvertiert durch Middleware checkUTC

Beispielanfrage:

POST /company/address
Authorization: Bearer {token}
Content-Type: application/json

{
  name: Logistiklager,
  company_name: CargoOffer SL,
  phone: +34912345678,
  addressGoogleMaps: {
    formatted_address: Calle de la Logística, 123, 28045 Madrid, Spanien,
    geometry: {
      location: {
        lat: 40.123456,
        lng: -3.987654
      }
    }
  },
  isDefault: false
}

Request​

Responses​

Erfolgreicher Betrieb

Response Headers