Mapeo de campos

Tu feed casi nunca usa exactamente nuestros nombres de campo. El mapeo es la capa que traduce tu columna/etiqueta (sku, pvp, existencias…) a nuestro campo (id, price, stock…). Funciona igual para CSV, XML y JSON.

Auto-detectamos primero. Si no defines mapeo, deducimos cada campo por el nombre de la columna o etiqueta (en español e inglés, y formatos como Google Merchant o Doofinder). Solo rellenas a mano lo que no acertemos.

Campos destino

Campo	Tipo	Notas
`id`	texto	Obligatorio. Identificador único en tu fuente (SKU, referencia…).
`title`	texto	Obligatorio. Nombre del producto/contenido.
`url`	texto	Enlace a la ficha. Si falta, generamos uno sintético.
`image`	texto	URL de la imagen (resolvemos relativas a absolutas).
`description`	texto	Descripción.
`price`	número	Precio actual.
`originalPrice`	número	Precio anterior/tachado → badge En oferta.
`stock`	entero	Unidades.
`availability`	texto	Disponibilidad textual → se traduce a stock (ver abajo).
`featured`	booleano	Destacado.
`category`	lista	Una o varias categorías.
`brand` / `sku` / `gtin`	texto	Se guardan en `attributes`.

Alias que auto-detectamos

Campo	Reconocemos (entre otros)
`id`	`id`, `sku`, `referencia`, `ref`, `codigo`, `articulo`, `id_producto`
`title`	`title`, `name`, `nombre`, `titulo`, `denominacion`
`url`	`url`, `link`, `enlace`, `ficha`, `url_ficha`, `permalink`
`image`	`image`, `imagen`, `img`, `image_link`, `foto`, `imagen_url`
`price`	`price`, `precio`, `pvp`, `sale_price`, `precio_venta`, `precio_actual`
`originalPrice`	`original_price`, `pvpr`, `precio_original`, `precio_anterior`, `list_price`
`stock`	`stock`, `existencias`, `unidades`, `cantidad`, `qty`, `inventory`
`availability`	`availability`, `disponibilidad`, `disponible`, `in_stock`, `stock_status`
`category`	`category`, `categoria`, `familia`, `seccion`, `product_type`
`brand`	`brand`, `marca`, `fabricante`, `manufacturer`
`gtin`	`gtin`, `ean`, `ean13`, `upc`, `barcode`

En XML ignoramos el prefijo de namespace, así que g:price se auto-detecta como price, g:image_link como image, etc.

Conversión de tipos (lo hacemos por ti)

Números con formato local: 1.299,00 y 1,299.00 y 39,95 se entienden todos como el mismo número. Los negativos se descartan.
Disponibilidad → stock: in stock / disponible / sí / true / 1 → hay stock; agotado / out of stock / no / 0 → sin stock (badge Agotado). Si ya mapeaste un stock numérico, ese manda.
Categorías: una cadena tipo Hogar > Cocina > Sartenes (o separada por |, ;, ,) se convierte en lista ["Hogar","Cocina","Sartenes"].
Campos vacíos: se omiten (no pisan con valores en blanco).

Demo: de un CSV a documentos

Imagina que exportas esto de tu base de datos (separador ;):

csv

sku;denominacion;pvp;pvpr;existencias;enlace;img;familia;disponible
A-100;"Sartén 24 cm, antiadherente";29,95;39,95;12;https://tienda.com/p/a-100;https://tienda.com/img/a-100.jpg;Hogar > Cocina > Sartenes;sí
A-101;Cuchillo chef;18,50;;0;https://tienda.com/p/a-101;https://tienda.com/img/a-101.jpg;Hogar > Cocina;no

Sin configurar nada, lo auto-detectamos así:

Tu columna	→ Campo Mibizum
`sku`	`id`
`denominacion`	`title`
`pvp`	`price`
`pvpr`	`originalPrice`
`existencias`	`stock`
`enlace`	`url`
`img`	`image`
`familia`	`category`
`disponible`	`availability`

Y el primer producto queda como:

json

{
  "id": "A-100",
  "docType": "product",
  "title": "Sartén 24 cm, antiadherente",
  "url": "https://tienda.com/p/a-100",
  "image": "https://tienda.com/img/a-100.jpg",
  "price": 29.95,
  "originalPrice": 39.95,
  "stock": 12,
  "category": ["Hogar", "Cocina", "Sartenes"],
  "attributes": { "availability": "sí" }
}

Fíjate: 29,95 se entendió como 29.95, pvpr (precio anterior) activará el badge de oferta, y la familia se partió en una jerarquía. El segundo producto, con existencias = 0 y disponible = no, queda con stock: 0 (badge Agotado).

¿Una columna con nombre raro?

Si tu export usa un nombre que no reconocemos (p. ej. cod_barras_int para el GTIN, o precio2 para el precio), lo mapeas a mano:

json

{
  "feedUrl": "https://tienda.com/export/productos.csv",
  "delimiter": ";",
  "mapping": {
    "price": "precio2",
    "gtin":  "cod_barras_int"
  }
}

El mapeo manual se combina con el auto-detectado: solo defines lo que haga falta corregir; el resto se sigue deduciendo solo.

Pruébalo en vivo

El paso "Probar ingest" del onboarding descarga tu feed real y te enseña los primeros documentos ya mapeados, para ajustar antes de conectar.

Mapeo de campos ​

Campos destino ​

Alias que auto-detectamos ​

Conversión de tipos (lo hacemos por ti) ​