Holded - Conectar y enviar documentos

Conecta Holded con haddock para enviar facturas de compra desde Documentos sin tener que exportar un archivo y subirlo manualmente.

Qué hace esta integración

Cuando envías documentos a Holded, haddock:

1. Crea el documento de compra en Holded.
2. Usa el proveedor de Holded que coincida con el mismo VAT/NIF/CIF del proveedor en haddock.
3. Envía la fecha, el número de factura, los importes y los impuestos del documento.
4. Adjunta el PDF del documento en Holded.
5. Añade una nota interna en Holded con el enlace al documento en haddock.
6. Muestra el estado del envío en la columna Contabilidad de la tabla de documentos.

La integración no crea proveedores en Holded. Si el proveedor no existe allí, primero tendrás que crearlo en Holded con el mismo VAT/NIF/CIF.

Antes de empezar

Necesitas:

• Una cuenta de Holded con acceso a la configuración de API.
• Una API key de Holded con permisos para leer contactos y crear documentos de compra con adjuntos.
• Permiso para gestionar integraciones en haddock.
• Los proveedores creados en Holded con el mismo VAT/NIF/CIF que tienen en haddock.
• Documentos de tipo factura, ya procesados o creados manualmente, con fecha, importes y PDF disponible.

Si no ves la opción de Holded en haddock, contacta con soporte.

Conectar Holded

1. Entra en el perfil del restaurante en haddock.
2. Ve a la sección Integraciones.
3. Busca Integraciones ERP y selecciona Holded.
4. Haz clic en Conectar.
5. En la ventana de conexión, abre el enlace para crear tu API key de Holded.
6. Copia la API key de Holded y pégala en haddock.
7. Haz clic en Conectar.

Cuando la conexión se complete, verás Holded como Conectado. Desde Ver detalles podrás revisar la conexión, actualizar la API key o desconectar Holded.

Enviar documentos a Holded

1. Ve a Documentos.
2. Selecciona los documentos que quieres enviar o aplica filtros para preparar el listado.
3. Haz clic en Enviar a Holded. También puedes encontrar esta opción dentro del menú Exportar.
4. Revisa la comprobación previa antes de enviar.
5. Si hay documentos bloqueados, corrige los problemas indicados.
6. Haz clic en Enviar documentos.

Si has seleccionado documentos y también hay más documentos visibles por los filtros, haddock te permitirá elegir entre:

• Documentos seleccionados: envía solo los documentos marcados.
• Todos los documentos filtrados: envía todos los documentos que cumplen los filtros actuales.

El envío de todos los documentos filtrados está limitado a 300 documentos por operación.

Cómo leer la comprobación previa

Antes de enviar, haddock agrupa los documentos en varios estados:

• Listos para enviar: se pueden enviar a Holded.
• Ya enviándose: ya hay un envío en curso para esos documentos.
• Ya enviados: ya existen como enviados a Holded.
• Proveedor no encontrado: falta proveedor, falta VAT/NIF/CIF o el proveedor no existe en Holded con ese identificador.
• No elegibles: falta fecha, PDF, importes, el documento aún no está procesado o el tipo de documento no es compatible.
• Incidencia de configuración: hay que revisar la conexión con Holded o los permisos de la API key.

En los documentos con problema de proveedor, haddock muestra el proveedor y el VAT/NIF/CIF para que puedas copiarlo y crearlo o corregirlo en Holded.

Estados después del envío

En la columna Contabilidad puedes ver:

• No enviado: el documento todavía no se ha enviado.
• Enviando: el envío está en curso.
• Enviado: el documento se ha creado en Holded correctamente.
• Enviado con aviso: el documento se creó en Holded, pero hubo un problema con el adjunto PDF.
• Error: Holded no pudo procesar el documento o falta corregir algún dato.

Cuando el documento tiene una referencia de Holded, en el menú de acciones del documento aparece Ver en Holded.

Si un documento que ya se envió desde Haddock se elimina después directamente en Holded, Haddock puede detectarlo la próxima vez que prepares un envío a Holded. El documento dejará de aparecer como enviado, mostrará un error indicando que ya no existe en Holded y podrás enviarlo de nuevo desde Haddock.

Limitaciones

• Solo se pueden enviar facturas de compra.
• Las facturas rectificativas o importes negativos se envían como abonos de compra.
• El envío es manual: seleccionas documentos o filtros y confirmas el envío.
• El envío masivo por filtros permite hasta 300 documentos.
• haddock no crea proveedores en Holded.
• El match de proveedor depende del VAT/NIF/CIF.
• haddock puede actualizar en Holded documentos enviados si siguen siendo compatibles y el proveedor sigue existiendo con el mismo VAT/NIF/CIF.
• haddock no sobrescribe las notas o mensajes de Holded cuando actualiza un documento. Las notas creadas directamente en Holded se conservan.
• haddock no elimina documentos en Holded.
• Si el documento aparece como enviado con aviso, puede existir en Holded aunque el PDF no se haya adjuntado correctamente.

Diferencia con exportar en formato Holded

Esta integración envía documentos directamente a Holded. Es diferente de la exportación en formato Holded, que descarga un archivo Excel o CSV para subirlo manualmente.

Si prefieres trabajar con archivo, puedes usar la opción de exportación de documentos en formato Holded.

Si algo falla

Revisa primero:

• Que Holded siga conectado en Integraciones ERP.
• Que la API key tenga permisos para subir documentos.
• Que el proveedor exista en Holded con el mismo VAT/NIF/CIF.
• Que el documento sea una factura procesada o manual.
• Que el documento tenga fecha, importes y PDF.

Si necesitas ayuda, envía a soporte:

• Nombre del restaurante.
• Número o enlace del documento en haddock.
• Proveedor y VAT/NIF/CIF.
• Estado que ves en la columna Contabilidad.
• Captura de la comprobación previa o del mensaje de error.

Actualizado el: 09/05/2026