Documentation | Wine Export Tariff API

Guide de démarrage rapide

1. Obtenez votre clé API

Inscrivez-vous gratuitement pour obtenir vos identifiants API. Votre clé API sera affichée dans le tableau de bord.

2. Faites votre première requête

Toutes les requêtes API nécessitent l'en-tête X-API-Key pour l'authentification.

# Calculate export duties
curl -X POST https://api.export-connect.io/api/v1/calculate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ec_your_api_key_here" \
  -d '{
    "destination_country": "US",
    "lines": [{
      "wine_type": "STILL_RED",
      "volume_liters": 0.75,
      "quantity": 12,
      "unit_price": 25.00,
      "alcohol_degree": 13.5
    }]
  }'
            

3. Gérez la réponse

L'API retourne une réponse JSON structurée avec les droits calculés ventilés par type de taxe.

{
  "destination_country": "US",
  "calculated_at": "2024-01-15T10:30:00Z",
  "lines": [{
    "reference": "LINE-001",
    "success": true,
    "total_duties": 18.72,
    "taxes": [
      {
        "name": "Federal Excise Tax",
        "rate": 1.07,
        "calculation_type": "fixed_per_liter",
        "amount": 9.63
      },
      {
        "name": "Import Duty",
        "rate": 3.0,
        "calculation_type": "percentage",
        "amount": 9.09
      }
    ]
  }],
  "grand_total": 18.72,
  "currency": "EUR"
}
            

Points d'accès API

POST

/api/v1/calculate

Calculez les droits d'export pour une ou plusieurs lignes d'expédition de vin.
POST

/api/v1/validate

Validez une expédition avant l'envoi. Vérifiez les restrictions et exigences.
GET

/api/countries

Listez tous les pays de destination supportés avec leurs codes.
GET

/api/wine_types

Listez tous les types de vins supportés avec leurs codes et codes HS.

Types de vins

Utilisez ces codes dans le champ wine_type :

Code	Description	Plage d'alcool
`STILL_RED`	Vin rouge tranquille	8% - 15%
`STILL_WHITE`	Vin blanc tranquille	8% - 15%
`STILL_ROSE`	Vin rosé tranquille	8% - 15%
`SPARKLING`	Vin effervescent (Champagne, Crémant, etc.)	10% - 13%
`FORTIFIED`	Vin fortifié (Porto, Xérès, etc.)	15% - 22%
`DESSERT`	Vins doux/de dessert	8% - 18%

Gestion des erreurs

L'API retourne des réponses d'erreur structurées avec des messages utiles :

{
  "type": "https://tools.ietf.org/html/rfc2616#section-10",
  "title": "An error occurred",
  "status": 400,
  "detail": "Country code 'XX' not found"
}
            

Besoin de la référence API complète ?

Notre documentation API interactive inclut tous les endpoints, paramètres et exemples en direct.

Voir la documentation API complète

Documentation développeur