Zum Inhalt

Validierungsfehler

Fehlertyp https://help.orderhi.com/partner-api/problems/validation-error
HTTP-Status 422

Bedeutung

Die Anfrage ist gültiges JSON, aber der Inhalt ist nicht zulässig. Die Details stehen in errors, pro Eintrag mit Feldname (field) und Meldung (message).

Typische Ursachen

  • Ein Pflichtfeld fehlt (z. B. items, customer.firstname, bei DELIVERY die Adressfelder).
  • Ein Referenzcode ist unbekannt (service_type_ref, payment_ref).
  • total_cents entspricht nicht der Summe aus Positionen, Optionen und Zuschlägen abzüglich Rabatten.
  • requested_time liegt in der Vergangenheit oder mehr als 7 Tage in der Zukunft.
  • Ein Wert hat den falschen Typ oder ist zu lang.

So beheben Sie den Fehler

  • Werten Sie errors[].field aus und korrigieren Sie das genannte Feld.
  • Prüfen Sie die erlaubten Werte unter „Referenzcodes“ in der API-Dokumentation.
  • Berechnen Sie total_cents aus den Positionen, Optionen, Zuschlägen und Rabatten.

Beispielantwort

Die Antwort hat den Content-Type application/problem+json.

{
  "type": "https://help.orderhi.com/partner-api/problems/validation-error",
  "title": "Validation failed",
  "status": 422,
  "detail": "The order is invalid.",
  "errors": [
    {
      "field": "items[0].sku_ref",
      "message": "Required."
    },
    {
      "field": "total_cents",
      "message": "Must equal items + charges - discounts (2150)."
    }
  ]
}

Alle Fehlertypen · English version