API02003: トークンが無効
これは何を意味するか
使用されている認証トークンがサーバーによって認識されていません。これはトークンが期限切れであることとは異なります — このトークンは有効でなかったか、取り消されています。
一般的な原因
- トークンが取り消された — 管理者がセッションを取り消しました
- トークンが破損した — 保存または送信中のデータ破損
- サーバーリセット — サーバーの秘密鍵が変更され、すべてのトークンが無効になりました
- 間違ったサーバー — 別のWordPressインストールからのトークン
サーバーエラーのマッピング
このエラーコードは、サーバーが返すときにトリガーされます：
| サーバーコード | ソース |
|---|---|
jwt_auth_invalid_token | JWT認証プラグイン |
修正方法
1. 再ログインする
セッションをクリアして、再認証してください。このデバイスに店舗に届いていない販売データがある可能性がある場合は、まず手順2の警告に従って確認してください：
- 完全にログアウトする
- POSを閉じて再度開く
- 認証情報を使ってログインする
2. アプリケーションデータをクリアする
まず未保存の作業がないか確認してください
ローカルデータを消去するかアプリを再インストールすると、このデバイスから店舗に届いていないデータ（オフライン中の販売、開いているカート、保存されていない編集内容など）が削除されます。消去する前にStore health → Databaseを開き、保留中またはサーバーに一度も届いていないデータがないことを確認してください。次にStore health → Logsでstuck recordsが0件、changes waiting to sendが0件であることを確認し、すべての開いているカートを完了するか記録してください。WCPOSにStore healthページがない場合は、先にWCPOSを更新してから確認してください。項目が表示されている、送信待ちがある、または確認できない場合は消去せず、店舗オーナーに相談するかサポートに連絡してください。
ログアウトで解決しない場合に限り、上記を確認してから実行してください：
- POSアプリのキャッシュ/データをクリアする
- ウェブの場合：サイトのブラウザクッキーとローカルストレージをクリアする
- デスクトップの場合："データをクリア"オプションがアプリ設定にあるか確認する
3. サーバー設定を確認する
この問題がすべてのユーザーに影響を与える場合：
- WordPressのソルトが変更されたか確認する
- JWTまたは認証プラグインの設定を確認する
- 最近のサーバー変更をレビューする
4. 正しいサーバーに接続していることを確認する
POSが正しいWordPressサイトに接続するように設定されていることを確認します。特に複数のインストールがある場合は注意が必要です。