Conexiones
Ruta: /ajustes/conexiones
Quién la usa: dueño (y cualquier rol con settings.manage; el gerente de la simulación también la ve)
Permiso requerido: settings.manage
Capturas: docs/manual/screenshots/conexiones/
Qué es
Conexiones es el catálogo de integraciones del restaurante. Muestra una ficha por proveedor, agrupada por tipo — Pagos (Tilopay, Yappy Comercial), Facturación electrónica (eFactura PAC) y un tercer grupo con las plataformas de marketplace (PedidosYa, Uber Eats, ASAP) — y en cada ficha el estado de la conexión y el formulario donde usted escribe sus propias credenciales. La bajada de la pantalla lo dice así: «Tus credenciales, tus cuentas: el dinero y las facturas van directo a tus proveedores — nunca pasan por Nura. Las claves se guardan cifradas y no vuelven a mostrarse.» El pie agrega que los proveedores nuevos aparecen solos: «Próximamente más pasarelas de pago y proveedores de facturación — aparecerán aquí automáticamente.»
Cuándo se usa
En la instalación, cuando contrata una pasarela o un PAC, y cada vez que rotan las claves de un proveedor. No se abre en la operación diaria.
Paso a paso
- Abra Ajustes y, en la barra de secciones, presione Conexiones.
- Ubique la ficha del proveedor. La etiqueta de la derecha dice cómo está: en
frankies-simlas seis fichas dicen Sin configurar. - Presione Conectar (dice Editar conexión si ya hay credenciales
guardadas). La ficha se abre con los campos que ese proveedor pide —
Tilopay: Usuario API, Contraseña API y API Key, los tres
ocultos.
- Elija el Ambiente (Pruebas (UAT) o Producción) y deje marcada la casilla Activo si la conexión debe usarse.
- Presione Guardar. La ficha responde «Conexión guardada.» y borra las claves del formulario. Cerrar sale sin guardar — así se recorrió en la simulación.
- Yappy Comercial, PedidosYa, Uber Eats y ASAP no tienen formulario aquí: su ficha ofrece Configurar en su asistente →, que lleva a Pagos en línea (Yappy) o a Canales externos (las tres plataformas).
Campos y botones
| Campo/Botón | Qué hace | Notas |
|---|---|---|
| Etiqueta de estado | Dice Sin configurar, Configurado — inactivo o Conectado (…) | En frankies-sim las seis fichas dicen «Sin configurar» |
| Conectar / Editar conexión | Abre el formulario de esa ficha | El texto cambia según si ya hay credenciales |
| Usuario API · Contraseña API · API Key (Tilopay) | Las tres credenciales de Tilopay | Campos ocultos; al guardar se borran de la pantalla y no se vuelven a mostrar |
| API Key del PAC (eFactura) | Clave del proveedor de facturación electrónica | Campo oculto |
| Punto de facturación (eFactura) | Punto de facturación que va en el documento | Campo visible, con marca de agua 001 |
| Ambiente | Pruebas (UAT) / Producción | Arranca en Pruebas (UAT) |
| Activo | Deja la conexión en uso o la apaga sin borrar las claves | Marcada por defecto |
| Guardar | Graba la conexión | Responde «Conexión guardada.»; si no escribe claves nuevas, conserva las guardadas |
| Cerrar | Cierra el formulario sin guardar | — |
| Configurar en su asistente → | Lleva al asistente propio del proveedor | Yappy → /ajustes/pagos; PedidosYa, Uber Eats y ASAP → /ajustes/canales |
Dos cosas que esta pantalla no hace. El encabezado del tercer grupo sale sin traducir: dice «marketplace» en vez de un nombre en español. Y la ficha de Tilopay dice Sin configurar aunque Pagos en línea muestre «Tilopay activo (UAT)»: la etiqueta solo refleja las credenciales cargadas desde esta pantalla.
Quien no tiene settings.manage no ve la sección: el cajero de la simulación
no tiene «Ajustes» en el menú lateral y, al escribir la ruta, la pantalla
responde «Sin permiso para conexiones.» con la barra de secciones vacía.
Mensajes y errores
"Sin permiso para conexiones." — lo que ve quien abre la ruta sin
settings.manage.
"Conexión guardada." — confirmación tras Guardar.
"No tienes permiso para esta acción."
NG_FORBIDDEN
"Plataforma desconocida"
NG_PROVIDER_UNKNOWN
"Algo salió mal. Intenta de nuevo."
NG_UNKNOWN— es lo que muestra la ficha cuando el servidor rechaza el guardado por ambiente inválido (NG_ENV_INVALID) o por dejar vacía una clave obligatoria (NG_FIELD_REQUIRED): esos dos códigos todavía no tienen texto propio en español.
Relacionado
- Pagos en línea — el asistente de Yappy y el estado de Tilopay
- Canales externos — contratos de comisión de las plataformas
- Dominio propio
- Facturación — la suscripción a Nura, que se cobra por Tilopay