Conecta Holded con un token de API

Crea en Holded un token de la API v2 con los permisos adecuados, pégalo en Filmo y configura impuestos, tesorería y avisos.

Administradores de la cuenta. El resto del equipo ve la integración y su estado, pero no puede conectarla, configurarla ni desconectarla.

Los pasos de Holded solo se ejecutan en workflows creados por un administrador. Xero, QuickBooks Online y Holded se están poniendo en marcha. Si en tu cuenta la tarjeta muestra «Próximamente», o su pestaña «Workflows» dice que las automatizaciones llegarán próximamente, todavía no están disponibles para ti.

Holded no usa una ventana de inicio de sesión. En su lugar, creas en Holded un , una clave que deja a Filmo actuar en tu cuenta de Holded, y lo pegas en Filmo. Después funciona como Xero, con menos .

Crea el token en Holded

Abre las credenciales En Holded, ve a Ajustes → Desarrolladores → Credenciales.
Crea un token de la API v2 Las claves antiguas de la API v1 ya no sirven.
Dale los permisos Lectura y escritura en Contactos, Facturas, Presupuestos y Tickets de venta; lectura y escritura en Cobros; lectura en Impuestos, Cuentas bancarias y Ajustes de facturación; y lectura y escritura en Webhooks.
Cópialo Ten el token a mano para el siguiente paso.

Conecta Holded

Abre la página de Holded Ve a «Configuración» → «Integraciones» → «Holded».
Abre el diálogo de conexión «Conecta tu cuenta de Holded» aparece en «Gestionar conexión».
Pega el token Pégalo en «Token de la API v2». También puedes darle un nombre a la cuenta.
Conecta Haz clic en «Conectar Holded». Filmo guarda el token cifrado y no vuelve a mostrarlo.

Ajustes de la conexión con Holded

Panel	Qué hace
Configuración de Holded	La cuenta de tesorería de Holded donde se anotan los cobros y pagos que envía Filmo. «Sincronizar ahora» la lee de Holded.
Mapa de impuestos / Mapa de impuestos de compra	Qué impuesto de Holded lleva cada impuesto de Filmo. Holded trabaja con identificadores de impuesto, no con porcentajes. Haz clic en «Guardar mapa».
Avisos de Holded	El enlace que permite a Holded avisar a Filmo de los cobros nuevos, con su estado.
Cuentas de cobro	Para cada cuenta de tesorería de Holded, la cuenta de tesorería y el método de pago de Filmo con que se registra un cobro de Holded.

Sin un enlace de activo, los disparadores de Holded no se disparan. Su estado te dice qué hacer:

Estado	Qué hacer
Activo	Nada. Holded avisa a Filmo de los cambios.
En conflicto	Otro webhook de Holded escucha los mismos eventos. Elimínalo en Holded y pulsa «Reintentar».
Error	No se pudo registrar. Inténtalo de nuevo en unos minutos.
Sin permiso	El token no puede gestionar webhooks. Usa un token de un usuario de Holded con el rol de desarrollador y vuelve a conectar.
Dirección desactualizada	Holded sigue avisando a una dirección antigua. Haz clic en «Sincronizar».
No disponible	Este entorno no puede recibir avisos de Holded.

En qué se diferencia Holded de Xero

No anula rectificativas.
Si Holded se niega a anular una factura, por ejemplo porque tiene cobros, la ejecución termina sin anular y deja una tarea.
Un no se puede enviar a Holded.
No hay avisos cuando algo se anula o se borra en Holded. La lee 10 documentos por tipo, para ahorrar la cuota mensual de llamadas de Holded.
Es el único programa al que se puede enviar un presupuesto, con el paso «Enviar presupuesto a Holded» en un workflow propio; no hay plantilla.

Desconecta Holded

Desconectar borra la copia del token que guarda Filmo y quita el enlace de avisos, pero Holded no permite revocar un token desde fuera. Elimínalo también en Holded si no quieres que siga siendo válido.

Si ves un error

Mensaje	Qué hacer
«Holded necesita configuración: …» al publicar	Completa el elemento en «Gestionar conexión».
«El desglose fiscal no se puede exportar sin alterar los impuestos»	El documento lleva una retención o un desglose que no cuadra. Anótalo en Holded a mano.
«Holded no admite impuestos de tipo variable…»	El documento no se puede enviar a Holded.
«Holded no permite anular la factura … en su estado actual…»	Revísala en Holded; el workflow deja una tarea.