Salta al contenuto principale
Versione: 1.x

DB03001: Errore di Sintassi della Query

Cosa Significa​

La query del database presenta errori di sintassi. Questo indica tipicamente un bug nell'applicazione piuttosto che un errore dell'utente.

Cause Comuni​

  • Bug software — Un problema nell'applicazione POS
  • Disallineamento della versione — Schema dati incompatibile
  • Dati corrotti — I dati contengono caratteri imprevisti
  • Problemi di codifica — Problemi di codifica dei caratteri

Come Risolvere​

1. Aggiorna l'Applicazione​

Assicurati di utilizzare l'ultima versione:

  • Controlla aggiornamenti per l'app POS
  • Aggiorna il plugin WordPress WCPOS
  • Riavvia dopo l'aggiornamento

2. Cancella i Dati dell'Applicazione​

Verifica prima che non ci siano lavori non salvati

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 gli altri passaggi di questa pagina non sono stati utili, e solo dopo aver eseguito il controllo indicato sopra, reimposta tutto:

  • Cancella i dati/cache locali
  • Accedi di nuovo
  • Riesegui la sincronizzazione dei dati

3. Controlla i Caratteri Speciali​

Se l'errore si verifica con dati specifici:

  • Controlla la presenza di caratteri insoliti nei nomi dei prodotti
  • Cerca emoji o simboli speciali
  • Prova con dati più semplici

4. Segnala il Bug​

Se il problema persiste:

  1. Nota quale azione causa l'errore
  2. Cattura eventuali dettagli sull'errore
  3. Riporta su GitHub

Di Solito è un Bug​

Gli errori di sintassi delle query sono tipicamente bug nel software, non errori dell'utente. Se incontri questo:

  • Non stai facendo nulla di sbagliato
  • Il team di sviluppo deve sapere
  • Una correzione sarà rilasciata in un aggiornamento

Soluzione Alternativa​

Fino a quando non sarà disponibile una correzione:

  • Prova approcci alternativi per svolgere il tuo compito
  • Usa l'amministrazione di WooCommerce per le operazioni interessate
  • Controlla regolarmente gli aggiornamenti
  • DB03002 — Tipo di Dato Non Valido
  • API03001 — Formato Richiesta Non Valido