Cómo integrarte#

Esta sección cubre los aspectos básicos de cómo integrarse. 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 la integración#

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

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

Para integrarte con nuestra API para partners, también debes ser uno de nuestros partners y asegurarte de tener:

Acceso a Partner Portal (nuestro portal de autoservicio para partners)
- Haz clic aquí para obtener más información sobre qué es Partner Portal.
Acceso al Plugin de Shops Integrations en Partner Portal
- Haz clic aquí para obtener más información sobre cómo acceder al Plugin de Shops Integrations.
Uno o más productos existentes en Catalog para enviar las actualizaciones

¿Qué se requiere para completar la Integración?#

Integrarse con los endpoints PUT, GET y POST

PUT para actualizar la información del producto, como el estado, el precio y la cantidad.
POST para crear una solicitud para exportar todo el catálogo de la tienda.
GET: tenemos 3 endpoints GET diferentes
- Para descargar los registros de trabajos de actualización masiva de productos (los resultados provienen de la solicitud PUT)
- Para revisar las categorías del catálogo
- Para recuperar los productos listados.

Configurar un Webhook para recibir los datos del producto

Para recibir la información actualizada del producto a nivel de artículo
Para exportar un catálogo completo a nivel de tienda

Administración y acceso de tokens#

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

Un token de API de portador es una forma de demostrar quién eres al realizar solicitudes a la API. Es parte del estándar OAuth 2.0 y se incluye en los encabezados de la solicitud para mostrar que tienes permiso para acceder a ciertos datos o servicios.

¿Cómo funciona?#

Obtén el token: use el Plugin de Shops Integratrions
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#

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.
- Paso 3: Genera un bearer token. Puedes crear hasta 11 tokens y no tienen vencimiento.
Asegura tus tokens#
Asegúrate de que los tokens estén almacenados de forma segura y no se compartan con los equipos de soporte.

Aquí se explica cómo generar tu token:

Cosas importantes que debes recordar sobre los tokens de API#

Cuando creas un token, ¡nunca caduca! Asegúrate y realiza un seguimiento de tus tokens de API, y nunca los compartas con otras personas, ni siquiera con nuestro equipo de soporte.
A cada token de API se le debe asignar un nombre específico que corresponda a su caso de uso previsto, por ejemplo: Gestión de Catálogo, Gestión de Órdenes, Gestión de Promociones.
Se pueden crear hasta 11 tokens a la vez
Los tokens son válidos para todas las tiendas de tu cadena (razón social)
Dado que los tokens se administran a través del Plugin de Shops Integrations, es recomendable limitar el acceso a ese Plugin a las personas de tu organización que realmente lo necesiten.
Para acceder a Partner Portal o al plugin Shops Integrations, comunícate con tu Account Manager