Conectar PedidosYa con Ventix
Guarda las credenciales que te da PedidosYa, prueba la conexión y activa la recepción de pedidos.
Para recibir tus pedidos de PedidosYa en Ventix, abre la configuración de PedidosYa, guarda las credenciales que te entrega PedidosYa, prueba la conexión y enciende Activar integración. Solo el Administrador puede cambiar esta pantalla. El Gerente la ve en modo de solo lectura y puede probar la conexión.
La primera vez se entra desde Configuraciones Globales → Módulos: en la tarjeta PedidosYa, pulsa Activar. Desde que guardas las credenciales, PedidosYa aparece también en Configuraciones Globales, aunque la integración siga apagada.
Antes de empezar
La conexión no depende solo de Ventix. Pídele esto a tu comercial de PedidosYa:
- Las credenciales de tu cadena: client_id, client_secret y chain_id.
- Acceso al Partner Portal, donde se configuran los avisos de pedidos y se descarga la lista de tiendas.
- Una tienda de prueba para la homologación, si PedidosYa te la exige antes de salir a producción.
- La activación de la integración directa en cada tienda. Esto lo hace PedidosYa, tienda por tienda.
Importante: el soporte de PedidosYa nos confirmó que, al activar la integración directa en una tienda, su tableta de pedidos deja de funcionar. No pidas esa activación en una tienda real hasta tener a tu personal listo para atender desde Ventix.
Sin esa activación, los pedidos de PedidosYa no llegan a Ventix aunque aquí todo esté en verde.
Pregúntale también cómo hacer las pruebas. Las pruebas oficiales de PedidosYa corren en Producción con la tienda de prueba, y el Sandbox puede no dejarte crear pedidos de prueba.
La integración es solo para cuentas reales con plan Enterprise. No está disponible en las cuentas de demostración.
Guardar las credenciales
- Abre la configuración de PedidosYa. La primera vez, entra a Configuraciones Globales → Módulos y pulsa Activar en la tarjeta PedidosYa. Después, entra por Configuraciones Globales → PedidosYa.
- En la tarjeta Credenciales, elige el Ambiente: Sandbox (pruebas) es para probar y Producción recibe los pedidos reales.
- Escribe el client_id y el chain_id. Si el chain_id está al final del client_id, pulsa Usar el chain_id del client_id.
- Pulsa Guardar credenciales.
- En la tarjeta Client secret, pulsa Guardar secreto, pega el client_secret y confirma con Guardar secreto.
El secreto queda cifrado y Ventix no lo vuelve a mostrar. Solo verás sus últimos caracteres.
Importante: cambiar el ambiente o el client_id borra el secreto. Cualquier cambio en el ambiente, el client_id o el chain_id apaga la integración y descarta la última prueba: tendrás que probar y activar otra vez.
Probar la conexión
- En la tarjeta Probar conexión, pulsa Probar conexión.
- Lee el resultado. Debe decir Conexión verificada, con cada paso en verde: Obtener el token, Permisos del token, Ambiente, Mercado y Acceso a la cadena.
Si falla, cada paso explica por qué. Puedes probar una vez cada 30 segundos. Si acabas de generar credenciales de Sandbox, espera hasta 5 minutos: PedidosYa tarda en activarlas.
Configurar los avisos de PedidosYa
PedidosYa le avisa a Ventix de cada pedido nuevo o cambio de estado. Estos avisos se llaman webhooks y se configuran una sola vez en el Partner Portal.
- En la tarjeta Webhook, pulsa Generar token.
- Copia el token en la ventana Token del webhook generado. Se muestra una sola vez.
- En el Partner Portal de PedidosYa, abre Shops Integrations.
- En Order webhook pega la URL de Order webhook (pedidos) y en Assortment webhook la de Assortment webhook (catálogo). Las dos se copian desde Ventix.
- En el campo secret de los dos, pega el token tal cual, sin la palabra «Bearer».
- En Ventix, pulsa Ya lo copié.
Puedes dejar todo esto listo antes de activar la integración. Mientras esté inactiva, Ventix rechaza los avisos y no guarda nada.
Importante: Regenerar token deja sin efecto el token anterior al instante. PedidosYa recibirá rechazos hasta que pegues el nuevo en el Partner Portal.
Activar la integración
Arriba de la pantalla, junto a Activar integración, verás lo que falta:
- El client_id y el chain_id guardados.
- El client_secret guardado y legible.
- Una prueba de conexión exitosa en las últimas 24 horas.
- En Producción, la aprobación de Producción de Smart Business para esta cadena. Solicítala a Soporte de Ventix.
- Que la cadena no esté conectada en otra cuenta de Ventix.
Cuando todo esté cumplido, enciende Activar integración. Verás Integración con PedidosYa activada. y la etiqueta Activa arriba de la pantalla. Después aparece Pedidos PedidosYa en el menú; si no lo ves, recarga la página.
Antes de recibir pedidos reales, deja listo lo siguiente, que se puede preparar con la integración apagada:
- Registrar las tiendas y asignarles sucursal.
- Configurar cómo se facturan los pedidos.
- Emparejar tus productos.
- Si quieres, enviar stock y precios.
Revisar si llegan los avisos
Debajo de las URLs, la tarjeta Webhook muestra Último webhook recibido y, si los hay, los webhooks rechazados por token inválido. En ese caso, revisa que el campo secret del Partner Portal tenga el token vigente.
La tarjeta Webhooks recibidos lista los últimos avisos con su Estado en Ventix. Lo normal es Procesado. Si se quedan en Pendiente por más de unos minutos, avisa a Soporte de Ventix.
Desconectar
Al final de la pantalla, Desconectar borra el secreto y el token, apaga la integración y descarta la última prueba. Las tiendas y la configuración de facturación se conservan.
Importante: al desconectar cambian las URLs de los avisos. Para reconectar tendrás que guardar el secreto, probar la conexión, generar un token nuevo y actualizar las URLs y el token en el Partner Portal.
Si algo sale mal
| Mensaje | Qué hacer |
|---|---|
| Prueba la conexión con éxito antes de activar la integración (la prueba vale 24 horas). | Pulsa Probar conexión y vuelve a activar. |
| Guarda el client_secret antes de activar la integración. | Guarda el secreto en la tarjeta Client secret. |
| Para activar Producción, Smart Business tiene que aprobar esta cadena de PedidosYa. Solicítalo a Soporte de Ventix. | Escribe a Soporte de Ventix y vuelve a activar cuando te aprueben. |
| Esta cadena de PedidosYa ya está conectada en otra cuenta de Ventix. | Desconéctala en la otra cuenta o consulta a Soporte de Ventix. |
| Credenciales inválidas: revisa el client_id y el client_secret. | Revisa también que el Ambiente corresponda a esas credenciales. |
| El chain_id no corresponde a estas credenciales. | Confirma el chain_id con PedidosYa. |
| No se pudo leer el secreto guardado; vuelve a ingresarlo. | Pulsa Reemplazar secreto y pégalo de nuevo. |
| Tu plan actual no incluye la integración con PedidosYa. | Necesitas el plan Enterprise. Ver Consultar plan y suscripción. |
| La integración con PedidosYa no está disponible para empresas demo. | Estás en una cuenta de demostración. La integración funciona solo en cuentas reales. |
Actualizado el

