Salta al contenuto principale
Versione: 1.x

API03001: Formato di Richiesta Non Valido

Cosa Significa

La richiesta inviata al server non era nel formato previsto. Il server non è riuscito a capire cosa stava chiedendo il POS perché la struttura della richiesta era errata.

Cause Comuni

  • Dati corrotti — I dati erano corrotti prima dell'invio
  • Bug software — Un problema nell'applicazione POS
  • Interferenza del proxy — Un proxy o firewall ha modificato la richiesta
  • Problemi di codifica dei caratteri — I caratteri speciali non erano codificati correttamente

Mappatura degli Errori del Server

Questo codice di errore viene attivato quando il server restituisce:

Codice ServerFonte
HTTP 400Qualsiasi risposta del server (fallback)

Come Risolvere

1. Riprova l'Azionamento

A volte si tratta di un imprevisto temporaneo:

  • Aspetta un momento e riprova
  • Aggiorna il POS e riprova

2. Controlla i Caratteri Speciali

Se stai inserendo dati con caratteri speciali:

  • Prova a rimuovere emoji o simboli insoliti
  • Usa caratteri standard per i nomi dei prodotti, ecc.

3. Aggiorna il POS

Assicurati di utilizzare l'ultima versione:

  • Controlla se ci sono aggiornamenti per l'app
  • Aggiorna il plugin WCPOS sul tuo server

4. Controlla la Configurazione della Rete

Se sei dietro a un proxy:

  • Verifica che il proxy non stia modificando le richieste
  • Controlla le regole del firewall
  • Prova ad accedere da una rete diversa

5. Riporta il Problema

Se questo accade costantemente:

  • Nota quale azione attiva l'errore
  • Controlla la console del browser per dettagli (versione web)
  • Riporta su GitHub con i passi per la riproduzione

Errori Correlati

  • API03002 — Parametri Richiesti Mancanti
  • API03003 — Valore del Parametro Non Valido