Si tienes tus propios Vendor IDs, puedes usarlos. Simplemente mapea tus IDs en el Partner Portal en la sección "Vendor Identifier" de Shops Integrations, como se muestra en la captura de pantalla a continuación, y vincula tu Vendor ID externo al Vendor ID de PedidosYa.

Si ya tengo una integración y quiero incorporar nuevas tiendas, ¿cómo puedo integrarlas?#

Tu configuración de integración está a nivel de cadena (razón social). Si se incorporan nuevas tiendas a la razón social integrada existente, no habrá necesidad de desarrollo adicional. Puedes usar las mismas credenciales. Asegúrate de enviar el archivo para la nueva tienda con el código de vendedor correcto en el nombre del archivo.

¿Cuál es la frecuencia de carga recomendada?#

Contrariamente al sentido común, más cargas no significan mejores valores de falta de stock. Te aconsejamos que ejecutes una carga de catálogo completo a primera hora y luego envíes deltas (solo los productos que se actualizaron) para tiempos de actualización más rápidos (siempre teniendo en cuenta cuándo se actualiza el inventario en tu sistema).

¿Puedo usar SKU o Código de Barras para las actualizaciones?#

Sí, SKU y Código de Barras son compatibles. Sólo debes usar uno de ellos por producto.

¿Hasta cuántos decimales puede tener el precio?#

Solo se admiten los primeros tres decimales, por ejemplo: 4.5555555 dará como resultado 4.555

¿Cuál es el significado del campo quantity?#

No almacenamos el campo quantity; actúa como una referencia en comparación con el stock de seguridad ya configurado en el catálogo. Se utiliza para la desactivación o activación de productos cuando el quantity es menor o mayor que el stock de seguridad, respectivamente.

Ej. si envías la quantity como 3 y el stock de seguridad está configurado como 5, el producto se desactivará en el front end porque la quantity < stock de seguridad

Note

El stock de seguridad no se puede configurar a través de la API. Su valor por defecto es de 1 unidad para todos los productos.

¿Cuál debería ser el tiempo de sincronización esperado para el catálogo?#

Los cambios en el catálogo tardarán hasta 15 minutos en sincronizarse con la App.

¿Cómo veo las actualizaciones de catálogo en el Partner Portal?#

Los archivos de catálogo se pueden ver en el Plugin de Shops Integrations en el Partner Portal. Además, puedes descargar los archivos que se han subido y ver los errores si hay alguno ocurrido a nivel de artículo.

¿Dónde puedo verificar los precios de mis productos?#

Ofrecemos el plugin Gestor del Catálogo accesible a través de la cuenta del Partner Portal de la tienda que te permitirá verificar los precios actuales de los productos.

¿Debo usar el Vendor ID como nombre de archivo para ejecutar una actualización de catálogo de varias tiendas?#

No, el nombre del archivo debe establecerse como <prefix.csv>. No es necesario especificar ningún identificador especial si vas a actualizar el catálogo de varias tiendas. Importante: No uses "_" como parte del prefijo, ya que evitará que el archivo lea la columna "vendors".

Envié el mismo SKU dos veces en un archivo SFTP. ¿Qué pasa?#

Los SKUs duplicados harán que ambas líneas se ignoren.

¿Por qué no se actualiza el precio de un producto?#

Verifica los archivos SFTP que has subido en el Plugin Shops Integrations en el Partner Portal Causas comunes:

SKU no está en el catalog → Solución: Agrega el SKU a través de POST /catalog o Partner Portal.
Precio = 0 → Solución: Asegúrate de que el precio > 0.
SKU duplicado en el archivo → Solución: Elimina la duplicación.

¿Cuáles son los errores comunes observados para las actualizaciones SFTP procesadas fallidas?#

Formato de nombre incorrecto (ejemplo de errores comunes)
- qa_v4ft.csv → el sistema no leerá la columna de vendor en el archivo.
- qa.csv → no se encuentra el Vendor ID en el nombre del archivo → recurrimos a la búsqueda de la columna de vendor → si se encuentra → continúa, de lo contrario, falla.
Se usó una carpeta incorrecta en el servidor SFTP de PedidosYa para soltar el archivo; en este caso, el archivo será rechazado.
Si envías un precio 0 o negativo, la línea se ignorará
El SKU no existe en el catálogo; si no has agregado un SKU en particular a tu catálogo, no hay nada que actualizar, por lo tanto, la línea se ignorará y verás el error "Missing SKU"
Se envió un SKU duplicado; en este caso, ambas líneas se ignorarán.

¿Cómo veo las actualizaciones de catálogo en el Partner Portal?#

Los archivos de catálogo se pueden ver en el plugin Shops Integrations en el Partner Portal. Además, puedes descargar los archivos que se han subido y ver los errores si los hay, ocurridos a nivel de artículo.

¿Qué es el Partner Portal y cómo obtengo acceso?#

El Partner Portal es una herramienta administrativa diseñada para ayudar a los partners a administrar eficientemente sus tiendas en nuestra plataforma. Sirve como un punto central donde puedes revisar y controlar varias funciones de las operaciones de tu tienda. Una vez que estés incorporado, nuestro equipo de Account Management te proporcionará acceso al portal. A través del Partner Portal, podrás:

Ver tu catálogo de productos
Configurar e integrar las integraciones de la tienda
Supervisar las promociones
Definir los horarios de apertura y cierre de la tienda
Revisar los pedidos en todas tus tiendas
Identificar problemas y realizar la solución de problemas inicial

Plugins Clave: Plugin Shops Integrations Este plugin te permite administrar y revisar tus integraciones. Puedes:

Revisar las actualizaciones diarias de los trabajos para los archivos SFTP de Promoción y Catálogo
Ver las integraciones existentes y su estado
Acceder a los archivos SFTP subidos
Revisar el contenido de los archivos SFTP y verificar si hay errores que ocurrieron durante el proceso de carga
Pausar la integración

Plugin de Promociones de Tiendas Este plugin te brinda una descripción completa de todas las promociones creadas para tus tiendas. Puedes:

Revisar todas las promociones activas e históricas
Ver cómo se creó cada promoción (por ejemplo, a través de SFTP o API)
Ver información detallada que incluye la fecha de creación, la hora y los SKUs afectados
Verificar los precios promocionales y la programación

Note

Por favor, contacta a tu Account Manager para recibir acceso al Partner Portal.

¿Cómo accedo al Plugin Shops Integrarions?#

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 en el Partner Portal solo a aquellos que necesitan realizar una función para tu negocio; esto se debe a que el Partner Portal puede contener información confidencial, es decir, configuraciones de webhook, access tokens.
Por favor, contacta a tu account manager si no sabes cómo obtener acceso al Partner Portal

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

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: