Quali sono gli errori più comuni nell'integrazione con Etsy e come posso risolverli?
La maggior parte degli errori di integrazione con Etsy dipende dalle regole di Etsy per le inserzioni e i negozi oppure da una temporanea mancata corrispondenza tra il tuo negozio Etsy e la tua Bacheca Printful. Di seguito trovi gli errori più comuni relativi a connessione, sincronizzazione, pubblicazione, importazione degli ordini e spedizione, suddivisi per categoria, insieme alle relative soluzioni. Se hai appena iniziato, scopri prima come collegare Etsy a Printful.
In questo articolo:
- Problemi di connessione/sincronizzazione
- Errori di pubblicazione dei prodotti
- Errore di importazione degli ordini
- Errore di spedizione
Problemi di connessione/sincronizzazione
Perché visualizzo «Shop not found» o «This account has no associated etsy.com stores»?
Questo messaggio viene visualizzato quando provi a collegare un account Etsy personale anziché un account venditore. A Printful è possibile collegare solo i negozi Etsy. Assicurati di avere un negozio attivo, non solo un account acquirente, e durante la procedura «Allow access» esci da Etsy e accedi di nuovo con l'account corretto. Se non hai ancora un negozio, vai su etsy.com/sell e seleziona Inizia.
Perché non riesco a collegare il mio negozio Etsy a Printful?
Segui questi passaggi nell'ordine indicato:
- Verifica se il negozio è già collegato a un altro account Printful (in tal caso, rimuovilo prima da quell'account tramite Impostazioni → Impostazioni del negozio → Generale → Rimuovi negozio; l'assistenza Printful non può farlo per te).
- Assicurati di aver completato l'intera procedura di registrazione come venditore su Etsy all'indirizzo etsy.com/sell.
- Svuota la cache e i cookie del browser oppure prova ad aprire una finestra in incognito; poi segui di nuovo i passaggi per collegare Etsy.
Perché il mio negozio Etsy risulta «Unavailable Shop»?
Significa che Etsy segnala che il tuo negozio non è raggiungibile.
- Clicca su Riconnetti se compare accanto al negozio su Printful (Negozi → Visualizza negozio oppure I miei prodotti → Pubblicato).
- Apri direttamente l'URL del tuo negozio Etsy per verificare che si carichi e che non sia in modalità vacanza o sospeso, quindi clicca su Aggiorna dati nel tuo negozio su Printful.
Se il negozio si carica correttamente su Etsy ma l'errore persiste, probabilmente si tratta di un problema temporaneo da parte di Etsy; se dura più di un giorno, contatta il nostro team di assistenza.
Cosa significano «refresh_token is revoked» o «oauth_problem: token_revoked»?
Di solito succede dopo aver modificato la password dell'account Etsy, un'operazione che revoca tutti i token API esistenti. Clicca su Riconnetti sul tuo negozio nella Bacheca Printful per autorizzare nuovamente l'accesso con un nuovo token; i prodotti e le impostazioni esistenti non verranno modificati.
Perché visualizzo il messaggio «system error while syncing store»?
Il messaggio viene visualizzato come «Something went wrong with sync on [store name]» e tende a verificarsi quando un negozio ha un numero molto elevato di varianti.
Spesso il problema si risolve disattivando Importa prodotti non sincronizzati da Etsy e selezionando Rimuovi nelle impostazioni di importazione del negozio.
Errori di pubblicazione dei prodotti
Perché non riesco a pubblicare su Etsy?
Un generico errore «Pubblicazione non riuscita» può avere diverse cause.
- Verifica che il negozio risulti Attivo su Printful nella sezione Negozi (se invece mostra un errore di sincronizzazione, risolvi prima quello, seguendo i passaggi indicati sopra).
- Verifica se il prodotto ha più di 100 varianti, poiché Etsy limita le inserzioni a 100. Se hai pubblicato da un modello, duplicalo e riprova; se hai pubblicato direttamente dal catalogo, ricrea il prodotto, salvalo come modello e poi pubblicalo.
Perché visualizzo «Product was not added! Unknown Etsy client exception»?
Quasi sempre il problema riguarda la lunghezza dei tag. Etsy limita ogni tag a 20 caratteri e questo errore viene visualizzato quando almeno un tag supera tale limite. Accorcia i tag e prova a pubblicare di nuovo. Consulta le limitazioni dei tag Etsy per l'elenco completo delle regole.
Perché la modifica del mio file di stampa non aggiorna il mockup su Etsy?
Se un'inserzione ha già 20 immagini su Etsy (il massimo consentito da Etsy per inserzione), Printful non può inviare automaticamente un nuovo mockup, perché non esiste un modo affidabile per stabilire quale immagine appartenga a ciascuna variante.
Usa Modifica file di stampa e seleziona tutte le varianti in modo che tutti i mockup si aggiornino insieme, oppure carica manualmente il nuovo mockup su Etsy. Anche inviare di nuovo l'inserzione funziona, ma Etsy addebiterà una nuova commissione per l'inserzione.
Perché la sincronizzazione dei miei prodotti Etsy continua a interrompersi?
Impostare un Colore principale nelle impostazioni dell'inserzione Etsy può far scomparire le altre varianti di colore e interrompere la sincronizzazione del prodotto. Anche modificare Taglia o Colore principale direttamente su Etsy può rimuovere altre opzioni di taglia o colore.
La maggior parte di questi problemi dipende da limitazioni di Etsy, non da qualcosa che hai fatto tu. Purtroppo, per risolvere devi sincronizzare manualmente di nuovo i prodotti interessati nella Bacheca Printful.
Perché ricevo un errore relativo a più varianti con la stessa identità?
Etsy non consente valori delle opzioni (come colore o taglia) più lunghi di 20 caratteri e l'importazione può non riuscire se si supera tale limite o se due varianti finiscono per avere valori identici.
Prova ad aggiungere di nuovo il prodotto al tuo negozio; se non funziona, pubblica prima l'inserzione su Etsy, poi importala in Printful.
Perché il titolo o l'inserzione del mio prodotto vengono rifiutati?
Etsy applica regole specifiche per titoli e descrizioni. Se l'invio o la sincronizzazione non riescono per questo motivo, il messaggio di errore indicherà quale parte dell'inserzione va modificata.
Consulta la nostra guida al manuale delle inserzioni Etsy e l'articolo sulle limitazioni dei tag per conoscere i requisiti attuali di Etsy.
Errore di importazione degli ordini
Perché i miei ordini Etsy non vengono visualizzati su Printful?
Se un ordine è confermato e pagato su Etsy ma non è ancora apparso nella tua Bacheca Printful:
- Consulta la nostra guida generale su cosa fare se il tuo ordine non è apparso su Printful.
- Assicurati che l'ordine risulti Pagato, abbia un numero d'ordine univoco e includa un indirizzo di spedizione.
- Verifica che la variante del prodotto risulti sincronizzata nella tua Bacheca Printful; se risulta non sincronizzata, attiva Importa ordini non sincronizzati. Poi clicca su Aggiorna dati nel tuo negozio.
Se la variante del prodotto non esiste su Printful, l'ordine non verrà importato e dovrai ricrearla manualmente nella tua Bacheca Printful.
Errore di spedizione
Perché il mio profilo di spedizione Etsy non viene salvato correttamente?
Un errore come «Object has validation errors: shipping_profile_name... already exists» di solito significa che il profilo di spedizione generato da Printful è stato duplicato su Etsy. Printful usa un identificatore univoco (una stringa come «PF-FRG2») nel nome del profilo per identificarlo; la presenza di due profili di spedizione con lo stesso identificatore causa un conflitto.
Per risolvere il problema, vai alle impostazioni dei profili di spedizione Etsy, rimuovi dal nome del profilo il testo dell'identificatore duplicato e salva le modifiche.
Hai ancora bisogno di aiuto? Il nostro team di supporto è qui per te: contattaci in qualsiasi momento tramite il nostro modulo di contatto oppure avvia una chat con noi.