Requisitos de Homologación

El propósito de este documento es hacer que los requisitos de construcción y homologación de diseño sean más transparentes. Estos requisitos se han categorizado según la urgencia y la obligatoriedad.

Categorización de Urgencia

Alta Prioridad

Los elementos marcados con esta etiqueta son temas de importancia primordial que deben recibir atención desde el principio. Si los elementos no cumplen con estos requisitos, la homologación puede ser rechazada.

Prioridad Media

Los elementos marcados con esta etiqueta son temas de prioridad secundaria que deben recibir atención durante el desarrollo. Si los elementos no cumplen con estos requisitos, la homologación puede ser detenida hasta que se aborden.

Baja Prioridad

Los elementos marcados con esta etiqueta son temas de prioridad secundaria que deben recibir atención durante el desarrollo. Si los elementos no cumplen con estos requisitos, la homologación puede ser detenida hasta que se realicen ajustes.

Categorización de Obligatoriedad

Obligatorio

Todos los elementos marcados con esta etiqueta deben ser verificados e implementados, independientemente de la solución presentada.

Recomendado

Todos los elementos marcados con esta etiqueta deben ser verificados y evaluados según la necesidad y el contexto en el que se encuentra la aplicación. Es decir, deben ser implementados si la aplicación presenta un caso de uso o un elemento similar.

Uso del NubeSDK

Alta Prioridad

⏰ Fecha de vigencia: 5 de junio de 2026

A partir del 5 de junio de 2026, la adopción del NubeSDK pasa a ser obligatoria para la aprobación en la homologación. Las apps enviadas después de esa fecha no serán aprobadas sin el uso del SDK.

Para revisores: a partir del plazo, verifiquen como parte del flujo de aprobación si la app fue desarrollada con el NubeSDK. Las apps en modelo legado (uso de document, window, jQuery o manipulación directa del DOM) no deben ser aprobadas.

En este punto, el partner debe garantizar que la aplicación fue desarrollada utilizando el NubeSDK — el modelo recomendado para apps que se ejecutan en el storefront y checkout de Tiendanube.

Descripción	Enlace	Obligatoriedad
App desarrollada con NubeSDK (a partir del 5 de junio de 2026)	Guía de migración	Obligatorio
No utiliza document, window, jQuery ni DOM directo	Guía de migración	Obligatorio

Antes de enviar, confirma que:

• La app está implementada con el NubeSDK y se ejecuta dentro de un Web Worker.
• No hay dependencias de manipulación directa del DOM, document, window ni bibliotecas como jQuery.
• La interfaz se construye con los componentes del NubeSDK y los UI Slots apropiados.

🔍 Verifícalo con el NubeSDK DevTools

Usa el NubeSDK DevTools (extensión de Chrome) para confirmar rápidamente si la app está corriendo con el NubeSDK: la sección Apps lista las aplicaciones construidas con el SDK y permite inspeccionar componentes, eventos y estado en tiempo real.

Para más contexto sobre el plazo, consulta la visión general de la Homologación y la visión general de Aplicaciones .

Uso de Plantillas Nimbus

Alta Prioridad

En este punto, debemos prestar atención al uso de las plantillas Nimbus con el fin de lograr una mayor coherencia visual con los productos de Tiendanube.

Descripción	Enlace	Obligatoriedad
Página de estado vacío e inicial	Ver directrices	Obligatorio
Página de error	Ver directrices	Obligatorio
Página de formularios	Ver directrices	Recomendado
Modal de confirmación	Ver directrices	Recomendado
Página de ajustes	Ver directrices	Recomendado
Página de tabla simple	Ver directrices	Recomendado
Página de tabla de productos	Ver directrices	Recomendado
Límites de personalización de plantillas	Ver directrices	Obligatorio

Uso de Componentes y Patrones

Alta Prioridad

En este punto, debemos prestar atención a la asignación de componentes y patrones según sus respectivas documentaciones.

Descripción	Enlace	Obligatoriedad
Componentes atómicos y compuestos	Ver directrices	Obligatorio
Patrones de composición	Ver directrices	Recomendado
Componentes de formularios	Ver directrices	Recomendado
Límites de personalización y flexibilidad	Ver directrices	Obligatorio

Uso de Conceptos de UX/UI

Prioridad Media

En este punto, debemos prestar atención a los comportamientos y la disposición de los elementos con el fin de lograr una mayor coherencia con los productos de Tiendanube.

Descripción	Enlace	Obligatoriedad
Priorización y organización de acciones y contenidos	Ver directrices	Obligatorio
Señalización de estado y estandarización de elementos	Ver directrices	Recomendado
Mensajes de retroalimentación y confirmaciones	Ver directrices	Recomendado
Procesamiento y carga de información	Ver directrices	Recomendado
Organización de datos en tablas	Ver directrices	Recomendado
Responsividad y alineamiento de elementos	Ver directrices	Obligatorio
Organización y señalización en formularios	Ver directrices	Recomendado

Uso de Conceptos de UX Writing

Baja Prioridad

En este punto, debemos prestar atención a los textos de las interfaces y sus respectivos elementos con el fin de lograr una mejor experiencia y comprensión del usuario.

Descripción	Enlace	Obligatoriedad
Nomenclatura de aplicaciones y pantallas	Ver directrices	Obligatorio
Fundamentos de UX Writing	Ver directrices	Obligatorio
Tono de voz de Tiendanube	Ver directrices	Obligatorio
Patrones de texto	Ver directrices	Obligatorio