Zamp for Adobe Commerce: Troubleshooting

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 Logs
  • Database Table: zamp_transaction_log

Enable Debug Logging

1. Navigate to Stores > Configuration > Sales > Tax > Zamp Configuration
2. Set "Enable Logging" to "Yes"
3. Configure "Log Entry Lifetime, Days" (minimum 30 days)
4. 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: support@zamp.com

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