Flux d'exportation - Intégration API

Ce guide décrit comment intégrer l'API The Trade Hub dans votre flux d'exportation. L'export ajoute une étape critique par rapport a l'import : le contrôle export des biens double usage. Pour le guide métier complet (régimes, documents, visa de sortie), consultez le guide import/export.

Vue d'ensemble

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

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│ 1. Classer    │───>│ 2. Contrôle      │───>│ 3. Utiliser     │
│    le produit    │    │    export         │    │    les résultats│
│    (ClassifyAI)  │    │    (Export Ctrl)  │    │    (votre SI)   │
└─────────────────┘    └──────────────────┘    └─────────────────┘

Étape 1 - Classer le produit

Comme pour l'import, determinez le code HS de votre marchandise :

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": "Machine-outil CNC pour usinage de précision, 5 axes, commande numerique Siemens"
  }'

Pour l'export, le classement conditionne aussi les contrôles a l'exportation (double usage, materiel militaire).

Étape 2 - Vérifier le contrôle export

Si votre produit est susceptible d'être soumis au contrôle des exportations (Règlement EU 2021/821), utilisez l'API Export Control :

curl -N -X POST https://api.thetradehub.eu/v1/export-control/chat \
  -H "X-API-Key: th_live_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Machine-outil CNC 5 axes, précision positionnement 2 microns, commande numerique",
    "locale": "fr"
  }'

Le flux SSE retourne des événements en temps reel :

Si les spécifications sont insuffisantes, le système pose des questions de clarification (événement clarification). Renvoyez une requete avec le meme session_id pour repondre.

Résultat de contrôle export

Le résultat indique si le bien est contrôle et les obligations de licence :

Voir la référence API Export Control pour la structure complete.

Alternative : mode asynchrone (jobs)

Pour les integrations sans streaming, utilisez le pattern asynchrone :

curl -X POST https://api.thetradehub.eu/v1/export-control/jobs \
  -H "X-API-Key: th_live_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Machine-outil CNC 5 axes, précision positionnement 2 microns",
    "locale": "fr"
  }'

Puis pollez le statut avec GET /v1/export-control/jobs/{id}.

Guides métier complémentaires

L'API The Trade Hub couvre le classement et le contrôle export. Pour les autres étapes du flux d'exportation, consultez :

• Guide import/export - Flux complet (régimes douaniers, documents, procédures)
• DELTA I/E - Déclaration d'exportation sur le système DELTA I/E
• Fondamentaux douaniers - Regimes douaniers, origine, valeur en douane

Prochaines étapes

• Consultez le flux d'importation pour les operations d'import
• Explorez les patterns d'intégration pour les bonnes pratiques en production
• Parcourez les référentiels pour les codes documents