Zamp for Shopware: Logging & Troubleshooting

Logging & Troubleshooting

Accessing Logs

To access Zamp Tax logs:

  1. Navigate to Extensions → My Extensions → Zamp Tax
  2. Click the "Logs" tab in the main navigation
  3. Select a date using the date picker
  4. Click "Get Logs" to view logs for that date
  5. 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

  1. Verify API Configuration:
    • Check API token validity in Settings tab
    • Ensure calculations are enabled
    • Confirm selected taxable states
  2. Check Order Data:
    • Verify shipping address is complete
    • Ensure product tax codes are assigned
    • Validate customer exemption status
  3. Review Recent Logs:
    • Check timestamps of errors
    • Look for patterns in failed requests
    • Verify HTTP response codes
  4. 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