Dokumentation | Wine Export Tariff API

Schnellstart-Anleitung

1. Holen Sie sich Ihren API-Key

Registrieren Sie sich kostenlos für ein Konto, um Ihre API-Zugangsdaten zu erhalten. Ihr API-Key wird im Dashboard angezeigt.

Kostenloses Konto erstellen

2. Machen Sie Ihre erste Anfrage

Alle API-Anfragen erfordern den X-API-Key-Header zur Authentifizierung.

# 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. Verarbeiten Sie die Antwort

Die API gibt eine strukturierte JSON-Antwort mit den berechneten Zöllen aufgeschlüsselt nach Steuerart zurück.

{
  "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"
}
            

API-Endpoints

POST

/api/v1/calculate

Berechnen Sie Exportzölle für eine oder mehrere Weinversandzeilen.
POST

/api/v1/validate

Validieren Sie eine Sendung vor dem Versand. Prüfen Sie Beschränkungen und Anforderungen.
GET

/api/countries

Listen Sie alle unterstützten Zielländer mit ihren Codes auf.
GET

/api/wine_types

Listen Sie alle unterstützten Weintypen mit ihren Codes und HS-Codes auf.

Weintypen

Verwenden Sie diese Codes im wine_type-Feld:

Code	Beschreibung	Alkoholbereich
`STILL_RED`	Roter Stillwein	8% - 15%
`STILL_WHITE`	Weißer Stillwein	8% - 15%
`STILL_ROSE`	Rosé Stillwein	8% - 15%
`SPARKLING`	Schaumwein (Champagner, Crémant, etc.)	10% - 13%
`FORTIFIED`	Likörwein (Port, Sherry, etc.)	15% - 22%
`DESSERT`	Süß-/Dessertweine	8% - 18%

Fehlerbehandlung

Die API gibt strukturierte Fehlerantworten mit hilfreichen Meldungen zurück:

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

Benötigen Sie die vollständige API-Referenz?

Unsere interaktive API-Dokumentation enthält alle Endpoints, Parameter und Live-Beispiele.

Vollständige API-Dokumentation ansehen

Entwickler-Dokumentation