Aller au contenu principal

Search HS codes by term

GET 
/company/categories/find

Recherche de correspondances dans les codes et descriptions des positions (6 chiffres) et sous-positions (8-10 chiffres) du Système Harmonisé. Permet une recherche libre sans avoir besoin de connaître la hiérarchie complète.

Objectif​

Faciliter la recherche rapide de codes SH lorsque le nom du produit est connu ou partiellement le code, sans naviguer dans la structure hiérarchique complète.

Cas d'utilisation​

  • Recherche par produit : Trouver le code SH pour thon, machinerie, textiles
  • Validation de codes : Vérifier si un code existe et obtenir sa description
  • Saisie semi-automatique : Suggérer des codes pendant que l'utilisateur saisit le nom d'un produit
  • Classement rapide : Trouver des catégories sans explorer toute la hiérarchie
  • Intégration avec l'inventaire : Classer des produits existants dans un catalogue

Caractéristiques de la recherche​

  • Insensible à la casse : Ne distingue pas les majuscules/minuscules
  • Correspondance partielle : Recherche dans les titres (codes) et descriptions (libellés)
  • Limite de 40 résultats : 20 positions + 20 sous-positions
  • Tri alphabétique : Résultats triés par code
  • Sources multiples : Recherche dans les collections de positions et sous-positions

Flux de recherche​

flowchart TD
  A[Recevoir terme] --> B{terme valide?}
  B -->|Non| C[404 USER_NOT_FOUND]
  B -->|Oui| D[Rechercher dans positions - max 20]
  D --> E[Rechercher dans sous-positions - max 20]
  E --> F[Combiner résultats]
  F --> G[Trier alphabétiquement]
  G --> H[Retourner tableau]

Notes importantes​

  • Requiert une authentification avec un token JWT d'entreprise
  • Le terme peut provenir d'un paramètre de requête, d'un paramètre de chemin ou du corps (il est extrait de tous)
  • Le terme est nettoyé des

Request​

Responses​

Codes SH correspondant à la recherche

Response Headers