fbpx

Especificación de feed de productos (CSV)

El conjunto de productos sobre los cuales se busca se define en un archivo que contiene todos los productos activos, junto con sus imágenes, categorías y otros campos textuales.

 

Especificación de CSV de Impresee v1.0

El conjunto de productos para realizar las búsquedas se puede describir mediante un CSV. Este archivo contiene toda la información del producto necesaria para realizar búsquedas y mostrar resultados de búsqueda: categorías, imágenes y atributos textuales del producto. El archivo CSV tiene la siguiente estructura:

Id Title URL Image URL [Description] [Price] [Category] [Normal Price]

Los diferentes valores deben especificarse entre comillas dobles (” “). Los valores deben estar separados mediante comas (“,“). Los valores entre [ ] son opcionales. En caso de que el valor no exista se debe dejar en blanco (ejemplo: “valor,, valor”). Ten en cuenta que el orden de las columnas es fijo, eso significa que la primera columna es el valor del sku, la segunda es el título del producto y así sucesivamente.

  • El atributo Id define el código del producto, el cual debe ser único dentro del catálogo. Normalmente es la SKU del producto, aunque puede ser cualquier otro ID.
  • El Title corresponde al título (o nombre) del producto.
  • El atributo URL es el enlace a la página de la tienda, donde se pueden encontrar los detalles del producto.
  • El atributo Image URL es una URL pública donde se encuentra la primera imagen de cada producto, o sea la principal. Los servidores de Impresee descargarán la imagen del producto desde esta URL.
  • El atributo Description corresponde a la descripción detallada del producto. Esta descripción se utiliza en la búsqueda basada en texto.
  • El atributo Price es el precio del producto.
  • El atributo Category define la categoría a la que pertenece el producto.

A continuación se puede encontrar un ejemplo de un catálogo en este formato:

Observaciones

  • NO incluya el encabezado (con el nombre de las columnas) como la primera fila del archivo.
  • Si algún valor contiene una coma (,), el valor DEBE estar entre comillas dobles.
  • Cualquier carácter especial (carácter de nueva línea, comillas dobles, entre otros) debe tener carácter de escape.

Sincronización del feed de productos

En la consola de administración de Impresee puedes configurar la URL donde descargar el archivo, el formato del archivo (XML, CSV u otro) y la frecuencia de actualización, ya sea a una hora del día (p. ej. a las 00:00), cada cierto periodo de tiempo (p. ej. cada 2 horas), manualmente, etc.

En el caso de la actualización automática, cuando se cumple el criterio de tiempo, Impresee descarga la URL, procesa los datos descargados y actualiza los productos en el motor de búsqueda.

Para las actualizaciones manuales, debes acceder a la consola de administración de Impresee y hacer clic en el botón actualizar. También puedes invocar el siguiente servicio para activar una actualización del catálogo: 

https://api.impresee.com/ImpreseeAdmin/api/v1/rest/update_now/{catalog_code}

Para obtener tu catalog_code por favor contáctanos a support@impresee.com.