Troubleshooting Zamp Tax
Debug Logging
Debug logging helps identify and resolve issues with tax calculations, transaction syncing, and API communication.
Enabling Debug Logs
Go to WooCommerce → Settings → Zamp Tax
Check the "Enable Debug Logging" option
Click "Save Changes"
Note: Debug logging will record detailed information about tax calculations, API calls, and transaction processing. This may impact performance if left enabled for extended periods.
Finding Log Files
Navigate to WooCommerce → Status → Logs
Look for files starting with "zamp-"
Common log files include:
In older plugin versions:
zamp-zamp_api-*.log- API communication logs.zamp-transactions-*.log- Transaction processing logs.zamp-calculations-*.log- Tax calculation logs.
plugin-zamp-tax- all plugin-related logs.
Understanding Log Messages
Log entries follow this format:
YYYY-MM-DD HH:MM:SS [Level] Message
Common log levels:
Debug - Detailed information for troubleshooting
Info - General operational messages
Error - Problems that need attention
Critical - Severe issues requiring immediate action
Common Error Resolution
When reviewing logs, pay special attention to:
API response codes other than 200
Failed transaction messages
Invalid address validation responses
Token validation errors
Common Issues & Solutions
Connection Issues
Symptoms:
"Not connected" API token status
Failed API calls
Timeout errors
Solutions:
Verify your API token is entered correctly
Ensure your site can reach api.zamp.com
Check for SSL/TLS issues
Confirm your token hasn't expired with Zamp's Support team
Calculation Errors
Symptoms:
Incorrect tax amounts
Missing tax calculations
Tax showing for non-taxable states
Solutions:
Verify nexus states are configured correctly
Check product tax codes
Validate shipping address formatting
Review tax exemption settings
Sync Failures
Symptoms:
Failed transaction syncs
Incomplete batch processing
Missing transactions in Zamp dashboard
Solutions:
Check "Send Transactions" is enabled
Review failed transactions report
Verify order statuses are "Completed" or "Processing"
Ensure correct date range for historical syncs
API Token Problems
Symptoms:
Invalid token errors
Authentication failures
Expired tokens
Solutions:
Generate a new token in your Zamp dashboard
Remove and re-add the token in WooCommerce settings
Check token permissions and scope
Clear any cached token data
Still Need Help?
If you continue experiencing issues after trying these solutions, please reach out!
Enable debug logging
Reproduce the issue
Download the relevant log files
Contact Zamp support with the logs and steps to reproduce