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 |
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:
- Las claves en
camelCase(imageLink,salePrice) se leen igual que sus equivalentes con guion bajo. - El precio puede ser un número, un texto (
"29.99 EUR") o un objeto convalueoamount. - Las categorías pueden ser un texto separado por
|o una lista de textos.
[
{
"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.
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 (se entienden
29,99,29.99 EURy1.299,00 €) - URL de imagen que no empiece por
https:// - Producto sin
id,title,priceoimage
Los productos descartados quedan registrados en el log de indexación del panel, en Sitios → Ver logs.