# Conectar PedidosYa con Ventix

URL: https://ventix.smartbusiness.site/manual/pedidosya/conectar-pedidosya

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

1. 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**.
2. En la tarjeta **Credenciales**, elige el **Ambiente**: **Sandbox (pruebas)** es para probar y **Producción** recibe
   los pedidos reales.
3. 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**.
4. Pulsa **Guardar credenciales**.
5. 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

1. En la tarjeta **Probar conexión**, pulsa **Probar conexión**.
2. 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.

1. En la tarjeta **Webhook**, pulsa **Generar token**.
2. Copia el token en la ventana **Token del webhook generado**. Se muestra una sola vez.
3. En el Partner Portal de PedidosYa, abre **Shops Integrations**.
4. 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.
5. En el campo **secret** de los dos, pega el token tal cual, sin la palabra «Bearer».
6. 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:

1. [Registrar las tiendas y asignarles sucursal](https://ventix.smartbusiness.site/manual/pedidosya/tiendas-y-sucursales).
2. [Configurar cómo se facturan los pedidos](https://ventix.smartbusiness.site/manual/pedidosya/facturar-pedidos).
3. [Emparejar tus productos](https://ventix.smartbusiness.site/manual/pedidosya/emparejar-productos).
4. Si quieres, [enviar stock y precios](https://ventix.smartbusiness.site/manual/pedidosya/catalogo-precios-y-stock).

## 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](https://ventix.smartbusiness.site/manual/administracion/consultar-plan-y-suscripcion). |
| 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. |