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 enregistrés
Lorsque Holded est configuré comme votre 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é.
Workflows pris en charge :
- Sélectionnez un partenaire existant → tous les champs sont remplis automatiquement
- Effacez le partenaire → modifiez les champs manuellement
- Saisissez les détails du client manuellement si le partenaire n'est pas encore dans Holded (un nouveau contact sera créé à l'émission de la facture)
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, par 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, quel que soit le paramètre du fournisseur.
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
Tester la connexion
Utilisez le bouton Tester la connexion après avoir saisi votre clé API. CADENSA appelle l'API Contacts de Holded pour vérifier que la clé est valide.
Un test réussi affiche :
✓ Connexion réussie
Holded n'a pas d'environnement sandbox. Pour tester :
- Créez un contact de test dans Holded (ex. « Test Client ES »)
- Générez une petite facture de test dans CADENSA
- Annulez-la immédiatement dans Holded (Facturas emitidas → ⋯ → Anular)
Résolution des problèmes
Erreur "401 Unauthorized" / "403 Forbidden"
La clé API est invalide, expirée ou manque des permissions requises.
Correction : Générez une nouvelle clé API dans Holded (Paramètres → Intégrations → API) et re-saisissez-la dans CADENSA.
Erreur "INVOICE_NO_ENTRIES"
Aucune entrée de temps n'a été trouvée pour la plage de dates et les filtres de projet sélectionnés.
Correction : Ajustez la plage de dates ou le filtre de projet et réessayez.
Contact non créé / mauvais contact associé
Si le numéro de TVA est manquant et que le nom de l'entreprise ne correspond pas exactement à un contact Holded existant, un doublon peut être créé.
Correction : Vérifiez Contactos dans Holded et fusionnez les enregistrements en double. Pour les futures factures, entrez toujours le NIF/CIF du client dans le champ numéro de TVA.
Le téléchargement du PDF échoue
Holded génère les PDF de manière synchrone — le PDF devrait être disponible immédiatement après la création de la facture.
Correction : Re-téléchargez depuis Rapports → Factures. Si le problème persiste, consultez la page de statut de Holded ou contactez le support Holded.
L'annulation de facture échoue
Seules les factures au statut pending ou draft peuvent être annulées. Les factures payées ne peuvent pas être annulées via l'API.
Correction : Annulez la facture manuellement dans Holded (Facturas emitidas → ⋯ → Anular) si l'appel API échoue.
Voir aussi
- Fournisseur de facturation — Vue d'ensemble de tous les fournisseurs
- Génération de factures — Comment créer des factures à partir d'entrées de temps
- Historique des factures — Consulter et re-télécharger les factures passées