Getting Started

Formatos de Feed

Koply acepta feeds en XML, CSV y JSON para importar tu catálogo de productos. El formato se detecta por el contenido del archivo, no por la extensión de la URL.

Google Shopping XML

Es el formato recomendado y el que ofrece mayor calidad de datos. Si ya tienes un feed de Google Shopping configurado en tu tienda, puedes usar la misma URL directamente en Koply.

Campo Obligatorio Variantes aceptadas
id ✓ g:id, sku
title ✓ g:title, name
price ✓ g:price
image ✓ g:image_link, image_url, picture
link ✓ g:link, url, product_url
description — g:description
brand — g:brand, manufacturer
product_type — g:product_type, category, categories
sale_price — g:sale_price
Tolerancia de campos: Koply detecta automáticamente los nombres de campo con o sin prefijo g:. No necesitas adaptar tu feed existente.

CSV

Útil si tu plataforma exporta el catálogo en formato tabla. Koply detecta automáticamente el separador (coma, punto y coma, tabulador o barra vertical) y soporta codificaciones UTF-8 e ISO-8859-1. La primera fila debe ser la cabecera.

Los nombres de columna no distinguen mayúsculas ni espacios (Image Link, image_link e imageLink son lo mismo) y se aceptan las columnas de un feed de Google Shopping (image_link, link, product_type, sale_price) y las de una exportación de WooCommerce (SKU, Name, Regular price, Images). Si una columna Images trae varias URLs, se usa la primera.

Columna Obligatorio Notas
id ✓ Identificador único del producto
title ✓ Nombre del producto
price ✓ Precio numérico. Ej: 19.99
image ✓ URL completa de la imagen, debe empezar por https://
url ✓ URL de la página del producto
brand —
categories — Categorías separadas por |
description —
sale_price — Precio de oferta. Si está presente se muestra tachado el precio original.

Ejemplo de cabecera CSV válida:

id,title,price,image,url,brand,categories,description,sale_price

JSON

Para tiendas que exponen el catálogo desde una API o un archivo .json. Koply acepta una lista de productos, un objeto que la contenga (products, items, data...) o un producto por línea (JSON Lines). Cada producto usa los mismos campos que el CSV, con estas particularidades:

[
  {
    "id": "SKU-001",
    "title": "Silla de oficina",
    "price": { "value": "89.90", "currency": "EUR" },
    "imageLink": "https://tutienda.com/img/sku-001.jpg",
    "link": "https://tutienda.com/silla-de-oficina",
    "categories": ["Oficina", "Oficina > Sillas"]
  }
]

Sitemap XML

Koply puede leer un sitemap.xml estándar para indexar las URLs de tus productos. Es la opción con menos datos disponibles, ya que el sitemap no incluye precios ni imágenes de forma nativa.

Limitaciones del Sitemap: Al no contener precio ni imagen directamente, Koply hará un scraping ligero de cada URL para extraerlos. Esto puede hacer que la primera indexación sea más lenta y que algunos productos queden sin imagen si el scraping no puede acceder a ellos.

Para catálogos con muchos productos o si necesitas la máxima calidad de datos, usa Google Shopping XML o CSV en su lugar.

Validaciones comunes

Independientemente del formato, Koply descarta productos que incumplan estas reglas:

Los productos descartados quedan registrados en el log de indexación del panel, en Sitios → Ver logs.