Passa al contenuto principale

Search HS codes by term

GET 
/company/categories/find

Cerca corrispondenze nei codici e nelle descrizioni delle voci (6 cifre) e delle sottovoci (8-10 cifre) del Sistema Armonizzato. Consente una ricerca libera senza la necessità di conoscere l'intera gerarchia.

Obiettivo​

Facilitare la ricerca rapida dei codici HS quando si conosce il nome del prodotto o parzialmente il codice, senza dover navigare l'intera struttura gerarchica.

Casi d'uso​

  • Ricerca per prodotto: Trovare il codice HS per tonno, macchinari, tessili
  • Validazione dei codici: Verificare se un codice esiste e ottenere la sua descrizione
  • Autocompletamento: Suggerire codici mentre l'utente scrive il nome di un prodotto
  • Classificazione rapida: Trovare categorie senza esplorare tutta la gerarchia
  • Integrazione con inventario: Classificare prodotti esistenti in un catalogo

Caratteristiche della ricerca​

  • Case-insensitive: Non distingue tra maiuscole e minuscole
  • Corrispondenza parziale: Cerca nei titoli (codici) e nelle descrizioni (labels)
  • Limite di 40 risultati: 20 voci + 20 sottovoci
  • Ordinamento alfabetico: Risultati ordinati per codice
  • Origini multiple: Cerca nelle collezioni di voci e sottovoci

Flusso di ricerca​

flowchart TD
  A[Ricevi termine] --> B{termine valido?}
  B -->|No| C[404 USER_NOT_FOUND]
  B -->|Sì| D[Cerca nelle voci - max 20]
  D --> E[Cerca nelle sottovoci - max 20]
  E --> F[Combina risultati]
  F --> G[Ordina alfabeticamente]
  G --> H[Ritorna array]

Note importanti​

  • Richiede autenticazione con token JWT aziendale
  • Il termine può provenire da query param, path param o body (viene estratto da tutti)
  • Il termine viene ripulito dagli apici singoli prima

Request​

Responses​

Codici HS corrispondenti alla ricerca

Response Headers