Saltar al contenido principal

Directrices de Publicación

Este documento tiene como objetivo proporcionar una guía completa y detallada para socios que deseen desarrollar y publicar aplicaciones en la tienda de aplicaciones de Tienda Negocio. Establece las directrices y los requisitos esenciales que deben seguirse durante la fase de homologación, asegurando que las aplicaciones sean seguras, confiables y ofrezcan una experiencia de alta calidad para los merchants y los consumers.

1. Requisitos Generales para Todas las Aplicaciones​

Las directrices en esta sección se aplican a todas las apps publicadas en la tienda de aplicaciones de Tienda Negocio. Dependiendo de la configuración de la app, también podrá necesitar cumplir con los requisitos específicos detallados en las secciones siguientes.

Configuraciones de Apps Prohibidas y Restringidas

Algunos tipos de apps no están permitidos en la tienda de aplicaciones de Tienda Negocio y otros deben tener su visibilidad limitada.

Tipos de Apps Prohibidas:

  • Apps que no utilizan las APIs de Tienda Negocio: Las apps que no utilizan las APIs públicas de Tienda Negocio no están permitidas. Los comerciantes no deben ser obligados a configurar apps personalizadas como parte de la funcionalidad de la app.
  • Apps que falsean datos: Las apps no deben violar los Términos y Condiciones Generales del Programa de Socios de Tienda Negocio. Su app debe usar solo información verdadera en pop-ups y notificaciones.
  • Apps que procesan pagos fuera del checkout de Tienda Negocio: Tienda Negocio no puede garantizar la seguridad de un pedido procesado por un checkout externo. Las apps que ignoran el checkout o el procesamiento de pagos están prohibidas.
  • Múltiples apps con funcionalidades duplicadas: Una app no puede ser idéntica a otra app que usted ya ha publicado.
  • Apps que principalmente comparten datos de comerciantes: Las apps que comparten datos de comerciantes con terceros necesitan consentimiento previo por escrito de Tienda Negocio y deben cumplir con los Términos de la API. Es importante que sigan la directriz de privacidad.

2. Instalación y Configuración​

Estos requisitos garantizan que los comerciantes puedan configurar y comenzar a usar su app rápidamente.

Permisos​

Los permisos son los niveles de acceso que su app tiene a los datos de una tienda a través de la API.

  • Su app solo tendrá acceso a los permisos que son estrictamente necesarios para su funcionalidad.

Configuración y flujos de comerciantes​

  • Las apps deben ser instaladas e iniciadas solo en los servicios de Tienda Negocio. Su app no debe solicitar la entrada manual de una URL de la tienda durante la instalación.
  • Para la seguridad del comerciante, su app no debe usar ventanas pop-up para funcionalidades esenciales, como la ejecución de OAuth.

Directrices posinstalación​

El rendimiento posinstalación es crucial dado que la tienda de aplicaciones atrae a nuevos tenderos que aún no tienen una alianza comercial, la aplicación debe ofrecer una claridad total en los primeros pasos.

El redireccionamiento tras la instalación debe ser fluido, eliminando barreras para los usuarios que están descubriendo la solución por primera vez.

Con esto, compartimos abajo dos sugerencias a seguir para esta usabilidad:

  • Automatizar la autenticación (recomendado)

En el modelo de integración de Tienda Negocio, después de que el comerciante hace clic en “aceptar” en la pantalla de permisos, el sistema genera un authorization code y lo redirige a la URL de callback definida.

El flujo ideal es que este código no se muestre al comerciante, sino que sea consumido automáticamente por el backend de la aplicación.

Pasos técnicos resumidos:

  • El comerciante es redirigido a la URL de callback configurada, la cual debe capturar el parámetro code.
  • El backend realiza una petición POST al endpoint de autenticación de Tienda Negocio, enviando los datos necesarios (client_id, client_secret, grant_type=authorization_code y el code recibido).
  • En respuesta, el sistema devuelve un access_token.
  • El backend guarda el access_token asociado a la tienda que instaló la aplicación, permitiendo realizar llamadas a la API en nombre de dicha tienda.
  • En lugar de mostrar el code o mensajes de error, el comerciante ya debe visualizar la pantalla de registro/inicio de sesión de la aplicación, concluyendo el proceso de forma natural y transparente.

Este flujo elimina dudas y pasos manuales, haciendo que la experiencia sea más sencilla y segura para el comerciante.

  • Landing page explicativa (sugerido)

En caso de que prefieran mantener la etapa de contacto directo con ustedes, es fundamental que el redireccionamiento se dirija a una pantalla que presente una landing page clara y objetiva, que contenga:

  • El paso a paso completo de lo que el comerciante debe hacer, como el flujo de registro o la generación de credenciales para su uso;
  • Las instrucciones hasta la finalización de la integración de la aplicación con la tienda.

Recomendamos la lectura de nuestra guía sobre Landing Pages y su importancia.

3. Funcionalidad y Calidad​

Para que su app tenga éxito, debe ofrecer una experiencia consistente y positiva.

Interfaz de Usuario​

  • Su app debe ser totalmente funcional a través de una UI, sin mostrar errores como 404, 500 o 300.
  • En caso de desarrollo de una solución incrustada (embedded), su app debe seguir las guías de diseño de Tienda Negocio (aún apuntando a la fuente original), como la biblioteca de componentes y la guía de estilo, para una experiencia cohesionada dentro del panel del comerciante.

Estado de la App​

  • Su app debe ser completa y testeable. No debe haber bugs en la interfaz, problemas de visualización o páginas de error que impidan que el equipo de revisión pruebe la app.
  • Si su app sincroniza datos entre Tienda Negocio y una plataforma externa, debe garantizar que todos los datos sean consistentes.
  • Las apps que ya no reflejen la funcionalidad principal original sometida serán reevaluadas y deberán ser reenviadas para una nueva revisión.

4. Rendimiento de la App​

  • Las aplicaciones que afectan la interfaz de la tienda deben tener un impacto mínimo en el rendimiento.

  • Las aplicaciones que utilizan webhooks para sincronizar datos deben garantizar que la sincronización sea eficiente y no sobrecargue los recursos de la tienda.

5. Listado de aplicaciones en la tienda​

La ficha de tu aplicación es tu carta de presentación para los comerciantes. Tiene que ser clara, concisa y responder directamente a las preguntas que un usuario potencial pueda tener. Para asegurarte de que toda la información esencial esté presente, resalta las siguientes secciones obligatorias en el perfil de la aplicación:

  • ¿Qué es la aplicación?
    • Comience con una descripción directa y objetiva. Explique el problema que resuelve su aplicación y a quién va dirigida. Utilice un lenguaje sencillo para que el comerciante comprenda rápidamente el valor de su solución.
  • ¿Cómo funciona la aplicación?
    • Describa el flujo de uso de forma clara y paso a paso. Puede usar listas o párrafos cortos para mostrar cómo interactúa el comerciante con la aplicación, desde la instalación hasta el uso diario.
  • ¿Cuáles son las funcionalidades de la aplicación?
    • Enumere las principales funcionalidades de la aplicación de forma organizada. Utilice viñetas o temas para facilitar la lectura. Resalte las funciones más relacionadas con el problema que resuelve la aplicación.
  • Ventajas de instalar la aplicación
    • Céntrese en los beneficios. En lugar de simplemente enumerar las funciones, explique qué gana el comerciante al usar su aplicación. Por ejemplo: "ahorrar tiempo", "aumentar las ventas" o "mejorar la experiencia del cliente".
  • Cómo integrar la aplicación
    • Proporcione instrucciones sencillas para la integración. Si el proceso es automático, indíquelo. Si hay pasos manuales, descríbalos claramente para que el comerciante se sienta seguro y pueda realizar la integración sin dificultades.
  • Precios y planes para comerciantes
    • Sea transparente con su estructura de precios. Explique los diferentes planes, qué incluye cada uno y si existe un período de prueba gratuito. La claridad evita sorpresas y facilita la decisión del comerciante.
  • Soporte comercial
    • Indique claramente cómo el comerciante puede contactar para hacer preguntas o resolver problemas. Incluya canales de soporte como correo electrónico, chat o un centro de ayuda (preguntas frecuentes). Demostrar que existe un soporte confiable aumenta la confianza en su producto.

Estas secciones garantizan que su listado esté completo y responda todas las preguntas que un comerciante pueda tener antes de instalar su aplicación.

Información básica de la aplicación​

Nombre de la aplicación: El nombre de la aplicación no puede incluir marcas comerciales de Tienda Negocio. Debe comenzar con un término o marca única.

Icono de la aplicación: El icono debe estar en formato JPEG o PNG, con dimensiones de 600x600px. No debe contener texto, capturas de pantalla ni fotografías. El logotipo no debe tocar los bordes.

Categorización de aplicaciones: Seleccione la categoría principal que mejor describa la funcionalidad de su aplicación.

6. Seguridad y datos​

La seguridad es una parte fundamental de cualquier negocio en línea y el incumplimiento de los requisitos de seguridad afectará directamente la disponibilidad de su aplicación.

  • Su aplicación debe tener un certificado SSL/TLS válido y sin errores.
  • Su aplicación debe proteger los iframes y evitar que dominios externos utilicen la aplicación en un iframe.
  • Su aplicación debe protegerse contra vulnerabilidades comunes de seguridad web.

Datos de usuario y privacidad​

  • Si su aplicación recopila, almacena, procesa o comparte datos personales, es su responsabilidad garantizar el cumplimiento de las leyes de privacidad.
  • Todas las aplicaciones públicas deben suscribirse a webhooks obligatorios para recibir solicitudes de eliminación de datos de los comerciantes.

7. Soporte​

Después del envío, debe ofrecer soporte a los comerciantes que utilizan su aplicación.

  • Debe tener una dirección de correo electrónico que los comerciantes puedan utilizar para comunicarse con usted.
  • La información de contacto del soporte debe ser fácil de encontrar e incluir instrucciones claras y específicas sobre cómo su aplicación se integra con Tienda Negocio.