Cómo integrarte#

Esta sección cubre los aspectos básicos de cómo integrarte. Haz clic en los siguientes enlaces para acceder a cada sección del proceso de integración según sea necesario, o simplemente desplázate hacia abajo en la página:

• Requisitos previos de integración

• ¿Qué necesitas desarrollar para completar la integración?

• Administración y acceso de tokens

• Acceso a los Endpoints de Producción

Requisitos previos de la integración#

Para ser elegible para esta integración, debes tener lo siguiente:

• Solución de picking propia: Ya estás utilizando tu propia solución de picking interna o de terceros para cumplir con los pedidos.

• Capacidad de desarrollo de API: la capacidad de desarrollar una API internamente o acceder a soporte de terceros para el desarrollo de API.

• Preparación técnica: debes tener la capacidad técnica y la infraestructura para recibir actualizaciones de pedidos en su webhook.

Si cumples con ambos requisitos, estás listo y puedes comenzar el proceso de integración. Para integrarte con nuestra Partner API, también debes ser uno de nuestros partners y asegurarte de tener:

• Acceso a Partner Portal: una herramienta de back office mediante la cual puedes supervisar los pedidos, las operaciones de la tienda, exportar los pedidos, administrar el catálogo en varias tiendas.

  • Haz clic aquí para obtener más información sobre qué es Partner Portal.

• Acceso al plugin Shops Integracions: este plugin de Vendor Portal te permite configurar el webhook y generar el token.

  • Haz clic aquí para obtener más información sobre cómo acceder al plugin Shops Integrations

  • Poseer una tienda de pruebas: debes tener una tienda de pruebas en nuestra plataforma correctamente configurada en PedidosYa

¿Qué necesitas desarrollar para completar la integración?#

En términos generales, hay dos cosas que debes hacer:

1. Configure un Webhook para recibir eventos de pedidos

   • Desarrolla un webhook para recibir eventos de pedidos en vivo

   • Asegúrate de que el webhook esté listo para recibir actualizaciones de cualquier modificación durante el ciclo de vida del pedido (por ejemplo, cambios de estado, cancelaciones)

2. Integrarte con los Endpoints de Partner API

   • Para comenzar a utilizar los endpoints, vas a necesitar tener un chainID, que será utilizado en la URL de la solicitud. Podés solicitar tu chain ID a tu Account Manager o encontrarlo directamente en el plugin de Shops Integrations, dentro de la URL:

     

   • Utiliza el endpoint PUT para modificar los pedidos según sea necesario

   • Utiliza el endpoint GET para recuperar información de pedidos de los últimos 60 días siempre que sea necesario.

     ¡Asegurar tu webhook es obligatorio!

     Por favor, consultá los FAQs

Administración y acceso de tokens#

¿Qué es un token y cómo lo uso?#

Un token API de tipo Bearer es una forma de demostrar quién sos cuando hacés solicitudes a una API. Forma parte del estándar OAuth 2.0 y se incluye en los headers de la solicitud para indicar que estás autorizado a acceder a ciertos datos o servicios.

¿Cómo funciona?#

• Obtén Client ID y Secret: use el Plugin de Shops Integratrions para obtenerlo

• Crea el Token: Al enviar la solicitud a la API incluyendo el Client ID y el Secret, vas a recibir un token de API que es válido por 2 horas.

• Use el token: cada vez que realices una solicitud a la API, incluye el token en el encabezado

¿Por qué es útil?#

• No es necesario usar nombres de usuario y contraseñas en cada solicitud.

• El servidor no tiene que recordar quién eres (solo verifica el token).

¿Qué necesito para acceder a él?#

Solo los usuarios con acceso al Plugin de Shops Integrations en Partner Portal pueden generar el token bearer de API desde la administración de tokens en la sección de configuración.

Pasos para la autenticación y el acceso a la API#

1. Generar un Token de API#

   • Paso 1: Ve a Partner Portal > Shops Integrations.

   • Paso 2: Ve a Configuración > API > Sección de administración de tokens, ingresa un nombre basado en tu caso de uso y genera un client_id y client_secret.

   • Paso 3: Realizá una solicitud para para obtener tu access_token en el siguiente endpoint:

https://pedidosya.partner.deliveryhero.io/v2/oauth/token

Incluí tu access_token en el header Authorization de cada solicitud que hagas a la Partner API. Antes del access_token, agregá la palabra Bearer seguida de un espacio:

Authorization: Bearer <access_token>

Cosas importantes que debes recordar sobre los tokens de API#

• Asegurate de guardar tu client_id y client_secret en un lugar seguro; los vas a necesitar cada vez que solicites un token.

• Podés crear hasta 10 client_id dentro de tu chain.

• Cuando generás un token, este expira en 2 horas.

• El token generado es válido para todas las tiendas dentro de tu chain.

• Para acceder al Partner Portal o a Shops Integrations, por favor contactá a tu Account Manager.

Endpoints de producción: Partner API/Orders#

• Consulta la sección aquí, que contiene un desglose del contexto y los usos/enlaces a los endpoints.