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 integración

• Administración de credenciales y acceso

• Configuraciones y limitaciones de formato(s) de archivo

Requisitos previos de integración#

Para integrar correctamente las actualizaciones de catálogoa 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 Shops Integrations dentro del Partner Portal

      1. Lo anterior es predeterminado para todos los partners que utilizan nuestra plataforma. Si tienes algún problema con el acceso a nuestros plugins, pónte en contacto con tu AM

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

3. **Catálogoactivo:** Los artículos deben estar asociados correctamente entre nuestro catálogode artículos y las tiendas de su cadena

4. Credenciales válidas: Necesarias para acceder a nuestro servidor central SFTP. Solicita credenciales válidas a tu 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. Acceder a una aplicación/software FTP

   • Ten acceso a una aplicación/Software FTP (ej. Filezilla) que te permitirá acceder al servidor de PedidosYa.

2. URL del host:

   • En la aplicación FTP deberás introducir: 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 introdujo antes, hay 2 tipos de formatos de archivo que puedes adoptar.
A continuación, puedes aprender sobre la configuración de cada uno y los detalles sobre sus capacidades y limitaciones.

• Formato de archivo doble para una sola tienda

• Formato de archivo doble para múltiples tiendas

Formato de archivo doble para una sola tienda#

• La actualización de catálogo y promociones se envía en dos archivos diferentes.

• Este formato está destinado a actualizar el catálogo de una sola tienda a la vez.

• El archivo de actualización para el catálogo debe enviarse al subdirectorio catalog

• El archivo de actualización para las Promociones debe enviarse al subdirectorio promotions

• Patrón de nomenclatura de archivos: <prefix>_<vendor_id>.csv, donde prefix puede ser cualquier cosa y vendor_id es el id de tienda externo definido en el Partner Portal o el id de tienda de la plataforma si no está configurado.

• Tiempo de procesamiento del archivo:

  • Máximo 15 minutos para archivos Catalog

• Limitaciones:

  • Límite de filas (incluido el encabezado de la columna): 1.5 millones

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

• Ejemplo de formato para la actualización de Catalog:

Formato de archivo doble para múltiples tiendas#

• La actualización de catálogo y promociones se envía en dos archivos diferentes.

• Este formato está destinado a actualizar el catálogo de más de una tienda en un solo archivo.

• El archivo de actualización para el catálogo debe enviarse al subdirectorio catalog

• El archivo de actualización para las Promociones debe enviarse al subdirectorio promotions

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

• Tiempo de procesamiento del archivo:

  • Máximo 15 minutos para archivos de catálogo

  • Máximo 50 minutos para archivos de promociones

• Limitaciones para los archivos de Catalog:

  • Límite de filas (incluido el encabezado de la columna): 1.5 millones

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

• Ejemplo de formato para la actualización de Catalog de múltiples tiendas: