Abbina prodotti tra cataloghi
«Wireless Mouse Blk 2.4G» nel listino di un fornitore e «Mouse ottico wireless nero» nel suo catalogo sono lo stesso articolo: lo strumento trova queste coppie senza un codice comune e restituisce una tabella di corrispondenze da rivedere. Pagamento a consumo, senza abbonamento.
Esegui online
Esegui questo sui nostri server con il tuo account. Gli strumenti gratuiti girano nel tuo browser; questo viene addebitato sul tuo saldo KIT al prezzo indicato sopra.
Questo strumento confronta due elenchi di prodotti — il tuo catalogo e quello di un fornitore, per esempio — e abbina gli articoli che sono lo stesso prodotto anche se nomi, marche o descrizioni non coincidono lettera per lettera. Utile quando due sistemi diversi chiamano lo stesso oggetto in modo diverso.
Perché i codici prodotto non bastano
Chiunque abbia unito il listino di un fornitore al proprio catalogo conosce il problema: i codici non coincidono, ogni fornitore descrive i prodotti a modo suo e un semplice CERCA.VERT trova solo i pochi articoli scritti in modo identico. I codici a barre come UPC ed EAN in teoria hanno risolto l'identificazione dei prodotti decenni fa, ma nella pratica i fornitori li omettono, usano codici interni o elencano le varianti con descrizioni leggermente diverse. Per questo serve un abbinamento che legga oltre il rumore, come «Blk» al posto di «Black» o un marchio abbreviato, fino al prodotto vero.
Quando usarlo e come leggere il risultato
Si usa all'arrivo di un nuovo listino: l'inserimento iniziale di un fornitore con duemila articoli, l'aggiornamento settimanale di prezzi e scorte, il confronto della stessa linea di prodotti tra tre fornitori o l'unione di due cataloghi acquisiti. Il risultato è una tabella di corrispondenze: le coppie con alta sicurezza si possono applicare subito, quelle ambigue vanno controllate a mano e un prodotto davvero nuovo resta senza abbinamento. L'errore tipico è applicare tutto senza guardare la lista breve dei casi dubbi.
Come funziona il confronto
Dai in pasto due elenchi — il tuo e quello esterno — e il motore restituisce le coppie più probabili, ciascuna con un grado di somiglianza indicato accanto al risultato trovato. Le corrispondenze più forti sono quasi certamente lo stesso prodotto; quelle più deboli meritano una verifica manuale prima di essere confermate definitivamente nel tuo sistema gestionale interno usato ogni giorno.
Casi d'uso
Il listino fornitori di Rossi & Figli S.r.l.
Rossi & Figli S.r.l. abbina automaticamente il listino di un nuovo fornitore al proprio catalogo esistente, individuando quali articoli sono già in vendita sotto un nome diverso.
L'unione di due cataloghi dopo un'acquisizione
Un'azienda di Padova unisce il catalogo prodotti di un'attività appena acquisita con il proprio, abbinando gli articoli duplicati prima di pubblicare il listino unificato.
Il confronto prezzi di Tecnoedil Verona
Tecnoedil Verona S.n.c. confronta periodicamente i materiali del proprio listino con quelli di un fornitore concorrente per verificare differenze di prezzo sullo stesso identico prodotto.
Domande frequenti
Serve che i due cataloghi usino gli stessi codici prodotto?
No, proprio il contrario: lo strumento serve quando i codici o i nomi sono diversi. Il confronto guarda la descrizione, non un identificativo comune.
Come capisco quali abbinamenti sono affidabili?
Ogni coppia restituita ha un grado di somiglianza: quelle più alte sono quasi certamente lo stesso prodotto, quelle basse meritano una verifica manuale prima di confermarle.
Quanti prodotti posso abbinare in un'esecuzione?
Fino a 10.000 elementi complessivi tra i due elenchi; per cataloghi più grandi conviene dividere il lavoro per categoria merceologica.
Funziona anche tra cataloghi in lingue diverse?
Sì, il modello è multilingue: puoi abbinare un catalogo in italiano con un listino fornitore scritto in un'altra lingua.
Che cosa succede a un prodotto nuovo che non esiste nel mio catalogo?
Resta senza abbinamento invece di essere forzato nella voce sbagliata. Le coppie sicure si possono applicare in automatico, mentre quelle dubbie vengono segnalate per un rapido controllo manuale.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/search/match-products \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"auriculares inalámbricos","candidates":["Auriculares Bluetooth","Teclado USB"]}'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({
"query": "auriculares inalámbricos",
"candidates": [
"Auriculares Bluetooth",
"Teclado USB"
]
})
});
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={
"query": "auriculares inalámbricos",
"candidates": [
"Auriculares Bluetooth",
"Teclado USB"
]
},
)
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" => '{"query":"auriculares inalámbricos","candidates":["Auriculares Bluetooth","Teclado USB"]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"query":"auriculares inalámbricos","candidates":["Auriculares Bluetooth","Teclado USB"]}`)
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)Esempio di richiesta
{
"query": "auriculares inalámbricos",
"candidates": [
"Auriculares Bluetooth",
"Teclado USB"
]
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "search.match_products",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Limiti
max_chunks | 10000 |
max_tokens | 20000 |
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
Il problema dei cataloghi che non si parlano
Un fornitore chiama un articolo “Zaino porta laptop 15 pollici nero”, il tuo catalogo lo ha registrato come “Borsa notebook 15" black”: stesso prodotto, nessuna corrispondenza esatta di testo tra i due elenchi. Abbinare cataloghi a mano richiede ore di confronto riga per riga; match_products lo automatizza confrontando il significato delle descrizioni, non le parole esatte usate da ciascun fornitore.
Quando conviene usarlo
Migrare un catalogo da un fornitore a un altro, unire due liste prodotto dopo l'acquisizione di un'attività, confrontare periodicamente i tuoi articoli con quelli di un competitor per verificare prezzi sullo stesso prodotto identico venduto altrove sul mercato locale italiano: in tutti questi casi pratici il confronto automatico per significato risparmia il lavoro manuale più noioso e ripetitivo di sempre.
Prezzo per articolo
Un catalogo di cinquecento prodotti da abbinare a un listino fornitore costa in genere pochi dollari totali, contro le tante ore che servirebbero per farlo manualmente riga per riga, senza alcun aiuto esterno. $0.002 a richiesta più $0.0015 ogni articolo confrontato, in dollari, senza costi aggiuntivi legati al numero esatto di abbinamenti trovati dal motore semantico usato per il confronto.
Domande tecniche
Quanto costa abbinare un catalogo di mille articoli?
$0.0015 per articolo confrontato più $0.002 a richiesta, in dollari: mille articoli restano nell'ordine di pochi dollari totali.
Posso automatizzare l'abbinamento ogni volta che arriva un nuovo listino?
Sì, via API colleghi lo strumento al momento in cui ricevi il listino aggiornato di un fornitore e ottieni gli abbinamenti senza intervento manuale.