Error Codes Reference

Troubleshoot SuitePortal errors with this complete error code reference. Authentication, sync, payment, and API error codes with solutions.

This reference explains common errors you might encounter and how to fix them.

Authentication Errors

These errors occur when logging in or accessing the portal.

Error	What It Means	How to Fix
Invalid credentials	Email or password is incorrect	Double-check your email and password. Use "Forgot Password" if needed.
Account locked	Too many failed login attempts	Wait 15 minutes or contact your admin to unlock.
Session expired	You were logged out due to inactivity	Log in again.
Access denied	You don't have permission for this action	Contact your admin to request access.

These errors occur when syncing data from NetSuite.

Error	What It Means	How to Fix
Connection failed	Can't connect to NetSuite	Check NetSuite credentials. Verify TBA is enabled.
Permission denied	NetSuite role lacks access	Add required permissions to the integration role.
Sync timeout	Sync took too long	Reduce batch size. Run during off-hours.
Invalid record	Record data doesn't match expected format	Check for data issues in NetSuite.
Rate limited	Too many NetSuite API calls	Wait and retry. Consider reducing sync frequency.

These errors occur when processing payments.

Error	What It Means	How to Fix
Payment declined	Card was declined by the bank	Try a different payment method. Contact your bank.
Invalid card	Card number is incorrect	Double-check card details.
Expired card	Card expiration date has passed	Use a card that hasn't expired.
Insufficient funds	Not enough money in account	Use a different payment method.
Processing error	Temporary issue with payment processor	Wait a moment and try again.

These errors occur when using the API.

Error	What It Means	How to Fix
Invalid API key	The API key is incorrect or revoked	Check your API key. Generate a new one if needed.
Rate limit exceeded	Too many API calls in a short time	Slow down requests. Check your rate limits.
Invalid request	The request format is wrong	Review API documentation for correct format.
Resource not found	The requested data doesn't exist	Verify the ID or path is correct.
Server error	Something went wrong on our end	Wait and retry. Contact support if it persists.

Quick reference for HTTP status codes you might see.

Code	Meaning
200	Success — Everything worked
201	Created — New resource was created
400	Bad Request — Check your request format
401	Unauthorized — Check your credentials
403	Forbidden — You don't have permission
404	Not Found — Resource doesn't exist
429	Rate Limited — Slow down your requests
500	Server Error — Try again later

If you can't resolve an error.