Flux d'importation - Intégration API

Ce guide décrit comment intégrer l'API The Trade Hub dans votre flux d'importation. Pour le guide métier complet (origine, valeur en douane, mesures TARIC, documents, déclaration), consultez le guide import/export.

Vue d'ensemble

L'API The Trade Hub intervient a deux étapes clés du flux d'importation :

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│ 1. Classer    │───>│ 2. Consulter     │───>│ 3. Utiliser     │
│    le produit    │    │    l'historique   │    │    les résultats│
│    (API)         │    │    (API)          │    │    (votre SI)   │
└─────────────────┘    └──────────────────┘    └─────────────────┘

Étape 1 - Classer le produit

La première étape consiste a déterminer le code HS de votre marchandise via l'API ClassifyAI.

curl -X POST https://api.thetradehub.eu/v1/classify/jobs \
  -H "X-API-Key: th_live_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Velo electrique avec moteur de 250W, batterie lithium-ion 36V, cadre aluminium",
    "locale": "fr"
  }'

Points clés pour une bon classement :

• Decrire la nature du produit (pas la marque ou le modele)
• Mentionner les materiaux constitutifs
• Preciser la fonction principale
• Indiquer les caractéristiques techniques (puissance, taille, poids)

Le résultat contient le code HS, la confiance, la justification GRI et les sources juridiques citees. Voir la référence API Classement pour la structure complete.

Étape 2 - Exploiter les résultats

Le résultat de classement vous donne les informations nécessaires pour preparer votre déclaration :

Étape 3 - Classement par lot

Pour les importations avec plusieurs articles, utilisez l'endpoint batch :

curl -X POST https://api.thetradehub.eu/v1/classify/batch \
  -H "X-API-Key: th_live_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {"id": "ART-001", "content": "Velo electrique 250W batterie lithium"},
      {"id": "ART-002", "content": "Casque de velo en polycarbonate avec visiere"},
      {"id": "ART-003", "content": "Pompe a velo manuelle en aluminium"}
    ],
    "locale": "fr"
  }'

Étape 4 - Historique et traçabilité

Retrouvez vos classements passes via l'API historique :

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

Exportez en CSV pour vos audits :

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

Guides métier complémentaires

L'API The Trade Hub couvre le classement. Pour les autres étapes du flux d'importation, consultez :

• Guide import/export - Flux complet en 10 chapitres (EORI, origine, valeur, droits, Incoterms, documents)
• Fondamentaux douaniers - Nomenclature, RGI, valeur en douane, origine, BTI/RTC, régimes
• DELTA I/E - Déclaration d'importation sur le système DELTA I/E

Prochaines étapes

• Consultez le flux d'exportation qui inclut le contrôle export
• Explorez les patterns d'intégration pour les bonnes pratiques en production