Händler · API-Dokumentation

Angebotsdaten eindeutig übermitteln.

Die Aurinox-Schnittstelle verarbeitet strukturierte Händlerfeeds. Hier finden Entwickler das erwartete JSON-Format, Pflichtfelder und nachvollziehbare Prüfregeln an einem Ort.

Schnittstellenvertrag

Ein kleines Format mit klaren Regeln.

Aurinox ruft den vereinbarten Feed ab. Die Daten werden geprüft und vorhandenen Katalogprodukten zugeordnet. Eine Feed-URL oder Zugangsdaten gehören nicht in öffentliche Formulare oder Support-Nachrichten.

01

Erwartete Antwort

Ein Angebot pro Array-Eintrag. Die Werte unten sind ausschließlich ein Formatbeispiel und keine echten Markt- oder Produktpreise.

JSON · BEISPIELDATEN
{
  "offers": [
    {
      "sku": "KRUG-1OZ",
      "price": 3729.90,
      "availability": "in_stock",
      "product_url": "https://shop.example/products/krugerrand-1oz",
      "premium_percent": 2.1,
      "external_id": "KRUG-1OZ-2026"
    }
  ]
}
02

Felder und Bedeutung

Pflichtfelder müssen in jedem aktiven Angebot vorhanden und maschinenlesbar sein.

FeldTypStatusBeschreibung
skuStringPflichtAurinox-SKU zur eindeutigen Produktzuordnung.
priceNumberPflichtPositiver Angebotswert als Zahl, nicht als formatierter Text.
product_urlURLPflichtDirekte HTTPS-Adresse zur Produktseite des Händlers.
availabilityStringOptionalVerfügbarkeitsstatus, beispielsweise in_stock.
premium_percentNumberOptionalAufgeld in Prozent, sofern im Quellsystem vorhanden.
external_idStringOptionalStabile interne Angebotskennung des Händlers.
03

Akzeptierte Root-Formate

Der Import erkennt diese vier Antwortstrukturen. Für neue Integrationen empfehlen wir das erste Format.

ALTERNATIV{ "results": [ ... ] }
ALTERNATIV[ ... ]
EINZELOBJEKT{ "offer": { ... } }
04

Vor der Übergabe prüfen

Diese Kontrollen verhindern die häufigsten Importfehler.

01

Gültiges JSON

Die Antwort enthält ausschließlich valides UTF-8-JSON und keine HTML-Fehlerseite.

02

Stabile Kennungen

SKU und externe ID ändern sich nicht bei jedem Abruf.

03

Numerische Preise

Preise werden als positive Zahl mit Punkt als Dezimaltrennzeichen geliefert.

04

Sichere Zieladresse

Produkt- und Feed-Adressen verwenden HTTPS und führen zur passenden Händlerseite.

Freigabe statt Blindflug

Der Import startet nach gemeinsamer Prüfung.

Feedintervall, Authentifizierung und Produktzuordnung werden im Händler-Onboarding abgestimmt. Aurinox verspricht keine automatische oder sofortige Freischaltung.