Recorrido de una vertical
De la cuenta de integrador a una aplicación desplegada y sus primeros clientes.
Alcance y estado
Esta guía recoge los diagramas y las aclaraciones de producto facilitados el 14 de septiembre de 2026. «Implementado» identifica el estado comunicado para este material; no certifica la disponibilidad en todos los entornos. Las propuestas se indican expresamente.
Abrir gráfico interactivo y ampliar · Ver imagen a tamaño completo
El texto de la guía desarrolla el gráfico para que puedas seguir el recorrido también sin utilizar el visor.
Este recorrido corresponde a la aplicación que utiliza una persona. No obliga a desarrollar una skill ni a recibir antes una oportunidad del marketplace.
1. Prepara la cuenta y la vertical
En el plano central se gestionan la cuenta del integrador, la marca, los dominios y los planes. El material describe hasta cinco licencias de desarrollo sin cobro. Sigue Prepara tu cuenta y vertical.
2. Registra el cliente OAuth
Registra la identidad de la aplicación, sus redirecciones y los scopes. Para este recorrido mantenemos como entrada el panel del desarrollador; el diagrama utiliza la referencia técnica RFC 7591, que no debe interpretarse como la obligación de realizar además un segundo registro.
Los scopes quedan fijados al registrar el cliente. Según las aclaraciones, ampliar el conjunto exige otro cliente. El fork no recibe los scopes de primera parte: las pantallas deben ocultar o limitar acciones que la aplicación no puede realizar, mostrando una explicación cuando corresponda.
Consulta Registra tu aplicación.
3. Adapta y despliega el frontend
El recorrido mostrado parte de un fork de pimia-web-shadcn conectado a @pimia/sdk. El identificador y el secreto del cliente pertenecen a la configuración del servidor. El navegador utiliza la cookie de sesión, no el secreto OAuth.
El material describe la lectura de marca, colores, soporte y planes desde el núcleo, para que esos cambios de configuración no requieran redesplegar. Las modificaciones de código de la aplicación sí siguen su proceso de despliegue.
Para pantallas y estilos utiliza la pestaña Frontend. Para la conexión continúa con Conecta tu ERP.
4. Incorpora clientes
La app ofrece /registro, presenta los planes y realiza el alta atribuida. El cliente es dueño de su tenant. La creación y la vinculación comercial no sustituyen el consentimiento OAuth para acceder a los datos.
5. Prepara producción antes de cobrar
El gráfico resume este requisito como «Stripe en los dos lados»: método de pago del canal en Pimia y Stripe propio del integrador para el cobro de sus planes. La rama «para cobrar» representa una condición previa, no una configuración que deba hacerse después del cobro.
En desarrollo, el material contempla las instancias de cortesía; en producción, las altas requieren plan y la preparación comercial correspondiente. Sigue Incorpora clientes y pasa a producción.
Resultado: aplicación de la vertical desplegada, cliente incorporado y acceso a sus datos autorizado por separado.