Solución de problemas

Síntoma, causa y solución para los problemas más comunes: generación, vista previa, secciones, dominios, pagos, pedidos, API y traducciones.

Cada tabla va de lo que ves a lo que debes hacer. Si el síntoma no aparece aquí, revisa las Preguntas frecuentes o la guía del área.

Generación y vista previa

Síntoma	Causa	Solución
La generación terminó, pero no se ve la vista previa.	La compilación de la vista previa no estaba disponible cuando terminó la generación; la pantalla tiene un estado propio para esto.	Abre el editor con Abrir editor y revisa la vista previa allí; si sigue sin cargar, pídele al agente que la reconstruya o vuelve a intentarlo en unos minutos. Guía: Generación en vivo.
La generación quedó parcial.	Una parte del sitio se generó y otra no. Es un estado soportado, no un error de tu cuenta.	Abre el editor y completa lo que falte con el agente en modo Construir. Revisa lo generado antes de publicar.
Reintenté y el resultado ignora mis archivos adjuntos.	El reintento reenvía el texto de tu descripción sin los adjuntos originales.	Vuelve a adjuntar los archivos al pedir el cambio.
El editor se niega a cambiar un texto desde la vista previa.	Textos calculados, ambiguos o que vienen de datos del negocio (productos, servicios, personal, galería) no se editan en el código.	Cambia el dato en su módulo del panel (Configuración, Productos, Servicios, Personal o Galería). Ver Editor.
Creé una página y no aparece en el sitio.	La creación escribe primero los archivos de la página y después registra la ruta; si el registro falla, los archivos quedan sin ruta.	Revisa la página en el editor y completa el registro de la ruta, o pídele al agente que lo haga. Ver Páginas y secciones.

Secciones

Síntoma	Causa	Solución
No veo el panel Secciones en el editor.	Secciones requiere dos cosas: estar habilitado para tu negocio (despliegue gradual) y un plan que lo incluya. En producción la lista de negocios habilitados parte vacía.	Revisa tu plan en Plan y facturación. Si ya lo incluye, el acceso aún no está activado para tu negocio. Ver Páginas y secciones.
No puedo copiar una sección.	Copiar secciones requiere dos cosas: estar habilitado para tu negocio (despliegue gradual, aparte del de Secciones) y un plan que incluya el modo código.	Si tu plan incluye Secciones pero no el modo código, esperar el despliegue no activará la copia. Revisa tu plan en Plan y facturación; si ya incluye el modo código, el acceso aún no está activado para tu negocio.

Secciones y la revisión de traducciones se habilitan por despliegue gradual: que no las veas no significa que algo esté roto en tu sitio.

Dominio propio

Síntoma	Causa	Solución
El dominio aparece como verificado pero abre sin HTTPS o con error de certificado.	La verificación de propiedad (registro TXT `_nimlio-challenge`) es un paso distinto del enrutamiento (CNAME) y de la activación del certificado. Pueden terminar en momentos diferentes.	Revisa que el CNAME esté escrito exactamente como lo muestra Nimlio y espera a que el DNS se propague y el certificado se active. Quita registros antiguos del mismo nombre. Ver Dominios y publicación.
Mi dominio raíz (sin `www`) no funciona.	Un dominio raíz no admite CNAME en muchos proveedores.	Usa aplanamiento de CNAME o un registro ALIAS si tu proveedor lo ofrece; si no, conecta un subdominio como `www`.
No puedo conectar un segundo dominio.	Cada sitio admite un solo dominio propio.	Quita el actual para reemplazarlo. Conectar un dominio depende de tu plan.
Mi subdominio de Nimlio es rechazado.	Debe tener de 1 a 63 caracteres en minúsculas, números o guiones, sin guion al inicio ni al final; los nombres reservados o ya usados se rechazan.	Elige otro nombre que cumpla esas reglas.

Pagos y pedidos

Síntoma	Causa	Solución
La pasarela confirma el pago pero el pedido sigue Pendiente.	La confirmación no llegó a Nimlio o llegó a un ambiente distinto (prueba frente a producción), o el pago aún no se aprobó.	En Pagos, revisa el Último evento recibido y que la URL de eventos esté pegada en el panel de la pasarela, en el mismo ambiente que tus llaves. Verifica la transacción en la pasarela antes de despachar. Ver Pagos.
Hice un pedido de ensayo y aparece como Pagado.	Estás con llaves de Pruebas: los cobros son simulados.	No despaches. Cuando todo funcione, usa Reemplazar llaves con las de producción y configura la URL de eventos de producción.
Un pedido online quedó Vencido.	El cliente no pagó a tiempo: la reserva de inventario dura una hora y los pedidos online pendientes viejos se cierran automáticamente.	El cliente puede volver a comprar. Revisa que el inventario se haya liberado en Productos.
El pedido dice «el inventario no alcanzaba cuando se pagó este pedido».	El pago se aprobó cuando ya no quedaban unidades.	Corrige las existencias en Productos y resuelve con el cliente antes de enviar.
El pedido muestra Requiere revisión.	El pago llegó después de que el pedido había fallado y ya no se pudo aplicar el crédito de la tarjeta de regalo o el descuento.	Cobra la diferencia antes de despachar.
Un pedido contra entrega rechazado en el checkout.	El interruptor Contra entrega está apagado.	Enciéndelo en Configuración › Envíos y contra entrega.
No encuentro el botón Exportar CSV.	Tu rol en el equipo no tiene ese permiso.	Pídele acceso al propietario del negocio. Ver Equipo.
No veo la opción de pagos en línea.	Los pagos en línea requieren el plan Pro o superior.	Mejora tu plan en Plan y facturación. Ver Planes y créditos.

Cancelar no devuelve dinero

Cancelar pedido solo actualiza la entrega. Si el cliente ya pagó en línea, haz la devolución desde el panel de tu pasarela.

API y acceso

Síntoma	Causa	Solución
La API devuelve 401.	Falta la llave, es inválida o se enviaron dos encabezados de llave que no coinciden. La API pública solo autentica llaves públicas (`nk_pub_`); las llaves secretas (`nk_sec_`) se rechazan.	Envía una sola llave pública, con `Authorization: Bearer` o `X-Nimlio-Key`.
La API devuelve 403 en una operación concreta.	El código `missing_scope` indica que la llave no incluye el permiso (scope) de esa operación (p. ej. `booking:write`, `orders:write` o `leads:write`); `api_key_suspended` indica que la llave está suspendida; `site_locked`, que el sitio está protegido con contraseña.	Según el código: usa una llave con el scope correcto, reactiva o reemplaza la llave suspendida, o consulta el sitio con acceso permitido. Ver API.
Recibo 429.	Superaste los límites por llave e IP (por minuto) o la cuota diaria.	Espera y reintenta con pausas crecientes; reduce la frecuencia de las llamadas.
Una ruta devuelve 403 con el código `feature_disabled`.	La función existe pero no está habilitada para tu negocio (despliegue gradual).	No es un error de tu integración; la función se habilita por negocio.
Mi cliente MCP no conecta con `GET /mcp`.	El servidor MCP solo acepta `POST` (respuestas JSON); `GET` devuelve 405.	Configura el cliente para usar `POST` con tu permiso `nmcp_`. Ver MCP.

Cuenta e idiomas

Síntoma	Causa	Solución
No veo la opción de verificación en dos pasos.	La verificación en dos pasos se habilita por despliegue gradual y por la versión mínima de las apps; en producción parte apagada.	Revisa Seguridad de tu cuenta más adelante. Ver Seguridad.
Tras restablecer la contraseña me cerró todas las sesiones.	Es intencional: restablecer la contraseña revoca todas las sesiones.	Vuelve a iniciar sesión con la contraseña nueva.
La revisión de traducciones responde 404.	Los endpoints de revisión de traducciones tienen un despliegue aparte de la pantalla Localización.	Usa los idiomas fijos de Localización (español e inglés); la revisión llegará cuando se habilite. Ver Idiomas.
Mi sitio en inglés no responde en `/en`.	El enrutamiento por idioma requiere estar habilitado para tu sitio y una configuración de idiomas compatible.	Revisa Localización. Ver Idiomas.
El sitemap o la imagen para compartir devuelven 404.	Se generan solo para sitios publicados, indexables y sin contraseña.	Publica el sitio, activa la indexación y quita la contraseña si no la necesitas. Ver SEO.