Zum Hauptinhalt springen

Register New Company

POST 
/company/auth/register

Endpoint zur Registrierung neuer Unternehmen und ihres anfänglichen Administrator-Benutzers.
Führt die folgenden Operationen aus:

  1. Validiert Pflichtdaten (Firmenname, übereinstimmende Passwörter)
  2. Prüft Eindeutigkeit der E-Mail-Adresse
  3. Erstellt eine steuerliche Adresse
  4. Erstellt das Unternehmen in der Datenbank
  5. Erstellt den Administrator-Benutzer
  6. Konfiguriert das Stripe-Konto (Customer + Connected Account)
  7. Sendet eine Willkommens-E-Mail
  8. Erstellt einen anfänglichen kostenlosen Tarif für 1 Monat
  9. Verknüpft mit einem bestehenden Anbieter, wenn die Steuer-ID übereinstimmt

Detaillierter Ablauf:​

  1. Client sendet Unternehmens- und Benutzerdaten im JSON-Format
  2. Server validiert Pflichtfelder (406 bei Fehlern)
  3. Prüft Steuer-ID gemäß spanischer Steuervorschriften (406 bei ungültiger ID)
  4. Überprüft Eindeutigkeit der E-Mail-Adresse (403 bei bereits vorhandener Adresse)
  5. Erstellt steuerliche Adresse mit den bereitgestellten Daten
  6. Registriert Unternehmen in der Datenbank
  7. Erstellt Administrator-Benutzer mit gehashtem Passwort
  8. Konfiguriert Stripe-Konto (Customer + Connected Account) für zukünftige Zahlungen
  9. Sendet Aktivierungs-E-Mail mit eindeutigem Token
  10. Erstellt anfänglichen kostenlosen Tarif für 30 Tage
  11. Falls ein company_provider mit derselben Steuer-ID existiert, wird dieser verknüpft

Datenanforderungen:​

  • Gültige Steuer-ID/NIF/CIF gemäß spanischer Vorschriften (optional, aber empfohlen)
  • Vollständiger Firmenname
  • Noch nicht registrierte Unternehmens-E-Mail-Adresse
  • Sicheres Passwort (mindestens 8 Zeichen, Großbuchstaben, Zahlen und Sonderzeichen)
  • Vollständige steuerliche Adresse

Request​

Responses​

Erfolgreiche Registrierung (gibt leeres Objekt zurück)

Response Headers