Comment obtenir des factures en PDF dans Zoho CRM

L'obtention de factures en PDF dans Zoho CRM implique généralement soit de les télécharger manuellement via l'interface utilisateur, soit de les récupérer par programmation via l'API Zoho Books — les deux approches sont présentées ci-dessous.

Pourquoi c'est important

Zoho CRM est souvent intégré à Zoho Books ou Zoho Invoice pour gérer la facturation, et les équipes commerciales ont fréquemment besoin de partager ou d'archiver des PDF de factures directement depuis leur flux de travail. Que vous souhaitiez joindre un PDF à un e-mail, le télécharger pour vos archives ou automatiser la récupération dans le cadre d'une fonction personnalisée, connaître la bonne méthode vous fait gagner un temps considérable. Cela est particulièrement pertinent pour les entreprises qui gèrent des processus automatisés de devis à encaissement dans Zoho.

> Remarque : Beam Help est une ressource d'assistance experte indépendante — et non le support officiel de Zoho.

---

Étape par étape

Option A : Télécharger un PDF de facture manuellement (approche via l'interface)

Étape 1. Ouvrez la facture que vous souhaitez télécharger. Depuis la vue détaillée de la facture, repérez le menu plus d'options (l'icône représentant des points de suspension). Les actions disponibles dans ce menu incluent Télécharger, qui exporte la facture directement en fichier PDF. ^[7][8]

Étape 2. Cliquez sur Télécharger dans ce menu. La facture sera enregistrée sur votre appareil au format PDF. Vous pouvez également choisir Imprimer dans le même menu si vous avez besoin d'une copie papier. ^[7][8]

Étape 3. Si vous souhaitez envoyer le PDF à un client par e-mail plutôt que de le télécharger vous-même, cliquez sur Envoyer la facture sur l'enregistrement de la facture. Par défaut, la case Ajouter le PDF de la facture est présélectionnée, de sorte que le PDF sera automatiquement joint à l'e-mail sortant. ^[2][3]

Étape 4. Avant l'envoi, vous pouvez renommer le PDF joint en cliquant sur son nom de fichier et en saisissant une nouvelle valeur. Vous pouvez également joindre jusqu'à trois fichiers supplémentaires, chacun ne dépassant pas 3 Mo, via l'option Pièces jointes. ^[2][3]

Étape 5. Dans le champ À, choisissez parmi l'adresse e-mail du contact, l'adresse e-mail de l'entreprise ou toute adresse e-mail appartenant aux contacts de l'entreprise — toutes extraites de votre organisation financière intégrée. Chacun des champs À, Cc et Cci accepte un maximum de cinq adresses e-mail. ^[2][3]

Étape 6. Cliquez sur Envoyer pour expédier l'e-mail avec le PDF en pièce jointe. ^[4][5]

---

Option B : Récupérer un PDF de facture via l'API Zoho Books (approche automatisation/développeur)

Cette méthode est utile lorsque vous souhaitez récupérer des PDF de factures par programmation — par exemple, dans une fonction personnalisée Zoho CRM ou un script Deluge.

Étape 1. Identifiez l'organizationid de votre organisation Zoho Books et l'invoiceid de la facture que vous souhaitez exporter. Ces deux valeurs sont requises en tant que paramètres de requête dans l'appel API. ^[1]

Étape 2. Construisez une requête GET vers le point de terminaison suivant, en remplaçant les valeurs par les vôtres :

https://www.zohoapis.com/books/v3/invoices/pdf?organization_id=YOUR_ORG_ID&invoice_ids=YOUR_INVOICE_ID

^[1]

Étape 3. Dans une fonction personnalisée Deluge (par exemple, dans Zoho CRM), utilisez invokeurl pour appeler ce point de terminaison avec un type de requête GET et le nom de votre connexion Zoho Books. Un exemple minimal ressemble à ceci :

DownloadInvoice = invokeurl
[
  url: "https://www.zohoapis.com/books/v3/invoices/pdf?organization_id=" + organizationID + "&invoice_ids=" + invoiceID
  type: GET
  connection: "zohobooks"
];

^[1]

Étape 4. La réponse contiendra les données binaires du PDF, que vous pourrez ensuite stocker, joindre à un enregistrement CRM ou transmettre selon les besoins de votre logique d'automatisation. ^[1]

---

Erreurs courantes

• Restrictions liées au statut de la facture : Une facture au statut Annulée ne peut pas être modifiée, et certaines actions ne sont disponibles qu'en fonction du statut actuel (par exemple, Marquer comme envoyée n'est disponible que lorsque la facture est à l'état Brouillon). Assurez-vous que la facture est dans un statut approprié avant de tenter de la télécharger ou de l'envoyer. ^[7][8]

• Limitations de nommage des PDF : Lors de l'envoi automatisé de factures par e-mail, renommer le PDF de manière dynamique (par exemple, en incluant le nom du client ou le numéro de facture dans le nom du fichier) peut nécessiter des contournements. Les outils actuels de la plateforme rendent les noms de fichiers PDF basés sur des variables non triviaux à mettre en œuvre dans certains contextes d'automatisation. ^[6]

• Le nom de la connexion doit correspondre exactement : Lorsque vous utilisez l'approche Deluge avec invokeurl, le paramètre connection doit correspondre exactement au nom de la connexion Zoho Books que vous avez configurée dans votre compte Zoho CRM. Un nom de connexion incorrect entraînera l'échec silencieux de l'appel API ou le renvoi d'une erreur d'authentification. ^[1]

• Limites de taille des pièces jointes : Lors de l'envoi de factures par e-mail, les pièces jointes supplémentaires sont limitées à trois fichiers d'un maximum de 3 Mo chacun. Le dépassement de ces limites empêchera l'envoi de l'e-mail. ^[2][3]

---

Points à vérifier

• Vérifiez que la facture n'est pas au statut Annulée avant de tenter de la télécharger ou de l'envoyer — les factures annulées ont des actions disponibles restreintes. ^[7][8]
• Confirmez que votre connexion Zoho Books est active et autorisée dans Zoho CRM si vous utilisez l'approche API/Deluge, et que les valeurs organizationid et invoiceids sont correctes. ^[1]
• Vérifiez que la case Ajouter le PDF de la facture est cochée dans la boîte de dialogue Envoyer la facture si un client signale ne pas avoir reçu la pièce jointe PDF dans son e-mail. ^[2][3]