Logging & Troubleshooting
Accessing Logs
To access Zamp Tax logs:
Navigate to Extensions → My Extensions → Zamp Tax
Click the "Logs" tab in the main navigation
Select a date using the date picker
Click "Get Logs" to view logs for that date
Use "Download Logs as PDF" to save logs for record keeping
Note: Logs are stored in daily files with format YYYY-MM-DD_log.txt
Understanding Log Formats
Log entries follow this format:
HH:MM:SS - EVENT TYPE
REQUEST/RESPONSE/ERROR: {JSON data}Common event types include:
INITIAL RESPONSE FROM ZAMP CALCULATION
ERROR IN RESPONSE FROM ZAMP CALCULATION
TEST ZAMP API TOKEN RESPONSE
PAID EVENT ORDER OBJECT RETRIEVED
REFUND EVENT ORDER OBJECT RETRIEVED
Common Error Messages
Error Message | Description | Resolution |
ERROR IN RESPONSE FROM ZAMP CALCULATION | Failed to get tax calculation from API | Verify API token and connection |
ERROR CALCULATING HISTORICAL SYNC TRANSACTION | Historical sync process failed | Check order data and retry sync |
ERROR IN DELETING PREVIOUS ORDER FROM ZAMP | Failed to remove outdated transaction | Manual cleanup may be required |
ERROR IN REFUND EVENT RESPONSE | Refund processing failed | Verify refund amount and order status |
Troubleshooting Steps
Verify API Configuration:
Check API token validity in Settings tab
Ensure calculations are enabled
Confirm selected taxable states
Check Order Data:
Verify shipping address is complete
Ensure product tax codes are assigned
Validate customer exemption status
Review Recent Logs:
Check timestamps of errors
Look for patterns in failed requests
Verify HTTP response codes
Common Fixes:
Clear browser cache
Reconnect API token
Verify network connectivity
Check SSL certificate validity
Important: If errors persist after trying these steps, contact Zamp support with your log files for further assistance.
Log Retention
Configure log retention settings in the Settings tab:
Enable "Compress and Retain Zamp logs after 30 days" to maintain historical logs
Logs are compressed after 30 days to save space
Access compressed logs through the Logs tab using the date selector