Intégration Holded
Holded est une plateforme de gestion d'entreprise tout-en-un conçue pour le marché espagnol (ES), prenant également en charge le Portugal, l'Italie, la France et l'Allemagne. Lorsqu'elle est configurée dans CADENSA, vous pouvez émettre des factures légalement valides directement à partir de vos entrées de temps suivies, compatibles avec le standard de facturation électronique espagnol FacturaE.
Holded est principalement conçu pour les entreprises en Espagne 🇪🇸, avec un support supplémentaire pour le Portugal 🇵🇹, l'Italie 🇮🇹, la France 🇫🇷 et l'Allemagne 🇩🇪.
L'Espagne impose le suivi des heures de travail depuis 2019 (Real Decreto-ley 8/2019). Le suivi du temps de CADENSA combiné à la facturation Holded offre un workflow complet journal de temps → facture pour les entreprises espagnoles.
Avant de commencer
Vous avez besoin :
- D'un compte Holded actif (tout plan payant)
- D'une clé API Holded (voir ci-dessous)
- D'une unité CADENSA avec au moins le rôle Admin
Étape 1 — Obtenir votre clé API Holded
- Connectez-vous à app.holded.com
- Allez dans Paramètres (icône engrenage, en haut à droite)
- Naviguez vers Intégrations → API
- Cliquez sur "+ Nouvelle clé API" (ou copiez une clé existante)
- Copiez la clé générée
Ne partagez jamais votre clé API et ne la commettez pas dans un système de contrôle de version. Toute personne ayant la clé peut créer et gérer des factures et des contacts en votre nom.
Pour la documentation officielle de l'API Holded, voir : developers.holded.com/reference
Étape 2 — Configurer dans CADENSA
- Ouvrez Paramètres → Facturation dans CADENSA
- Sélectionnez Holded 🇪🇸 comme fournisseur
- Collez votre clé API dans le champ Clé API
- Cliquez sur Tester la connexion — un
vert confirme que la clé est valide - Cliquez sur Enregistrer
Étape 3 — Configurer les valeurs par défaut
Configurez les valeurs par défaut pour que la boîte de dialogue Générer une facture soit pré-remplie avec des valeurs adaptées :
| Paramètre | Valeur recommandée (ES) | Description |
|---|---|---|
| Devise par défaut | EUR | Devise utilisée sur les nouvelles factures |
| TVA % par défaut | 21 | IVA espagnol standard (impuesto sobre el valor añadido) |
| Délai de paiement | 30 | Jours jusqu'à la date d'échéance |
| Type de document par défaut | Facture | Présélectionne "Facture" dans la boîte de dialogue |
| Pays de l'émetteur | ES | Pays de votre entreprise — active la suggestion automatique de TVA |
- 21% — Taux standard (tipo general) — la plupart des services
- 10% — Taux réduit (tipo reducido) — hôtellerie, transport, certains aliments
- 4% — Taux super-réduit (tipo superreducido) — livres, médicaments, certains aliments
- 0% — Exonéré — livraison intra-UE, exportation, certains services financiers
Émettre une facture via Holded
Une fois configuré, suivez le flux standard de génération de factures :
- Ouvrez Rapports → appliquez des filtres de plage de dates et de projet
- Cliquez sur Générer une facture
- Dans le champ Type de document, sélectionnez Facture — le canal de sortie affiche
Holded - Remplissez les détails du client (nom, adresse, pays, numéro de TVA/NIF)
- Définissez le taux de TVA (défaut : 21%)
- Cliquez sur Aperçu de la facture → vérifiez les lignes et les totaux
- Cliquez sur Émettre la facture (Holded)
CADENSA envoie la facture à l'API Holded. Un enregistrement de contact est automatiquement trouvé ou créé (recherche par numéro de TVA en premier, puis par nom). La facture est créée et le PDF est disponible au téléchargement.
- Un nouveau document de facture est créé dans Holded sous Facturación → Facturas emitidas
- Un contact est automatiquement créé s'il n'est pas trouvé
- Le PDF de la facture est disponible pour téléchargement immédiat
Correspondance des contacts
CADENSA recherche un contact Holded existant dans cet ordre :
- Par numéro de TVA/NIF — correspondance la plus fiable (entrez le numéro de TVA du client dans la boîte de dialogue de facturation)
- Par nom d'entreprise — correspondance exacte (insensible à la casse)
- Créer nouveau — si aucune correspondance n'est trouvée, un nouveau contact est créé automatiquement
Pour les clients espagnols, entrez toujours le NIF/CIF (ex. B12345678) dans le champ numéro de TVA du client. Cela garantit que le bon contact Holded est trouvé même si le nom de l'entreprise varie légèrement.
Sélecteur de partenaires
Lorsque Holded est configuré comme fournisseur de facturation, la boîte de dialogue Générer une facture affiche un sélecteur de partenaires — une liste déroulante recherchable alimentée directement depuis vos contacts Holded.
Fonctionnement :
- Tapez un nom ou un texte partiel pour rechercher vos contacts Holded en temps réel
- Sélectionner un partenaire remplit automatiquement tous les champs client : nom de l'entreprise, adresse, code postal, ville, pays, numéro de TVA
- Le champ pays affiche le nom original du pays dans Holded (ex. "Spain", "Hungary") pour une reconnaissance facile — tandis que le code ISO sous-jacent (ex.
ES,HU) est utilisé pour le calcul de la TVA et la logique d'autoliquidation
Holded stocke les noms de pays en texte complet ("Spain", "Germany", etc.). CADENSA convertit automatiquement ces noms en codes ISO 3166-1 alpha-2 en interne pour une suggestion correcte de TVA (nationale / autoliquidation / exportation). Le nom complet est affiché dans l'interface pour la lisibilité.
Mappage des taux de TVA
Holded utilise des objets de taxe nommés. CADENSA mappe automatiquement votre taux de taxe numérique :
| Taux de taxe | Nom de taxe Holded | Cas d'utilisation |
|---|---|---|
| 21% | IVA 21% | IVA espagnol standard |
| 10% | IVA 10% | Taux réduit |
| 4% | IVA 4% | Taux super-réduit |
| 0% | Exento | Exonéré / exportation |
Langues des factures
CADENSA sélectionne automatiquement la langue de facturation en fonction du pays de l'émetteur :
| Pays de l'émetteur | Langue de facturation |
|---|---|
| ES | Espagnol (es) |
| FR | Français (fr) |
| DE | Allemand (de) |
| PT | Portugais (pt) |
| IT | Italien (it) |
| Autre | Espagnol (es, défaut) |
Routage des documents
| Type de document | Sortie |
|---|---|
| Proforma | PDF interne (jamais envoyé à Holded) |
| Résumé de travail | PDF interne (jamais envoyé à Holded) |
| Facture | Envoyé à l'API Holded → PDF retourné |
Seuls les documents de type Facture sont envoyés à Holded. Les Proformas et Résumés de travail sont toujours générés en interne.
Historique des factures et téléchargement PDF
Après une création de facture réussie :
- La facture apparaît dans Rapports → Factures dans CADENSA
- La facture apparaît également dans votre compte Holded sous Facturación → Facturas emitidas
- Vous pouvez re-télécharger le PDF à tout moment depuis l'un ou l'autre endroit
Résolution des problèmes
Erreur "401 Unauthorized"
- Vérifiez que la clé API est correcte et non expirée
- Régénérez une clé dans Holded si nécessaire
Contacts en double
- Entrez toujours le NIF/CIF pour les clients espagnols afin d'assurer une correspondance précise
Aucun environnement sandbox
Holded n'a pas d'environnement sandbox. Pour les tests :
- Créez un contact de test dans Holded (ex. "Client Test ES")
- Générez une petite facture de test dans CADENSA
- Annulez-la immédiatement dans Holded (Facturas emitidas → ⋯ → Anular)
Ressources connexes
Besoin d'aide ?
- E-mail : support@cadensa.io