Ctrl K

¿Cómo conecto y configuro VTEX?

Cómo crear el rol y la clave en VTEX, dónde pegarlos y qué hace cada parte de la pantalla.

Actualizado el 18 de octubre de 2026

VTEX se conecta con una clave de aplicación que creás en el admin de tu tienda, atada a un rol con los permisos justos. La clave tiene dos partes, la App Key y el App Token, y las dos se pegan en Tilo.

Una vez conectada, la pantalla es la misma que la de cualquier tienda, más un paso propio de VTEX: informarle la factura a cada pedido.

Crear el rol en VTEX

  1. 1

    En el admin de VTEX, entrá a Configuración de la cuenta → Roles.

  2. 2

    Creá un rol nuevo y ponele de nombre "Tilo".

  3. 3

    Sumale los recursos de la lista de abajo y guardá.

Los recursos, por producto, con los nombres que muestra VTEX:

  • Catalog: SKUs.
  • Pricing: Read prices y Modify prices.
  • Logistics: Logistics full access.
  • OMS: List Orders, View order, Change order workflow status, Notify invoice y Feed v3 and Hook Admin.

Crear la clave de aplicación

  1. 1

    En el admin, entrá a Configuración de la cuenta → Claves de aplicación.

  2. 2

    Generá una clave nueva, sólo para Tilo.

  3. 3

    Asignale el rol "Tilo" que creaste recién.

  4. 4

    Copiá la App Key y el App Token.

Importante

VTEX muestra el App Token una sola vez. Copialo antes de cerrar la ventana; si lo perdés, generá una clave nueva.

Pegarlos en Tilo

  1. 1

    Abrí Conexiones en el menú lateral y elegí VTEX.

  2. 2

    Escribí el Nombre de la cuenta VTEX: si tu admin está en mitienda.myvtex.com, es mitienda.

    Formulario de conexión de VTEX con Nombre de la cuenta VTEX, App Key y App Token
  3. 3

    Pegá la App Key y el App Token.

  4. 4

    Tocá Conectar. Tilo prueba la clave antes de guardarla: si al rol le falta un permiso, te dice cuál.

Consejo

Recién conectada, conviene traer el catálogo antes de prender nada más: así los productos quedan emparejados y el stock no se pisa. Ver importar los productos de la tienda.

La franja de arriba

Arriba de todo está la tarjeta de la tienda: con qué cuenta de VTEX estás conectado, si la conexión anda y los dos botones para manejarla.

Franja de VTEX conectada: estado Conectada, nombre de la cuenta, hace cuánto se sincronizó y los botones Sincronizar ahora y Desconectar
  • Guía e IA — Guía abre esta página. IA le pide al asistente que te explique la pantalla, por si te queda una duda puntual.
  • Estado — Conectada es que todo anda. Con error es que la última vez algo falló: abajo aparece el motivo. Reconectá es que la autorización se venció y hay que volver a darla.
  • La cuenta — El nombre de tu tienda tal como figura en VTEX. Ver la abre, para confirmar que es la que querías conectar.
  • Sincronizada — Hace cuánto se actualizó por última vez. El ? de al lado dice cómo se mantiene al día sola: se actualiza sola cada unos minutos.
  • Sincronizar ahora — Trae en el momento lo nuevo de la tienda y le manda lo que cambió en Tilo, productos y pedidos juntos. Sigue en segundo plano: podés salir de la pantalla. Mientras corre, el botón pasa a Parar.
  • Desconectar — Corta la conexión. Los pedidos y productos que ya entraron quedan en Tilo, pero se pierden los ajustes y los vínculos entre productos.

El mapa: qué viaja para cada lado

Debajo de la franja hay un dibujo con dos flechas: la de arriba va de Tilo a VTEX y la de abajo vuelve de VTEX a Tilo. Sobre cada flecha están las cosas que viajan en ese sentido.

Mapa de la conexión con VTEX: una flecha de Tilo a la tienda con Stock y Precio, y otra de la tienda a Tilo con Ventas y Productos
  • Una etiqueta llena es algo que está prendido; una punteada, algo apagado. El mapa cambia solo cuando prendés o apagás un interruptor de más abajo.
  • Vinculadas son las publicaciones de la tienda que ya están emparejadas con un producto de Tilo: sólo a esas les llega el stock y el precio.
  • Sin vincular · ver y asociar abre la lista de publicaciones que no encontraron su producto en Tilo, para asociarlas a mano.
  • Pausadas o finalizadas aparece si alguna publicación vinculada ya no está a la venta en la tienda.

Consejo

Los productos se emparejan por su código (SKU). Si cargás el mismo SKU en Tilo y en la tienda, se vinculan solos en la próxima sincronización.

De Tilo a VTEX

La tarjeta con la flecha verde agrupa lo que Tilo le manda a VTEX. Cada interruptor se guarda en el momento, sin botón de guardar.

Tarjeta de Tilo hacia VTEX, con los interruptores de stock y precio
  • Empujar stock automáticamente — Cada cambio de stock en Tilo se publica en la tienda. En Depósito de la tienda elegís de qué depósito sale: con Todos los depósitos se publica la suma y las ventas descuentan del principal.
  • Empujar precio automáticamente — Publica el precio final, con IVA, de la lista de precios que elijas debajo. Si un producto tiene un precio propio para esta tienda, ese le gana a la lista.
  • Re-publicar precios cuando cambia la cotización — Aparece con el precio prendido. Sirve si tenés productos con el costo en dólares: cuando cambia la cotización, el precio nuevo se publica en el momento en vez de esperar a la próxima sincronización.

Importante

En VTEX, si un producto tiene un precio fijo en la política comercial principal, la tienda muestra ese y no el de Tilo.

De VTEX a Tilo

La otra tarjeta, con la flecha de vuelta, es lo que Tilo trae de VTEX: las ventas, los productos y, a pedido, los precios y el stock que tiene hoy la tienda.

Tarjeta de VTEX hacia Tilo, con Traer ventas automáticamente y sus campos
  • Importar productos… — Muestra los productos de VTEX que todavía no están en Tilo y te deja elegir cuáles crear. Antes de crear nada, ves qué se crea y qué se empareja.
  • Traer ventas automáticamente — Cada venta pagada entra a Tilo como pedido. Al prenderlo aparecen los campos de abajo.
  • Desdeobligatorio — Sólo entran las ventas creadas a partir de ese día. Viene en el día de hoy para no traer el historial de la tienda; cambiarla después no borra lo ya traído.
  • Cliente — Consumidor final factura todas las ventas así. Con los datos del comprador lo busca entre tus clientes por su email y, si no existe, lo crea.
  • Vendedor — A quién de tu equipo se le asignan las ventas de esta tienda, para las comisiones. Puede quedar sin vendedor.
  • Envío que paga el cliente — Ítem de la factura lo suma como una línea, así la factura coincide con lo que cobró la tienda. Adicional del pedido lo suma a la venta sin facturarlo. No traerlo lo deja afuera.
  • IVA del envío — Aparece si el envío va como ítem de la factura: con qué alícuota se factura esa línea.
  • Traer productos automáticamente — En cada sincronización entran solos los productos nuevos que publiques en la tienda, sin pasarte del tope de tu plan.
  • Traer precios… y Traer stock… — Cargan en Tilo lo que tiene hoy cada publicación: el precio en una lista de precios, el stock en un depósito. Antes de aplicar te muestran qué va a cambiar. Necesitan productos vinculados.
  • Traer imágenes… — Trae la foto principal de cada publicación a su producto de Tilo. Necesita productos vinculados.

Ver también

Cómo traer el catálogo la primera vez: importar los productos de la tienda.

Emisión automática con cada venta

Con Traer ventas automáticamente prendido aparece una fila de pasos numerados. Corren solos y en orden apenas entra una venta pagada; el que apagues lo hacés a mano desde el pedido.

Fila de pasos de la emisión automática: Pedido, Remito, Factura y Cobro, cada uno con su interruptor
  • 1 · Pedido — Siempre: cada venta pagada entra como pedido.
  • 2 · Remito — Descuenta el stock del depósito que despacha la venta. Apagado, el stock no se mueve hasta que hagas el remito a mano.
  • 3 · Factura — Emite la factura de ARCA. Elegís el punto de venta y el concepto; sin punto de venta no se factura. Si ARCA falla, la venta queda igual como pedido.
  • 4 · Cobro — Registra el cobro de la factura en la caja y con el medio que elijas. Necesita la factura prendida y una caja sin apertura ni cierre de turno.
  • 5 · Informar a VTEX — Le informa la factura al pedido de VTEX, que pasa a Facturado. Sin esto el pedido queda en Preparando entrega. Necesita la factura prendida.
  • Si se cancela: nota de crédito — Si la tienda cancela una venta ya facturada, Tilo emite sola la nota de crédito que la anula. No devuelve la plata de un cobro: queda como saldo a favor del cliente.

Ver también

Qué conviene definir antes de prenderlo: que los pedidos se facturen y cobren solos.

Si algo deja de andar

  • Si la tarjeta dice Reconectá, la autorización con VTEX se venció: tocá Reconectar y volvé a darla. Los ajustes no se pierden.
  • Si dice Con error, el motivo está en el recuadro rojo de abajo. Corregí lo que indica y tocá Sincronizar ahora.
  • Si una publicación no recibe el stock, revisá en el mapa que esté vinculada: si figura entre las sin vincular, asociala a su producto.

Importante

Si el precio que se ve en la tienda no es el de Tilo, revisá que el producto no tenga un precio fijo en la política comercial principal de VTEX: ese le gana al que publica Tilo.

Artículos relacionados

Sobre esto en Tilo

Omnicanal e integraciones — Tiendanube, Mercado Libre, WooCommerce, Shopify, PrestaShop, VTEX, Tienda Negocio y Empretienda con tu local: un solo stock, tus precios y facturas solas. Ver en qué plan está incluido.

¿Te quedó alguna duda?

Escribinos a contacto@tilo.ar y te ayudamos a dejarlo funcionando.

Probar Tilo gratis