Hepsiburada Marketplace Sync - Aggiornamento automatico di giacenze e prezzi via API o CSV

Il tuo negozio è la fonte della verità. Il marketplace deve seguirlo.

Vendere su Hepsiburada significa tenere aggiornate tre cose su ogni inserzione: prezzo, giacenza disponibile e tempo di spedizione. Se lo fai a mano, finisci per riesportare un foglio di calcolo ogni mattina; se te ne dimentichi per un giorno, o vendi merce che non hai più oppure resti con un prezzo che non volevi offrire. Questo modulo rende il tuo catalogo PrestaShop l'unica fonte e riporta le modifiche dall'altra parte.

Due modi per consegnare, un solo generatore di righe

• Esportazione CSV — scarica un file con le colonne esatte, nell'ordine esatto, che il caricatore massivo di Hepsiburada si aspetta, e caricalo tu stesso nel portale venditore.
• Listing API — inserisci le tue credenziali e il modulo dialoga direttamente con Hepsiburada. Punta un cron all'indirizzo fornito e le modifiche di giacenza e prezzo vengono consegnate da sole.

Entrambe le strade passano per lo stesso generatore di righe, quindi il file che scarichi e i dati che l'API invia coincidono sempre. Se ti serve verificare che cosa sta facendo l'API, scarica il file.

Che cosa invia, e che cosa lascia intatto

Il team catalogo di Hepsiburada è proprietario dell'inserzione in sé, perciò questo modulo non tocca mai i nomi dei tuoi prodotti, né le descrizioni, le immagini, le categorie o gli attributi. Invia i campi di competenza del venditore: prezzo al netto delle imposte, giacenza disponibile, tempo di spedizione, etichette di corriere e indirizzo, quantità massima acquistabile e tipo e lunghezza della personalizzazione. Nulla di ciò che appartiene al loro catalogo viene sovrascritto.

Protezioni, perché un prezzo sbagliato costa caro

• «Hold back» (trattieni scorta) — sottrae un margine di sicurezza da ogni quantità prima dell'invio. Impostalo a 2 e un prodotto con 5 pezzi viene offerto con 3, così un ordine dal marketplace non può vendere ciò che il tuo negozio ha appena venduto.
• Moltiplicatore di prezzo — invia il prezzo del negozio senza modifiche, oppure aggiunge un margine per coprire la commissione del marketplace. I valori superiori a 10 vengono rifiutati come refuso anziché pubblicati.
• «Never send a price below» (non inviare mai un prezzo inferiore a) — una soglia di sicurezza. Le righe al di sotto vengono trattenute e segnalate invece di andare online con la cifra sbagliata.
• «Never offer more than» (non offrire mai più di) — limita la quantità mostrata sul marketplace a prescindere da quanta ce n'è in magazzino.

I prodotti disattivati o non disponibili per l'ordine vengono inviati con giacenza zero invece di essere scartati, così smettono di vendere sul marketplace anziché restare lì a invecchiare in silenzio.

Ti dice che cosa non può essere inviato, e perché

Il pannello di stato nella scheda Getting started (per iniziare) indica per nome i prodotti interessati invece di lasciarti tirare a indovinare: nessuno SKU e nessun codice di magazzino, un prezzo che risulta pari a zero, un prezzo sotto la tua soglia, un nome mancante nella lingua di esportazione. Gli SKU duplicati vengono rilevati prima dell'invio: Hepsiburada rifiuta un intero lotto se uno compare due volte, quindi intercettarlo in anticipo ti risparmia un caricamento da rifare per intero. Il campo corriere viene validato rispetto ai corrieri pubblicati da Hepsiburada e avvisa se il nome non è riconosciuto, cosa che dalla loro parte verrebbe altrimenti ignorata in silenzio.

Sincronizzazione programmata che riferisce con onestà

La scheda Send (invio) mostra un indirizzo cron con token. Punta il cron del tuo hosting su quell'indirizzo — ogni trenta minuti è la scelta tipica — e per impostazione predefinita invia solo ciò che è cambiato dall'ultima esecuzione riuscita; i salvataggi dei prodotti e i movimenti di magazzino contrassegnano le inserzioni come modificate in automatico. Aggiungi &mode=full per rinviare tutto dopo che Hepsiburada ha rifiutato o perso un lotto. L'endpoint risponde in JSON, così uno strumento di monitoraggio può distinguere un guasto reale da un'esecuzione senza novità; le esecuzioni simultanee vengono rifiutate perché una lenta non si accavalli, e rigenerare l'indirizzo invalida subito il precedente se la URL dovesse trapelare.

Collegare i prodotti, e le combinazioni

Ogni inserzione Hepsiburada ha un HepsiburadaSku. Incollalo nella scheda Hepsiburada della pagina prodotto, oppure usa «Link products automatically» (collega i prodotti automaticamente) se i riferimenti PrestaShop corrispondono già ai tuoi codici di magazzino venditore su Hepsiburada. Le combinazioni sono pienamente supportate: ciascuna viene collegata e prezzata separatamente, perché Hepsiburada tratta ogni variante come un'inserzione a sé.

Che cosa ha corretto la versione 2.0

La versione 1.x calcolava sempre il prezzo da wholesale_price, un campo che la maggior parte dei negozi lascia vuoto, perciò ogni prezzo esportato era 0,00. La versione 2.0 usa per impostazione predefinita il prezzo di vendita, si rifiuta di esportare un prezzo pari a zero e avvisa quando come origine è selezionato il prezzo di costo su un catalogo privo di prezzi di costo. La versione 1.x scriveva inoltre lo SKU a ogni singolo actionProductUpdate, quindi qualunque altra via di salvataggio — una variazione di giacenza, il web service, un altro modulo — lo azzerava in silenzio; la 2.0 scrive solo quando il modulo di inserimento prodotto ha realmente trasmesso quei campi. I collegamenti ora sono memorizzati per negozio anziché come un unico SKU per prodotto a livello globale, e la 1.x salvava le credenziali API ma non inviava mai alcuna richiesta da nessuna parte, quindi l'aggiornamento lascia l'API disattivata finché non la attivi deliberatamente.

Compatibilità

PrestaShop 1.7, 8 e 9, senza override, in otto lingue: francese, inglese, italiano, olandese, polacco, spagnolo, tedesco e turco. Compatibile con il multinegozio: i collegamenti sono memorizzati per negozio, così lo stesso prodotto può avere SKU Hepsiburada diversi in negozi diversi, e la pagina di configurazione ti indica sempre su quale negozio sta agendo. La disinstallazione rimuove le tabelle e le impostazioni del modulo; le tue inserzioni Hepsiburada conservano gli ultimi valori ricevuti e semplicemente smettono di essere aggiornate.

Domande frequenti

Mi serve l'API o mi basta un file?

Vanno bene entrambe. Scarica il CSV e caricalo nel portale venditore, oppure attiva l'API e lascia che un cron consegni le modifiche. Entrambe producono dati identici.

Cambierà i titoli o le immagini dei miei prodotti su Hepsiburada?

No. Quelli sono gestiti dal loro team catalogo. Il modulo invia solo prezzo, giacenza, tempo di spedizione, etichette di corriere e indirizzo, quantità massima e impostazioni di personalizzazione.

Come evito di vendere più del disponibile?

Imposta una quantità da trattenere («Hold back»). Ogni valore di giacenza viene ridotto di tale quantità prima dell'invio, così il marketplace non vede mai le tue ultime unità.

Quali credenziali servono all'API?

Le credenziali della Listing API di Hepsiburada, che non sono quelle di accesso al portale venditore: richiedile a Hepsiburada. Un 401 significa che nome utente o password sono errati, un 403 che non sono abilitate alla Listing API e un 404 che l'ID venditore è sbagliato. C'è un pulsante «Test connection» (prova connessione) che mostra il messaggio esatto restituito da loro.

Gestisce le combinazioni?

Sì. Ogni combinazione viene collegata e prezzata separatamente, perché Hepsiburada tratta ogni variante come un'inserzione a sé.

Perché è stato rifiutato l'intero caricamento?

Quasi sempre per uno SKU duplicato: Hepsiburada rifiuta il lotto intero se uno compare due volte. Il pannello di stato trova i duplicati prima che tu invii.

Con la 1.x tutti i miei prezzi sono stati esportati a zero. È stato risolto?

Sì. Dipendeva dal fatto che la 1.x calcolava il prezzo dal campo del prezzo di costo, che la maggior parte dei negozi lascia vuoto. La versione 2.0 usa per impostazione predefinita il prezzo di vendita e si rifiuta di esportare un prezzo pari a zero.