VTEX
externovtex Plataforma externa de ecommerce utilizada como sistema de registro para catálogo de productos, gestión de órdenes, autenticación de clientes y configuración de sellers y tiendas. Varios microservicios de White Label consumen sus APIs para sincronizar estado y delegar operaciones comerciales.
Usado por
12Servicio responsable de la autenticación en el sistema. Genera y valida access tokens y refresh tokens, y gestiona credenciales de sistemas externos como VTEX, almacenando cookies y sesiones en la base de datos de identidad.
Cart (legacy)Servicio legado responsable del carrito de compras del cliente. Expone APIs gRPC/HTTP para: - Crear y recuperar carritos por identificador y usuario. - Añadir, actualizar, parchear y eliminar items del carrito. - Gestionar mensajes y comentarios asociados al carrito y a items específicos. - Actualizar datos de envío del carrito (dirección, tipo de entrega, tipo de dirección). - Validar el carrito en base a reglas de negocio, grupos de cliente y contexto de entrega. - Configurar el tipo de sustitución de productos en caso de falta de stock.
CartsReimplementación completa del carrito de compras del cliente sobre la arquitectura White Label. Expone APIs gRPC/HTTP para: - Crear, recuperar y eliminar carritos por identificador y usuario. - Añadir, actualizar y eliminar items del carrito (patch masivo e individual). - Gestionar mensajes y comentarios asociados al carrito. - Actualizar datos de envío del carrito (dirección, tienda de despacho, tipo de entrega, tipo de dirección) y simular el carrito para un contexto dado. - Validar el carrito en base a reglas de negocio, grupos de cliente y contexto de entrega. - Configurar el tipo de sustitución de productos en caso de falta de stock.
CatalogServicio unificado de catálogo. Consolida en un solo microservicio, un solo contrato y una sola capa de cálculo de precios lo que antes vivía repartido entre [Product Search (legacy)](/catalog/services/dc-wl-groceries-core-search) y [Product Detail (legacy)](/catalog/services/dc-wl-groceries-core-products). Expone 21 RPCs gRPC + grpc-gateway HTTP, API-first sobre Protobuf, para: - Búsqueda/discovery: keyword search, navegación por categoría/colección, facets, autocomplete, autosuggest, productos relacionados, top searches (Constructor.io con fallback a VTEX/VIS). - Producto/detalle: obtención por id/sku/slug/ean (individual y batch), con resolución in-process del producto base (VTEX Catalog) más overlay de stock/precio en tiempo real (VIS). - Enriquecimiento por tenant: productType/food, PPUM formateado, showAddToCart, tags de promoción, info-tags, display ads (CMedia).
CustomersServicio central de cliente que concentra múltiples responsabilidades. Expone APIs para: - Gestión del perfil de cliente (creación, actualización, desactivación, existencia). - Términos y consentimientos (OneTrust / Conta). - Notificaciones e inbox del cliente (incluyendo popups y su estado). - Direcciones del cliente y sincronización con sistemas externos como VTEX. - Preferencias (dietarias, marketing, suscripciones, tabaco). - Dispositivos asociados al cliente. - Premios y beneficios del cliente (loyalty prizes). - Información geográfica y de tiendas, consumida desde CMS/servicios externos. - Lógica para determinar tiendas/sellers que pueden despachar a una dirección, reutilizada por otros servicios a través de este endpoint.
ListsMicroservicio del dominio "Mis Listas". Gestiona las listas de compras de los usuarios, incluyendo la lista especial de Favoritos. Expone APIs gRPC + grpc-gateway para: - Crear, renombrar y eliminar listas. - Agregar, quitar y actualizar cantidades de ítems. - Vaciar una lista completa. - Consultar listas y su detalle, enriquecidas con datos de catálogo.
OrdersServicio responsable del historial y detalle de pedidos del cliente. Expone APIs gRPC/HTTP para: - Obtener el listado de órdenes de un cliente. - Obtener el detalle de una orden puntual. - Obtener la factura (invoice) asociada a una orden.
Product Detail (legacy)Servicio legado responsable de la ficha de producto. Expone APIs HTTP para obtener información detallada de un producto, utilizando un modelo de datos muy similar al de Search, pero enriquecido con: - Detalles adicionales del producto. - Ingredientes y atributos específicos. - Recomendaciones de productos relacionados. - Información extendida para la pantalla de detalle.
Promotions EngineServicio responsable de calcular y devolver promociones aplicables a productos y/o carritos. Implementa reglas de priorización para determinar qué promociones son más beneficiosas para el usuario en un contexto dado, resolviendo conflictos entre múltiples ofertas y combinaciones posibles.
Product Search (legacy)Servicio legado responsable de la búsqueda y descubrimiento de productos. Expone APIs gRPC/HTTP para: - Top searches y sugerencias de búsqueda. - Autocomplete y autosuggest combinando términos y productos relacionados. - Búsqueda de productos por keyword, categoría y colección. - Obtención de facets y opciones de filtrado para resultados de búsqueda. - Información de paginación, ordenación y filtros aplicados sobre los resultados.
Session ManagerServicio legado que maneja autenticación y sesiones de usuarios, incluyendo generación de tokens y gestión de credenciales para sistemas externos como VTEX.
VTEX ProxyProxy que concentra en un solo lugar las credenciales y configuración de VTEX (base URL, app key, app token) de todos los tenants. Expone un API HTTP (Rust/Axum) para que otros servicios y herramientas accedan a VTEX sin que cada uno gestione sus propias credenciales por tenant.