Roles y permisos del comercio

En el portal, que alguien pueda o no hacer algo no depende de una sola cosa. Dependen de tres preguntas independientes, y las tres tienen que decir que sí:

Permiso efectivo = capacidad del comercio + rol del usuario + alcance de la clave (si hay clave)

flowchart LR
  A["¿Tu comercio tiene<br/>esta capacidad?"] -->|sí| B["¿Tu usuario tiene<br/>este permiso?"]
  B -->|sí| C["¿La clave cubre<br/>esta operación?"]
  C -->|sí| OK["Se hace"]
  A -->|no| N1["«Esta función no está<br/>habilitada para tu comercio»"]
  B -->|no| N2["«Necesitas el permiso…;<br/>pídeselo a tu administrador»"]
  C -->|no| N3["La clave no tiene alcance"]

1. La capacidad del comercio

La decide FINORA (o el adquirente) para el comercio entero. Es un interruptor por función:

Capacidad	Qué habilita	¿Mueve dinero?
Desarrollador	Claves de API, secreto de los webhooks, checkout y documentación	No
Cobro sin terminal propio	Cobrar desde el portal, empujar cobros a un equipo, enlaces de pago	Sí
Marketplace	Ver y descargar aplicaciones	No
Equipos	Generar códigos de enrolamiento	No
Devoluciones	Pedir devoluciones y vueltos	Sí
Liquidaciones	Ver liquidaciones y estados de cuenta	No
Monitoreo en vivo	La Torre y sus pantallas de TV	No
Usuarios	Crear usuarios del comercio	No

Hay plantillas de un clic (básica, integrador, cadena) que fijan todas a la vez. Apagar una capacidad bloquea empezar cosas nuevas, nunca terminar las que están en curso: revocar una clave filtrada, aprobar una devolución a medio camino o el autoactualizador de un equipo ya instalado siguen funcionando.

2. El rol del usuario

Lo asigna el administrador de tu comercio a cada persona. Hay roles para cada trabajo, de menos a más:

Rol	Para quién
Solo lectura	Quien solo consulta
Autorizado a instalar	Quien descarga aplicaciones y enrola equipos; no crea claves ni usuarios ni cobra
Soporte	Quien gobierna la flota sin tocar el dinero
Analista	Quien lee ventas, lotes y liquidaciones
Disputas	Quien atiende contracargos
Desarrollador	Quien integra el ERP o la tienda web
Gerente (administrador)	Quien administra el comercio: claves, usuarios, medios, devoluciones, cobros
Propietario	El único que nombra o retira propietarios y administradores

El rol justo

Dale a cada persona el rol más pequeño que le permita hacer su trabajo. Quien instala equipos no necesita cobrar; quien cobra no necesita crear claves.

3. El alcance de la clave

Solo aplica cuando un sistema (tu ERP, tu tienda web) llama a la API con una clave. Cada clave tiene un alcance:

Alcance	Cubre
Integración	Cobros, checkout, webhooks y consultas. Para un ERP, una tienda web o un sistema de facturación
Equipos	Activar y actualizar terminales. No mueve dinero. Solo para instalaciones de TI; para un equipo nuevo se usa el código de enrolamiento
Completo	Todo lo que tu comercio puede hacer en la API. Úsalo solo si de verdad lo necesitas

Cómo lo ves en el portal

• Si tu comercio no tiene la capacidad, la sección no aparece; si entras por el enlace directo, ves «Esta función no está habilitada para tu comercio; pídela a FINORA».
• Si tu usuario no tiene el permiso, la sección aparece atenuada y con candado; al entrar, el portal te dice qué permiso falta, qué rol lo trae y te deja un mensaje listo para copiar a tu administrador. Ver Pedir un permiso que te falta.

Lo que necesitas recordar

• Tres comprobaciones independientes: comercio, usuario y clave.
• El comercio lo decide FINORA; el usuario, tu administrador; la clave, quien la crea.
• Apagar algo nunca deja una operación a medias.