Documentation API TTNHub

L'API TTNHub vous permet d'intégrer la facturation électronique conforme El Fatoura dans vos applications. Découvrez nos fonctionnalités et inscrivez-vous pour accéder à la documentation technique complète.

Version de l'API: v1
Format: JSON
Encodage: UTF-8
Conformité: El Fatoura / Tunisie TradeNet (TTN)

Démarches Préalables

Avant d'utiliser l'API TTNHub, votre entreprise doit effectuer deux démarches obligatoires :

Important - Obligations légales
  • 1er juillet 2025 : Obligation pour les grandes entreprises et fournisseurs de l'État
  • 1er janvier 2026 : Extension à davantage de services et fournitures
  • Septembre 2026 : Généralisation à toutes les entreprises tunisiennes

1 Obtenir un certificat électronique TunTrust

Le certificat de signature électronique est obligatoire pour signer vos factures électroniques. Il donne une valeur juridique à vos documents.

SITE www.tuntrust.tn Site officiel TunTrust CERT Certificat ID-Trust Certificat de signature électronique ACHAT ecert.tuntrust.tn Commander un certificat en ligne

Types de certificats :

  • ID-Trust : Certificat personnel pour signature de documents
  • Enterprise-ID : Cachet électronique d'entreprise

2 S'inscrire auprès de Tunisie TradeNet (TTN)

L'inscription à TTN est obligatoire pour soumettre vos factures à la plateforme nationale El Fatoura.

SITE www.tradenet.com.tn Site officiel Tunisie TradeNet INFO El Fatoora Page dédiée El Fatoura EMAIL commercial@tradenet.com.tn Contact service commercial TTN

Procédure d'inscription :

  1. Télécharger le dossier d'abonnement sur tradenet.com.tn
  2. Remplir la fiche d'information et le contrat d'abonnement
  3. Fournir les documents : registre de commerce, carte d'identification fiscale
  4. Signer les conditions générales du service
  5. Recevoir vos identifiants TTN après validation

3 Configurer TTNHub

Une fois les étapes 1 et 2 complétées, vous pouvez configurer TTNHub avec vos identifiants.

  1. Créer un compte TTNHub
  2. Uploader votre certificat TunTrust (.p12 ou .pfx)
  3. Configurer vos identifiants TTN (login/mot de passe)
  4. Tester en mode sandbox avant la production
  5. Commencer à émettre des factures électroniques conformes !

Documentation externe

SITE www.tradenet.com.tn Site officiel Tunisie TradeNet INFO El Fatoora - Facturation Électronique Page dédiée El Fatoura EMAIL commercial@tradenet.com.tn Contact service commercial TTN

Procédure d'inscription TradeNet

  1. Télécharger le dossier d'abonnement sur tradenet.com.tn ou le demander par email
  2. Remplir la fiche d'information et le contrat d'abonnement
  3. Fournir les documents requis (registre de commerce, carte d'identification fiscale)
  4. Signer les conditions générales du service
  5. Recevoir vos identifiants TTN après validation
  6. Configurer vos identifiants dans TTNHub pour commencer à émettre des factures

Documentation technique

DOC Guide El Fatoura (VATupdate) Présentation complète du système DOC Guide facturation électronique Tunisie Exigences de conformité
Adresse Tunisie TradeNet
Rue du Lac Malaren, Lotissement El Khalij
Les Berges du Lac, 1053-Tunis, Tunisie

Fonctionnalités de l'API

Notre API offre toutes les fonctionnalités nécessaires pour la facturation électronique en Tunisie.

Création de Factures

Créez des factures au format TEIF avec calcul automatique des totaux et TVA.

Signature Électronique

Signature XAdES automatique conforme aux spécifications TTN.

Validation El Fatoura

Soumission automatique à Tunisie TradeNet et obtention de la référence TTN.

QR Code El Fatoura

Génération automatique du QR Code de vérification conforme.

Export PDF & XML

Téléchargement des factures en PDF professionnel et XML TEIF signé.

Webhooks

Notifications en temps réel du statut de vos factures.

Endpoints API

Aperçu des endpoints disponibles dans l'API TTNHub.

POST /api/v1/invoices Créer une facture
GET /api/v1/invoices Lister les factures
GET /api/v1/invoices/{id} Récupérer une facture
POST /api/v1/invoices/{id}/submit Soumettre à El Fatoura
GET /api/v1/invoices/{id}/pdf Télécharger PDF
GET /api/v1/invoices/{id}/xml Télécharger XML TEIF
DELETE /api/v1/invoices/{id} Annuler une facture

Authentification

L'API utilise une authentification par clé API. Incluez votre clé API dans l'en-tête X-API-Key de chaque requête.

En-tête HTTP 
X-API-Key: elfat_xxxxxxxxxxxxxxxxxxxxx

Les clés API sont générées depuis votre dashboard et peuvent être...

Contenu réservé aux membres

Inscrivez-vous gratuitement pour accéder à la documentation complète sur l'authentification, les clés API et la sécurité.

S'inscrire gratuitement

Exemples de Code

Intégrez rapidement l'API TTNHub avec nos exemples dans plusieurs langages.

TypeScript / JavaScript 
const response = await fetch('/api/v1/invoices', {
  method: 'POST',
  headers: {
    'X-API-Key': 'elfat_xxxxx',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    // ...
  })
});

Exemples de code complets

Accédez aux exemples complets en TypeScript, Python, C#, Java, PHP et cURL pour intégrer rapidement l'API.

S'inscrire gratuitement

Webhooks

Recevez des notifications en temps réel lorsque le statut de vos factures change.

Exemple de payload webhook 
{
  "event": "invoice.validated",
  "data": {
    "invoiceId": "...",
    "ttnReference": "TTN..."
  }
}

Configuration des Webhooks

Découvrez comment configurer les webhooks, les événements disponibles et sécuriser vos endpoints.

S'inscrire gratuitement

Mode Sandbox

Testez votre intégration sans envoyer de factures réelles à El Fatoura.

Environnement URL
Production https://api.ttnhub.com/api/v1
Sandbox https://sandbox.ttnhub.com/api/v1

Accès au Mode Sandbox

Inscrivez-vous pour obtenir vos clés API sandbox et commencer à tester votre intégration.

S'inscrire gratuitement

Prêt à intégrer l'API TTNHub ?

Inscrivez-vous gratuitement pour accéder à la documentation complète, obtenir vos clés API et commencer à générer des factures électroniques conformes.

Commencer gratuitement

50 factures offertes • Aucune carte bancaire requise