Manual de Integración de Ventas 🛍️
La integración entre el sistema AlterVision y los sistemas POS/ERP de las tiendas tiene como objetivo importar los datos de ventas de cada tienda a la plataforma. Este documento describe claramente las formas en que los sistemas de las tiendas pueden integrarse con nuestro sistema.
Resumen de Métodos de Integración
Presentamos cuatro formas de realizar la integración, que se diferencian principalmente en cómo fluye la información entre los sistemas. En el modelo Push, el cliente envía la información directamente a nuestra plataforma, lo que permite un mayor control. En el modelo Pull, nuestra plataforma consulta periódicamente una API proporcionada por el cliente. En el modelo de API de Terceros, los datos se obtienen de un proveedor externo que ya integra con el sistema AlterVision. Por último, la importación manual permite ingresar los datos mediante hojas de cálculo CSV a través de PainelAlter.
Método 1: PUSH - El cliente envía datos a AlterVision
Cómo funciona
El cliente implementa una rutina (job, webhook o servicio) que envía los datos de ventas a un endpoint seguro en nuestra plataforma. Una vez recibidos, estos registros se validan, se eliminan duplicados y se presentan en el panel para reportes y análisis.
Más información
Accede a la documentación completa en Documentación de la API AlterVision
Cuándo elegirlo
Recomendado cuando el cliente desea baja latencia (datos casi en tiempo real), control total sobre qué registros salen de su entorno y prefiere gestionar internamente el proceso de envío.
Beneficios
No se requiere IP fija ni redirección de puertos: solo se utilizan conexiones salientes. Mayor control sobre la información compartida.
Desafíos
El cliente es responsable de desarrollar la rutina de envío de datos de ventas y garantizar que los datos se envíen de manera confiable (reenvío automático en caso de errores, por ejemplo).
Método 2: PULL - Los datos se obtienen a través de la API del cliente
Cómo funciona
El cliente desarrolla y expone una API capaz de devolver los datos de ventas. Nuestra plataforma consulta periódicamente el endpoint proporcionado para recopilar las ventas.
Más información
Cuándo elegirlo
Cuando el cliente ya posee integraciones similares con otros sistemas o cuando las políticas internas impiden crear o mantener rutinas automatizadas de envío.
Beneficios
No es necesario mantener rutinas ni servidores; solo se requiere el mantenimiento de la API.
Desafíos
Dependencia de la disponibilidad y el rendimiento de la API del cliente, además de la necesidad de manejar autenticación, límites de tasa y paginación.
Método 3: API de Terceros - Los datos se obtienen de un tercero
Cómo funciona
Nuestra plataforma obtiene las ventas directamente de la API del proveedor de POS que el cliente utiliza. En lugar de que el cliente construya una nueva rutina, consumimos los datos ya proporcionados por el proveedor del POS.
Cuándo elegirlo
Cuando el cliente ya utiliza un POS con API disponible y prefiere aprovechar esta fuente lista para reducir el trabajo interno, o cuando el proveedor del POS es la única fuente confiable de los registros de ventas.
Beneficios
Reduce el esfuerzo del cliente al aprovechar la API del POS, acelerando la integración y facilitando la estandarización.
Desafíos
Depende de la disponibilidad y cambios en la API del proveedor, lo que puede afectar la actualización y consistencia de los datos, y puede requerir coordinación para soporte y credenciales.
Método 4: Importación Manual
La importación manual permite ingresar datos de ventas en el sistema mediante la carga de una hoja de cálculo en formato CSV. Este método es ideal para escenarios en los que los datos ya están organizados externamente o cuando no hay una integración automatizada disponible.
Para utilizar esta funcionalidad, acceda a PainelAlter y navegue hasta Atajos Rápidos > Importar Ventas > Cargar Hoja de Cálculo. En esta sección, es posible descargar las plantillas estándar de CSV, que deben utilizarse como base para garantizar que los datos estén en el formato correcto.
Después de completar la hoja de cálculo con la información necesaria, simplemente cargue el archivo en la misma área. El sistema procesará los datos y realizará la importación automáticamente.
Recomendamos seguir estrictamente la plantilla proporcionada, respetando los nombres de las columnas y el formato de los datos, para evitar errores durante el procesamiento.