Integración · Plataformas de venta
Conectar VTEX a Igniten
Conecte la cuenta VTEX de su empresa para consultar pedidos, catálogo de productos, inventario, precios y clientes. La conexión es una sola, de la organización: cada persona ve sólo lo que un administrador le da en Roles, y cada cambio requiere una tarjeta que puede revisar antes de confirmar.
Qué lee Igniten, y qué no
Lee
- pedidos, catálogo de productos, inventario, precios y clientes
No lee
- Contraseñas de compradores, números completos de tarjeta, códigos de seguridad, direcciones y teléfonos.
- Nada de una persona de su equipo que no tenga el permiso de esta aplicación en Roles.
Cómo se conecta
4 pasos · ≈ 15 min
-
Cree en VTEX un rol de sólo lectura
En el admin de VTEX toque su avatar (la inicial de su correo, arriba a la derecha) → Account settings → User roles → + Create Role.
- OMS → List Orders
- OMS → View order
- Catalog → SKUs
- Pricing → Read prices
- Logistics → Logistics inventory read only
- Dynamic Storage → Read only documents
- En «Choose role» elija Custom y póngale de nombre «Igniten lectura».
- En «Choose a product» elija cada producto de la lista de arriba y tilde SÓLO el recurso que figura al lado. No tilde nada más.
- Toque Save. Para crear roles su usuario de VTEX necesita el recurso «Save access profile»; si no lo tiene, pídaselo a quien administra VTEX en su empresa.
Salió bien si En User roles aparece «Igniten lectura» y, al abrirlo, ve exactamente los seis recursos de la lista.
-
Genere una clave con ese rol
Toque su avatar → Account Settings → API Keys, quédese en la pestaña Generated y toque + Generate Key.
- En «Key identification» escriba «Igniten lectura» y en los roles elija sólo «Igniten lectura». Toque Generate.
- VTEX muestra la clave (AppKey, empieza con vtexappkey-) y un enlace de un solo uso. Toque Copy, abra ese enlace y copie el token (AppToken): se muestra UNA sola vez.
- Guarde los dos en un lugar seguro hasta el paso siguiente. Nunca los pegue en el chat del ayudante.
Salió bien si En la pestaña Generated aparece «Igniten lectura» con estado activo.
-
Cargue la clave en Igniten
En Igniten, entre a Conexiones, elija VTEX y toque Conectar.
- Igniten prueba la clave leyendo un pedido antes de guardarla; si falta un recurso del rol, se lo dice y no guarda nada.
- La conexión es de toda su organización: cada persona ve sólo lo que un administrador le da en Roles.
Salió bien si Conexiones muestra VTEX como conectada, con el nombre de su cuenta.
-
Habilite cambios si los necesita
Repita los pasos 1 y 2 con un rol y una clave nuevos llamados «Igniten cambios», y cárguelos en Conexiones → VTEX → Habilitar cambios.
- Pricing → Modify prices
- Logistics → Logistics inventory full access
- Ese rol lleva sólo los dos recursos de la lista. Las notas de pedido (VTEX DO) no piden ningún recurso.
- Use la MISMA cuenta VTEX que en la lectura. Cada persona que vaya a cambiar algo necesita además el permiso de acciones, que da un administrador en Roles, y cada cambio pide una tarjeta de confirmación.
Salió bien si En Conexiones, VTEX dice que los cambios están habilitados.
Qué permisos pide
| Permiso | Para qué | Cuándo hace falta |
|---|---|---|
OMS → List Orders | Para listar los pedidos. | Siempre |
OMS → View order | Para leer un pedido. | Siempre |
Catalog → SKUs | Para encontrar productos. VTEX no tiene un recurso de sólo lectura para SKUs: este también permitiría editarlos, e Igniten no los edita. | Siempre |
Pricing → Read prices | Para consultar precios. | Siempre |
Logistics → Logistics inventory read only | Para consultar stock por depósito. | Siempre |
Dynamic Storage → Read only documents | Para encontrar clientes por nombre y correo. | Siempre |
Pricing → Modify prices | Para cambiar el precio, con tarjeta. | Siempre |
Logistics → Logistics inventory full access | Para cambiar el stock de un depósito, con tarjeta. | Siempre |
Los dos niveles de permiso que recomendamos, y qué habilita cada uno, están en Permisos recomendados.
Qué puede salir mal
- «VTEX rechazó la clave o sus permisos; revise el rol indicado en el instructivo»
-
Por qué La AppKey o el AppToken están mal copiados, o el rol de la clave no tiene los recursos de lectura.
Qué hacer En VTEX → Account settings → User roles, abra «Igniten lectura» y verifique los seis recursos; si el token se perdió, genere una clave nueva.
- «La dirección tiene que ser https://SU-CUENTA.vtexcommercestable.com.br»
-
Por qué Pegó otra dirección (por ejemplo la de la tienda o la del admin myvtex).
Qué hacer Escriba sólo el nombre de su cuenta, por ejemplo «mitienda».
- «La escritura debe usar la misma cuenta que la lectura»
-
Por qué La clave de cambios es de otra cuenta VTEX.
Qué hacer Genere la clave «Igniten cambios» en la misma cuenta que conectó para leer.
- «La tienda se conecta para toda la organización: lo hace un administrador de Igniten»
-
Por qué Cargó las claves sin ser administrador de Igniten.
Qué hacer Pídale a un administrador de su organización que las cargue.
- «403»
-
Por qué Falta un permiso de la aplicación o del registro en Roles.
Qué hacer Pídale al administrador que revise sus permisos de esta aplicación.
Los límites, dichos
- Los listados dicen hasta N: no son el total de su negocio.
- Las direcciones y teléfonos no entran al directorio; productos y clientes llevan sólo campos de superficie cifrados.
- La escritura se confirma con tarjeta y no se reintenta ante un error del proveedor.
Preguntas frecuentes
¿Qué ve cada persona?
La cuenta VTEX la conecta la organización una sola vez. Cada persona ve sólo lo que un administrador le dio en Roles para esta aplicación; sin ese permiso no ve nada.
¿Puede borrar o devolver dinero?
No permite borrar, reembolsar, cancelar ventas ni mover plata. Las notas de pedido no piden ningún recurso en VTEX. Igniten le va a pedir confirmación cada vez antes de cambiar algo.
¿Quién puede conectarlo?
Un administrador de Igniten, con un usuario de VTEX que pueda crear roles y claves. Si ese usuario lo tiene otra persona, ella crea el rol y la clave y le pasa los dos datos por un canal seguro, nunca por el chat del ayudante.
¿Qué dirección pongo?
Sólo el nombre de su cuenta: lo que va antes de .myvtex.com cuando entra al admin. En https://mitienda.myvtex.com/admin es «mitienda». Igniten arma la dirección https://mitienda.vtexcommercestable.com.br.
¿Cuánto tarda?
El recorrido tarda aproximadamente 15 minutos. Tenga abierto el admin de VTEX y el panel de Igniten.
¿Cómo lo desconecto?
Un administrador entra a Conexiones, abre VTEX y toca Desconectar. Se eliminan la lectura y la escritura para toda la organización. Además, en VTEX → Account Settings → API Keys, desactive las claves de Igniten.
¿Dónde van mis claves?
Igniten guarda la AppKey y el AppToken cifrados y nunca los vuelve a mostrar. Nunca pegue una clave en el chat del ayudante. Si la pegó, regenere el token en VTEX y cárguelo de nuevo.
¿Cómo habilito cambios?
Un administrador conecta primero la lectura. Después crea en VTEX el rol «Igniten cambios» y una segunda clave con ese rol, y la carga en Habilitar cambios. Cada persona que vaya a cambiar algo necesita el permiso de acciones en Roles, y cada cambio pide una tarjeta.
¿Qué quiere decir 403?
403 quiere decir que falta un permiso: en VTEX, un recurso del rol de la clave; en Igniten, el permiso de esta aplicación en Roles.