Importablauf - API-Integration

Dieser Leitfaden beschreibt, wie Sie die The Trade Hub API in Ihren Importablauf integrieren. Für den vollständigen Geschäftsleitfaden (Ursprung, Zollwert, TARIC-Maßnahmen, Dokumente, Zollanmeldung) siehe den Import/Export-Leitfaden.

Übersicht

Die The Trade Hub API unterstützt bei zwei wichtigen Schritten im Importablauf:

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│ 1. Produkt      │───>│ 2. Historie      │───>│ 3. Ergebnisse   │
│    klassifizieren│    │    prüfen        │    │    verwenden   │
│    (API)         │    │    (API)         │    │    (Ihr System)│
└─────────────────┘    └──────────────────┘    └─────────────────┘

Schritt 1 – Produkt klassifizieren

Der erste Schritt besteht darin, den HS-Code für Ihre Waren mit der ClassifyAI API zu ermitteln.

curl -X POST https://api.thetradehub.eu/v1/classify/jobs \
  -H "X-API-Key: th_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Elektrisches Fahrrad mit 250W Motor, Lithium-Ionen 36V Batterie, Aluminiumrahmen",
    "locale": "en"
  }'

Wichtige Punkte für eine genaue Tarifeinreihung:

• Beschreiben Sie die Beschaffenheit des Produkts (nicht Marke oder Modell)
• Nennen Sie die Bestandteile / Materialien
• Geben Sie die Hauptfunktion an
• Führen Sie die technischen Spezifikationen auf (Leistung, Größe, Gewicht)

Das Ergebnis enthält den HS-Code, die Zuverlässigkeit (confidence), GRI-Begründung und zitierte Rechtsquellen. Die vollständige Struktur finden Sie in der Klassifizierungs-API-Dokumentation.

Schritt 2 – Ergebnisse verwenden

Das Klassifizierungsergebnis liefert die Informationen, die Sie zur Vorbereitung Ihrer Zollanmeldung benötigen:

Schritt 3 – Stapelklassifizierung

Für Importe mit mehreren Artikeln nutzen Sie den Batch-Endpunkt:

curl -X POST https://api.thetradehub.eu/v1/classify/batch \
  -H "X-API-Key: th_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {"id": "ART-001", "content": "Elektrisches Fahrrad 250W Lithium-Batterie"},
      {"id": "ART-002", "content": "Polycarbonat-Fahrradhelm mit Visier"},
      {"id": "ART-003", "content": "Manuelle Aluminium-Fahrradpumpe"}
    ],
    "locale": "en"
  }'

Schritt 4 – Historie und Rückverfolgbarkeit

Rufen Sie Ihre vergangenen Klassifizierungen über die Historie-API ab:

curl "https://api.thetradehub.eu/v1/classify/history?from=2026-01-01&status=completed&hs=87" \
  -H "X-API-Key: th_live_your_api_key"

Exportieren Sie die Daten für Prüfungen als CSV:

curl "https://api.thetradehub.eu/v1/classify/history/export?from=2026-01-01" \
  -H "X-API-Key: th_live_your_api_key" \
  -o classifications.csv

Ergänzende Geschäftsleitfäden

Die The Trade Hub API deckt die Klassifizierung ab. Für die weiteren Schritte im Importablauf siehe:

• Import/Export-Leitfaden – Vollständiger Ablauf in 10 Kapiteln (EORI, Ursprung, Wert, Abgaben, Incoterms, Dokumente)
• Zollgrundlagen – Nomenklatur, GIR, Zollwert, Ursprung, vZTA/RTC, Verfahren
• DELTA I/E – Importzollanmeldung im DELTA I/E-System

Nächste Schritte

• Sehen Sie sich den Exportablauf an, der auch Exportkontrolle beinhaltet
• Erkunden Sie die Integrationsmuster für Best Practices in der Produktion