Questa guida copre l'installazione del plugin LedgerPort sul tuo negozio WooCommerce e il completamento della connessione a QuickBooks Online tramite la procedura guidata di configurazione.
Prima di iniziare
- Il tuo sito deve utilizzare HTTPS. LedgerPort richiede una connessione sicura e bloccherà il flusso di connessione sui siti solo HTTP.
- WooCommerce deve essere installato e attivo. LedgerPort non si attiverà senza di esso.
- È necessario un account LedgerPort attivo su ledgerport.com. Se non ne hai uno, puoi crearne uno su app.ledgerport.com.
- La valuta del tuo negozio WooCommerce deve corrispondere alla valuta principale dell'azienda QuickBooks Online. LedgerPort non converte le valute e bloccherà l'attivazione in caso di discrepanza.
Passaggio 1: Installa il plugin
Opzione A: Installa da WordPress.org
- Nella tua bacheca di WordPress, vai su Plugin » Aggiungi nuovo plugin.
- Cerca LedgerPort.
- Fai clic su Installa ora, quindi su Attiva.
Opzione B: Carica il file zip
- Nella tua bacheca di WordPress, vai su Plugin » Aggiungi nuovo plugin.
- Fai clic su Carica plugin.
- Seleziona il file
ledgerport.zipche hai scaricato. - Fai clic su Installa ora, quindi su Attiva.
Dopo l'attivazione, LedgerPort ti reindirizzerà automaticamente alla procedura guidata di configurazione. Se non vieni reindirizzato, vai su LedgerPort » Bacheca nel menu di amministrazione e fai clic su Configura connessione o trova il link alla procedura guidata di configurazione.
Passaggio 2: Apri la procedura guidata di configurazione
La procedura guidata di configurazione si apre come sovrapposizione a schermo intero. Ti guida attraverso la connessione del tuo negozio a LedgerPort e l'autorizzazione dell'accesso alla tua azienda QuickBooks Online.
Fai clic su Connetti a LedgerPort per iniziare.
Passaggio 3: Autorizza la connessione
Dopo aver fatto clic su Connetti, LedgerPort ti reindirizza a app.ledgerport.com per completare l'autorizzazione.
- Accedi al tuo account LedgerPort (o creane uno nuovo).
- Seleziona l'account aziendale LedgerPort che desideri connettere al tuo negozio WooCommerce.
- Fai clic su Autorizza per concedere a LedgerPort l'accesso al tuo negozio.
Verrai quindi reindirizzato automaticamente al tuo sito WordPress.
Passaggio 4: Provisioning della connessione
Quando vieni reindirizzato indietro, LedgerPort esegue automaticamente il flusso di provisioning in background:
- Salva le tue credenziali API in modo sicuro.
- Crea una chiave API REST di WooCommerce con accesso in lettura.
- Registra i seguenti webhook di WooCommerce per inviare dati in tempo reale a LedgerPort:
| Argomento del Webhook | Cosa cattura |
|---|---|
| ordine.creato | Nuovi ordini |
| ordine.aggiornato | Modifiche all'ordine (stato, articoli, ecc.) |
| ordine.eliminato | Ordini eliminati |
| prodotto.creato | Nuovi prodotti |
| prodotto.aggiornato | Modifiche al prodotto |
| prodotto.eliminato | Prodotti eliminati |
| cliente.creato | Nuovi clienti |
| cliente.aggiornato | Modifiche al profilo cliente |
| cliente.eliminato | Clienti eliminati |
| rimborso.creato | Rimborsi ordini |
| variante_prodotto.creata / aggiornata / eliminata | Varianti di prodotto variabili |
- Registra la connessione con la piattaforma LedgerPort.
Se il provisioning ha successo, verrai indirizzato alla Dashboard di LedgerPort e la connessione sarà attiva.
Risoluzione dei problemi di connessione
“Il tuo sito non utilizza HTTPS” Il tuo sito deve avere SSL abilitato. Contatta il tuo provider di hosting per abilitare HTTPS, quindi torna alla procedura guidata di configurazione e riprova.
“Corrispondenza valuta errata” Il tuo negozio WooCommerce è impostato su una valuta diversa rispetto alla tua azienda QuickBooks Online. Vai su WooCommerce » Impostazioni » Generali e aggiorna il campo Valuta per corrispondere alla valuta principale della tua azienda QBO, quindi riconnetti.
“Connessioni massime raggiunte” Il tuo piano LedgerPort ha un limite al numero di negozi connessi. Accedi a app.ledgerport.com, rivedi il tuo piano ed effettua l'aggiornamento se necessario.
“Questo sito è già connesso a un altro account” L'URL del tuo sito è già registrato sotto un account LedgerPort diverso. Se possiedi quell'account, accedi a app.ledgerport.com e disconnetti la connessione esistente, quindi riconnetti. Se ciò è inaspettato, contatta il supporto LedgerPort.
Provisioning fallito a metà LedgerPort utilizza un rollback transazionale. Se un passaggio del provisioning fallisce, tutti i passaggi completati (chiavi API, webhook) vengono annullati automaticamente in modo che il tuo negozio WooCommerce non rimanga in uno stato parziale. Torna alla procedura guidata di configurazione e riprova.
Disconnessione
Per disconnettere il tuo negozio da LedgerPort:
- Vai su LedgerPort » Connessione.
- Fai clic su Disconnetti.
- Conferma la disconnessione.
LedgerPort:
- Eliminerà la chiave API REST di WooCommerce che ha creato.
- Eliminerà tutti i webhook di LedgerPort da WooCommerce.
- Notificherà la piattaforma LedgerPort in modo che la connessione venga disattivata sul lato SaaS.
Il tuo negozio e i tuoi ordini WooCommerce non vengono interessati. Vengono rimossi solo la chiave API specifica di LedgerPort e i webhook.
Riconnessione
Per riconnetterti dopo una disconnessione, torna su LedgerPort » Dashboard e fai clic sul pulsante di configurazione o riconnessione per eseguire nuovamente la procedura guidata di configurazione. Tutte le mappature precedenti memorizzate in LedgerPort vengono mantenute.
Domande Frequenti
Devo creare manualmente la chiave API di WooCommerce? No. LedgerPort crea e gestisce la chiave API REST di WooCommerce automaticamente durante il flusso di connessione. Non è necessario configurare nulla in WooCommerce » Impostazioni » Avanzate » REST API.
LedgerPort influenzerà i miei webhook WooCommerce esistenti? LedgerPort crea e gestisce solo i propri webhook (denominati “LedgerPort – topic”). Non modifica alcun webhook creato da te.
Dove vengono archiviate le mie credenziali? La tua chiave API LedgerPort e le credenziali WooCommerce sono archiviate nella tabella delle opzioni di WordPress, crittografate utilizzando AES-256-CBC con le chiavi di sicurezza di WordPress del tuo sito.
Posso rieseguire la procedura guidata di configurazione senza disconnettermi? Se sei già connesso, la procedura guidata di configurazione riconoscerà la connessione esistente. Per iniziare da capo, disconnettiti prima dalla pagina Connessione, quindi esegui nuovamente la procedura guidata.
Quale ruolo utente di WooCommerce è richiesto per connettere LedgerPort? Devi disporre della funzionalità manage_woocommerce, assegnata per impostazione predefinita agli amministratori di WordPress e ai responsabili del negozio WooCommerce.
Se riscontri problemi, non esitare a contattarci facendo clic qui. Il nostro team di supporto sarà in grado di aiutarti.
