Saltar a contenido

Resumen

Esta sección describe las diferentes opciones de integración disponibles para conectar la tienda online con sistemas externos. La integración tiene dos direcciones: - Entrada: La Tol consume a datos de los sistemas de información de cliente (Cargas Batch, ) - Salida: La Tol genera datos que son transmitidos a los sistemas de información del cliente

Integración vía API

Apis De Tol (Consumer) a Sistemas de cliente (Provider)

Definimos una API que está documentada y definida en la sección OpenAPI Integración. Esta APi permite que la Tol obtenga información de los sistemas de información del cliente bajo demanda. Por ejemplo en el flujo de login:

sequenceDiagram
    participant Usuario
        Usuario->>Tol: Login
        Tol->>Sistemas de Integracion: Login
        Sistemas de Integracion->>Tol: Datos de usuario
        Note right of  Sistemas de Integracion: Si los datos son correctos
 devolvemos el usuario
        Tol->>Usuario: Token JWT
        Usuario->>Tol: Descarga de mis cupones
        Tol->>Sistemas de Integracion: Obtener cupones externos de usuario
        Sistemas de Integracion->>Tol: Cupones del usuario
    loop Importar Cupones
        Tol->>Tol: Filtrar cupones válidos
    end
        Tol->>Usuario: Cupones de usuario válidos

Apis De Sistemas de cliente (Consumer) a Tol (Provider)

La tienda online ofrece una API REST que permite a los sistemas externos acceder a los datos de la tienda y realizar acciones como gestionar pedidos, actualizar el inventario o gestionar clientes. Estas APIs forman parte del Backoffice de la Tol

Integración vía Cargas de Archivos por Lotes (Batch)

La tienda online permite la carga de archivos en varios formatos en formato JSON para la importación de datos. Esta opción es útil para la integración con sistemas que no admiten la integración a través de API. Los detalles sobre los formatos de archivo y los procesos de carga se describen en la sección Integración vía cargas.

Tipos de Datos Soportados

La integración con sistemas externos abarca varios tipos de datos, incluyendo:

  • Surtido (Productos)
  • Atributos de Producto
  • Imágenes de Producto
  • Lotes de Producto
  • Grupos de Producto
  • Afinidad de Producto
  • Precios de Producto
  • Promociones
  • Facturas y Tickets
  • Entregas y Devoluciones

Cada uno de estos tipos de datos se describe en detalle en las secciones correspondientes dentro de la documentación de integración.