8. Troubleshooting
Common Issues and Solutions
API Connection Issues
Issue: Failed API connection test
Verify API token is entered correctly in configuration
Check system logs for detailed error messages
Ensure proper network connectivity to
api.zamp.com
Tax Calculation Problems
Issue: Incorrect tax calculations
Verify taxable states are configured correctly
Check product tax codes are set properly
Ensure customer tax exemption codes are valid
Review transaction logs for API response details
Issue: Missing tax calculations
Confirm module is enabled (
tax/zamp_configuration/active)Verify tax calculation is enabled (
tax/zamp_configuration/allow_tax_calculation)Check if customer's state is in configured taxable states
Error Message Reference
Common Error Messages
CONFLICT: Transaction already exists in Zamp system
Resolution: Use re-sync functionality to update transaction
Connection failed!: API connection test failure
Resolution: Verify API credentials and network connectivity
Invalid tax code errors
Resolution: Reference https://developer.zamp.com/api/tax-codes for valid codes
Debug Logging
Log Locations
System Logs:
var/log/system.log var/log/exception.log
Transaction Logs:
Admin Panel:
System > Zamp Transaction LogsDatabase Table:
zamp_transaction_log
Enable Debug Logging
Navigate to Stores > Configuration > Sales > Tax > Zamp Configuration
Set "Enable Logging" to "Yes"
Configure "Log Entry Lifetime, Days" (minimum 30 days)
Save configuration
Log Contents
API requests and responses
Transaction processing status
Error messages and stack traces
Tax calculation details
Support Contact Information
Technical Support
Zamp Support:
Website: https://www.zamp.com
Knowledge Base: https://support.zamp.com
Email: [email protected]
Before Contacting Support
Please gather the following information:
Adobe Commerce version
Extension version
Error messages from logs
Steps to reproduce the issue
Transaction IDs (if applicable)
Relevant transaction log entries
Note: For security, never share your API credentials when requesting support. Also, it is recommended to clear any sensitive or irrelevant information from log files before sharing.