Erste Schritte

Fehler

Jede Fehlerantwort ist JSON mit einem error-String und, sofern zutreffend, einem maschinenlesbaren Code sowie einer für Abhilfe geeigneten Nachricht.

Status

Code

Wann

Behebung

400

invalid body

Zod-Validierung fehlgeschlagen. Der Antworttext enthält ein issues-Array mit Details pro Feld.

Das fehlerhafte Feld korrigieren und erneut senden.

400

unsupported_destination

Bestimmungsland gehört nicht zu den mehr als 220, die LandedFees unterstützt.

Prüfen Sie /coverage und wechseln Sie zu einem unterstützten Bestimmungsland.

401

unauthorized

Fehlender, fehlerhafter oder widerrufener API-Schlüssel.

Prüfen Sie den Authorization-Header und stellen Sie bei Bedarf einen neuen Schlüssel im Dashboard aus.

402

quota_exceeded

Monatskontingent des aktuellen Plans erschöpft.

Upgrade unter /pricing oder auf den Monatsreset warten.

422

MISSING_HS_CODE

Ein oder mehrere Positionen haben keinen HS-Code, und die Inline-Klassifizierung ist fehlgeschlagen.

Geben Sie einen expliziten hs_code oder einen aussagekräftigeren Produktnamen an.

422

DOMESTIC_SHIPMENT

origin_country und destination_country sind identisch.

Landed Cost gilt nur für grenzüberschreitende Bewegungen. Eines der Länder anpassen.

422

DATA_NOT_AVAILABLE

Verifizierte Satzdaten sind für das angefragte Land noch nicht geladen.

Wählen Sie ein abgedecktes Land (siehe /coverage) oder kontaktieren Sie den Support für beschleunigte Abdeckung.

429

rate_limited

Sliding-Window-Ratenlimit überschritten.

Retry-After beachten und zurückweichen.

500

internal

Unerwarteter Serverfehler. Die Antwort enthält einen detail-String.

Idempotent wiederholen. Support kontaktieren, wenn der Fehler bestehen bleibt.

Fehlerbehandlung

HTTP/2 400
content-type: application/json

{
  "error": "invalid body",
  "issues": [
    {
      "path": ["origin_country"],
      "message": "String must contain exactly 2 character(s)"
    }
  ]
}

Wird geladen