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

¡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:

[
    {
        "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