Guida a Synqo One
Tutto quello che ti serve per configurare e pubblicare il tuo catalogo su marketplace.
🚀 Primi passi
Synqo è uno strumento per pubblicare il tuo catalogo prodotti sui marketplace (partendo da Temu). Imposti le regole una volta sola, poi generi il feed in automatico.
Come funziona Synqo
Synqo segue un flusso in quattro fasi: importa i prodotti dal tuo catalogo, applica le regole di prezzo e filtraggio, controlla il risultato in pre-lancio, poi genera il feed per il marketplace.
Fase 1 — Aggiungi un catalogo
Vai su Cataloghi nella sidebar. Puoi aggiungere un catalogo da un URL CSV (es. feed fornitore) oppure usare il catalogo TerminalVideo già integrato. Il sistema scarica e normalizza i prodotti automaticamente.
Fase 2 — Imposta le regole
Nella sezione Regole prezzo & esclusioni configuri:
- Regole prezzo — ricarico, spedizione, IVA, commissioni
- Inclusioni ed esclusioni — quali prodotti includere o escludere dal feed
- Regole per segmento — parametri specifici per categorie o brand particolari
Fase 3 — Pre-lancio
La pagina Pre-lancio ti mostra l'anteprima completa del feed: quanti prodotti sono pronti, quanti esclusi e quanti bloccati (con motivo). Puoi scaricare CSV di debug prima di pubblicare.
Fase 4 — Pubblica il feed
Quando sei soddisfatta del risultato, scarica il CSV finale dalla sezione Regole prezzo (bottone "Scarica CSV") oppure usa il link JSON diretto. Il feed applica tutte le regole impostate in automatico.
📂 Cataloghi
Un catalogo è la sorgente dati dei tuoi prodotti. Synqo supporta cataloghi CSV via URL e cataloghi integrati come TerminalVideo.
Come aggiungere un catalogo CSV via URL
Nella pagina Cataloghi, fai clic su "+ Nuovo catalogo". Inserisci:
- Nome — nome leggibile (es. "Ociostock IT")
- Codice — identificatore breve senza spazi (es.
ociostock_it) - URL CSV — link diretto al file CSV del fornitore
Synqo scarica il CSV, lo analizza e mappa automaticamente le colonne. Se il CSV ha un separatore non standard (punto e virgola, tab), viene rilevato in automatico.
Come funziona il mapping colonne
Synqo cerca automaticamente colonne con nomi comuni. Se il tuo CSV usa nomi diversi, puoi definire un mapping manuale tramite i preset fornitore.
Le colonne chiave riconosciute automaticamente sono:
| Campo Synqo | Nomi colonna riconosciuti |
|---|---|
ean | ean, barcode, cod_barre, gtin, ean13 |
title | titolo, title, nome, name, descrizione, description |
brand | brand, marca, marchio, manufacturer |
netto | netto, prezzo_netto, costo, price, prezzo, cost |
stock_qty | stock, qty, quantity, giacenza, disponibilita |
img_url | img, image, immagine, foto, photo, img_url |
Preset fornitore
I preset fornitori sono configurazioni predefinite per CSV con strutture note. Quando selezioni un preset, il mapping colonne viene compilato automaticamente senza dover configurare nulla a mano.
Attualmente i preset disponibili sono quelli configurati per i tuoi fornitori abituali. Contatta il supporto per aggiungere un nuovo preset.
💶 Regole prezzo
Le regole prezzo definiscono come Synqo calcola il prezzo di vendita finale a partire dal prezzo netto del fornitore.
Ricarico vs Margine
Synqo usa il ricarico (markup) come parametro di input, non il margine. I due concetti sono correlati ma diversi:
| Concetto | Formula | Esempio (netto 10 €, ricarico 25%) |
|---|---|---|
| Ricarico % | prezzo = netto × (1 + ricarico/100) |
10 × 1,25 = 12,50 € |
| Margine equivalente | margine = ricarico / (100 + ricarico) × 100 |
25 / 125 × 100 = 20% |
L'interfaccia mostra sempre il margine equivalente in automatico accanto al campo ricarico, così puoi controllare entrambi i valori.
ricarico = margine / (100 − margine) × 100
Formula completa del prezzo
Il prezzo finale viene calcolato applicando questi passaggi in ordine:
2. prezzo = prezzo + ricarico_fisso // aggiunta fissa in €
3. prezzo = prezzo × (1 + fee_marketplace% / 100)
4. prezzo = prezzo × (1 + fee_pagamento% / 100)
5. prezzo = (prezzo + spedizione) × (1 + IVA% / 100) // IVA su tutto
6. prezzo = arrotondamento(prezzo)
| Prezzo netto fornitore: | 8,00 € |
| Ricarico 50%: | → 8 × 1,50 = 12,00 € |
| Ricarico fisso 0 €: | → 12,00 € |
| Fee marketplace 10%: | → 12 × 1,10 = 13,20 € |
| Fee pagamento 2%: | → 13,20 × 1,02 = 13,46 € |
| Spedizione 3,90 €: | → 13,46 + 3,90 = 17,36 € |
| IVA 22%: | → 17,36 × 1,22 = 21,18 € |
Ricarico fisso (€)
Il ricarico fisso è un importo in euro aggiunto dopo il ricarico percentuale. Utile per coprire costi fissi di gestione indipendenti dal prezzo del prodotto (es. etichette, imballaggio).
Esempio: ricarico 30% + 0,50 € fissi su un prodotto da 5 € → 5 × 1,30 = 6,50 + 0,50 = 7,00 € (prima di fee, spedizione e IVA).
Spedizione
La spedizione fissa (€) è il costo di spedizione aggiunto al prezzo del prodotto prima di applicare l'IVA. Si tratta di un costo fisso per ogni articolo, indipendente dal peso.
Se la spedizione è già inclusa nel prezzo o gratuita, lascia il campo a 0.
IVA
L'IVA viene applicata all'intero importo (prodotto + spedizione). In Italia per la maggior parte dei prodotti fisici è il 22%. Per libri, farmaci e altri beni è inferiore — verifica l'aliquota corretta per la tua categoria.
Commissioni marketplace
La fee marketplace è la commissione trattenuta dalla piattaforma su ogni vendita. Su Temu varia tipicamente tra il 5% e il 15% in base alla categoria. Inserisci la percentuale esatta indicata nel contratto marketplace.
Fee pagamento
La fee pagamento copre i costi di transazione (carta di credito, PayPal, ecc.) applicati dalla piattaforma. Tipicamente 1–3%.
Arrotondamento
Tre modalità disponibili:
- 2 decimali — arrotondamento matematico standard (es. 21,185 → 21,19)
- Forza .99 — arrotonda al centesimo sotto e aggiunge .99 (es. 21,18 → 20,99)
- Forza .95 — come .99 ma con .95 (es. 21,18 → 20,95)
⚙️ Inclusioni ed Esclusioni
Le regole di inclusione ed esclusione controllano quali prodotti compaiono nel feed finale. Puoi filtrare per titolo, marca, EAN, codice interno, prezzo e quantità.
Differenza tra "Includi" ed "Escludi"
Le due azioni si comportano in modo diverso e si applicano in questo ordine:
- Includi: se esistono regole di tipo "includi", solo i prodotti che corrispondono ad almeno una di esse passano al passo successivo. I prodotti che non corrispondono a nessuna regola "includi" vengono scartati.
- Escludi: tra i prodotti rimasti, vengono rimossi quelli che corrispondono ad almeno una regola "escludi".
Operatori disponibili
| Operatore | Tipo campo | Descrizione | Esempio |
|---|---|---|---|
contiene |
Testo | Il campo contiene la stringa specificata (case-insensitive) | Titolo contiene "funko" → include tutti i Funko Pop |
uguale a |
Testo / Numero | Il campo corrisponde esattamente al valore | Marca uguale a "LEGO" → solo prodotti LEGO |
inizia per |
Testo | Il campo inizia con il prefisso specificato | SKU inizia per "FNK" → tutti i codici Funko |
è uno di |
Testo / EAN | Il campo è in una lista di valori separati da virgola | EAN è uno di "0123…,9876…" → lista EAN specifica |
> maggiore di |
Numero | Il campo numerico è maggiore del valore | Quantità > 0 → solo prodotti disponibili |
≥ maggiore o uguale |
Numero | Il campo numerico è maggiore o uguale al valore | Prezzo netto ≥ 5 → escludi prodotti sotto i 5 € |
< minore di |
Numero | Il campo numerico è minore del valore | Stock < 3 → escludi prodotti con scorte basse |
≤ minore o uguale |
Numero | Il campo numerico è minore o uguale al valore | Netto ≤ 1 → escludi prodotti a meno di 1 € |
Esempi pratici
Esempio 1 — Escludi contenuto vietato per categoria
- Titolo
contiene"erotico" → Escludi - Titolo
contiene"adult" → Escludi
Esempio 2 — Pubblica solo una marca
- Marca
uguale a"FUNKO" → Includi
Esempio 3 — Escludi prodotti esauriti o troppo economici
- Quantità
≤0 → Escludi - Prezzo netto
<2 → Escludi
Operatore "è uno di" — liste EAN
L'operatore è uno di è particolarmente utile per lavorare con liste di EAN (codici a barre). Inserisci i codici separati da virgola nel campo valore.
Esempio: vuoi includere solo tre prodotti specifici → EAN è uno di 0123456789012, 9876543210987, 1111111111111 → Includi
Non ci sono limiti sulla lunghezza della lista. Puoi incollare centinaia di EAN separati da virgola.
🎯 Regole per segmento
Le regole per segmento ti permettono di applicare parametri di prezzo diversi a gruppi specifici di prodotti, sovrascrivendo la regola base solo dove necessario.
Come funzionano
Per ogni prodotto, Synqo controlla le regole segmento in ordine dall'alto verso il basso. Appena trova una regola che corrisponde al prodotto (per titolo, marca o categoria), usa i parametri di quella regola al posto di quelli base.
Se nessuna regola segmento corrisponde, vengono usati i parametri della regola base (quella definita nella sezione "Regole economiche").
Perché l'ordine conta
Solo la prima regola che corrisponde viene applicata. Questo significa che devi mettere le regole più specifiche prima di quelle più generiche.
| Regola base: | Ricarico 60% · Spedizione 3,90 € |
| Regola segmento #1: | Titolo contiene "FUNKO" → Ricarico 25% · Spedizione 2,50 € |
Un prodotto con titolo "Lego Technic" usa il Ricarico 60% (regola base).
Esempio: segmento prima di generico
Supponiamo di avere queste regole:
- Titolo
contiene"Funko Pop Batman" → Ricarico 20% - Titolo
contiene"Funko" → Ricarico 25% - (Regola base) → Ricarico 60%
Per il prodotto "Funko Pop Batman #1234": corrisponde alla regola 1 (più specifica) → usa il 20%. Non arriva mai alla regola 2.
Se invertissi l'ordine, la regola 2 ("contiene Funko") verrebbe trovata prima, e il Batman userebbe il 25% invece del 20%.
Parametri sovrascrivibili
Per ogni regola segmento puoi specificare (lascia vuoto per usare la regola base):
- Ricarico %
- Ricarico fisso €
- Spedizione €
- Fee marketplace %
- Fee pagamento %
- Modalità arrotondamento
🔍 Pre-lancio
Il pre-lancio è la schermata di controllo prima di esportare il feed. Mostra esattamente quanti prodotti passeranno e quanti vengono bloccati o esclusi, con i motivi.
I tre tab: Pronti, Esclusi, Bloccati
Come interpretare i risultati
Totale catalogo = Pronti + Esclusi + Bloccati. Se la somma non torna, ci sono prodotti con dati incompleti che vengono saltati.
Il tab Pronti mostra una preview con prezzo calcolato, immagine e stato classificazione. Puoi verificare che i prezzi siano sensati prima di esportare.
Il tab Esclusi mostra la regola specifica che ha causato l'esclusione di ciascun prodotto. Utile per verificare che le tue regole funzionino come previsto.
Il tab Bloccati mostra il motivo del blocco per ogni prodotto. I motivi più comuni:
- Classificazione mancante — il prodotto non è stato abbinato a una categoria Temu. Esegui la classificazione automatica o assegna manualmente una categoria.
- Prezzo non calcolabile — il prezzo netto è 0 o mancante nel catalogo fornitore.
- Dati obbligatori mancanti — campi richiesti da Temu (es. brand, immagine) non presenti.
Come scaricare il CSV dei bloccati
Nel tab Bloccati trovi il bottone "Scarica CSV". Il file contiene tutti i prodotti bloccati con la colonna motivo_blocco che spiega il problema di ciascuno. Usa questo CSV per lavorare offline e capire cosa correggere.
🏪 Marketplace
La sezione Marketplace gestisce i canali di vendita collegati al tuo account Synqo. Attualmente supportato: Temu (EU).
Collegare un marketplace
Nella pagina Marketplace trovi i canali disponibili. Per collegare Temu hai bisogno delle credenziali API:
- App Key — l'identificativo della tua applicazione Temu
- App Secret — la chiave segreta (non condividerla mai)
- Access Token — il token di accesso al tuo account venditore Temu
Puoi trovare queste credenziali nell'area sviluppatori del pannello Temu Seller. Una volta inserite e salvate, Synqo le usa per generare i feed nel formato richiesto da Temu.
Stato del canale
Ogni canale mostra il suo stato:
- Connesso — le credenziali sono configurate e valide
- Non configurato — mancano le credenziali API
- Errore — le credenziali sono scadute o non valide
Più marketplace
Synqo è progettato per supportare più marketplace in parallelo. Il sistema usa il concetto di "canale" per separare regole, prezzi ed esclusioni per piattaforma. Puoi avere regole diverse per Temu IT, Temu DE, o altri marketplace futuri.
❓ Domande frequenti
Risposte alle domande più comuni sull'uso di Synqo.