> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hakumedia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cargar el catálogo

> Qué campos necesita cada producto y cómo se mantiene al día.

El catálogo es la base de todo: un producto que no está cargado no se puede patrocinar.

## Campos

Cada comercio define sus propias columnas. Seis son obligatorias:

| Campo           | Para qué se usa                                 |
| --------------- | ----------------------------------------------- |
| Identificador   | El SKU. Tiene que ser único dentro del catálogo |
| Título          | Búsqueda por texto                              |
| Descripción     | Búsqueda por texto                              |
| Marca           | Búsqueda por texto                              |
| ID del vendedor | Asocia el producto con su anunciante            |
| GTIN            | Código de barras (UPC o EAN)                    |

Las columnas adicionales, como precio, categoría, rating o disponibilidad, sirven para
filtrar los pedidos de anuncios y vuelven en la respuesta.

<Note>
  Los resultados que coinciden en título y marca se ordenan antes que los que coinciden
  solo en la descripción.
</Note>

## Crear el catálogo

Al crear el catálogo se declara la lista de columnas y cuál cumple cada rol:

```json theme={"dark"}
{
  "label": "Catálogo principal",
  "source": "database",
  "identifier_field": "sku",
  "title_field": "title",
  "description_field": "description",
  "seller_id_field": "seller_id",
  "gtin_field": "upc",
  "field_list": [
    "sku", "title", "brand", "description", "price",
    "type_name", "subtype_name", "rating", "upc",
    "availability_status", "seller_id"
  ]
}
```

<Warning>
  La asignación de columnas no se puede cambiar después de crear el catálogo, y cada
  publisher tiene un solo catálogo.
</Warning>

## Cargar productos

| Forma                   | Cuándo conviene                                 |
| ----------------------- | ----------------------------------------------- |
| Archivo CSV             | Carga inicial o actualización completa          |
| Un producto por llamada | Altas y cambios de precio o stock en el momento |

Un producto:

```json theme={"dark"}
{
  "item_data": {
    "sku": "777111222333",
    "title": "Zapatillas Runner Pro",
    "brand": "Runner",
    "description": "Zapatillas livianas para correr en asfalto.",
    "price": "59990",
    "type_name": "CALZADO",
    "subtype_name": "running",
    "rating": "4.5",
    "upc": "123123123123",
    "seller_id": "10001234"
  }
}
```

El detalle de cada llamada está en la [referencia de API](/api/introduccion).