Manual del Distribuidor

Documentacion oficial RJ CRM

v3.0.33-s271

Manual del Distribuidor - RJ CRM

Version 3.0.33-s271 - Actualizado 09/07/2026

Que es un distribuidor

Un distribuidor es un partner autorizado por RJ Soluciones para vender, instalar y dar soporte del CRM a sus propios clientes. Cada distribuidor tiene:

Acceso al portal

  1. Entra en https://licencias.rjsoluciones.es.
  2. Usa las credenciales proporcionadas por RJ Soluciones (email + password).
  3. El sistema detecta automaticamente tu rol de distribuidor.
El portal utiliza autenticacion JWT con tokens Bearer. Las sesiones persisten en el navegador y se refrescan automaticamente.

Panel del distribuidor

KPIs (Mi cartera)

Cartera (ingresos)

Tabla de clientes

Muestra todos tus clientes con:

Emitir una licencia

  1. Haz clic en + Nueva licencia.
  2. Selecciona el plan como radio-card (s137).
  3. Rellena: slug (identificador unico), nombre empresa, dominio CRM (ej. acme-crm.rjsoluciones.es), max usuarios, dias (defecto 365), addon ERP V3 si aplica, modulos adicionales.
  4. El precio se calcula automaticamente (pricing modular base + addons).
  5. Haz clic en Emitir licencia.
  6. Se muestra el one-liner de instalacion y el token. Copialos y envialos al cliente.

One-liner de instalacion

El comando que el cliente (o tu) ejecuta en su servidor Ubuntu/Debian:

LICENSE_KEY="..." SLUG="acme" DOMINIO="acme-crm.rjsoluciones.es" bash <(curl -fsSL https://get.rjsoluciones.es/crm)

El script se encarga de todo: dependencias, PostgreSQL, Node.js, Cloudflare Tunnel, certificados.

Gestionar licencias

Editar modulos existentes (s135-s136)

Funcionalidad nueva: ya no es necesario revocar y volver a emitir. Desde el portal:

  1. Pulsa Editar en la fila de la licencia.
  2. Modifica los modulos activos (check/uncheck) + max_usuarios.
  3. Guardar.

Hot-reload (s136): el CRM del cliente aplica el cambio automaticamente en menos de 6h (telemetria) o inmediatamente cuando hace cualquier verificacion.

Renovar

Clic en Renovar, indicar dias (defecto 365). Se genera nuevo token y se extiende la licencia.

Revocar

Clic en Revocar e indicar motivo (ej. "Impago"). El CRM del cliente deja de funcionar.

Restaurar

Si fue revocada por error, clic en Restaurar para reactivar.

Regenerar PINs portal del cliente (s135-s136)

Desde el panel del cliente puedes:

Tickets de soporte

El distribuidor puede crear tickets de soporte para contactar con RJ Soluciones (por ejemplo, incidencias de instalacion, problemas tecnicos, escalados de clientes).

Crear un ticket

  1. Accede a la seccion Tickets en la navegacion principal.
  2. Haz clic en + Nuevo ticket.
  3. Rellena:
    • Cliente (slug de la licencia, opcional): si es sobre un cliente concreto, especifica su slug.
    • Asunto: titulo breve del incidente.
    • Descripcion: detalles del problema.
    • Prioridad: urgente, alta, normal o baja.
  4. Haz clic en Crear ticket.
  5. RJ Soluciones recibira una notificacion por email automaticamente.

Gestionar tickets

Firmas digitales de contratos (DocuSeal)

Tanto el distribuidor como el cliente final pueden firmar digitalmente sus contratos de distribucion/licencia usando DocuSeal Plus integrado.

Enviar contrato a firma

  1. En el panel de Mis clientes (o en el panel de distribuidores si eres admin), encuentra la licencia.
  2. Haz clic en el boton Enviar a firma (ojo de llave).
  3. Se abrira un dialogo pidiendo el email del firmante (opcional; usa el del registro por defecto).
  4. DocuSeal envia un email con el enlace de firma.
  5. El firmante completa la firma en el navegador.

Estados de firma

Reenviar y cancelar

11 modulos canonicos (normalizacion automatica)

El sistema soporta estos 11 módulos canonicos desde la migración 069. Los alias legacy se normalizan automáticamente:

Si ves licencias con alias legacy en BD, el sistema las interpreta correctamente. Al regenerar el JWT (editar licencia), se usan automáticamente los IDs canonicos.

Tabla de módulos:

Modulo canonicoAlias legacyDescripcion
nucleocrmCore CRM (clientes, tareas, agenda, dashboard) - siempre activo
soporte—Tickets, SLA, partes SAT, motor automatizaciones
facturacion—Facturas, presupuestos, productos, recurrente
contratos—Contratos + rentabilidad
presupuestos—Plantillas presupuesto
firmas—DocuSeal Plus integrado (firmas digitales)
ia—IA adapter (Ollama/OpenAI/Anthropic/Gemini) + RAG + Bandeja
whatsapp—WhatsApp Business + Email entrante (Inbox multicanal)
rrhhjornadaFichaje GPS + vacaciones + Portal Empleado
portal_clienteportalPortal soporte clientes (PIN bcrypt)
erp_v3—Integracion ERP V3 (addon +15 EUR)

Planes y precios

Nota importante: Los planes y precios se pueden personalizar por distribuidor y tenant. Cada plan tiene: nombre, precio PVD, período (mensual/anual), IVA (defecto 21%), max. usuarios, descripción y módulos incluidos. Los siguientes son los valores canonicos por defecto — verifica en tu instancia que sean los mismos.
PlanPrecio/mes (PVD)Modulos incluidos
Starter29 EURnucleo
Profesional49 EUR+ soporte, facturacion, contratos, presupuestos, portal_cliente
Business79 EUR+ ia, whatsapp, rrhh, firmas
Enterprise129 EURTodo + SLA prioritario
Addon ERP V3+15 EURerp_v3 (sobre cualquier plan)

Precios sin IVA, sin permanencia. PVD = Precio de Venta a Distribuidor.

Precios individuales de modulos (s261)

Si prefieres comuponer licencias modulo a modulo sin usar planes predefinidos:

Dashboard admin

Si eres administrador del portal, el panel te muestra:

Resumen ejecutivo

Revenue global (solo admin)

Margen y comisiones

El distribuidor obtiene una ganancia sobre cada cliente igual al margen configurado (por defecto 25%).

Nota: El margen del distribuidor puede personalizarse por tenant. Verifica tu margen actual en el dashboard.

Despliegue y actualizaciones

Instalacion inicial

  1. El servidor del cliente necesita Ubuntu 22+ o Debian 12+ con acceso root.
  2. Emite la licencia desde el portal.
  3. Ejecuta el one-liner (tu o el cliente).
  4. Tras la instalacion, el cliente accede a su CRM y completa el Wizard de Setup (/setup) con datos empresa, conectores, etc.

Actualizaciones (update.sh v6, s135)

Para actualizar un cliente a la ultima version:

crm-actualizar <slug>

O para todos los clientes:

crm-actualizar --all

El update.sh v6 (s135) hace:

Otros comandos VPS utiles

ComandoDescripcion
crm-estadoVer estado de todas las instancias
crm-instalarInstalar nueva instancia
crm-actualizar <slug>Actualizar cliente
crm-actualizar --allActualizar todos
crm-desinstalar <slug>Eliminar instancia

Mi perfil (distribuidor)

Como distribuidor, puedes cambiar ajustes personales desde el boton Mi perfil en la barra superior.

Cambiar contraseña

  1. Haz clic en Mi perfil.
  2. Ve a Ajustes > Password.
  3. Introduce tu contraseña actual y la nueva (min. 8 caracteres).
  4. Guardar.

Configuracion SMTP personalizado (opcional)

De forma opcional, puedes usar tu propia configuracion SMTP (servidor de correo) en lugar de la del portal central RJ. Esto es útil si quieres que los correos de notificacion de tickets provengan de tu dominio.

  1. Haz clic en Mi perfil.
  2. Ve a Ajustes > SMTP.
  3. Rellena los datos del servidor SMTP (host, puerto, usuario, password, from).
  4. Guarda. Los proximos correos de notificacion de tickets usaran tu SMTP.
Si no configuras SMTP personalizado, los correos se envian desde la configuracion SMTP central del portal.

Actualizar datos fiscales

Desde Mi perfil tambien puedes actualizar o añadir tus datos fiscales (razón social, CIF, dirección, teléfono, web). Estos se usan para referencia administrativa.

Administracion (solo admin)

Gestionar distribuidores

  1. Ve a Distribuidores (admin).
  2. Puedes crear, editar o desactivar distribuidores.
  3. Cada distribuidor tiene:
    • Nombre, email, contraseña (opcional al editar).
    • Margen personalizable (% ganancia sobre PVP).
    • Datos fiscales (CIF, razón social, dirección, web, teléfono, registro mercantil).
    • Opción de crear su licencia propia (instancia interna).
  4. Cuando desactivas un distribuidor, sigue visible pero marcado como inactivo. Sus licencias no se afectan.

Gestionar planes

  1. Ve a Planes (admin).
  2. Crea nuevos planes o edita los existentes:
    • Nombre, descripción, precio PVD.
    • Período: mensual (defecto) o anual.
    • IVA (defecto 21%).
    • Max. usuarios permitidos.
    • Módulos incluidos (checklist).
  3. Puedes desactivar planes sin eliminarlos. Los clientes existentes no se ven afectados, pero no podras asignar licencias con ese plan.

Actualizar el portal (admin)

  1. Ve a Ajustes > Avanzado.
  2. Haz clic en Actualizar portal.
  3. El sistema iniciara una actualizacion en background. El portal puede reiniciarse brevemente.
  4. Se abrira un monitor en vivo con el log de la actualizacion.

Cambiar password y SMTP (admin)

Datos fiscales del admin

Ve a Ajustes y rellena tus datos fiscales (nombre legal, CIF, dirección, teléfono, web, registro mercantil). Se guardan para referencia administrativo.

Wizard de configuracion inicial (distribuidor)

Cuando un distribuidor accede por primera vez al portal, se muestra un wizard automático de 4 pasos para configurar:

  1. Cambiar contraseña (min. 8 caracteres): actualiza tu password provisional.
  2. SMTP personalizado (opcional): configura tu servidor de correo (host, puerto, usuario, password, "from"). Si lo omites, se usa el SMTP central de RJ.
  3. Datos fiscales (opcional): razón social, CIF/NIF, dirección, teléfono, web.
  4. Finalizar: se guarda todo y el wizard se cierra.

Puedes saltar cualquier paso y completarlo después desde Mi perfil (botón en la barra superior). El wizard solo aparece en el primer acceso.

Configuracion post-instalacion para tu cliente (CRM)

Despues de instalar el CRM en el servidor del cliente, guiale para completar el setup:

  1. Wizard /setup: completar resumen con todos los datos.
  2. Datos de empresa: Configuracion > Empresa (nombre, CIF, logo cabecera, datos bancarios SEPA).
  3. Conectores de email: Configuracion > Conectores > Google o SMTP/IMAP.
  4. Email entrante a tickets: si el cliente quiere que los emails generen tickets/conversaciones automaticamente, configurar Gmail API (Label ID) o IMAP (host/usuario/password) en Conectores. Aparecen en el Inbox multicanal.
  5. WhatsApp: si el cliente tiene WhatsApp Business API, configurar OAuth (1 clic) o token manual.
  6. IA: si el plan incluye IA, configurar proveedor en Admin > IA (Ollama local para coste cero, o OpenAI/Anthropic/Gemini).
  7. Portal de clientes: el cliente puede generar PINs individuales o masivos para sus clientes finales. PIN bcrypt, email automatico.
  8. 2FA TOTP (recomendado para admins): Admin > Seguridad > Activar 2FA.
  9. DocuSeal (si plan incluye firmas): configurar plantillas en DocuSeal Plus y vincularlas a Contratos/Presupuestos/SEPA.
  10. Tema visual: elegir tema en la barra superior (default, brutal-dark, brutal-light, linear-dark, stripe, revolut-dark, kraken).

Que puede hacer tu cliente final con cada plan

A continuacion, las capacidades de cada plan que tu cliente final (quien instala el CRM en su servidor) podra usar:

Starter (29 EUR)

Gestion basica de clientes, tareas, notas, agenda, dashboard personalizable @dnd-kit, buscador global Cmd+K, scoring inteligente.

Profesional (49 EUR)

Todo lo anterior mas:

Business (79 EUR)

Todo lo anterior mas:

Enterprise (129 EUR)

Todo lo anterior con SLA prioritario de RJ Soluciones.

Addon ERP V3 (+10 EUR)

Conexion con la base de datos del ERP V3 (PostgreSQL):

Telemetria y monitoring (s135-s136)

Cada CRM instalado reporta telemetría al portal de licencias:

Visible en tu panel de clientes en tiempo cuasi-real.

Hot-reload (sin reinicio)

Cuando editas los modulos de una licencia desde el portal, el CRM del cliente lo aplica automaticamente en menos de 6h (en la siguiente telemetría) o inmediatamente cuando hace una verificacion manual. No requiere reinicio del servidor.

Caracteristicas tecnicas avanzadas (pendiente de confirmar)

OAuth bounce central (spec-046/047)

El portal actúa como punto central de rebote para autenticaciones OAuth (Google, WhatsApp). Cuando un CRM cliente inicia OAuth:

  1. Redirige a licencias.rjsoluciones.es/cb/google (o /cb/whatsapp).
  2. El portal valida la firma HMAC del state, verifica el tenant origin.
  3. Redirige al CRM del cliente con code + state sin modificar (RFC 6234 compliance).
  4. Anti open-redirect: valida estrictamente que tenant_origin sea un hostname dentro del sufijo permitido.

Esto simplifica la gestión de credenciales OAuth en distribuidores: una sola pareja client_id/client_secret centralizada en el portal, sin duplicarla en cada tenant.

Webhook proxy DocuSeal

El portal recibe webhooks de DocuSeal (POST /api/webhook-firmas) y los reenvía automáticamente al CRM destino según el slug en la metadata del documento. Esto desacopla DocuSeal (centralizado) de los CRMs clientes.

Telemetria publica (GET /api/check)

Cada CRM instalado puede reportar telemetría sin autenticación a licencias.rjsoluciones.es/api/check?sub=SLUG&version=X&uptime=Y. El portal actualiza version_instalada y estado en tiempo cuasi-real (cada 6h por defecto). No requiere token.

Soporte

Para incidencias con el portal o instalaciones: