Configuración

Desde Configuración defines cómo opera tu negocio en Zelta POS: tus sucursales y bodegas, los usuarios y sus roles y permisos, tu suscripción y las integraciones (API keys y webhooks) para conectar tu e-commerce u otros sistemas con el API público.

Esta sección suele administrarla el rol de administrador. Para acceder, ingresa al panel en https://pos.zelta.dev y ve a Configuración.

El panel de Administración agrupa sucursales, bodegas, cajas, usuarios, fiscal e integraciones.

Sucursales y bodegas

Zelta POS es multi-sucursal y multi-bodega. Una sucursal es un punto de venta (una tienda) y una bodega es el lugar donde se controla el stock. Una sucursal puede tener una o varias bodegas.

1. Ve a Configuración > Sucursales.
2. Haz clic en Nueva sucursal e ingresa su nombre y datos.
3. Configura su información fiscal para la facturación electrónica (ver ).
4. Crea al menos una bodega asociada a la sucursal.

Usuarios y roles

Da de alta a las personas de tu equipo y define qué puede hacer cada una mediante roles y permisos.

Rol	Qué puede hacer
Administrador	Configura todo: sucursales, usuarios, productos, facturación e integraciones
Cajero / Vendedor	Vende, maneja la caja y atiende clientes, con acceso limitado a la configuración

1. Ve a Configuración > Usuarios.
2. Haz clic en Invitar usuario e ingresa su correo.
3. Asígnale un rol y las sucursales a las que tendrá acceso.
4. Envía la invitación.

Usuarios: administra las cuentas del equipo y su rol (Propietario, Administrador, Cajero…).

Asigna el rol mínimo necesario

Otorga a cada usuario solo los permisos que necesita para su trabajo. Esto protege la información sensible y reduce errores en la operación.

Suscripción y plan

En la sección de Suscripción consultas el plan contratado, las capacidades incluidas y el estado de tu cuenta. Desde aquí gestionas tu plan según el crecimiento de tu negocio.

Suscripción: plan actual, uso de sucursales y usuarios, e historial de pagos.

API keys e integraciones

Si quieres conectar Zelta POS con tu tienda en línea u otros sistemas, este es el lugar donde habilitas el API público.

Generar una API key

1. Ve a Configuración > API y Webhooks > pestaña Claves API.
2. Haz clic en Nueva API key, asígnale un nombre y (opcional) una sucursal por defecto.
3. Copia la clave (empieza con zpk_); se muestra una sola vez, así que guárdala en un lugar seguro.

Sección API y Webhooks: gestiona tus claves de la API pública, webhooks y métodos de pago.

Asígnale un nombre y, opcional, una sucursal por defecto.

El secreto zpk_… se muestra una sola vez: cópialo y guárdalo.

Usa esta clave para autenticar tus llamadas al API público. Consulta para conocer cómo enviarla en tus solicitudes.

Cuida tus API keys

Una API key da acceso a tu negocio a través del API. No la compartas ni la publiques en código visible. Si crees que una clave se vio comprometida, revócala y genera una nueva.

Webhooks

Los webhooks notifican a tu sistema cuando ocurren eventos en Zelta POS (por ejemplo, una venta nueva), enviando la información a una URL que tú indiques. Configúralos en Integraciones > Webhooks y consulta el detalle en .

Siguientes pasos

• — Configura los datos fiscales de cada sucursal.
• — Usa tus API keys zpk_… para integrar.
• — Recibe notificaciones de eventos en tiempo real.