Soporte y diagnóstico rápido
Esta guía reúne los canales de atención al cliente de Frihet, qué datos incluir para resolver cualquier incidencia en el primer contacto y el árbol de diagnóstico rápido para los casos más habituales (tanto desde la interfaz web como mediante agentes MCP o la API REST).
Estado del sistema
Disponibilidad en tiempo real de la aplicación, API v1, webhooks y pasarelas fiscales.
Abrir ticket contextual
Formulario directo con prioridad según tu plan y contexto de tu consulta.
Feedback dentro de la app
Reporta errores o propón mejoras desde la pantalla exacta donde trabajas.
1. Canales de soporte
Puedes escribirnos desde el formulario contextual o por correo electrónico (ver la sección 6). La prioridad de atención depende de tu plan.
Qué incluir para una resolución en el primer contacto
Para evitar idas y vueltas —y proteger tu privacidad—, incluye únicamente identificadores de referencia (nunca contraseñas, claves API completas ni archivos .p12/.pfx de certificado digital):
- Correo de tu cuenta o nombre del espacio de trabajo.
- Identificador del documento afectado: número de serie de la factura (ej.
F-2026-0142), ID del gasto o fecha del movimiento bancario. - Código de estado o mensaje literal: si se trata de un rechazo de la AEAT/Hacienda Foral o un error de la API REST (
400,401,403,422,429), pega el mensaje exacto devuelto.
2. Diagnóstico rápido: Cumplimiento fiscal (VeriFactu, TicketBAI y Facturae)
| Síntoma o aviso | Causa habitual | Solución paso a paso (UI y Agente MCP) |
|---|---|---|
| No me deja editar ni borrar una factura emitida | Por normativa antifraude (inmutabilidad fiscal), una factura emitida y encadenada no puede alterarse ni eliminarse. | Emite una factura rectificativa (abono) desde el menú de acciones de la factura (Crear rectificativa, por sustitución S o por diferencias I), o usa la herramienta MCP create_credit_note. |
| Rechazo AEAT por NIF/CIF del destinatario no identificado | El NIF del cliente contiene espacios, guiones o no coincide exactamente con la razón social registrada en el censo de la AEAT. | 1. Corrige el NIF y el nombre fiscal en la ficha del cliente (Gestión de clientes). 2. Si es un operador intracomunitario, verifica el NIF-IVA con frihet_tax_id_vies_lookup.3. Reenvía el registro desde el estado VeriFactu ( verifactu_resubmit). |
| Error de certificado digital al firmar o presentar | El archivo .p12 / .pfx ha caducado, la contraseña introducida es incorrecta o el certificado ha sido revocado por la FNMT/autoridad emisora. | Ve a Ajustes → VeriFactu y cumplimiento fiscal, sube el certificado .p12/.pfx vigente e introduce su contraseña. Consulta el estado en tiempo real con verifactu_status o ticketbai_status. |
| Factura electrónica Facturae / XRechnung rechazada por el receptor | Falta el código de unidades DIR3 (en licitaciones públicas FACe) o el Leitweg-ID (en administraciones alemanas). | Completa los códigos administrativos en la ficha del cliente antes del envío. Más detalle en Facturae B2G. |
3. Diagnóstico rápido: Facturación, cobros y envío de emails
| Síntoma o aviso | Causa habitual | Solución paso a paso |
|---|---|---|
| El cliente indica que no ha recibido el email de la factura | Dirección con errata, filtro corporativo estricto o rebote registrado en la actividad. | 1. Revisa el historial de actividad dentro del detalle de la factura para comprobar si figura como Entregado o Rebotado. 2. Verifica el email en la ficha del cliente y pulsa Reenviar. |
| El botón "Pagar online" no aparece en la factura o portal | La pasarela de cobro no está conectada o la factura ya figura como paid. | Conecta Stripe Connect o GoCardless en Ajustes → Integraciones y activa los enlaces de pago en Enlaces de pago. |
| Desajuste de céntimos entre base imponible y total con IVA/IRPF | Redondeo por línea frente a redondeo sobre base agregada al importar desde otro software. | Revisa la configuración de decimales e impuestos en Precios e impuestos. |
4. Diagnóstico rápido: Bancos y conciliación
| Síntoma o aviso | Causa habitual | Solución paso a paso |
|---|---|---|
| Un cobro importado del extracto bancario no se empareja solo con su factura | El ingreso llegó al banco con la comisión de la pasarela descontada o sin el número de factura en el concepto. | Entra en Finanzas → Bancos, filtra las transacciones sin emparejar, pulsa Revisar y confirma la sugerencia con Aplicar, o usa Vincular factura para hacerlo manualmente. Ver Conciliación bancaria automática. |
| Al importar un extracto (OFX, QFX, MT940, CAMT.053 o CSV) no aparecen movimientos nuevos | Los movimientos de ese rango de fechas ya habían sido importados previamente (el detector anti-duplicados los ignora de forma segura). | Comprueba el rango de fechas exportado desde tu entidad financiera. Más detalles en Conexiones bancarias. |
5. Diagnóstico rápido: API REST, Webhooks y Servidor MCP
| Código / Síntoma | Causa raíz | Solución |
|---|---|---|
401 Unauthorized en llamadas a https://api.frihet.io/v1 | Cabecera X-API-Key ausente, clave revocada o espacios en blanco al copiar la clave. | Genera o verifica tu clave activa (fri_live_...) en Ajustes → API Keys (Claves API) y envíala en el header X-API-Key. |
429 Too Many Requests | Se ha superado la ventana de rate limit por minuto de tu clave API. | Respeta la cabecera Retry-After y utiliza operaciones por lotes o paginación (limit / cursor). Ver API REST. |
| Mi endpoint no recibe eventos de Webhook | URL no accesible por HTTPS público, certificado TLS inválido o respuesta con código distinto de 2xx tras más de 10 segundos. | Usa el botón Enviar prueba en Ajustes → Webhooks o ejecuta la herramienta MCP test_webhook para inspeccionar el código HTTP devuelto por tu servidor. |
| Mi agente (Claude Code / Cursor / ChatGPT) no ve las nuevas herramientas MCP | Versión antigua en caché de npx o variable FRIHET_API_KEY no definida en el archivo de configuración del cliente MCP. | Asegúrate de usar la última versión publicada de @frihet/mcp-server (1.17.0) o el endpoint remoto https://mcp.frihet.io/mcp. Guía completa en Conectar tu agente. |
6. Contacto directo
Si tras revisar esta guía necesitas asistencia personalizada:
- Desde dentro de Frihet ERP: abre el menú lateral → Feedback.
- Formulario web con contexto: www.frihet.io/es/contact
- Correo electrónico de soporte: ayuda@frihet.io