--- title: "Soporte y diagnóstico rápido" description: "Centro de soporte y guía de resolución de incidencias frecuentes en VeriFactu, facturación, bancos, API y MCP." canonical_url: "https://docs.frihet.io/primeros-pasos/soporte-diagnostico" language: "es" --- # 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**](https://status.frihet.io): Disponibilidad en tiempo real de la aplicación, API v1, webhooks y pasarelas fiscales. - [**Abrir ticket contextual**](https://www.frihet.io/es/contact?topic=support&from=docs:soporte-diagnostico): Formulario directo con prioridad según tu plan y contexto de tu consulta. - [**Feedback dentro de la app**](/configuracion/widget-feedback): Reporta errores o propón mejoras desde la pantalla exacta donde trabajas. --- ## 1. Canales de soporte Puedes escribirnos desde el [formulario contextual](https://www.frihet.io/es/contact?topic=support) 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): 1. **Correo de tu cuenta** o nombre del espacio de trabajo. 2. **Identificador del documento afectado**: número de serie de la factura (ej. `F-2026-0142`), ID del gasto o fecha del movimiento bancario. 3. **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](/cumplimiento/inmutabilidad)), 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](/clientes/gestion-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](/cumplimiento/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](/integraciones/stripe-connect) o [GoCardless](/integraciones/gocardless) en **Ajustes → Integraciones** y activa los enlaces de pago en [Enlaces de pago](/facturacion/enlace-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](/productos/precios-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](/finanzas/conciliacion-bancaria-automatica). | | **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](/finanzas/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](/configuracion/api-keys)) 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](/desarrolladores/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](/agentes/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](https://www.frihet.io/es/contact?topic=support&from=docs:soporte-diagnostico) - **Correo electrónico de soporte**: [ayuda@frihet.io](mailto:ayuda@frihet.io)