Catálogo — NexoPOS

Crea el catálogo de productos: módulos (versiones/actualizaciones), complementos (funciones de la plataforma) y paquetes (planes que compran los clientes).

Rutas de administrador:

Administrador → Módulos
Administrador → Complementos
Administrador → Paquetes

Módulos (del módulo a la versión)

Un módulo es una extensión de NexoPOS que la plataforma puede instalar en instalaciones autorizadas. Cada módulo tiene una o más versiones (lanzamientos).

Crea un módulo

Administrador → Módulos → Crear.
Establecer nombre, slug, descripción.
Opcional: repositorio predeterminado de GitHub y visibilidad para las versiones.
Estado: disponible / no disponible; permitir actualizaciones cuando no está disponible; controla si las instalaciones existentes aún pueden actualizarse.

Publicar una versión (release)

Abre el módulo → agrega versión:

Source	Fields
GitHub	Repo owner/name, ref/tag (e.g. v1.2.0), visibility; platform token used if private
ZIP	Upload package (size limit enforced server-side, e.g. 50MB)

Marca la versión publicada para que pueda seleccionarse para instalaciones y actualizaciones.

Flujo de trabajo:

Create module
  → Add version (GitHub ref or ZIP)
  → Publish version
  → Attach module to one or more bundles
  → Customer installs/updates from entitled bundle

Marcador de posición de captura de pantalla: página de muestra del módulo con lista de versiones y acción de Publicar

Consejos

Prefiere etiquetas semver como github_ref para la reproducibilidad.
Los repositorios de módulos privados requieren un PAT válido de Admin → GitHub.
El canal principal de NexoPOS (último/fijado) está separado en Configuración → GitHub.

Complementos

Los complementos son derechos de pago opcionales en una instalación (no a nivel de organización). Hoy solo están conectadas dos claves de funciones de la plataforma:

Feature (UI)	feature_key	Unlocks
Custom domain	custom_domain	Domain tab attach/verify when Domain mode is addon
Backups	backups	Backup tab + scheduled platform backups

Crea un complemento

Administrador → Complementos → Crear.
Función: seleccione en el menú desplegable (no texto libre). Elegir la clave incorrecta significa que la interfaz nunca se desbloqueará.
Nombre, descripción, precio (centavos), moneda, intervalo de facturación (mensual / anual / única vez).
Disponibilidad — p. ej., publicada (comprable), oculta, etc.
Guardar.

Interacción en modo de dominio

Admin Domain custom_domain_mode	Customer experience
free	Custom domain without purchasing the add-on
addon	Must purchase Custom domain add-on (or already entitled)
disabled	Domain attach not offered

Interacción de copias de seguridad

Requiere el complemento de copias de seguridad publicadas + una suscripción activa durante la instalación.
El almacenamiento y la programación provienen de Configuración → S3 / Copias de seguridad, no solo del precio del complemento.

Paquetes (planes)

Un paquete es lo que los clientes suscriben por instalación. Incluye:

Precios (prueba / introducción / recurrente)
Límites de recursos (disco, etiqueta/uso de CPU)
Módulos incluidos
Funciones de marketing / insignias
Disponibilidad (publicada, etc.)

Campos de precios explicados

Field	Meaning
Trial days (trial_days)	Free trial length on first checkout of a new install. No paid “full price” invoice is invented while trialing. Renewals never re-grant trial.
Intro / entry price (intro_price_cents)	Preferential first charge amount (in cents) when intro is configured.
Intro period days (intro_period_days)	How long the intro pricing window is intended to last (product metadata used with intro pricing).
Recurring price (recurring_price_cents)	Ongoing price after intro / for renewal line items.
Billing interval	e.g. monthly
Currency	ISO code, e.g. USD

Checkout crea elementos de línea a partir de estas reglas dentro de BillingService (agnóstico del gateway).

Cómo interactúan los ensayos, los inicios y los recurrentes

Piensa en tres palancas:

Solo prueba: el cliente comienza sin pagar el total del cobro recurrente; la suscripción está en período de prueba hasta que finaliza la prueba, y luego se aplica la cobranza normal / período de gracia. Ejemplo (seed Professional): trial_days = 14, intro 0, recurrente $49.
Precio inicial sin prueba: el primer cobro usa los céntimos del precio introductorio; el recurrente es el precio de lista después / en las renovaciones. Ejemplo (semilla Starter): inicial $1 (100 céntimos), recurrente $19, prueba 0.
Ni — el primer cobro utiliza el precio recurrente de inmediato.

Importante:

La prueba es para la verificación de una nueva instalación, no para un asiento gratuito permanente.
Las compras adicionales en la mitad del ciclo de vida son partidas separadas / elementos de pasarela.
Los cupones (si están configurados) se aplican en el pago cuando son válidos.

Ejemplos resueltos

Estilo inicial

	Value
Intro	$1.00 for first period
Recurring	$19.00 / month
Trial	0 days

El cliente paga el importe inicial en el primer pago exitoso (según las reglas del gateway) y, posteriormente, de forma recurrente.

Estilo profesional

	Value
Trial	14 days
Recurring	$49.00 / month
Intro	$0

El cliente puede comenzar sin una factura completa pagada durante la prueba; después de la prueba, se aplican las reglas de cobro y de período de gracia/suspensión.

Adjuntar módulos

En el formulario del paquete, seleccione qué módulos están incluidos. Solo aparecen los módulos a los que tiene derecho para la instalación o actualización en las instalaciones del cliente.

Publicar el paquete

Establecer disponibilidad en publicado y el orden de clasificación / insignia destacada para la página de precios de marketing.

Orden sugerido de configuración del catálogo

Configura la configuración de GitHub.
Crea módulos + publica al menos una versión de cada uno.
Crea complementos (custom_domain, copias de seguridad) si los vendes.
Crea paquetes, adjunta módulos, configura prueba/introducción/recurrente.
Publica paquetes y abre precios como cliente.
Configura el modo de dominio y S3 para que los complementos funcionen realmente de extremo a extremo.