Cómo obtener facturas en PDF en Zoho CRM

Obtener facturas en PDF en Zoho CRM generalmente implica descargarlas manualmente a través de la interfaz o recuperarlas de forma programática mediante la API de Zoho Books — ambos enfoques se explican a continuación.

Por qué esto es importante

Zoho CRM suele integrarse con Zoho Books o Zoho Invoice para gestionar la facturación, y los equipos de ventas frecuentemente necesitan compartir o archivar PDFs de facturas directamente desde su flujo de trabajo. Ya sea que quieras adjuntar un PDF a un correo electrónico, descargarlo para tus registros o automatizar la recuperación como parte de una función personalizada, conocer el método correcto ahorra mucho tiempo. Esto es especialmente relevante para empresas que ejecutan procesos automatizados de cotización a cobro dentro de Zoho.

> Nota: Beam Help es un recurso de soporte experto independiente — no es el soporte oficial de Zoho.

---

Paso a paso

Opción A: Descargar un PDF de factura manualmente (enfoque desde la interfaz)

Paso 1. Abre la factura que deseas descargar. Desde la vista de detalle de la factura, localiza el menú de más opciones (el icono de puntos suspensivos). Las acciones disponibles allí incluyen Descargar, que exporta la factura directamente como archivo PDF. ^[7][8]

Paso 2. Haz clic en Descargar desde ese menú. La factura se guardará en tu dispositivo como PDF. También puedes elegir Imprimir desde el mismo menú si necesitas una copia en papel. ^[7][8]

Paso 3. Si deseas enviar el PDF a un cliente por correo electrónico en lugar de descargarlo tú mismo, haz clic en Enviar factura en el registro de la factura. De forma predeterminada, la casilla Agregar PDF de factura está preseleccionada, por lo que el PDF se adjuntará automáticamente al correo saliente. ^[2][3]

Paso 4. Antes de enviar, puedes cambiar el nombre del PDF adjunto haciendo clic en su nombre de archivo y escribiendo un nuevo valor. También puedes adjuntar hasta tres archivos adicionales, cada uno de no más de 3 MB, usando la opción Archivos adjuntos. ^[2][3]

Paso 5. En el campo Para, elige entre la dirección de correo electrónico del contacto, la dirección de correo de la empresa o cualquier dirección de correo perteneciente a los contactos de la empresa — todas extraídas de tu organización financiera integrada. Cada uno de los campos Para, Cc y Cco admite un máximo de cinco direcciones de correo electrónico. ^[2][3]

Paso 6. Haz clic en Enviar para despachar el correo electrónico con el PDF adjunto. ^[4][5]

---

Opción B: Recuperar un PDF de factura mediante la API de Zoho Books (enfoque de automatización/desarrollador)

Este método es útil cuando deseas obtener PDFs de facturas de forma programática — por ejemplo, dentro de una función personalizada de Zoho CRM o un script de Deluge.

Paso 1. Identifica el organizationid de tu organización en Zoho Books y el invoiceid de la factura que deseas exportar. Ambos valores son necesarios como parámetros de consulta en la llamada a la API. ^[1]

Paso 2. Construye una solicitud GET al siguiente endpoint, sustituyendo tus valores reales:

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

^[1]

Paso 3. En una función personalizada de Deluge (por ejemplo, dentro de Zoho CRM), usa invokeurl para llamar a este endpoint con un tipo de solicitud GET y el nombre de tu conexión de Zoho Books. Un ejemplo mínimo es el siguiente:

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

^[1]

Paso 4. La respuesta contendrá los datos binarios del PDF, que luego puedes almacenar, adjuntar a un registro de CRM o reenviar según sea necesario dentro de tu lógica de automatización. ^[1]

---

Errores comunes

• Restricciones por estado de la factura: Una factura en estado Anulado no puede editarse, y ciertas acciones solo están disponibles según el estado actual (por ejemplo, Marcar como enviada solo está disponible cuando la factura está en estado Borrador). Asegúrate de que la factura esté en un estado apropiado antes de intentar descargarla o enviarla. ^[7][8]

• Limitaciones en el nombre del PDF: Al adjuntar PDFs de facturas mediante tareas automatizadas de envío de correo, cambiar el nombre del PDF de forma dinámica (por ejemplo, incluyendo el nombre del cliente o el número de factura en el nombre del archivo) puede requerir soluciones alternativas. Las herramientas actuales de la plataforma hacen que los nombres de archivo de PDF basados en variables no sean triviales de implementar en algunos contextos de automatización. ^[6]

• El nombre de la conexión debe coincidir exactamente: Al usar el enfoque de Deluge con invokeurl, el parámetro connection debe coincidir exactamente con el nombre de la conexión de Zoho Books que hayas configurado en tu cuenta de Zoho CRM. Un nombre de conexión incorrecto hará que la llamada a la API falle silenciosamente o devuelva un error de autenticación. ^[1]

• Límites de tamaño de archivos adjuntos: Al enviar facturas por correo electrónico, los archivos adjuntos adicionales están limitados a tres archivos con un máximo de 3 MB cada uno. Superar estos límites impedirá que se envíe el correo. ^[2][3]

---

Qué verificar

• Verifica que la factura no esté en estado Anulado antes de intentar descargarla o enviarla — las facturas anuladas tienen acciones restringidas disponibles. ^[7][8]
• Confirma que tu conexión de Zoho Books esté activa y autorizada en Zoho CRM si estás usando el enfoque de API/Deluge, y que los valores de organizationid e invoiceids sean correctos. ^[1]
• Comprueba que la casilla Agregar PDF de factura esté seleccionada en el diálogo Enviar factura si un cliente reporta no haber recibido el PDF adjunto en su correo electrónico. ^[2][3]