Salta al contenuto principale
Versione: 1.x

API06003: Configurazione del sito non valida

Cosa Significa​

La configurazione del sito è invalida o incompleta. Questo potrebbe comportare URL errati, impostazioni di autenticazione o altri problemi di configurazione.

Cause Comuni​

  • Configurazione parziale — Alcune impostazioni mancano
  • Impostazioni discordanti — La configurazione non corrisponde al sito
  • Configurazione danneggiata — Le impostazioni sono state corrotte
  • Modifiche al sito — Il sito è stato modificato senza aggiornare la configurazione del POS

Come Risolvere​

1. Rivedere tutte le impostazioni​

Controlla la configurazione completa:

  • L'URL del sito è corretto
  • L'autenticazione è correttamente configurata
  • Eventuali impostazioni aggiuntive sono corrette

2. Riconfigurare da zero​

Controlla prima che non ci siano modifiche non salvate

La cancellazione dei dati locali o la reinstallazione dell'app elimina tutto ciò che si trova su questo dispositivo e non è ancora arrivato al negozio, comprese le vendite effettuate offline, i carrelli aperti e le modifiche non salvate. Prima di cancellare qualsiasi dato, apri Stato del negozio → Database e verifica che non ci siano elementi indicati come bloccati o mai arrivati al server; poi controlla in Stato del negozio → Registri che ci siano 0 record bloccati e 0 modifiche in attesa di invio; infine completa o annota ogni carrello aperto. Se WCPOS non mostra la pagina Stato del negozio, aggiorna prima WCPOS e poi verifica. Se trovi elementi elencati o in attesa, oppure non puoi effettuare il controllo, non cancellare nulla: chiedi al proprietario del negozio o contatta il supporto.

Solo se la configurazione è danneggiata, e solo dopo aver effettuato il controllo precedente:

  1. Cancella tutte le impostazioni memorizzate
  2. Inizia nuovamente il processo di configurazione
  3. Inserisci una nuova configurazione

3. Controlla i requisiti del sito​

Verifica che il tuo sito WordPress soddisfi i requisiti:

  • WordPress è installato e accessibile
  • WooCommerce è installato e attivo
  • Il plugin WCPOS è installato e attivo
  • I permalink sono abilitati (non "Semplice")

4. Testa l'accesso al sito​

Verifica che questi URL funzionino in un browser:

  • https://yoursite.com/ — Sito principale
  • https://yoursite.com/wp-json/ — REST API
  • https://yoursite.com/wp-json/wcpos/v1/ — API di WCPOS

5. Controlla le impostazioni di WordPress​

Nell'amministrazione di WordPress:

  1. Impostazioni → Generale — Verifica gli URL
  2. Impostazioni → Permalink — Assicurati che non sia "Semplice"
  3. WooCommerce → Stato — Controlla eventuali problemi

Requisiti di Configurazione​

Una configurazione valida necessita di:

  • URL del sito — URL completo con protocollo
  • Autenticazione — Credenziali valide o chiavi API
  • Permessi — L'utente ha accesso al POS
  • Plugin — I plugin richiesti sono attivi