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:

• Prerrequisitos de integración

• Gestión de credenciales y acceso

• Configuraciones y limitaciones de formato(s) de archivo

Prerrequisitos de integración#

Para integrar correctamente las promociones a través de SFTP, se deben cumplir los siguientes requisitos:

1. Incorporación a los productos de Local Shops, incluyendo:

   1. Acceso al Partner Portal

   2. Acceso al plugin de integraciones dentro del Partner Portal

2. Configuración de ID de tienda externo: Si utilizas tus propios ID de tienda, asegúrate de que estén configurados correctamente.

3. Catálogo activo: Los artículos deben estar asociados correctamente entre nuestro catálogo de artículos y las tiendas de tu cadena.

4. Credenciales válidas: Necesarias para acceder a nuestro servidor central SFTP. Solicita credenciales válidas a su Account Manager.

5. Cliente SFTP: Debes ser capaz de enviar archivos CSV en el formato especificado, detallado en la sección ‘Sección de formato de archivo’

Credenciales y acceso al servidor de pedidosya#

1. Accede a una aplicación/software FTP

   • Ten acceso a una aplicación/software FTP (por ejemplo, Filezilla) que te permita acceder al servidor de PedidosYa.

2. URL del Host:

   • En la aplicación FTP deberás ingresar: vendor-automation-sftp-live-us.prod.aws.qcommerce.live

3. Credenciales:

   • Nombre de usuario

   • Contraseña

4. Puerto (punto final de comunicación) que siempre es 22, sin importar a qué cadena estés accediendo.

Configuraciones y limitaciones de formato(s) de archivo#

Como se presentó anteriormente, hay 2 tipos de formatos de archivo que puede adoptar.
A continuación, puedes obtener información sobre la configuración de cada uno y detalles sobre sus capacidades y limitaciones.

• Formato de archivo doble para una sola tienda

• Formato de archivo doble para múltiples tiendas

Se requiere el cumplimiento de al menos uno de los formatos de archivo disponibles como se describe a continuación para una integración SFTP totalmente funcional. Para permitir una sincronización adecuada, los archivos deben seguir convenciones de nomenclatura específicas:

Formato de archivo doble para una sola tienda#

• Las actualizaciones de catálogo y promociones se envían en dos archivos separados.

  • Este formato está diseñado para actualizar las promociones de una sola tienda a la vez. Sin embargo, se pueden incluir varias promociones para la misma tienda, lo que te permite crear promociones para diferentes fechas dentro de un solo archivo.

    • El archivo de actualización para promociones debe cargarse en el subdirectorio Promotions.

  • Patrón de nomenclatura de archivos: <prefix>_<vendor_id>.csv

    • El prefix puede ser cualquier valor elegido

    • El vendor_id se refiere al ID de tienda externo definido en el Partner Portal o al ID de tienda de la plataforma si no se ha configurado ningún ID de tienda externo.

• Tiempo de procesamiento del archivo: máx. 50 minutos

• Limitaciones:

  • Límite de filas (incluido el encabezado de la columna): 20K

  • Límite de SKU: 19,999

  • Tamaño máximo de archivo: 200 MB

  • Conteo de promociones: 1000 en un archivo (promociones con diferentes fechas)

• Ejemplo de formato:

Formato de archivo doble para múltiples tiendas#

• Las actualizaciones de catálogo y promociones se envían en dos archivos separados.

  • Este formato está diseñado para actualizar las promociones de múltiples tiendas dentro de un solo archivo.

  • El archivo de actualización para promociones debe cargarse en el subdirectorio Promotions.

    • Patrón de nomenclatura de archivos: <prefix>.csv, el nombre de archivo no debe tener ningún guión bajo, por ejemplo: Testchain.csv

• Tiempo de procesamiento del archivo: máx. 90 minutos

• Limitaciones:

  • Límite de filas (incluido el encabezado de la columna): 20K

  • Límite de SKU: 99,999

  • Número máximo de productos (SKU x Vendors): 300K

  • Tamaño máximo de archivo: 200 MB

  • Conteo de promociones: 1000 en un archivo (promociones con diferentes fechas)

• Ejemplo de formato: