Was es bedeutet

Ihr Request-Body hat die Eingabevalidierung von PreVOP nicht bestanden, weshalb das Gateway ihn abgelehnt hat, bevor der VOP-Provider kontaktiert wurde. Die Antwort enthält in title und detail das erste fehlerhafte Feld sowie den Grund.

Wann Sie diesen Fehler sehen

• Ein Pflichtfeld fehlt im JSON-Payload.
• Ein String überschreitet seine maximale Länge (z. B. ist party.name gemäß EPC 267-24 auf 140 Zeichen begrenzt).
• Ein Feld enthält Zeichen außerhalb des EPC-zulässigen Zeichensatzes.
• Eine IBAN schlägt bei der ISO-7064-mod-97-Prüfsumme fehl.
• Ein BIC hat die falsche Länge für den konfigurierten Provider (8 oder 11 Zeichen).
• Der Request-Body überschreitet das konfigurierte Größenlimit (Standard 10 KB).

Beispiel-Antwort

HTTP/1.1 400 Bad Request
Content-Type: application/problem+json
X-Request-ID: 550e8400-e29b-41d4-a716-446655440000

{
  "type":    "https://errors.prod.prevop.alseda.eu/errors/validation-failed",
  "code":    "VALIDATION_FAILED",
  "title":   "party.name: name too long (max 140 chars)",
  "status":  400,
  "detail":  "party.name: name too long (max 140 chars)"
}

So beheben Sie das Problem

1. Lesen Sie title — dort steht das erste fehlerhafte Feld mit der verletzten Regel.
2. Lesen Sie detail für die vollständige Erklärung und issues[] (falls vorhanden) für die komplette Liste aller Probleme im Payload.
3. Vergleichen Sie Ihren Request mit der OpenAPI-Spezifikation, um die erwartete Struktur, die Typen und die Einschränkungen zu prüfen.
4. Korrigieren Sie das Feld und senden Sie den Request mit einer neuen X-Request-ID erneut (ein Retry mit derselben ID kann von der Quota-Kontrolle als Duplikat abgelehnt werden).

Verwandte Themen

• Customer API Contract §4.1 — Fehlerumschlag-Format
• Customer API Contract §4.2 — PreVOP-Fehlercodes (Zeile VALIDATION_FAILED)
• Siehe auch: FORMAT_ERROR — gleiche Strukturprüfung, wenn der Fehler stattdessen vom Upstream-Provider erkannt wird.