ES - Mejores prácticas y recomendaciones para estructurar tu catálogo (Feed)

Owned by María Álvarez Rodríguez
Last updated: Apr 23, 2021
5 min read

¡Tu catálogo es muy importante para nosotros y queremos aprovecharlo al máximo!

Antes de enviar un catálogo, con los datos de todos los productos/servicios y su comportamiento asociado, es importante tener en cuenta una serie de pasos para que Empathy pueda reconocerlo.

Formato

Los archivos Feed deben enviarse en formato XML / Json o Zip que los contenga.

El encoding del archivo deberá ser “utf-8”

Tipos de Feed

Pueden ser de dos tipos:

  • Catálogo (feed completo):
    • Un feed con todos los idiomas → deberá contener un campo de idioma 
    • Un feed por idioma
  • Deltas: tipos:
    • Actualizar datos (reemplazar datos no válidos por otros válidos)
    • Borrar datos.
    • Insertar datos.

Campos Requeridos:

Existen unos campos mínimos requeridos para que el Feed sea válido: 

  • ID: identificador de cada producto
    • Debe ser único
  • Nombre:
    • String del nombre de un producto 
  • Imagen:
    • Url de la imagen (no deberá estar rota o cortada)
    • Dimensiones de la imagen
  • Url del Producto:
    • Url del producto (no deberá estar rota o cortada)
  • Precio:
    • Formato en número
  • Categoría:
    • Debe seguir una jerarquía (ver ejemplo más abajo)
  • Idiomas:
    • Puede ser:
      • un feed por idioma
      • un feed con todos los idiomas: deberá contener un campo de idioma 

NOTA: Ninguno de los campos anteriores debería venir vacío.

Campos deseados:

Además, sería ideal poder disponer de campos extra como:

  • Id de Categoría:
    • Un único valor para cada categoría
  • Descripción:
    • Debe ser específica para cada producto
  • Precio rebajado:
    • Formato en número
  • Color:
    • Formato de valor CSS
    • Nombre común (mejor "azul" que "aguamarina")
  • Imagen adicional
  • Marca

Ejemplo en formato XML:


Ejemplo en formato JSON:


JSON example 
[
    {
        "id_product": "119040",
        "id_manufacturer": "323",
        "reference": "119040-0",
        "name": "Camiseta The Mandalorian Star Wars retro",
        "link": "https://www.customer.com/camiseta-the-mandalorian-star-wars-retro.html",
        "includes": "",
        "description": "Camiseta con simbolo mandaloriano para que puedas lucir todo el poder de la fuerza",
        "brand": "Disney",
        "image": "https://www.customer.com/media/i/img_397.jpg",
        "thumb": "https://www.customer.com/media/i/cache/image/240x240/q3df78eab93725d0gs685fb8d27136e9p/i/m/img_397.jpg",
        "visualizations": "0",
        "conversion_rate": "0",
        "sales_period": "0.000",
        "sales_total": "0",
        "available_date": "",
        "stock": 0,
        "colour": "grey",
        "discount_type": "",
        "tematicas": [
            {
                "id": "370",
                "name": "Star Wars"
            },
            {
                "id": "1968",
                "name": "The Mandalorian"
            }
        ],
        "category": [
            {
                "id": "292",
                "name": "Ropa"
            },
            {
                "id": "293",
                "name": "Camisetas & Camisas"
            },
            {
                "id": "358",
                "name": "Merchandising"
            },
            {
                "id": "446",
                "name": "Moda"
            }
        ],
        "price": 19.99,
        "price_discounted": 16.99,
        "skus": [
            {
                "id_product_attribute": "0934751",
                "reference": "119040-119234",
                "visualizations": null,
                "conversion_rate": "0.0000",
                "sales_period": "0",
                "sales_total": null,
                "available_date": "",
                "size": "S",
                "stock": "0"
            }
        ]
    }
]



¿Cuándo sería un Feed No Válido?

  • Formato Incorrecto: tags sin cerrar, comas que puedan faltar....
  • Codificación Incorrecta: de los caracteres dentro del Feed


Siguiendo estas sencillas instrucciones será mucho más sencillo empezar a trabajar con un Feed Correcto (smile)