Common Errors and Codes in IZI
Este conteúdo não está disponível em sua língua ainda.
Common Errors and Codes in IZI
Section titled “Common Errors and Codes in IZI”Authorization and Access Errors
Section titled “Authorization and Access Errors”| Code / message | Cause | Fix |
|---|---|---|
| 401 Unauthorized | Session expired or invalid token | Log out and back into CRM |
| 403 Forbidden | No rights for the action | Check role in Settings → Staff |
| ”Invalid login or password” | Typo or password changed | Check caps lock; use email password reset if forgotten |
| ”Account blocked” | Too many failed attempts or manual block | Contact your organization’s administrator |
Agent and PC Errors
Section titled “Agent and PC Errors”| Code / message | Cause | Fix |
|---|---|---|
| ”Agent not found” | Agent not running or not installed | Launch agent on the PC or reinstall it |
| ”Agent connection timeout” | Network between agent and server interrupted | Check internet on PC, restart agent |
| ”PC offline” | Agent hasn’t responded for N seconds | Recovery instructions |
| ”Invalid agent version” | Agent version is outdated | Update agent via Settings → Equipment |
| ”License expired” | PC license has expired | Contact IZI support |
Session Errors
Section titled “Session Errors”| Code / message | Cause | Fix |
|---|---|---|
| ”Session already active” | Session already running on this PC | End the active session, then start a new one |
| ”Insufficient balance” | Client’s balance can’t cover the tariff | Top up balance or choose a lower-cost tariff |
| ”Session stuck” | Agent lost connection mid-session | Force end instructions |
| ”Tariff not available” | Tariff deactivated or not assigned to the PC | Check tariff settings in the Tariffs section |
Payment Errors
Section titled “Payment Errors”| Code / message | Cause | Fix |
|---|---|---|
| ”Payment declined” | Bank rejected the payment | Try another card or cash |
| ”Terminal unavailable” | Terminal not responding | Terminal diagnostics |
| ”Transaction timeout” | Client or cashier didn’t complete operation in time | Restart the payment |
| ”Duplicate transaction” | Repeated payment with same parameters | Wait 5 minutes or change amount; contact support if refund needed |
| ”CloudPayments error 5” | Insufficient funds on card | Another card or different payment method |
Shift Errors
Section titled “Shift Errors”| Code / message | Cause | Fix |
|---|---|---|
| ”Active sessions exist” | Can’t close shift with active sessions | End all sessions |
| ”Pending transactions” | Unfinished transactions present | Wait or cancel stuck transactions |
| ”Shift already closed” | Shift already closed by another administrator | Check Finance → Shift History |
Network and Server Errors
Section titled “Network and Server Errors”| Code / message | Cause | Fix |
|---|---|---|
| 500 Internal Server Error | Error on the IZI server | Wait 1–2 minutes and retry; if persistent — contact support |
| 503 Service Unavailable | Server temporarily unavailable (maintenance) | Wait and retry |
| ”No internet connection” | CRM device lost network | Check internet on your computer |
| ”SSL certificate error” | Security certificate issue | Update your browser; if that doesn’t help — contact support |
Error Not in the Table
Section titled “Error Not in the Table”- Copy the exact error text from the screen
- Note the time and action that triggered the error
- Contact IZI support — provide the error text and steps to reproduce
Perguntas frequentes
Where can I view the full error log in IZI?
Settings → Event Log. It shows recent system events with timestamps. For issues with a specific PC — PC card in the Hall section → History tab.
Error 403 — what does it mean?
No access rights. Either the user's role doesn't include the required action, or the auth session expired. Log out and back in; if that doesn't help — check roles in Settings → Staff.
Agent not found error appears every morning — why?
The agent isn't set to start automatically with Windows. Add IZI Agent to startup: Win+R → shell:startup → create a shortcut to the agent in the folder that opens.
Connection error after changing internet provider — what to do?
After changing providers or router settings, the IP or DNS may have changed. Restart the agent on all PCs. If that doesn't help — check whether the new router is blocking any ports.