Generisches JSON#

Generisches JSON – Eingang für beliebige JSON-Payloads mit einem reichen Schema für deutsche B2B-Bestellungen. Kein Zusatz-Addon erforderlich.

Überblick#

Nicht jedes System passt in eine der dedizierten Integrationen. Für individuelle Shop-Systeme, ERP-Exports, EDI-Konverter oder selbst entwickelte Webhooks bietet Orderport einen offenen JSON-Eingang. Orderport flacht die eingehende JSON-Struktur ab und stellt jedes Feld im Mapping-Editor zur Verfügung.

Das vordefinierte Schema ist speziell auf deutsche/DACH-B2B-Bestellungen ausgelegt: USt-ID, GLN, getrennte Liefer- und Rechnungsadressen, EANCOM-Mengeneinheiten, Steuersätze pro Position, Zahlungsbedingungen und Incoterms. Auto-Mapping für openTrans, JSON und JTL-Wawi ist vorhanden.

Die Integration unterstützt nur den Eingang.

Kompatibilität#

Unterstützte Versionen#

Bekannte Einschränkungen#

• Festes Beispiel-Dokument. Der Mapping-Editor zeigt ein vordefiniertes DACH-B2B-Beispiel – Sie können kein eigenes Payload hochladen. Liefert Ihre Quelle Felder außerhalb des Schemas, tragen Sie diese Pfade im Editor manuell ein. Der Normalizer flacht trotzdem alles ab.
• Kein Schema-Validator. Orderport prüft nicht auf Pflichtfelder – stimmt ein Feld nicht mit der Erwartung, erkennt man das erst am Ergebnis.
• Array-Handling funktioniert via []-Notation (items[].sku). Geschachtelte Arrays in Arrays werden unterstützt, können aber unübersichtlich werden.
• Binäre oder base64-codierte Inhalte innerhalb von Feldern werden unverändert durchgereicht – keine Dekodierung.

Authentifizierung#

Frei wählbar:

• Bearer Token – einfach, empfohlen für viele Partner
• HMAC-SHA256 – wenn der Absender die Payload signieren soll
• Shared-Secret-Header – wenn ein individueller Custom-Header gebraucht wird

Einrichten in Orderport#

Pipeline anlegen#

1. Pipelines → Neue Pipeline
2. Eingabeformat: Generisches JSON, Ausgabeformat: openTrans, JSON oder JTL-Wawi
3. Auto-Mapping wird ausgeführt – ~22 Regeln werden vorgeschlagen (bei openTrans) bzw. ~20 (bei JSON)
4. Mapping bei Bedarf manuell anpassen
5. Für Felder, die Ihre Quelle liefert, aber nicht im vordefinierten Schema vorkommen: Zielfeld anklicken und den Quell-Pfad als Freitext eingeben (z. B. metadata.partner_reference)

Credential#

Credentials → Hinzufügen. Typ nach Anforderung des Absenders.

Einrichten im Quellsystem#

Sie senden die JSON-Payload per HTTP POST an die Webhook-URL. Das konkrete Setup hängt von Ihrem System ab:

• WordPress Plugin: cURL mit vorbereitetem Secret-Header
• Custom ERP-Export: Cron-Job, der nach jeder Bestellung einen POST absetzt
• Zapier/Make/n8n: HTTP-Action mit Auth-Header

Auto-Mapping#

Für drei Zielformate generiert Orderport Standard-Mappings, wenn Sie keine eigenen Regeln hinterlegen. Damit können Sie mit einer neuen Pipeline sofort loslegen.

Technische Details#

Quellschema#

Das Schema ist in acht Gruppen organisiert. Alle Pfade nutzen Punkt-Notation; Arrays werden mit [] gekennzeichnet.

Bestellkopf#

Beträge & Steuern#

Käufer#

Lieferadresse#

Rechnungsadresse#

Positionen#

Zahlung & Versand#

Metafelder (automatisch berechnet)#

Beispiel-Payload#

{
  "order": {
    "id": "PO-2026-04-00123",
    "date": "2026-04-19T09:15:00+02:00",
    "delivery_date": "2026-04-26",
    "reference": "Projekt Alpha / Kostenstelle 4200",
    "type": "new",
    "language": "de",
    "comment": "Bitte Lieferung vor 12:00 Uhr an Tor 4."
  },
  "totals": {
    "currency": "EUR",
    "net_amount": 1500.00,
    "gross_amount": 1785.00,
    "tax_amount": 285.00
  },
  "buyer": {
    "gln": "4012345000009",
    "company": "Muster GmbH",
    "contact_name": "Max Mustermann",
    "email": "einkauf@muster.de",
    "vat_id": "DE123456789",
    "street": "Hauptstr. 1",
    "zip": "80331",
    "city": "München",
    "country": "DE"
  },
  "delivery": {
    "gln": "4012345000016",
    "company": "Muster GmbH – Zentrallager",
    "street": "Industriestr. 42",
    "additional": "Tor 4",
    "zip": "80331",
    "city": "München",
    "country": "DE"
  },
  "invoice": {
    "company": "Muster GmbH",
    "street": "Hauptstr. 1",
    "zip": "80331",
    "city": "München",
    "country": "DE",
    "vat_id": "DE123456789"
  },
  "items": [
    {
      "line_number": 1,
      "sku": "WIDGET-001",
      "ean": "4003969945418",
      "name": "Premium Widget Blau",
      "quantity": 10,
      "unit": "PCE",
      "unit_price_net": 150.00,
      "tax_rate": 19
    },
    {
      "line_number": 2,
      "sku": "KABEL-025",
      "name": "Anschlusskabel 2,5 m",
      "quantity": 5,
      "unit": "MTR",
      "unit_price_net": 12.80,
      "tax_rate": 19
    }
  ],
  "payment": {
    "method": "invoice",
    "terms": "14 Tage netto, 2% Skonto bei 7 Tagen"
  },
  "shipping": {
    "method": "DHL",
    "incoterms": "DAP"
  }
}

Endpoint#

Webhook-URL je Pipeline: https://orderport.app/api/v1/webhook/{token}.

Fehlerbehebung#

Nächste Schritte#

• Feldmapping
• KI-Mapping
• Zugangsdaten