- 1L'analisi in cinque minuti: Autorizzazione, Dati o Configurazione?
- 2Classe 1: La connessione è caduta (scadenza autorizzazione)
- 3Classe 2: Ordini mancanti o in ritardo
- 4Classe 3: Transazioni duplicate (sovrapposizione feed bancario + connettore)
- 5Classe 4: Commissioni raggruppate nei depositi
- 6Classe 5: Conti errati e deriva del mapping
- 7Classe 6: Sincronizzazione interrotta dopo una modifica di app o tema
- 8Quando la tua integrazione QuickBooks Shopify non funziona come previsto
- 9Se questa è la terza volta che visiti questa pagina
Sei classi di errore coprono quasi ogni problema. Trova il tuo in cinque minuti, quindi applica la soluzione e scopri quale soluzione non dura mai.
L'ultimo ordine in QuickBooks è di martedì. È venerdì. Non hai cambiato nulla, nessuno ha toccato nulla, eppure la tua integrazione QuickBooks Shopify non funziona — di nuovo — tre giorni prima di aver bisogno di numeri puliti per una dichiarazione IVA.
Se questo ti sembra familiare, probabilmente lo è. La maggior parte delle persone che arrivano su questa pagina hanno già riconnesso l'integrazione una volta, l'hanno vista funzionare per qualche settimana e hanno pensato che il problema fosse risolto. Poi si è rotta in modo diverso — che è esattamente il motivo per cui l'ultima soluzione non è durata.
Due cose prima delle soluzioni. Primo, una precisazione: produciamo uno strumento di sincronizzazione a pagamento concorrente, quindi il nostro punto di vista esiste. La discussione sul prodotto rimane completamente fuori dalla risoluzione dei problemi — appare una volta, chiaramente etichettata, alla fine. Secondo, un cambio di prospettiva: la bugia che tiene bloccate le persone su questa pagina è "Devo averla configurata male." Quasi certamente non è così. La rottura della sincronizzazione non è un problema con una soluzione — sono sei classi di errore distinte, ognuna con i propri sintomi, cause e riparazioni. Diagnostica prima, poi risolvi.
L'analisi in cinque minuti: Autorizzazione, Dati o Configurazione?
Ogni errore di sincronizzazione risponde a una di tre domande. Rispondi in ordine per trovare la tua sezione.
1. Qualcosa si sta sincronizzando? Trova la transazione più recente creata dal connettore in QuickBooks. Se tutto si è fermato in una data specifica, hai un problema di connessione — autorizzazione persa (Classe 1), o una modifica lato Shopify che l'ha interrotta (Classe 6).
2. I dati arrivano, ma incompleti o in ritardo? Ordini mancanti, o tutto che appare un giorno dopo del previsto: un problema di flusso dati (Classe 2).
3. I dati arrivano, ma errati? Le entrate sembrano raddoppiate, le commissioni sono invisibili, o il reddito finisce su conti strani: un problema di configurazione (Classi 3, 4 e 5).
| Sintomo | Classe probabile |
|---|---|
| Nulla si è sincronizzato da una data specifica | 1 — Autorizzazione scaduta |
| Interrotto subito dopo aver cambiato app, temi o piani | 6 — Modifica app/tema |
| Alcuni ordini mancanti, o in ritardo | 2 — Ordini mancanti o in ritardo |
| Le entrate sembrano raddoppiate | 3 — Duplicati |
| Le entrate corrispondono ai depositi, ma non ci sono spese di commissione da nessuna parte | 4 — Commissioni raggruppate nei depositi |
| Vendite che finiscono in "Entrate non categorizzate" o account strani | 5 — Deriva di mappatura |
Passa alla tua classe. Ognuna ti fornisce i sintomi, la causa effettiva e i passaggi di correzione che puoi eseguire da solo.
Classe 1: La connessione è caduta (scadenza autorizzazione)
Sintomi: la sincronizzazione si è interrotta completamente in una data specifica. Nulla è fallito rumorosamente: gli ordini hanno semplicemente smesso di apparire. Le impostazioni del connettore potrebbero mostrare il negozio disconnesso o chiederti di riautorizzare.
Perché succede: l'integrazione funziona tramite un token di autorizzazione concesso al momento della prima connessione. I token vengono revocati più spesso di quanto ci si aspetti: un cambio di password, la disattivazione di un account del personale, una modifica delle autorizzazioni, un evento di sicurezza di routine da entrambe le parti. La persona che ha originariamente connesso l'integrazione lasciando il tuo team è il classico killer silenzioso: le sue credenziali scompaiono e la connessione scompare con esse.
La correzione:
- Riautorizza nelle impostazioni del connettore. Disconnetti e riconnetti il negozio, approvando tutte le autorizzazioni richieste.
- Usa l'account giusto. Riconnetti come proprietario del negozio o amministratore dell'azienda, non come utente staff che potrebbe essere disattivato in seguito. Questa singola abitudine previene la maggior parte dei fallimenti di autenticazione ripetuti.
- Controlla i filtri della tua posta elettronica. La maggior parte dei connettori invia un avviso di disconnessione. Se è finito nello spam, hai perso giorni di sincronizzazione senza saperlo. Aggiungi il mittente all'elenco consentiti.
- Ripristina il periodo mancante. La riconnessione non sempre risincronizza la finestra disconnessa. Annota la data di interruzione e la data di riconnessione, quindi verifica se quegli ordini sono arrivati; in caso contrario, le correzioni della Classe 2 coprono il loro recupero.
Prevenzione: dedica un account amministrativo all'integrazione e metti un controllo mensile di due minuti sul tuo calendario: l'ordine più recente in QuickBooks corrisponde all'ultimo in Shopify?
Classe 2: Ordini mancanti o in ritardo
Sintomi: i totali non corrispondono ai tuoi report Shopify. Ordini specifici sono assenti, o tutto appare un giorno o più dopo la vendita.
Perché succede: tre cause separate si nascondono sotto questo unico sintomo.
- Frequenza di sincronizzazione. Molti connettori sincronizzano secondo una pianificazione, batch giornalieri piuttosto che in tempo reale. Un "ritardo" potrebbe essere semplicemente la pianificazione che funziona come previsto.
- Ambito. I connettori spesso sincronizzano un sottoinsieme di tipi di ordini per progettazione. Le vendite POS, gli ordini bozza o gli ordini da canali di vendita aggiuntivi potrebbero essere esclusi.
- Confini. Una sincronizzazione iniziata a metà mese di solito non va indietro nel tempo, e una discrepanza di fuso orario tra Shopify e il tuo file aziendale QuickBooks può spostare gli ordini vicini alla mezzanotte nel giorno sbagliato.
La correzione:
- Controlla la pianificazione di sincronizzazione nelle impostazioni del connettore e conferma che il ritardo non sia solo la cadenza configurata. Attiva una sincronizzazione manuale se l'opzione è disponibile.
- Trova il modello negli ordini mancanti. Recupera cinque di essi in Shopify. Stesso canale? Stesso intervallo di date? Stesso metodo di pagamento? Un modello indica un limite di ambito, non un malfunzionamento.
- Se si tratta di un limite di ambito, registra gli ordini esclusi in un altro modo — in genere una scrittura di diario mensile per i totali di quel canale — e accetta che il connettore non li gestirà.
- Se si tratta di una finestra di intervallo (da un'interruzione di autorizzazione o da un inizio a metà mese), cerca un'opzione di importazione storica o di risincronizzazione dell'intervallo di date nelle impostazioni del connettore. Nessuna opzione significa che l'intervallo viene inserito manualmente, una sola volta.
- Allinea i fusi orari tra le impostazioni del tuo negozio Shopify e QuickBooks in modo che gli ordini di confine giornaliero rientrino nel periodo corretto.
Classe 3: Transazioni duplicate (sovrapposizione feed bancario + connettore)
Sintomi: le entrate in QuickBooks sono circa il doppio di quanto hai effettivamente venduto. Ordini o pagamenti appaiono due volte. Il tuo conto economico sembra fantastico e completamente sbagliato.
Perché succede: questa è la più comune errore di configurazione e non è un bug in nulla. Il connettore registra le tue vendite Shopify in QuickBooks. Poi il tuo feed bancario importa il deposito del pagamento Shopify — gli stessi soldi — e se fai clic su Aggiungi invece di Abbina, QuickBooks crea una seconda voce di reddito sopra la prima. Ogni Aggiungi raddoppia un pagamento.
La correzione:
- Cambia prima l'abitudine: da oggi, non aggiungere mai un pagamento Shopify dal feed bancario. Abbinalo sempre alla transazione che il connettore ha già creato. Aggiungi crea reddito; Abbina conferma il reddito che esiste già.
- Pulisci i duplicati esistenti. Trova i depositi che sono stati Aggiunti dove il connettore aveva già registrato le vendite; annullali o escludili, quindi Abbinali correttamente. Lavora mese per mese, partendo dai più recenti.
- Verifica la presenza di un secondo sincronizzatore. Due connettori in esecuzione contemporaneamente — una vecchia app che non hai mai disinstallato più una nuova — o lo stesso intervallo di date importato due volte duplicheranno anche. Uno strumento, una fonte di verità.
- Verifica con un pagamento. Traccia un singolo pagamento recente: un set di voci di vendita, un deposito, abbinati insieme. Se quella catena è pulita, la tua pulizia ha funzionato.
Classe 4: Commissioni raggruppate nei depositi
Sintomi: le entrate in QuickBooks corrispondono quasi esattamente ai tuoi depositi bancari — il che suona bene finché non noti che è inferiore a quanto Shopify dice che hai venduto, e nessuna spesa per commissioni Shopify esiste da nessuna parte nel tuo conto economico.
Perché succede: Shopify ti paga netto — vendite meno rimborsi meno commissioni di elaborazione, come un unico deposito forfettario. Se l'integrazione registra quel forfettario come reddito, le commissioni svaniscono al suo interno: depositi netti registrati come ricavi lordi, il che dichiara in modo errato sia le entrate che le spese e può distorcere la cifra di vendita su cui si basano le tue dichiarazioni fiscali. L'anatomia completa di quel divario si trova in Commissioni Shopify in QuickBooks.
La correzione:
- Cerca opzioni di gestione delle commissioni nelle impostazioni del connettore. Se il connettore può suddividere i pagamenti in vendite, rimborsi e commissioni, attivalo e mappa la riga delle commissioni a un conto di spesa "Commissioni di elaborazione del commerciante".
- Se non è possibile, arrotonda manualmente. Una volta al mese, estrai il report dei pagamenti di Shopify, somma le commissioni e registra una scrittura contabile: aumenta le vendite dell'importo della commissione, registra lo stesso importo come spesa per commissioni. Il reddito netto non cambia, ma ricavi e spese diventano entrambi veritieri.
- Correggi la cronologia che conta. Come minimo, correggi l'anno fiscale corrente nello stesso modo, una voce al mese.
Una bandiera onesta: se il passaggio 1 non ha prodotto risultati, non è una errata configurazione, è un limite. Tieni a mente questo pensiero per la sezione dopo le correzioni.
Classe 5: Conti errati e deriva del mapping
Sintomi: vendite che appaiono in "Redditi non classificati". I ricavi di un nuovo metodo di pagamento che finiscono in un posto strano. Libri contabili che erano accurati al momento dell'impostazione e che sono diventati lentamente sempre più errati da allora.
Perché succede: la mappatura, ovvero quali fondi di Shopify vanno a quale conto QuickBooks, viene configurata una volta, all'installazione, in base al negozio che avevi allora. I negozi cambiano: un nuovo gateway di pagamento, buoni regalo, un nuovo canale di vendita, un conto rinominato nel tuo piano dei conti. Tutto ciò che la mappatura non riconosce finisce nel conto predefinito del connettore, e i predefiniti sono dove l'accuratezza muore silenziosamente.
La correzione:
- Apri la sezione di mappatura nelle impostazioni del connettore e controlla ogni riga: ogni categoria di fondi di Shopify (vendite, rimborsi, commissioni, tasse, gateway) rispetto al conto QuickBooks a cui viene registrata.
- Caccia i riassuntivi. Tutto ciò che viene instradato a un conto generico predefinito o "Non classificato" è una deriva non mappata. Assegnagli un conto reale.
- Riassegna gli elementi sparsi. Con la mappa corretta, trova le transazioni storiche nei conti sbagliati e spostale: gli strumenti di riassegnazione di QuickBooks o il tuo commercialista possono farlo in blocco.
- Rivedi la mappa trimestralmente e aggiungi un passaggio alla checklist di lancio: un nuovo gateway, canale o tipo di prodotto significa controllare la mappa quella settimana.
Classe 6: Sincronizzazione interrotta dopo una modifica di app o tema
Sintomi: l'interruzione è correlata a una modifica: hai installato o rimosso un'app Shopify, cambiato tema, modificato i piani Shopify o aggiunto un'app per il checkout o la modifica degli ordini.
Perché succede: le app Shopify possono condividere autorizzazioni, alterare i dati degli ordini o cambiare il modo in cui gli ordini vengono creati. La disinstallazione di un'app può revocare l'accesso di cui un'altra dipendeva. Le app di modifica degli ordini e di upselling possono produrre forme di ordine che il connettore non si aspetta e su cui fallisce silenziosamente.
La correzione:
- Costruisci la cronologia. Abbina la data in cui la sincronizzazione si è interrotta con il tuo registro delle modifiche: Shopify conserva un record delle attività del negozio e la cronologia delle installazioni delle tue app si trova nell'amministrazione.
- Riconnetti prima. Un disturbo delle autorizzazioni assomiglia esattamente alla Classe 1, e la correzione della Classe 1 (riautorizzazione completa con un account amministratore) risolve la maggior parte di questi problemi.
- Testa con un ordine. Se gli ordini toccati da un'app specifica falliscono mentre altri si sincronizzano, l'hai isolata.
- Escala con dettagli specifici. Contatta il supporto del connettore e il supporto dell'app con la data dell'interruzione, numeri di ordini di esempio e la cronologia. Prove specifiche trasformano un ticket di due settimane in uno di due giorni.
Quando la tua integrazione QuickBooks Shopify non funziona come previsto
Ora la parte onesta. Guarda la classe che hai appena corretto e chiediti: era un problema tuo o un problema dello strumento?
I problemi-tuoi vengono risolti una volta e rimangono risolti. L'abitudine Add-vs-Match. La revisione della mappatura che nessuno ha programmato. L'integrazione connessa tramite il login di un ex dipendente. Le email di disconnessione che finiscono nello spam. Nessuno di questi si ripete se adotti i passaggi di prevenzione — e nessuno strumento, a nessun prezzo, li risolve per te.
I limiti degli strumenti ritornano, non importa cosa fai. Commissioni che non possono essere suddivise dai depositi per ogni pagamento. Tipi di ordini o canali che il connettore non supporta, mai. Cadenza di sincronizzazione che non puoi cambiare. Nessun modo per riempire un vuoto senza inserimento manuale. Se la tua "correzione" si è trasformata in un rituale mensile — una scrittura di diario ricorrente, una pulizia ricorrente, un'importazione manuale ricorrente — non hai corretto l'integrazione. Sei diventato parte di essa.
Nessuno dei due verdetti è un insulto. Un connettore gratuito o entry-level che fa esattamente ciò per cui è stato costruito, al tuo volume, è una risposta perfettamente valida — molti negozi dovrebbero correggere l'abitudine, tenere lo strumento e smettere di leggere qui. La distinzione è importante perché i due verdetti hanno passi successivi opposti: uno è un promemoria sul calendario, l'altro è una migrazione.
Se questa è la terza volta che visiti questa pagina
Se hai aggiunto questo post ai preferiti, il segnalibro è l'indizio. Risolvere una sincronizzazione una volta è manutenzione. Risolverla ogni mese è un abbonamento pagato con le domeniche sera.
Se ci sei, tre letture, in ordine:
- Revisione Connettore QuickBooks Shopify — cosa fa bene il connettore gratuito e precisamente dove si ferma, così puoi nominare il tuo limite invece di indovinare.
- Superare il Connettore Gratuito QuickBooks — come migrare a uno strumento di sincronizzazione più potente senza rifare la tua cronologia.
- Miglior Software di Contabilità Shopify — l'intero campo di ciò a cui migreresti, inclusi gli strumenti che ci battono su lavori specifici.
E la divulgazione dall'inizio, messa in pratica: noi realizziamo LedgerPort, una sincronizzazione a pagamento da Shopify e WooCommerce a QuickBooks costruita attorno ai limiti di questo post — journal dei pagamenti con commissioni suddivise per deposito, mappatura che controlli e lacune di sincronizzazione che puoi vedere e riparare invece di scoprire al momento delle tasse. Il piano gratuito copre 30 ordini al mese — abbastanza per elaborare un pagamento reale e verificare se la Classe 4 scompare dalla tua vita. Se non lo fa, hai perso cinque minuti e hai già triagiato più velocemente di così oggi.
