API Marketplace — Backend Microservicio

Qué hace este microservicio

Este backend expone una API REST en formato JSON para dar soporte a una plataforma de marketplace: gestión de usuarios, tiendas (vendors), catálogo de productos, carrito de compras, órdenes de venta, pagos, envíos, tasas de cambio (BCV), impuestos (IVA/IGTF) y configuración asociada.

Está pensado para alta concurrencia, escalabilidad y para ser consumido por frontends y otros servicios (por ejemplo, un admin o una tienda online).

Áreas principales

• Autenticación: Registro, login, OTP, administradores.
• Usuarios y tiendas: Clientes, vendors, agentes.
• Catálogo: Productos, categorías, atributos, búsqueda (Algolia).
• E-commerce: Carrito, órdenes de venta, totales por vendor, pagos e integraciones (Pago Móvil, TDC, transferencias, etc.).
• Configuración: Tasas de cambio (manual/BCV), impuestos, directorio, métodos de pago y envío.
• Extras: Wishlist, reseñas, newsletter, cron (rates, indexación), estadísticas.

Cómo usar la API

Los endpoints están bajo /api/v1/.... Las peticiones deben incluir la cabecera X-API-Key (o la clave configurada en el servidor). Para documentación detallada, revisa el README del repositorio y la lista de rutas (customers, products, shopping-cart, sales-order, rates, etc.).