Integrazioni E-Commerce - Risoluzione problemi generici

Disconnettere e reinstallare l'integrazione è una soluzione affidabile per errori di connessione persistenti, problemi di autenticazione e situazioni in cui gli ordini hanno smesso di essere importati e gli altri passaggi di risoluzione dei problemi non hanno funzionato. Prima di procedere, assicurati di capire esattamente cosa perderai.

Passaggi per reimpostare l'integrazione

1. Nel tuo account Sendcloud, vai su Impostazioni > Integrazioni.
2. Trova la tua integrazione nell'elenco e clicca su Disconnetti.
3. Reinstalla l'integrazione seguendo la guida di configurazione per la tua piattaforma. Puoi trovare tutte le guide di installazione nella sezione Integrazioni del Centro assistenza.
4. Dopo la riconnessione, vai su Impostazioni > Integrazioni > Configura e ricrea le regole di spedizione eliminate.

Prima di controllare la configurazione del tuo negozio, assicurati che il tuo account Sendcloud sia completamente configurato. Un account incompleto può bloccare silenziosamente una nuova connessione. Consulta prima i passaggi di configurazione dell'account in cima a questo articolo.

Se il tuo account è configurato correttamente, segui i passaggi seguenti:

Il tuo negozio non è accessibile pubblicamente
Sendcloud deve raggiungere il tuo negozio tramite Internet per stabilire una connessione. Se il tuo negozio è in modalità manutenzione, protetto da password o non ancora pubblicato, la connessione non riuscirà. Assicurati che il tuo negozio sia attivo e accessibile pubblicamente prima di connetterlo.

Il tuo certificato SSL non è valido o è scaduto
Anche se il tuo negozio si carica correttamente in un browser, un certificato SSL non valido bloccherà le chiamate API di Sendcloud. Verifica che il certificato sia valido e correttamente configurato presso il tuo provider di hosting.

Un plugin o un'app di terze parti sta causando un conflitto
I plugin di sicurezza, di caching e le estensioni di pagamento sono le cause più comuni di conflitti di connessione. Per identificare il responsabile, disabilita i plugin aggiuntivi uno alla volta, iniziando da quelli di sicurezza, firewall o caching, e prova a riconnetterti dopo ognuno. Non appena la connessione riesce, hai trovato il conflitto.

Gli indirizzi IP di Sendcloud vengono bloccati
Se il tuo server o ambiente di hosting usa un firewall o una lista di indirizzi IP consentiti, potrebbe bloccare Sendcloud. Aggiungi gli indirizzi IP di Sendcloud alla tua lista di consentiti: 

L'elenco completo è anche mantenuto e aggiornato su: https://cdn.sendcloud.com/global-media/public-ips.txt 
Se il tuo negozio usa Cloudflare, le sue impostazioni di sicurezza potrebbero bloccare Sendcloud. Leggi la nostra guida dedicata: Risoluzione dei problemi di Cloudflare che blocca Sendcloud.

Un proxy di caching sta bloccando le chiamate API
Se usi un proxy di caching, assicurati che non blocchi o memorizzi nella cache le richieste API di Sendcloud. Chiedi al tuo sviluppatore di controllare le impostazioni della cache e di assicurarsi che il dominio Sendcloud non sia bloccato.

Controlla il registro delle richieste non riuscite
Vai su Impostazioni > Integrazioni > Registro richieste non riuscite nel tuo account Sendcloud. Eventuali errori di connessione vengono registrati qui con una descrizione. Condividi il messaggio di errore con il tuo provider di hosting o sviluppatore se hai bisogno di aiuto per interpretarlo.

Se la tua integrazione funzionava e si è interrotta senza che tu abbia apportato modifiche evidenti, la causa è quasi sempre qualcosa che è cambiato sul lato del tuo negozio o sul lato di Sendcloud. Segui i passaggi seguenti prima di contattare il supporto.

Verifica prima se si tratta di un problema lato Sendcloud
Prima di dedicare tempo alla risoluzione dei problemi del tuo negozio, controlla la pagina di stato di Sendcloud. Se è in corso un incidente che riguarda le integrazioni, il tuo problema potrebbe risolversi da solo una volta che verrà sistemato — non è necessaria alcuna azione da parte tua.

Pensa a cosa è cambiato di recente
La grande maggioranza delle interruzioni improvvise dell'integrazione è causata da una modifica, anche una che sembra non avere nulla a che fare con Sendcloud. Chiediti:

• Hai aggiornato di recente la piattaforma del tuo negozio, il tema o qualche plugin?
• Hai aggiornato il plugin o l'app Sendcloud nel tuo negozio?
• Il tuo provider di hosting ha migrato il server o modificato qualche configurazione?
• Il dominio o l'URL del tuo negozio è cambiato?
• Hai rigenerato chiavi API o cambiato password nel back-end del tuo negozio?
• Hai installato un nuovo plugin di sicurezza o attivato una regola firewall?

Se uno di questi casi si applica, quella modifica è molto probabilmente la causa. Controlla il registro delle richieste non riuscite (vedi la sezione precedente) per l'errore apparso più o meno nello stesso momento.

Verifica che il plugin Sendcloud sia aggiornato
Una versione obsoleta del plugin Sendcloud nel tuo negozio è una causa frequente di interruzioni improvvise, specialmente dopo un aggiornamento della piattaforma. Vai nella sezione plugin o app del tuo negozio e conferma di stare usando la versione più recente dell'integrazione Sendcloud.

Verifica che le tue credenziali API siano ancora valide
Se le chiavi API o i token sono stati rigenerati nel tuo negozio, anche automaticamente, la connessione a Sendcloud si interrompe immediatamente. Vai su Impostazioni > Integrazioni > Configura nel tuo account Sendcloud e verifica le credenziali. Se sembrano obsolete, ricollega l'integrazione con le nuove chiavi.

Controlla il registro delle richieste non riuscite
Vai su Impostazioni > Integrazioni > Registro richieste non riuscite e cerca il momento in cui sono comparsi gli errori. Il codice di errore e la descrizione ti diranno cosa è cambiato. Abbina il risultato alla sezione corrispondente in questo articolo.

Segui i controlli seguenti nell'ordine indicato prima di contattare il supporto.

I nuovi ordini possono richiedere fino a 4 minuti per apparire
Sendcloud recupera i nuovi ordini circa ogni 4 minuti. Se hai appena effettuato un ordine di prova e non è ancora apparso, aspetta qualche minuto e aggiorna la pagina prima di presumere che ci sia qualcosa che non va.

Controlla il filtro date in Sendcloud
Per impostazione predefinita, la vista degli ordini in entrata mostra gli ordini degli ultimi 7 giorni. Se stai cercando ordini più vecchi, apri il filtro date e imposta un intervallo più ampio. Questa è la ragione più comune per cui gli ordini sembrano «mancanti».

Gli ordini più vecchi di 30 giorni non vengono importati
Quando colleghi il tuo negozio per la prima volta, Sendcloud importa solo gli ordini degli ultimi 30 giorni. Gli ordini effettuati prima di questo periodo non appariranno automaticamente. Se hai bisogno di importare ordini più vecchi, contatta il supporto dal tuo account Sendcloud.

Verifica che la tua integrazione sia ancora connessa
Vai su Impostazioni > Integrazioni e conferma che il tuo negozio sia elencato tra le integrazioni connesse. Se non è così, la connessione si è interrotta e dovrà essere ristabilita. Vedi la sezione seguente sulla reimpostazione dell'integrazione.

Controlla il registro delle richieste non riuscite
Vai su Impostazioni > Integrazioni > Registro richieste non riuscite. Se ci sono errori elencati, prendi nota del messaggio di errore — è il modo più rapido per diagnosticare cosa non funziona. Invia l'errore al tuo provider di hosting o sviluppatore se necessario.

Un plugin potrebbe inviare dati degli ordini incompleti
Alcuni plugin modificano o rimuovono i dati degli ordini prima che raggiungano Sendcloud, causando errori silenziosi. Disabilita i plugin aggiuntivi uno alla volta per identificare se qualcuno di essi interferisce. I prodotti contrassegnati come virtuali nel tuo negozio possono anche causare l'omissione degli ordini.

Il tuo negozio potrebbe non essere accessibile pubblicamente
Se il tuo negozio è entrato in modalità manutenzione o la connessione è diventata irraggiungibile, gli ordini smettono di essere importati. Verifica che il tuo negozio sia attivo e raggiungibile da Internet.

Quando crei un'etichetta in Sendcloud, l'integrazione invia automaticamente il numero di tracciamento e lo stato dell'ordine aggiornato al tuo negozio. Se ciò non avviene, controlla quanto segue.

Verifica che la tua integrazione sia ancora connessa
Il feedback può essere inviato solo se la connessione tra Sendcloud e il tuo negozio è attiva. Vai su Impostazioni > Integrazioni e conferma che il tuo negozio appaia tra le integrazioni connesse. Se la connessione si è interrotta, gli aggiornamenti di tracciamento per gli ordini spediti nel frattempo non verranno inviati retroattivamente — dovrai aggiornare manualmente quegli ordini nel tuo negozio.

Controlla il registro delle richieste non riuscite
Vai su Impostazioni > Integrazioni > Registro richieste non riuscite. Se Sendcloud ha tentato di inviare feedback ma ha fallito, l'errore viene registrato qui con una descrizione. È il modo più rapido per confermare se è stato fatto un tentativo di invio.

Controlla quando è stata creata l'etichetta
Il feedback viene inviato nel momento in cui l'etichetta viene creata in Sendcloud. Se l'etichetta è stata creata mentre l'integrazione era disconnessa, non sarà stato inviato alcun feedback per quell'ordine. Aggiorna manualmente lo stato dell'ordine nel tuo negozio in questi casi.

Il feedback potrebbe essere in ritardo, non mancante
Se elabori un gran numero di ordini contemporaneamente, la tua piattaforma potrebbe limitare gli aggiornamenti in entrata da Sendcloud, causando un breve ritardo prima che stati e numeri di tracciamento appaiano. Aspetta qualche minuto prima di presumere che il feedback sia completamente fallito.

Questi due errori sono i problemi legati all'autenticazione più comuni in tutte le integrazioni. Si assomigliano ma hanno cause diverse.

401 — Sendcloud non riesce ad autenticarsi con il tuo negozio
Significa che Sendcloud viene rifiutato perché le credenziali che utilizza non sono valide o sono scadute. Le cause più comuni sono:

• Le chiavi API utilizzate per connettere l'integrazione sono scadute o sono state rigenerate nel tuo negozio senza essere aggiornate in Sendcloud.
• Il tuo account Sendcloud non ha un metodo di pagamento configurato. Vai su Impostazioni > Finanze e assicurati che sia attivo un metodo di pagamento — una configurazione di fatturazione incompleta può bloccare l'autenticazione.

Per correggere un errore 401, rigenera le chiavi API nel tuo negozio e reinseriscile in Sendcloud in Impostazioni > Integrazioni > Configura. Se questo non funziona, disconnetti e reinstalla l'integrazione da zero per generare una nuova connessione.

403 — Sendcloud viene attivamente bloccato
Significa che il tuo server o un livello di sicurezza a monte sta rifiutando completamente le richieste di Sendcloud. Le cause più comuni sono:

• Gli indirizzi IP di Sendcloud vengono bloccati dal firewall o dall'ambiente di hosting del tuo server. Aggiungili alla tua lista di consentiti — l'elenco completo si trova su https://cdn.sendcloud.com/global-media/public-ips.txt.
• Cloudflare sta bloccando le richieste di Sendcloud tramite Bot Fight Mode o regole WAF. Leggi la nostra guida dedicata: Risoluzione dei problemi di Cloudflare che blocca Sendcloud.
• Per Shopify: il token OAuth utilizzato durante l'installazione è scaduto o le autorizzazioni dell'app sono cambiate. Reinstallare l'app Sendcloud in Shopify genera un nuovo token e risolve il problema.

Controlla prima il registro delle richieste non riuscite
Vai su Impostazioni > Integrazioni > Registro richieste non riuscite. Un errore 401 appare come orders.apis.base.exceptions.AuthenticationError. Un errore 403 appare come orders.apis.base.exceptions.AccessDenied o come un generico errore di accesso negato. Il registro ti indica con quale tipo hai a che fare prima di intraprendere qualsiasi azione.

Il registro delle richieste non riuscite è il tuo primo punto di riferimento per qualsiasi problema di integrazione. Registra ogni volta che Sendcloud ha tentato di comunicare con il tuo negozio e ha fallito — che si tratti di recuperare ordini, inviare feedback di tracciamento o verificare la connessione. Se qualcosa non va con la tua integrazione, il motivo si trova quasi sempre qui.

Come trovarlo
Vai su Impostazioni > Integrazioni nel tuo account Sendcloud. Trova la tua integrazione nell'elenco e clicca su Visualizza > registro dei problemi di connessione (o Registro richieste non riuscite, a seconda del tipo di integrazione).

Cosa vedrai
Ogni voce mostra la data e l'ora della richiesta non riuscita, il codice di errore e una descrizione di cosa è andato storto. Gli errori più recenti appaiono in cima. Aspetti chiave da cercare:

• Il codice di errore (401, 403, 404, 500, ecc.) indica la categoria del problema. Usa la sezione precedente sugli errori 401 e 403, o la guida di risoluzione dei problemi della tua piattaforma in fondo all'articolo, per abbinare il codice a una soluzione.
• La descrizione dell'errore spesso indica la causa esatta, per esempio: orders.apis.base.exceptions.AuthenticationError o orders.apis.base.exceptions.NotFoundError. Copia questo testo quando contatti il supporto, in quanto accelera notevolmente la diagnosi.
• Il timestamp ti indica quando il problema è iniziato. Se gli errori iniziano in un momento specifico, pensa a cosa è cambiato in quel periodo — un aggiornamento del plugin, una migrazione del server, una modifica della password o un aggiornamento di WooCommerce sono cause frequenti.

Se il registro è vuoto
Un registro vuoto non significa sempre che tutto funziona. Può significare che Sendcloud non sta raggiungendo affatto il tuo negozio — la richiesta non passa nemmeno per generare un errore. Se i tuoi ordini hanno smesso di essere importati e il registro è vuoto, torna alla checklist di connessione precedente e verifica che il tuo negozio sia accessibile pubblicamente e che gli indirizzi IP di Sendcloud non siano bloccati.

Cosa fare con l'errore
La maggior parte degli errori nel registro sono risolvibili — abbina il codice di errore alla sezione corrispondente in questo articolo o nella guida di risoluzione dei problemi della tua piattaforma. Se hai seguito i passaggi pertinenti e l'errore persiste, apri una richiesta di supporto dal tuo account Sendcloud e allega uno screenshot della voce del registro insieme al testo esatto dell'errore. È la cosa più utile che puoi fornire al supporto.