Produktdaten liefern

JSON-Feed nach unserem Schema

Der genauste Weg, und der mit den wenigsten Rückfragen. Ein HTTPS-Endpunkt liefert alle Produkte in einem Dokument.

Felder je Produkt

Felder je Variante

Werte für health_claims.status

Jeder andere Wert und ein fehlendes Feld werden wie kein_nem behandelt. Setz den Status also auch dann, wenn er keine_claims lautet. Testkits und Zubehör dürfen im Feed bleiben, sie sind dann für die Beratung ausgeschlossen.

Betrieb des Feeds

• HTTPS und öffentlich abrufbar. Basic Auth ist möglich, nenn uns dann Benutzer und Passwort.
• Ein Dokument mit allen Produkten, keine Seitennummerierung.
• Antwort in unter 20 Sekunden. Bei großen Katalogen vorgeneriert ausliefern.
• generated_at als ISO-8601-Zeitstempel, damit wir die Frische sehen.
• product_number und sku dürfen sich nicht bei jeder Generierung ändern.

Vier Regeln, an denen Produkte verloren gehen

1. Kein product_number oder kein title Das Produkt wird verworfen.
2. Keine Variante mit positivem price Das Produkt wird verworfen. Der Preis ist als JSON-Zahl zu liefern; zur Sicherheit nehmen wir auch Zeichenketten der Formen "3.95" und "3,95" an. Alles andere (Währungszeichen, Tausendertrenner, 0) zählt als kein Preis. Das ist der häufigste Grund, warum ein Feed formal in Ordnung aussieht und bei uns null Produkte ankommen.
3. Unbekannter health_claims.status Das Produkt liegt im Katalog, ist in der Beratung aber unsichtbar.
4. Punkt, Unterstrich, Leerzeichen oder Schrägstrich in der sku Das Produkt ist empfehlbar, fällt aber aus dem Warenkorb-Link, ohne Fehlermeldung. Die Kundin sieht dann einen unvollständigen Warenkorb.

Liegt die url nicht auf der Domain, die du uns genannt hast, verwerfen wir den Produktlink. Vor dem Start heißt das: keine Testshop-Domains im Feed.

Beschreibung, Nährwerte, Dosierung

Gilt für alle Wege. Aus der HTML-Beschreibung lesen wir Inhaltsstoffe und Dosierung, die Grundlage jeder Empfehlung.

• Echte <table>-Auszeichnung mit Kopfzeile und mindestens zwei Spalten. Tabellen als Bild oder als div-Raster können wir nicht lesen.
• Erste Spalte: Name des Nährstoffs. Unterzeilen beginnen mit davon oder einem Bindestrich.
• Mengenspalte: die Kopfzelle muss eines der Wörter Tagesdosis, Menge oder je enthalten. Erkannt werden etwa pro Tagesdosis (3 Kapseln), je Portion (10 g) und Menge pro Kapsel. Eine Spalte je 100 g überspringen wir, weil wir den Bezug auf die Portion brauchen.
• NRV-Spalte, optional: Kopfzelle enthält NRV oder % RM.
• Verzehrempfehlung unter einer Zwischenüberschrift <h3>Verzehrempfehlung</h3>, hinter der Tabelle.

<table>
  <tr><th>Nährstoff</th><th>pro Tagesdosis (3 Kapseln)</th><th>% NRV</th></tr>
  <tr><td>Magnesium</td><td>300 mg</td><td>80</td></tr>
  <tr><td>davon aus Magnesiumcitrat</td><td>1875 mg</td><td>-</td></tr>
</table>
<h3>Verzehrempfehlung</h3>
<p>3 Kapseln täglich mit reichlich Wasser zu einer Mahlzeit.</p>

Kannst du Zutaten und Nährwerte strukturiert ausgeben, also Name, Menge, Einheit und Prozent NRV je Zeile, nehmen wir das lieber als HTML. Dann entfällt das Auslesen der Tabelle.

Vorhandenes Format nutzen

Vier Wege, für die dein Shop nichts Neues bauen muss.

Shopify

Wir lesen die öffentliche products.json. Von dir brauchen wir nur die Shop-Domain. Der Warenkorb läuft über Cart-Permalinks, der Gutschein über /discount/<code>.

WooCommerce, Feed im Google-Merchant-Format

Erzeugt dein Shop schon einen Feed für das Google Merchant Center, lesen wir denselben Feed. Diese Felder werten wir aus:

JSON-LD auf den Produktseiten

Kein Feed nötig: wir folgen deiner Sitemap und lesen auf jeder Produktseite das schema.org-JSON-LD (Product oder DietarySupplement) mit sku, price und availability, dazu die Zutaten- und Nährwerttabelle aus dem Seiten-HTML. Voraussetzung: das JSON-LD steht auf jeder Produktseite und enthält die Artikelnummer.

PrestaShop-JSON

Wir lesen id_product, name, reference, price_current (ersatzweise price oder price_default), description_short, description_webshop_full, images und link_rewrite für den Produktlink.

Etwas anderes

Schick uns ein Beispiel deines Exports: eine Datei, eine URL oder eine Liste der Felder. Wir melden dir, ob wir es direkt lesen können oder was wir brauchen.

Selbst prüfen

Für den JSON-Feed. Jede Ausgabe ist ein Produkt, das bei uns nicht oder nur halb ankommt.

npx --yes -p ajv-cli -p ajv-formats ajv validate --spec=draft2020 -c ajv-formats \
  -s json-feed.schema.json -d feed.json --errors=text --all-errors

pipx run check-jsonschema --schemafile json-feed.schema.json feed.json

Ohne Installation, nur mit jq:

jq -r '.products[] | select((.product_number|type) != "string" or (.product_number|length) == 0
  or (.title|type) != "string" or (.title|length) == 0)
  | "VERWORFEN (product_number/title): \(.title // "?")"' feed.json

jq -r '.products[] | select([.variants[]?.price | select(type == "number")] | length == 0)
  | "VERWORFEN (kein numerischer Preis): \(.product_number)"' feed.json

jq -r '.products[] | .health_claims.status as $s
  | select((["done","keine_claims","bundle","kein_nem"] | index($s)) == null)
  | "UNSICHTBAR (health_claims.status): \(.product_number) = \($s|tostring)"' feed.json

jq -r '.products[] | .product_number as $p | .variants[]?
  | select((.sku // "") | test("^[A-Za-z0-9-]+$") | not)
  | "WARENKORB-VERLUST (sku): \($p) = \(.sku|tostring)"' feed.json

Keine Ausgabe heißt: der Feed geht vollständig durch. Schick uns die URL, dann prüfen wir gegen und melden Produktzahl und Auffälligkeiten.

Weiter mit Schritt 2: Warenkorb übergeben.