Emparejar productos
Un proveedor llama a un producto 'Mouse Inalámbrico Neg 2.4G' y su catálogo lo llama 'Mouse Óptico Inalámbrico Negro': sin ID compartido, sin coincidencia exacta de texto, solo dos personas describiendo el mismo producto de forma distinta. Este endpoint lee ambos lados y determina cuáles filas son en realidad el mismo artículo, así que fusionar catálogos deja de ser una semana de cruces manuales en hojas de cálculo.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
El problema, sin rodeos
Cualquiera que haya fusionado el listado de un proveedor con un catálogo interno conoce el dolor: los SKU no coinciden, cada proveedor redacta los nombres de producto a su manera, y una búsqueda simple solo detecta el puñado de artículos que por casualidad están escritos de forma idéntica. Multiplique eso por un distribuidor con diez mil SKU y un minorista que integra tres proveedores nuevos cada trimestre, y la conciliación manual se vuelve un trabajo recurrente, tedioso y propenso a errores que alguien teme cada vez que llega una lista de precios nueva.
Qué hace el emparejamiento en realidad
Envía su catálogo y la lista de artículos del proveedor, y la tarea corre de forma asíncrona, devolviendo un task_id de inmediato. Compara cada artículo del proveedor contra su catálogo por significado y atributos en lugar de exigir una coincidencia exacta de texto, y devuelve las mejores coincidencias ligadas a ese task_id, entregadas mediante webhook firmado o un enlace firmado de 24 horas, así obtiene una tabla de correspondencias que puede revisar o aplicar automáticamente.
Por qué la coincidencia exacta nunca fue suficiente
Estándares de código de barras como UPC y EAN resolvieron la identificación de productos hace décadas, en teoría, pero en la práctica los proveedores suelen omitirlos, usar códigos internos en su lugar, o listar variantes bajo descripciones ligeramente distintas. El emparejamiento difuso existe precisamente porque el mundo real no entrega identificadores limpios y compartidos, entrega 'Neg' en vez de 'Negro' y nombres de marca abreviados, y el emparejamiento tiene que leer más allá de ese ruido hasta llegar al producto real.
Cómo encaja en un flujo de catálogo
Esto se ejecuta típicamente cada vez que llega un nuevo listado de proveedor, ya sea la integración única del catálogo completo de un proveedor nuevo o una actualización semanal recurrente de precios y existencias. Como el precio es por solicitud más por ítem, emparejar un lote de mil SKU de proveedor contra su catálogo tiene un costo calculable, y las tareas de emparejamiento que fallan se reintentan automáticamente sin costo, evitando que una carga defectuosa se convierta en un gasto no planeado.
Dónde sigue haciendo falta una persona
El emparejamiento devuelve sus mejores candidatos, normalmente con suficiente señal para aplicar automáticamente los de alta confianza y marcar los ambiguos para una revisión rápida; un producto genuinamente nuevo sin equivalente en el catálogo debe quedar sin emparejar en lugar de forzarse dentro de la entrada equivocada. El endpoint está diseñado para reducir el trabajo de conciliación a una lista corta de revisión, no para eliminar por completo el criterio humano en los casos límite.
Qué puede hacer con ella
Integración de un proveedor nuevo
Un minorista recibe la lista de precios completa de un distribuidor nuevo y empareja sus dos mil artículos contra el catálogo existente en un solo lote, en lugar de cruzar SKU a mano uno por uno.
Actualizaciones semanales de precios
El flujo automatizado de precios de un mayorista empareja cada listado entrante de proveedor con los SKU internos antes de actualizar precios, así una coincidencia equivocada nunca sobrescribe silenciosamente el producto incorrecto.
Comparación de precios entre proveedores
Un comprador empareja la misma línea de productos entre los catálogos de tres proveedores distintos para comparar precios en artículos equivalentes, aunque cada proveedor los nombre de forma diferente.
Deduplicación de catálogo
Un marketplace que fusiona dos catálogos adquiridos usa el emparejamiento para encontrar productos superpuestos listados bajo nombres distintos, marcando duplicados antes de publicar el catálogo combinado.
Preguntas frecuentes
¿Cómo funciona la API de emparejar productos sin SKU compartidos?
Compara nombres, descripciones y atributos de producto por similitud semántica, así que puede emparejar artículos aunque los proveedores usen códigos o redacciones completamente distintas.
¿Esto es coincidencia exacta o coincidencia difusa?
Es coincidencia difusa: está construida específicamente para manejar nombres inconsistentes, abreviaturas e identificadores faltantes, no solo cadenas de texto idénticas.
¿Existe un plan gratuito para search.match_products?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Cuánto cuesta emparejar productos en volumen?
Es de $0.002 por solicitud más $0.002 por ítem, así que emparejar un listado grande de proveedor tiene un costo predecible y calculable antes de ejecutarlo.
¿Garantiza que todos los ítems queden emparejados?
No, y eso es intencional: los productos genuinamente nuevos sin equivalente en el catálogo quedan correctamente sin emparejar en lugar de forzarse en la entrada equivocada.
¿Puedo emparejar miles de SKU de proveedor a la vez?
Sí, está diseñado para uso masivo: envíe el listado completo de un proveedor en un solo lote y el precio escala por ítem emparejado.
¿Cómo recibo los resultados del emparejamiento?
La llamada devuelve un task_id de inmediato, y la tabla de correspondencias se entrega mediante webhook firmado o un enlace firmado válido por 24 horas.
¿Qué pasa si falla una tarea de emparejamiento?
Se reintenta automáticamente hasta tres veces, y nunca se cobra por una tarea que finalmente falla.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/search/match-products \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"items":["valor-1","valor-2"]}'const res = await fetch("https://api.kit.forhosting.com/search/match-products", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"items": [
"valor-1",
"valor-2"
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/search/match-products",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"items": [
"valor-1",
"valor-2"
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/search/match-products", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"items":["valor-1","valor-2"]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"items":["valor-1","valor-2"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/search/match-products", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"items": [
"valor-1",
"valor-2"
]
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "search.match_products",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_chunks | 10000 |
max_tokens | 20000 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |