Dokumentation

Ressourcen

Änderungsprotokoll

Änderungen am öffentlichen v1-Vertrag und an der Dokumentation.

v1.2.0 · Entwurf

27. August 2026

  • contract_partner_id für im Dashboard konfigurierte Vertragspartner ergänzt; KOPA-Schlüssel und Stammdaten bleiben außerhalb des API-Payloads.
  • Bei submission_mode: company werden Antragsteller und Halter fachlich identisch erzeugt und keine Vollmacht erstellt; bei third_party bleibt die Vollmacht erforderlich.
  • Signaturprofile ergänzt: Absendername, Logo und Redirect-Ziel der Signaturanfrage je Antrag steuerbar.
  • Neue Endpunkte unter /api/v1/signature-profiles mit den Scopes signature_profiles:read und signature_profiles:write.
  • signature_profile_id bei der Antragserstellung sowie signature_profile im Antragsobjekt ergänzt.
  • Wirkungslose Felder vehicle.manufacturer_code und vehicle.type_code aus dem Antragsvertrag entfernt; gesendete Werte wurden nie verarbeitet und werden weiterhin ignoriert.
  • 409- und 429-Antworten belegen den Idempotency-Key nicht mehr; derselbe Key kann nach einem Konflikt oder Budget-Limit erneut verwendet werden.
  • Fehlerdetails der Wunschkennzeichen-Endpunkte auf das einheitliche Format path/code/message umgestellt.
  • Saisonkennzeichen im Antrag werden wie bei Check und Reservierung auf zwei bis elf Monate begrenzt.
  • results.authority_status liefert die aktuelle Behördenquittung als Array aus { code, message }-Paaren; eine Antwort kann mehrere Quittungscodes mit jeweils eigener Message enthalten.
  • AB verlangt bei Pkw jetzt auch den vorderen Kennzeichen-Sicherheitscode (security_codes.front); Motorräder und Anhänger benötigen weiterhin nur rear.
  • registration.delivery und registration.authorized_party werden bei AB ignoriert; die Außerbetriebsetzung versendet keine Dokumente.
  • vehicle.electric_plate und vehicle.historic_plate gelten nur für Vorgänge mit neuem Kennzeichen und werden bei AB und HA ignoriert; vehicle.requested_registration_date gilt nur für NZ und TZ.
  • signature_profile_id wird bei AB ignoriert, da die Abmeldung keine Signatur erfordert.

v1.1.0 · Entwurf

26. August 2026

  • Eigenständige Halterressourcen mit Revisionen und optionaler Nachweisprüfung ergänzt.
  • Halterverifizierung von QES-Identifizierung und Antragssignatur getrennt.
  • Zulassungsstellen, Wunschkennzeichenchecks, Reservierungen und Bestätigungen ergänzt.
  • Kennzeichenschilder und Feinstaubplaketten als antragsgebundene Bestellungen ergänzt.
  • holder_id als bevorzugte Halterreferenz und additional_services bei Antragserstellung ergänzt.
  • AB benötigt weder Halterreferenz noch Halterverifizierung oder Signatur.

v1.0.0 · Entwurf

23. August 2026

  • Erster öffentlicher Vertragsentwurf für AB, WG, WZ, NZ, TZ, UG und HA.
  • Getrennte Live- und Testschlüssel mit dz_live_- und dz_test_-Präfix.
  • Idempotente Anlage, Signaturlink, Status, Dokumente und Gebühren beschrieben.
  • Testanträge sowie deterministische Testereignisse dokumentiert.

Zum Öffnen eines Treffers Enter drücken.