Questa guida spiega il flusso di collegamento di Printful quando Printful è indicato esplicitamente come disponibile in Integrazioni → Evasione ordini. Fa fede solo la schermata Integrazioni attiva del tuo account; né questo articolo, né il logo di un fornitore, né un URL diretto dimostrano la disponibilità. Se Printful è assente o non disponibile lì, fermati: è fuori dal tuo ambito attuale.
Un collegamento riuscito può rendere disponibili le funzionalità concesse dal tuo token Printful; il comportamento di catalogo, ordini e webhook dipende comunque dal negozio selezionato, dai permessi e dallo stato attuale dell’integrazione. Verifica l’intero flusso di un ordine associato e un riferimento del fornitore accettato prima della produzione.
Se vuoi prima il quadro generale, vedi come funziona il collegamento di un fornitore.
Prima di iniziare
Un po’ di configurazione in Printful rende il collegamento più fluido.
- Tieni pronto un account Printful, con il tuo negozio e le impostazioni di pagamento configurati. Conferma i dati di pagamento in Printful prima di convalidare un ordine di prova e un riferimento del fornitore.
- Decidi da quale negozio Printful Composerie deve evadere gli ordini. Se il tuo account Printful ha più di un negozio, scegli quello giusto durante il collegamento.
- Se colleghi con una chiave API, genera un token privato con solo l’accesso indicato nei passaggi di configurazione: ordini, prodotti e webhook. Controlla quei permessi in Printful prima dell’approvazione.
Il percorso con la chiave API prevede tre brevi passaggi numerati: configura il tuo negozio e i dati di pagamento, crea il token, poi incollalo e scegli il tuo negozio. Rimandano direttamente alla dashboard di Printful e alla documentazione API di Printful, così puoi aprire ogni passaggio in una nuova scheda e seguirlo.
Collega Printful
Segui solo il metodo di configurazione mostrato nella tua pagina di Printful. Dove è attivo l’accesso con un clic di Printful, la scheda si intitola «Collega il tuo account Printful» e parte con un pulsante «Continua con Printful»; il modulo con il token API è raccolto sotto Usa invece una chiave API. Dove non è attivo, la scheda mostra direttamente il modulo con il token API.
Apri la pagina di collegamento di Printful
Vai all’hub Integrazioni nella dashboard e apri la sezione Evasione ordini. Continua solo quando la scheda di Printful mostra esplicitamente un’azione di configurazione disponibile, poi selezionala per aprire la pagina di collegamento.
Scegli come collegarti
Usa uno dei metodi di collegamento mostrati nella pagina.
Per accedere, seleziona «Continua con Printful», accedi a Printful e approva l’accesso. Torni subito alla pagina di Printful in Composerie. Se rifiuti o l’autorizzazione non riesce, la pagina lo dice e non cambia nulla. La (i) accanto a «Solo ciò che serve per prodotti e ordini» spiega l’accesso richiesto da Composerie e l’avvertenza sul singolo webhook per negozio, più sotto.
Per usare un token che gestisci tu, seleziona Usa invece una chiave API.
Incolla il token e cerca i negozi
Se hai scelto il percorso con la chiave API, incolla il tuo token API privato nel campo Chiave API, poi seleziona Cerca negozi. Composerie convalida il token con Printful e legge i negozi presenti nel tuo account.
Seleziona il negozio da collegare
Dopo che i negozi sono stati trovati, scegli nel selettore Negozio il negozio Printful che Composerie deve usare per l’evasione. Elenca ogni negozio del tuo account e parte dal primo.
Completa il collegamento
Seleziona «Collega Printful». Il pulsante compare solo dopo che Cerca negozi ha trovato un negozio, e richiede un negozio selezionato. Composerie conserva il tuo token cifrato e registra il negozio che hai scelto.
Se il flusso di collegamento segnala che un webhook è stato registrato, Composerie può ricevere gli eventi di stato supportati per quel negozio selezionato. Quando Printful restituisce il tracciamento in un evento o in una risposta di stato supportati, Composerie può registrarlo sull’ordine del fornitore corrispondente.
Conferma il collegamento
Dopo il collegamento, la pagina di Printful passa alla vista collegata. Controlla che tutto sembri corretto.
L’intestazione mostra lo stato Connesso. La riga del registro sotto termina con Ultimo controllo, cioè quando Composerie ha confermato per l’ultima volta che le credenziali funzionano ancora. La scheda Collegamento mostra il Negozio che hai scelto e Collegato dal, con il modo in cui ti sei collegato: «accesso con Printful» o «Chiave API». Usa questi valori, lo stato della connessione e un flusso di prova per confermare che la credenziale funzioni ancora. Lo stato e il tracciamento del fornitore compaiono solo quando Printful li restituisce tramite un percorso di connessione supportato.
Nella stessa scheda, imposta Valuta di acquisto sulla valuta di fatturazione del tuo account Printful, così costi e margini sono corretti.
Da qui puoi aprire il catalogo di Printful e iniziare a creare un prodotto. Seleziona Sfoglia il catalogo nell’intestazione della pagina.
Per importare i prodotti e scegliere cosa vendere, vedi sfogliare il catalogo di un fornitore. Per mantenere funzionante la connessione nel tempo, vedi mantenere in salute la connessione a un fornitore.
Domande frequenti
Accesso con un clic o token API, quale devo usare?
Usa uno dei metodi mostrati nel tuo account. Continua con Printful usa la schermata di approvazione di Printful; il percorso con la chiave API sotto Usa invece una chiave API ti permette di controllare tu credenziale e permessi.
Perché non vedo il pulsante Collega Printful?
Compare quando Cerca negozi ha trovato un negozio nel tuo account. Incolla il token, seleziona Cerca negozi, poi controlla il negozio nel selettore Negozio.
Il token funziona ma non è comparso nessun negozio. E adesso?
Crea prima un negozio in Printful, poi torna e seleziona di nuovo Cerca negozi. Composerie ha bisogno di un negozio da cui evadere prima di potersi collegare.
Il mio token API è al sicuro?
Sì. Composerie conserva il token cifrato e registra solo quale negozio hai selezionato. Per ruotarlo, scegli Modifica credenziali nel menu Altre azioni e salva un token nuovo; quello attuale continua a funzionare finché non salvi. Una connessione fatta con l'accesso offre invece lì Ricollega con Printful.
Collegare Printful sovrascriverà il mio webhook esistente?
Può succedere. Printful consente una sola configurazione di webhook per negozio, quindi la registrazione di Composerie sostituisce la precedente. Nella scheda con l'accesso con un clic, la (i) accanto a Solo ciò che serve per prodotti e ordini lo dice prima che tu ti colleghi.
Se hai difficoltà, contatta il supporto e ti aiuteremo.
Passo successivo: sfoglia il catalogo di Printful per aggiungere il tuo primo prodotto.