Getting Started

Formatos de Feed

Koply acepta tres formatos de feed para importar tu catálogo de productos.

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 o tabulador) y soporta codificaciones UTF-8 e ISO-8859-1.

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

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:

Precio igual a cero o no numérico
URL de imagen que no empiece por https://
Producto sin id, title, price o image

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

Quick Start Solución de problemas