NOGL
Händlerdokumentation

Händlerdokumentation

Eine Anbindung planen, validieren und prüfen.

Ein technischer Leitfaden für Händler und Quellenverantwortliche. Vereinbaren Sie den Datenvertrag, bevor Sie Zugriff erteilen oder sich auf regelmäßige Übertragungen verlassen.

1. Zugriffsweg auswählen

Öffentliche Beobachtung, privater Datenauszug und ausgehende Benachrichtigung haben unterschiedliche Berechtigungen und Abnahmekriterien. Wählen Sie einen Weg für den ersten Test.

  • Öffentliche Quelle: URLs, Land, Produktumfang und Beobachtungsdatum vereinbaren. Zugängliche Shopify-Kataloge lassen sich in der öffentlichen Demo testen; weitere Abdeckung muss bestätigt werden.
  • Kundeneigene Eingabe: begrenzten Export oder freigegebenen Zugriff vereinbaren. Ein Plattformname im Verzeichnis belegt keinen funktionierenden authentifizierten Connector.
  • Ausgehende Übertragung: Ziel und Empfänger vereinbaren. Eine Testzustellung prüfen, bevor Bericht, Tabelle oder Benachrichtigung verlässlich genutzt werden.

2. Kleinen Datenvertrag festhalten

Dokumentieren Sie die Bedeutung einer Zeile, ihr führendes System und die Kriterien für eine erfolgreiche Übergabe. Das folgende Beispiel ist ein vorgeschlagener Katalogvertrag, kein von jedem Connector akzeptiertes Uploadformat.

  • Umfang: benannte Quelle, Markt, Produktauswahl, Zeitraum und Lese- oder Schreibrichtung.
  • Identität: stabile Produkt- und Variantenschlüssel; Zuordnungen bei unterschiedlichen System-IDs dokumentieren.
  • Werte: Feldtypen, Währung, Steuerbasis, Einheiten, Zeitzone und Regeln für fehlende Werte.
  • Übertragung: abgestimmter Weg, Zeitplan, Aktualitätsgrenze, Verantwortung sowie Pausieren und Widerrufen des Zugriffs.
Beispiel eines Katalogvertrags
FeldBedeutungPrüfung
product_key / variant_keyStabile QuellenidentitätEindeutig auf vereinbarter Zeilenebene
observed_atBeobachtungszeit mit ZeitzoneInnerhalb der akzeptierten Aktualitätsgrenze
gtinGlobal Trade Item Number, wie sie auf dem Quelleintrag angezeigt wird8, 12, 13 oder 14 Ziffern mit gültiger Prüfziffer; Unbekanntes bleibt leer
delivery_termsLiefergebühr, Lieferzeit und Liefergebiet wie angezeigtWährungs- und Steuerbasis dokumentiert; Unbekanntes bleibt unbekannt und wird nie als Null gelesen
price / currencyAngezeigte oder vereinbarte PreisbasisSteuer- und Währungsdefinition dokumentiert
availabilityVerfügbarkeitsangabe der QuelleUnbekannt bleibt von nicht verfügbar getrennt
source_referenceNachvollziehbarer Quelldatensatz oder URLStichprobe kann abgeglichen werden
Einen Produktdatensatz prüfen

Fiktives Beispiel zum Feldumfang

Das Feld prüfen, bevor Sie die Verbindung planen

Eine öffentliche Produktseite, ein angefragtes privates Feld und ein vorgeschlagener Schreibzugriff sind unterschiedliche Nachweise. Trennen Sie diese anhand des fiktiven Beispiels, bevor Sie eine Verbindung besprechen. Dieser Leitfaden verbindet kein Konto.

Version der Illustration: t21-v1

Mit einer Händlerfrage beginnen

Wählen Sie eine Frage, um ein festes Beispiel zu prüfen. Die Auswahl ändert nur diese Illustration; sie fordert weder Daten noch Berechtigungen an.

Was zeigt dieses öffentliche Angebot?

F01 · Variantentitel

Das Feld zur Quelle zurückverfolgen

Vergleichen Sie das Quellenfeld mit dem vorgeschlagenen NOGL-Feld. Ein Zuordnungsvorschlag ist keine verifizierte Zuordnung. Eine mehrdeutige oder fehlende Identität bleibt ungeklärt.

Quellenfeld
listing.variant_title
Vorgeschlagenes NOGL-Feld
product.title
Quellen-ID
FX-PUBLIC-01
Fiktive Quellenreferenz
fixture:catalog/linen-shirt-blue-m
Zuordnungsstatus
Zuordnungsvorschlag — nicht verifiziert

Zugriff und Richtung getrennt betrachten

Öffentliche Nachweise belegen keinen Zugriff auf private Datensätze. Angefragter Zugriff ist kein erteilter Zugriff. Ein vorgeschlagener Schreibzugriff benötigt eine gesonderte Prüfung von Umfang und Freigabe; hier wird nichts geschrieben.

Richtung
Lesenachweis
Zugriffsstatus
Nur öffentliches Beispiel
  • Berechtigungsnachweis: nicht vorhanden
  • Händlerfreigabe: unbekannt
  • NOGL-Laufzeitunterstützung: ungeprüft

Angezeigte Richtung und Zugriffsstatus folgen dem ausgewählten Feld; die Auswahl ändert weder Berechtigung, Freigabe, Zuordnung noch Laufzeitnachweis.

Fehlenden Kontext sichtbar halten

Prüfen Sie bei Bedarf Quellenversion, Beobachtungszeit, Variante, Standort, Währung und Einheit. Fehlende Werte bleiben unbekannt; sie werden nicht zu null Stück. Ein Verfügbarkeitstext belegt keinen Bestand je Standort.

Beispielwert
Linen shirt · blue · M
Währung
Nicht vorhanden
Einheitenbezug
Nicht vorhanden
Beobachtungszeit des Wertes
2026-09-30T09:00:00Z
Quellen-ID des Wertes
FX-PUBLIC-01
Quellen- / Vorschlagsversion
fixture-v1
Version des angefragten Umfangs
fixture-v1
Nachweisumfang
Erfundenes Beispiel einer öffentlichen Produktseite; eine Variante, deutscher Markt, ein angezeigtes Angebot.
Metadatenbasis
Erfundene Illustration; fehlender Wert oder Zeitpunkt hat keinen behaupteten Beobachtungsnachweis.

fixture-v1 beschreibt diese erfundene Illustration, keine verifizierte Quellenschemaversion oder Version eines Lieferantenangebots.

Vorschlagsmetadaten sind kein Herkunftsnachweis für einen Wert

Nur eine fiktive Variante; die Quellenidentität bleibt ein Vorschlag.

Eine menschliche Prüfung vorbereiten

Zeigen Sie die offenen Punkte zur ausgewählten Frage an. Eine verantwortliche Person auf Quellenseite muss Identität, Feldbedeutung, minimale Berechtigung und vorgesehene Richtung prüfen. Diese Notizen sind eine Illustration, keine versendete Anfrage und keine Freigabe.

Prüfnotizen anzeigen

Diese offenen Punkte gehören zur ausgewählten Frage; das Beispiel löst keinen davon auf.

  • F01 · Variantentitel

    Nur eine fiktive Variante; die Quellenidentität bleibt ein Vorschlag.

  • F02 · Angezeigter Preis

    EUR ist im Beispiel angegeben; Steuer- und Versandbasis sind unbekannt.

  • F03 · Verfügbarkeitstext

    Nur der Wortlaut der Produktseite; kein Nachweis für Menge, Standort oder Verkäufe.

Eine verantwortliche Person auf Quellenseite muss vor einem gesondert autorisierten Test Identität, Feldbedeutung, minimale Berechtigung und vorgesehene Richtung prüfen.

Einen begrenzten nächsten Schritt vereinbaren

Vereinbaren Sie im Verbindungsplan Quellenverantwortung, Datengrenzen und einen gesondert autorisierten Test. Machbarkeit, Laufzeitunterstützung und Händlerfreigabe bleiben ungeprüft. Hier wird nichts importiert, veröffentlicht oder synchronisiert.

Eine begrenzte Verbindungsprüfung planenProduktinformationen prüfenDen siebenstufigen Zyklus ansehen

3. Minimalen vereinbarten Umfang freigeben

Nutzen Sie den mit NOGL und Ihrer Quellenadministration vereinbarten Einrichtungsweg. Diese Dokumentation erteilt keine Berechtigungen und verbindet keine Konten.

  • Felder und Ziel von der Quellenverantwortung freigeben lassen. Soweit passend mit einer Teststichprobe oder begrenztem Lesezugriff beginnen.
  • Test- und Produktionsziele trennen. Prüfen, ob Ausgaben Datensätze anhängen oder vorhandene Bereiche ersetzen.
  • Bei Bedarf einen sicheren Austausch von Zugangsdaten vereinbaren. Keine Passwörter, API-Schlüssel oder Kundendaten über ein allgemeines Kontaktformular senden.
  • Verantwortung für Widerruf, Schlüsselwechsel und Änderungen am Quellenschema festhalten.

4. Mit der Quelle abgleichen

Prüfen Sie eine kleine Stichprobe gemeinsam, bevor die Abdeckung erweitert wird. Erfolgreicher Transport allein belegt weder Vollständigkeit noch Eignung für die Handelsfrage.

  • Empfangene, fehlende und doppelte Datensätze zählen. Stabile Schlüssel und einige bekannte Produkte direkt mit der Quelle vergleichen.
  • Preise, Währungen, Einheiten und Zeitstempel abstimmen. Einen fehlenden Wert von einer tatsächlichen Null unterscheiden.
  • Bei öffentlichen Scans beobachtete Anzahl und Vollständigkeit getrennt halten. Ein Teilergebnis ist ein nützlicher Beleg, aber keine vollständige Kataloganzahl.
  • Bei Nachrichten oder Tabellen tatsächliches Ziel und Empfängersichtbarkeit prüfen. Ersetzung und Duplikatverhalten bestätigen.
  • Testdatum, Umfang, Ergebnis, offene Lücken und die Freigabe für den nächsten Schritt dokumentieren.
Vorbereitete MCP-Belege vergleichen

5. Zustandsprüfung vereinbaren

Vereinbaren Sie vor regelmäßiger Nutzung, wer Fehler prüft und wie veraltete Daten gekennzeichnet werden. Dies sind Abnahmeanforderungen, keine Zusagen eines aktiven Monitoring-Dashboards.

  • Letzte erfolgreiche Beobachtung oder Übertragung, erwartetes Intervall und maximal akzeptierter Verzug.
  • Datensatzanzahl sowie Änderungen bei fehlenden oder ungültigen Feldern gegenüber dem letzten akzeptierten Lauf.
  • Fehlerkategorie, betroffener Umfang und nächster Schritt; keine Zugangsdaten oder personenbezogenen Daten in gemeinsamen Logs.
  • Benannte fachliche und technische Verantwortung, Eskalationsweg und getestetes Pausieren oder Widerrufen.

6. Protokolle zur Anbindungsverifizierung

Bevor Sie vom abgestimmten Schema zur aktiven Ausführung übergehen, durchlaufen Sie das dreiphasige Verifizierungsprotokoll: Vorab-Handshake, Vollständigkeitsprüfung und Abgleich nach dem Import.

  • Vorab-Handshake: TLS-1.3-Verschlüsselungsgrenze, Gültigkeit von Bearer-Tokens oder HMAC-Signaturen sowie Endpunkt-Erreichbarkeit mit einem Einzeldatensatz-Ping vor dem Batch-Auszug prüfen.
  • Vollständigkeitsprüfung: Datensatzanzahl im Batch-Manifest mit eingegangenen Zeilen abgleichen. Prüfsummen validieren und lautlose Kürzung bei langen Beschreibungen ausschließen.
  • Identitäts- und Körnungsvertrag: Eindeutige Primärschlüssel mit der vereinbarten Zeilenebene abgleichen. Batches mit kollidierenden product_key- oder variant_key-Datensätzen ablehnen oder isolieren.
  • Toleranzgrenze für Nullwerte: Strenge Nullwert-Grenzen einhalten (<0,1 % bei Preis, Währung und Verfügbarkeit; unzugeordnete Felder bleiben explizit null, niemals null Euro).
  • Idempotenzvalidierung: Wiederholsicherheit durch zweimaliges Verarbeiten einer Test-Nutzlast prüfen; der Zustand darf keine Duplikate oder Scheinausgaben erzeugen.
VP-01 · Phase 1: AnbindungsverifizierungAbnahmeschranke

Vorab-Transport-Handshake

Transportisolation, TLS-Verschlüsselungsgrenze und Berechtigungsumfang vor dem ersten Batch-Auszug prüfen.

  • TLS 1.3 mit gültigem SAN-Hostnamen-Zertifikat bestätigt
  • OAuth2-Token / API-Schlüssel mit reinen Lese-Berechtigungen validiert
  • Einzel-Datensatz-Probehandshake liefert HTTP 200 innerhalb eines 500ms-Fensters
  • Ratenbegrenzung der Quelle dokumentiert; Backoff-Zeitplan abgestimmt

Aktion bei Fehler: Anbindungsausführung anhalten; Konfigurationsticket ohne Wiederholungssturm erstellen.

VP-02 · Phase 2: Transport- & SchemakonformitätAbnahmeschranke

Vollständigkeits- & Herkunftsprüfung

Übertragenes Datenvolumen und Schemastruktur mit dem deklarierten Quellmanifest abgleichen.

  • Übertragene Zeilenzahl stimmt zu 100 % mit der Prüfsumme des Quellmanifests überein
  • Keine lautlose Zeichenkürzung bei Beschreibungs- und Attributfeldern
  • Erforderliche Identifikationsschlüssel (product_key, variant_key) vorhanden und ungleich null
  • Zeitstempelfelder nach ISO 8601 UTC mit dokumentiertem Zeitzonen-Offset normalisiert

Aktion bei Fehler: Inkonsistenten Batch in Quarantäne-Bucket umleiten; Rohdaten zur Prüfung sichern.

VP-03 · Phase 3: Datenintegritäts-SchrankeAbnahmeschranke

Abgleich nach dem Import & Idempotenz

Prüfen, ob eingegangene Daten zur Historie passen und sich ohne Seiteneffekte erneut einspielen lassen.

  • Doppelte Übertragung erzeugt null neue Zeilen und identische Prüfsummen
  • Nullwert-Rate bei kommerziellen Pflichtfeldern (Preis, Währung, Status) unter 0,1 %
  • Katalogschlüssel lassen sich ohne verwaiste Varianten 1:1 auf Händleridentifikatoren abbilden
  • Eindeutige Unterscheidung zwischen nicht lieferbarem und nicht beobachtetem Bestand gewahrt

Aktion bei Fehler: Nachgelagerte Modellübernahme einfrieren; fachliche und technische Leitung informieren.

7. Kontrollpunkte für Datenflusszustand & Schutzschalter

Betriebliche Anbindungen erfordern vereinbarte Zustandskontrollpunkte, die Schutzschalter auslösen, anstatt nachgelagerte Handelsentscheidungsmodelle zu verfälschen.

  • Aktualitäts-SLA-Kontrollpunkt: Maximal tolerierten Verzug festlegen (z. B. 6 Std. für Katalogbeobachtungen, 1 Std. für Bestellereignisse). Bei Überschreitung wird der Datenstrom als veraltet markiert und Prognosegewichte eingefroren.
  • Schutzschalter bei Schema-Drift: Unerwartete Spalten, Typfehler oder Feldumbenennungen leiten Datensätze sofort in eine isolierte Dead-Letter-Queue (DLQ) um.
  • Preisanomalie-Schranke: Plötzliche katalogweite Preisabweichungen (>25 % Medianverschiebung) lösen einen Prüfstopp aus, bis der Einkauf explizit freigibt.
  • Widerrufsprotokoll für Zugangsdaten: Bei Auth-Fehlern (HTTP 401/403) pausiert der Connector sofort; automatische Wiederholungen sind auf maximal 3 mit exponentiellem Backoff begrenzt.
  • Menschlicher Eskalationsweg: Benannte technische und fachliche Prüfpersonen festlegen, die Schutzschalter-Auslösungen untersuchen und die Fortsetzung autorisieren.
HP-01

Aktualitäts-SLA-Kontrollpunkt

Messgröße
Importverzögerung im Vergleich zum Zeitstempel der Quellenerzeugung
Schwellenwert
Max. 6 Stunden für Katalogdaten; max. 1 Stunde für Bestell-/Bestandsdaten
Schutzschalter-Reaktion
Datensatz als veraltet markieren, SLA-Verzug protokollieren, automatische Gewichte einfrieren
Verantwortung
Technischer Datenbetrieb
HP-02

Schutzschalter bei Nullwert-Grenzen

Messgröße
Anteil fehlender oder ungültiger Werte bei kommerziellen Pflichtfeldern
Schwellenwert
> 0,5 % fehlende Preise oder > 0,1 % fehlende SKU-Schlüssel im Batch
Schutzschalter-Reaktion
Pipeline-Schutzschalter auslösen, Schreibzugriff stoppen, Dateningenieur alarmieren
Verantwortung
Datenqualitäts-Leitung
HP-03

Schema-Drift & Feldevolution-Schranke

Messgröße
Feldnamen-, Datentyp- oder Nullbarkeitsänderungen gegen den registrierten Vertrag
Schwellenwert
Nulltoleranz bei unangekündigten Entfernungen oder Typänderungen
Schutzschalter-Reaktion
Batch in Dead-Letter-Queue (DLQ) verschieben, Schema-Drift-Benachrichtigung senden
Verantwortung
Integrationsarchitektur
HP-04

Preisanomalie-Detektor im Katalog

Messgröße
Medianverschiebung der Preise bei übereinstimmenden Produktkatalog-Datensätzen
Schwellenwert
Katalogweite Preisverschiebung von mehr als 25 % bei > 100 Artikeln in einem Update
Schutzschalter-Reaktion
Manuelle Freigabe durch den Einkauf vor Übernahme in die Preisberechnung verlangen
Verantwortung
Einkaufs- / Sortimentsleitung

Fehlersuche beim Test

Begrenzen Sie den fehlerhaften Umfang so, dass er reproduzierbar bleibt. Nennen Sie dem Support Quelle, ungefähren Zeitpunkt und eine bereinigte Beschreibung.

  • Keine Zeilen: vereinbarten Zeitraum, Markt, Filter und Berechtigungen prüfen, bevor ein leerer Katalog angenommen wird.
  • Teilergebnisse: gemeldete Vollständigkeit, Anfragefehler und Quellengrenzen prüfen; beobachtete Anzahl nicht als Gesamtzahl bezeichnen.
  • Falsche Produktzuordnung: Variantenschlüssel, Bundles, Packungsgrößen und sprachspezifische Datensätze prüfen.
  • Veraltete Ausgabe: Quellenzeitstempel mit Übertragungszeit und vereinbartem Zeitplan vergleichen.
  • Abgelehnter Zugriff oder fehlgeschlagene Zustellung: berechtigte Quellenverantwortliche um Prüfung von Rechten und Zielkonfiguration bitten. Keine Zugangsdaten in Tickets kopieren.

Quelle & Kosten · öffentliche Referenz

Referenz für USITC HTS Online

Ein begrenzter öffentlicher Beleg für eine Suche im US-Zolltarif. Quelle, Datum und Hoheitsgebiet bleiben sichtbar, ohne aus einer öffentlichen Referenz eine Klassifizierung oder Zollberechnung abzuleiten.

Hoheitsgebiet
Vereinigte Staaten · Harmonized Tariff Schedule der USA
Beobachtete Revision
HTS-Revision 21 für 2026 · Archivdatum 09.10.2026
Beobachtete Suche
6109
Herkunft
Öffentliche Suche und Archiv der offiziellen USITC, in einer öffentlichen Browsersitzung beobachtet; CBP CROSS wird als separate angrenzende Entscheidungsquelle gezeigt.

Belegansichten

Öffentliche USITC-Suchbelege werden angezeigt.

Vor der Nutzung dieser Referenz

Bestätigen Sie Produkt, Land und Hoheitsgebiet sowie die aktuelle tarifliche Behandlung mit dem zuständigen Zoll- oder Trade-Compliance-Team. Diese Seite dokumentiert eine öffentliche Quellenbeobachtung; sie ist keine Produktklassifizierung und keine Zollberechnung.

Verwenden Sie dies nur als Referenz; hier wird keine Produktklassifizierung, Zollberechnung oder rechtliche Feststellung bereitgestellt.