# developer-ai.txt for LOI - La Oferta Irresistible
# https://loi.com.uy/developer-ai.txt
# Last updated: 25 February 2026

[overview]
LOI - Somos la Oferta Irresistible, las mejores ofertas al mejor precio de las mejores marcas y con los envíos más rápidos en tiempo récord. LOI operates a multi-brand e-commerce platform serving Uruguay and Chile with a hybrid PHP MVC backend and React TypeScript frontend. The platform handles product catalog, shopping cart, checkout, payment processing, shipping logistics, and customer management across three market-facing brands: LOI Uruguay, LOI Chile, and MiBelleza.

The backend uses a custom MVC framework with PHP 8.x, MySQL 8.0+, and 60+ specialized business logic services. The frontend is built with React 18, TypeScript, Redux Toolkit, and React Query. The platform integrates with multiple payment gateways (Plexo, Bamboo Payment, Mercado Pago, Getnet), logistics providers (UES, DAC, MooVa, La Nave, Districad, SoyDelivery), ERP systems (NetSuite), and marketplace platforms (MercadoLibre).

[public-api]
status: available
notes: Public API endpoints are available for product search, catalog browsing, category navigation, and store information. No API key registration required for public endpoints.

Public endpoints:
- [Product Search](https://loi.com.uy/index.php?ctrl=productos&act=buscar&q={query}) - Search products by text query
- [Product Detail](https://loi.com.uy/index.php?ctrl=productos&act=detalle&prod_urlseo={slug}) - Get product details by URL slug
- [Product List by Category](https://loi.com.uy/index.php?ctrl=productos&act=lista_productos&categ_urlseo={category}) - List products filtered by category
- [New Arrivals](https://loi.com.uy/index.php?ctrl=index&act=novedades&cantidad={limit}) - Get latest products added to catalog
- [Current Offers](https://loi.com.uy/index.php?ctrl=index&act=obtenerOfertas&pagina={page}&cantidad={limit}) - Get active promotional offers
- [Trending Products](https://loi.com.uy/index.php?ctrl=index&act=tendencias&pagina={page}&cantidad={limit}) - Get trending products
- [Categories Tree](https://loi.com.uy/index.php?ctrl=index&act=categorias) - Get complete category hierarchy
- [Collections](https://loi.com.uy/index.php?ctrl=index&act=colecciones) - Get curated product collections
- [Brand Stores](https://loi.com.uy/index.php?ctrl=index&act=tiendasOficialesJson) - Get brand store directory
- [Featured Stores](https://loi.com.uy/index.php?ctrl=index&act=tiendasOficialesJson&destacadas=1) - Get featured brand stores
- [Payment Methods](https://loi.com.uy/index.php?ctrl=index&act=cargarListadoTarjetasJSON) - Get available payment methods
- [Homepage Content](https://loi.com.uy/index.php?ctrl=index&act=cargarListadoDiapositivasJSON) - Get homepage banners and sliders
- [Announcements](https://loi.com.uy/index.php?ctrl=index&act=obtenerAnuncios) - Get active site announcements
- [Physical Stores](https://loi.com.uy/index.php?ctrl=index&act=tiendasOficialesJson) - Get physical store locations with addresses and GPS coordinates
- [Product Feed](https://loi.com.uy/api/v1/products.json) - Paginated product feed with filtering and sorting

[public-areas]
- Storefront website (all domains) - Fully public, no authentication required
- Product catalog pages - Public access
- Category and collection pages - Public access
- Brand store pages - Public access
- Search functionality - Public access
- Physical store locator - Public access
- Public API endpoints - No authentication required
- AI Discovery Files (llms.txt, ai.txt, identity.json, etc.) - Public access
- Structured data (JSON-LD schemas) - Publicly embedded in HTML
- Admin panel (/admin/) - Requires authentication, restricted access
- User account pages (/panel-de-usuario/) - Requires user authentication
- Checkout process - Requires user session or guest checkout
- Shopping cart operations - Session-based, no authentication required for viewing

[authentication]
Public API endpoints:
- No authentication required
- Rate limiting applied per IP address

Authenticated API endpoints:
- Method: Bearer token authentication
- Token obtained via: POST to /auth endpoint with user credentials or legacy token
- Public token available: POST to /request-token for unauthenticated access
- Token included in: Authorization header as "Bearer {token}"
- Session-based authentication also supported for web requests

User authentication:
- Method: Session-based cookies for web interface
- User registration: Available through storefront registration form
- Password requirements: Enforced by security service

Admin authentication:
- Method: Cookie-based authentication
- Access: Restricted to authorized staff only
- No public API access to admin functions

[platforms]
loi.com.uy
- Purpose: LOI Uruguay storefront and main e-commerce platform
- Technology: PHP MVC backend, React TypeScript frontend
- Access: Public storefront, authenticated admin panel
- Currency: UYU (Uruguayan Peso)
- Market: Uruguay

loichile.cl
- Purpose: LOI Chile storefront and e-commerce platform
- Technology: PHP MVC backend, React TypeScript frontend
- Access: Public storefront, authenticated admin panel
- Currency: CLP (Chilean Peso)
- Market: Chile

mibelleza.uy
- Purpose: MiBelleza brand storefront (beauty-focused)
- Technology: PHP MVC backend, React TypeScript frontend
- Access: Public storefront, authenticated admin panel
- Currency: UYU (Uruguayan Peso)
- Market: Uruguay

[documentation]
- [OpenAPI Specification](/openapi.json) - Complete API reference in OpenAPI 3.1.0 format with all endpoints, parameters, and response schemas
- [Full AI Agent Documentation](/llms-full.txt) - Comprehensive technical documentation for AI systems including API endpoints, structured data schemas, and integration patterns
- [AI Plugin Manifest](/.well-known/ai-plugin.json) - Machine-readable plugin manifest for AI agent integration
- [AI Interaction Guide](/ai.txt) - Permissions and restrictions for AI systems
- [Organization Identity](/identity.json) - Structured organization data in JSON format
- [Brand Guidelines](/brand.txt) - Naming conventions and brand rules

[technical-contact]
API integration enquiries: tech@loi.com.uy
Technical support: tech@loi.com.uy
General technical enquiries: tech@loi.com.uy

[rate-limits]
Public endpoints:
- Rate limit: 100 requests per minute per IP address
- Burst: No explicit burst limit documented
- Headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Search endpoints:
- Rate limit: 60 requests per minute per IP address
- Applies to: Product search and filtering endpoints

Authenticated endpoints:
- Rate limit: 200 requests per minute per token
- Applies to: User profile, cart operations, purchase history, favorites

Rate limit exceeded:
- HTTP status: 429 Too Many Requests
- Response: JSON error with code "RATE_LIMIT_EXCEEDED"
- Retry: Wait until rate limit window resets

[metadata]
version: 1.0
last_updated: 2026-02-25
related_files: [llms.txt](/llms.txt), [llms-full.txt](/llms-full.txt), [ai.txt](/ai.txt), [ai.json](/ai.json), [identity.json](/identity.json), [openapi.json](/openapi.json), [.well-known/ai-plugin.json](/.well-known/ai-plugin.json)