Tu configuración de integración está en el nivel de la cadena (razón social). Si se incorporan nuevas tiendas a las cadenas integradas existentes, no será necesario realizar desarrollos adicionales. Solo tienes que informar a tu Account Manager de que tienes una nueva tienda y él la creará en nuestros sistemas. A continuación, puedes utilizar el mismo token y el identificador correcto para el nuevo punto de venta (Vendor ID) al enviar la solicitud.

¿Puedo obtener el token yo mismo?#

Sí, puedes generar tokens por tu cuenta. Debes tener acceso al plugin Shops Integrations en el Partner Portal.

¿Cómo encuentro mi Vendor ID?#

Ponte en contacto con tu Account Manager para obtener el Vendor ID.

¿Cuántos tokens puedo generar?#

Puedes generar hasta 11 tokens de API en el Partner Portal. Se trata de tokens de portador que no tienen fecha de caducidad y son aplicables a nivel de cadena, lo que significa que una sola clave de API puede gestionar todos las tiendas de una cadena.

¿Qué pasa si ya tengo Vendor IDs internos y no quiero usar los IDs de PedidosYa para los identificadores de tienda?#

Si tienes tus propios Vendor IDs, puedes utilizarlos. Simplemente, asigna tus IDs en el Partner Portal en la sección "Vendor Identifier", como se muestra en la siguiente captura de pantalla, y vincula tu Vendor ID externo al Vendor ID de PedidosYa.

¿Puedo crear la misma promoción para varias tiendas?#

Sí. Se puede hacer en el parámetro "vendors" (puede ser el ID de la plataforma o el ID externo del partner asignado en el Partner Portal). Si vendors = [*] la promoción se aplicará a todos las tiendas asociadas a la cadena.

¿Qué tipos de promociones puedo crear?#

Descuentos de precio tachado (descuento de valor absoluto, descuento porcentual, precio final).

Si envío dos solicitudes para el mismo SKU: una para promoción de precio tachado y otra para promoción BOGO con diferentes fechas superpuestas, ¿qué se verá en la interfaz?#

La promoción que tenga un start_time posterior será visible después de que se superponga a la primera promoción.

¿Puedo modificar la fecha de finalización de una promoción activa?#

Primero debes desactivar la promoción anterior "active": false y enviar una nueva solicitud con nuevas fechas.

¿Puedo eliminar solo uno o algunos SKUs de la promoción?#

Sí, añadiendo los SKUs pertinentes al parámetro "discount" y, a continuación, estableciendo "active" como "false".

¿Puedo usar SKU o código de barras para las actualizaciones?#

No, solo se admite SKU.

¿Cuáles son las limitaciones del Partner API/Promociones?#

Las promociones creadas a través de la API deben modificarse a través de la API
Para modificar/eliminar una promoción, se requiere la misma solicitud de cuerpo
Actualmente, no hay visibilidad de errores a nivel de artículo cuando se utiliza el Partner API/Promociones
No es posible crear promociones para diferentes SKUs y diferentes tiendas en una sola solicitud

¿Puedo desactivar las promociones?#

Sí, se puede hacer con la solicitud PUT, estableciendo el parámetro "active" como "false".

¿Cuál es el límite de tamaño de la campaña?#

El Partner puede crear hasta 2 millones de promociones en una sola solicitud (skus*vendors)

¿Cuándo puedo esperar que la promoción sea visible en la interfaz después de crearla a través de la API?#

La creación de la promoción puede tardar un máximo de 50 minutos si la solicitud alcanza la capacidad máxima

¿Puedo crear una promoción para todas las tiendas dentro de la cadena?#

Si vendors = [*] la promoción se aplicará a todos las tiendas asociadas a la cadena.

Los precios de descuento cambian durante la campaña, ¿tenemos que desactivar la primera campaña o podemos reemplazarla con un nuevo precio de descuento?#

Si el precio de descuento cambia durante la campaña, puedes enviar la solicitud para el SKU cuyo precio se ha modificado con nuevas fechas y nuevos precios, en este caso nuestro sistema priorizará la fecha de inicio más reciente y activará la nueva promoción.

¿Cómo desactivo una campaña?#

Puedes desactivar la campaña enviando "active": false en la solicitud.

¿Qué sucede si el mismo SKU se incluye en varias promociones?#

La promoción con la fecha de inicio más reciente anulará las anteriores.

¿Por qué mi promoción no se muestra en la interfaz?#

Comprueba si:

discounted_price < precio original
start_date está en el futuro y el formato es correcto
El SKU está activo en el catálogo
Ha pasado el tiempo de sincronización (hasta 50 minutos)

¿Cómo accedo al plugin Shops Integrations?#

Puedes acceder al plugin Shops Integrations en el Partner Portal, tu Account Manager te dará acceso o durante el registro con nosotros.
Se recomienda limitar el acceso a los plugins de tiendas en el Partner Portal solo a aquellos que necesiten realizar una función para tu negocio, ya que el Partner Portal puede contener información confidencial, es decir, configuraciones de webhook, tokens de acceso.
Ponte en contacto con tu Account Manager si no sabes cómo obtener acceso al Partner Portal

¿Dónde puedo consultar mis promociones?#

Ofrecemos complementos de Promociones de tiendas accesibles a través de la cuenta del Partner Portal de la tienda que te permitirán consultar las promociones actuales.

¿Dónde puedo obtener más asistencia?#

Si tienes alguna pregunta sobre la integración puedes contactar al equipo Soporte de Integraciones a través del correo [email protected] o agendando una reunión en este link.

Si tienes un issue, pónte en contacto con el equipo de Soporte de Integraciones en el correo [email protected] y proporciona: