Implementación VTEX en Chile: VTEX IO, headless, marketplace y multi-país

VTEX es una plataforma de comercio digital enterprise nacida en Brasil y consolidada en toda Latinoamérica, usada por retailers de gran escala como Falabella, Cencosud, Walmart Chile, Sodimac, Easy y decenas de cadenas multi-país de la región. A diferencia de Shopify (SaaS orientado a PyMEs y marcas D2C) o Jumpseller (PyME chilena con foco local), VTEX está diseñada para operaciones enterprise con catálogos de decenas de miles de SKUs, marketplaces multi-vendor, multi-tienda, multi-país y multi-moneda en una sola instalación, integración profunda con ERPs y WMS corporativos, y customizaciones de fondo vía VTEX IO. La regla práctica: si tu operación factura menos de USD 1M/año y tiene catálogo simple, Shopify o Jumpseller probablemente son la decisión correcta porque son más baratas, rápidas de levantar y mantenidas por un equipo más pequeño. Si tu operación es retail mid-large, vendes en varios países LATAM, tienes catálogo complejo (variantes, listas de precio por canal, promociones cruzadas, B2B + B2C en la misma marca), necesitas operar marketplace propio con varios vendedores o estás obligada a integrarse con un ERP corporativo y un WMS robusto, VTEX justifica su mayor costo y curva de aprendizaje. La conversación honesta antes de cotizar es siempre la misma: cuánto facturas, qué catálogo manejas, en cuántos países operas y qué sistemas backend ya tienes; con eso queda claro si VTEX es la mejor herramienta o si estás sobre-comprando.

Una implementación VTEX en Chile parte desde USD 35.000-60.000 (aproximadamente $32-55 millones CLP) para una tienda B2C single-country con tema custom razonable, integración SII boleta, pasarela de pagos chilena (Webpay y Mercado Pago) y catálogo migrado. El rango sube rápido según complejidad: una implementación enterprise multi-tienda multi-país con marketplace propio, headless storefront en React, apps custom en VTEX IO, integración profunda con ERP corporativo (SAP, Oracle, Microsoft Dynamics) y WMS empresarial se ubica entre USD 120.000 y USD 350.000 (entre $110 y $320 millones CLP), con timelines de 6 a 12 meses. A esto hay que sumar el costo de licencia VTEX, que opera con modelo revenue-share (un porcentaje del GMV con mínimos mensuales) negociado directamente con VTEX y que no cobramos nosotros, y el mantenimiento evolutivo post-launch que típicamente se calcula entre USD 4.000 y USD 12.000 mensuales según volumen y SLA. El driver número uno del costo no es la plantilla visual: es la cantidad de integraciones backend (ERP, WMS, pagos, logística, marketplaces) y la complejidad del modelo comercial (B2B con listas por cliente, multi-país con reglas tributarias distintas, marketplace con comisiones por vendedor, etc.). Por eso el discovery de 2-4 semanas que hacemos antes de cotizar firme es la inversión más rentable del proyecto: define alcance real y evita sorpresas que en VTEX, por su nivel de complejidad, son caras.

VTEX IO es la plataforma de desarrollo serverless de VTEX para construir, desplegar y operar aplicaciones e-commerce custom sobre la infraestructura de VTEX. En términos prácticos, es el ecosistema técnico que permite extender VTEX más allá de su tema estándar: componentes React custom para el storefront, apps backend en Node.js que se conectan a APIs internas y externas, integraciones, workflows, builders especializados (store, masterdata, GraphQL, react, node), versionamiento y CI/CD nativos. Importa porque cualquier customización seria en VTEX vive en VTEX IO: si solo se trata de cambiar colores y tipografías, alcanza con la configuración del tema base; pero apenas necesitas un componente que no existe, una integración no estándar, un flujo de checkout custom, un comportamiento condicional por país, una vitrina personalizada por segmento de cliente o un dashboard interno para tu equipo comercial, tienes que escribir código en VTEX IO. La curva de aprendizaje es real: VTEX IO mezcla conceptos de microfrontends, GraphQL, Apollo Client, Stencil/StoreFront React, builders propios y un modelo de despliegue particular. Por eso un equipo de devs React generalista no es automáticamente productivo en VTEX IO; hay que aprender el SDK, las convenciones, las APIs internas (Catalog, Checkout, Master Data, Orders) y los patrones de extensibilidad. En Blackend trabajamos VTEX IO como cualquier stack moderno: TypeScript estricto, testing, code review, CI/CD, observabilidad y documentación; no improvisamos sobre la marcha porque en VTEX un bug en checkout cuesta plata medible cada minuto.

Sí, y es uno de los diferenciadores fuertes de VTEX frente a Shopify, Jumpseller o WooCommerce. VTEX trae nativamente un módulo de marketplace que permite operar dos modelos: VTEX como marketplace donde varios vendedores publican y venden (modelo Mercado Libre/Falabella), y VTEX como seller que se conecta a marketplaces externos para sindicar catálogo y recibir pedidos. En el primer caso, VTEX gestiona el onboarding de sellers, la sincronización de catálogo, el split de la venta entre marketplace y seller, las comisiones configurables por categoría o por seller, el flujo logístico (despacho directo del seller o consolidación en bodega central) y la conciliación financiera. Cada seller puede tener su propio precio, stock, tiempo de despacho y reglas comerciales, manteniendo la experiencia de checkout y branding del marketplace. Las customizaciones típicas que hacemos en marketplaces VTEX son: panel de seller con dashboard de ventas y comisiones, integración del catálogo del seller con su ERP propio, workflow de aprobación de productos antes de publicar, reglas de visibilidad por país/región, separación de boletas electrónicas por seller para cumplimiento tributario, y reporting financiero consolidado para el operador del marketplace. Esta es una de las razones por las que cadenas chilenas que partieron como retailer puro y luego abrieron marketplace (Falabella, Sodimac, Paris) eligieron VTEX: el módulo está pensado desde el día uno para esto, no es un parche.

Sí, VTEX se integra con el SII chileno para emisión automática de boleta y factura electrónica, pero el detalle importa: VTEX no es un emisor DTE nativo, sino que se apoya en proveedores certificados (Haulmer, OpenFactura, NubeFact, Bsale, Acepta, Sovos) a través de la capa de integración que se construye sobre VTEX IO o vía conectores de mercado. El flujo estándar es: cuando se cierra la venta en VTEX y el pago es confirmado por la pasarela, VTEX dispara un evento (vía webhook o consumido vía Orders API) que la capa de integración procesa para armar el DTE correcto (boleta 39 para B2C sin RUT, factura 33 para B2B con RUT, boleta exenta 41, nota de crédito 61 para devoluciones) y enviarlo al proveedor certificado, que a su vez lo timbra contra el SII y devuelve el folio. El DTE timbrado vuelve a VTEX para asociarse al pedido y, opcionalmente, se envía por email al cliente final. La complejidad real está en los casos borde: pedidos parciales con varios despachos (¿una boleta o varias?), refunds totales vs parciales, productos exentos vs gravados en el mismo carrito, gift cards, suscripciones recurrentes, marketplace donde cada seller debe emitir su propia boleta a su nombre, y reconciliación con los libros de compraventa que después se cargan a SII. Esto se diseña antes de programar, no se descubre después. Si quieres ver más detalle de cómo abordamos la pieza tributaria, revisa nuestra página de integración SII boleta electrónica.

VTEX soporta nativamente las pasarelas chilenas más usadas: Webpay Plus de Transbank (la pasarela dominante para tarjetas de crédito y débito en Chile), Mercado Pago (tarjetas, transferencias, Mercado Crédito), y vía integraciones custom o conectores de mercado también opera con Khipu (transferencias bancarias instantáneas), Flow, Onepay, Servipag, Multicaja y BICE Pagos. Para tarjetas internacionales y casos enterprise multi-país, también se conecta con Stripe, PayU LATAM, Cybersource y procesadores globales que la cadena ya tenga contratados. La capa de pagos en VTEX se llama VTEX Payment Gateway y es la responsable de orquestar el flujo: tokenización, autorización, captura, anulación, refund y conciliación. Configurar una pasarela en VTEX no es solo activarla: hay que decidir reglas de captura (manual vs automática), comportamiento ante 3DSecure, manejo de cuotas (con/sin interés, con qué bancos), políticas anti-fraude, qué pasa con autorizaciones expiradas, qué pasa con pagos con doble cobro, y cómo se refleja todo eso en los flujos contables. En operaciones multi-país (típico de retail enterprise) hay que orquestar pasarelas distintas por país: Webpay para Chile, PayU para Colombia, Mercado Pago para Argentina, etc., manteniendo una experiencia de checkout consistente. Esta orquestación es parte estándar de nuestras implementaciones VTEX cuando hay alcance multi-país.

Sí, migrar desde Shopify, Shopify Plus, Magento, WooCommerce, Salesforce Commerce Cloud, BigCommerce, Vtex Legacy o plataformas custom hacia VTEX es uno de los proyectos que más implementamos en clientes que crecieron sobre una plataforma que ya no les da el techo. La migración a VTEX se trabaja en cinco frentes paralelos: (1) catálogo: SKUs, categorías, atributos, especificaciones, imágenes, variantes, listas de precio se exportan de la plataforma origen y se cargan a VTEX vía API Catalog con scripts custom que validan integridad referencial; (2) clientes y direcciones: base de clientes con historial de compras, direcciones, listas de favoritos y datos de B2B (RUT, condición de pago, descuentos por cliente) se migran a Master Data y al módulo de clientes B2B; (3) órdenes históricas: opcionalmente se importan órdenes pasadas para mantener trazabilidad, aunque muchos clientes prefieren cortar limpio y dejar histórico en la plataforma vieja en modo solo-consulta; (4) URLs y SEO: mapeo 301 de cada URL antigua hacia la nueva URL en VTEX para no perder posicionamiento; este punto se subestima siempre y es donde más se pierde tráfico orgánico en migraciones mal planificadas; (5) integraciones: pasarelas, ERP, WMS, CRM, BI, herramientas de marketing se reconectan al nuevo entorno antes del cut-over. La migración se hace con un período de coexistencia donde ambas plataformas operan en paralelo durante 2-4 semanas para validar comportamiento real con tráfico controlado, y solo después se ejecuta el cut-over definitivo apuntando el dominio al nuevo storefront. Migrar VTEX no es un copy-paste: es un proyecto enterprise serio que requiere planificación, testing y un plan de rollback.

VTEX históricamente se posicionó enterprise, pero con los años ha bajado su umbral de entrada y hoy también operan empresas medianas que están en una trayectoria clara de crecimiento o que tienen un caso de uso que justifica la plataforma por características específicas (marketplace, multi-país, B2B complejo) más que por volumen puro. Dicho eso, seamos honestos: si tu operación factura menos de USD 1M-2M anuales y tu catálogo es relativamente simple, VTEX probablemente es overkill y vas a pagar licencia revenue-share, costos de implementación y complejidad técnica que no necesitas; en ese caso Shopify, Shopify Plus o incluso Jumpseller te dan más velocidad por menos plata. VTEX empieza a justificarse cuando: facturas más de USD 2M anuales con expectativa de seguir creciendo, operas o planeas operar en más de un país LATAM, tienes catálogo con más de 5.000 SKUs y reglas comerciales complejas, necesitas operar marketplace propio con múltiples vendedores, tienes B2B y B2C en la misma marca con reglas distintas, o tu casa matriz corporativa ya estandarizó en VTEX y necesitas alinearte. Cuando una empresa mediana entra a VTEX por las razones correctas (no por aspiración, sino por necesidad real del negocio), la inversión se justifica porque la plataforma escala con el negocio sin requerir replatform; cuando entra por aspiración o por recomendación mal calibrada, suele terminar en un proyecto sobredimensionado que tarda más, cuesta más y entrega menos valor del esperado. La pregunta correcta no es "¿VTEX sí o no?", sino "¿qué problema concreto estoy resolviendo y VTEX es la mejor herramienta para ese problema?".