Zum Hauptinhalt springen

Search HS codes by term

GET 
/company/categories/find

Sucht nach Übereinstimmungen in Codes und Beschreibungen von Positionen (6-stellig) und Unterpositionen (8-10-stellig) des Harmonisierten Systems. Ermöglicht eine freie Suche, ohne die vollständige Hierarchie zu kennen.

Ziel​

Die schnelle Suche nach HS-Codes zu erleichtern, wenn der Produktname oder teilweise der Code bekannt ist, ohne die vollständige hierarchische Struktur durchzunavigieren.

Anwendungsfälle​

  • Suche nach Produkt: HS-Code für Thunfisch, Maschinen, Textilien finden
  • Validierung von Codes: Überprüfen, ob ein Code existiert und seine Beschreibung abrufen
  • Autovervollständigung: Codes vorschlagen, während der Benutzer den Produktnamen eingibt
  • Schnelle Klassifizierung: Kategorien finden, ohne die gesamte Hierarchie zu erkunden
  • Integration mit Inventar: Vorhandene Produkte in einem Katalog klassifizieren

Suchmerkmale​

  • Groß-/Kleinschreibung ignorierend: Unterscheidet nicht zwischen Groß- und Kleinbuchstaben
  • Teilweise Übereinstimmung: Sucht in Titeln (Codes) und Beschreibungen (Labels)
  • Limit von 40 Ergebnissen: 20 Positionen + 20 Unterpositionen
  • Alphabetische Sortierung: Ergebnisse nach Code sortiert
  • Mehrere Quellen: Sucht in Sammlungen von Positionen und Unterpositionen

Suchablauf​

flowchart TD
  A[Suchbegriff empfangen] --> B{gültiger Begriff?}
  B -->|Nein| C[404 USER_NOT_FOUND]
  B -->|Ja| D[In Positionen suchen - max. 20]
  D --> E[In Unterpositionen suchen - max. 20]
  E --> F[Ergebnisse kombinieren]
  F --> G[Alphabetisch sortieren]
  G --> H[Array zurückgeben]

Wichtige Hinweise​

  • Erfordert Authentifizierung mit einem JWT-Token des Unternehmens
  • Der Begriff kann aus Query-Param, Path

Request​

Responses​

Übereinstimmende HS-Codes mit der Suche

Response Headers