Zamp for Shopware: Historical Data
Historical Data Management
Historical Sync Feature
The Historical Sync feature allows you to synchronize past order data with Zamp Tax:
- Access via Extensions → My Extensions → Zamp Tax → Historical Sync tab
- Syncs completed orders with paid status to Zamp Tax system
- Allows bulk synchronization of historical transactions
- Requires active Zamp API token configured in settings
Date Range Selection
Note: Historical sync is available for orders from January 1, 2022 onwards.
To select orders for synchronization:
- Locate the date range selectors in the Historical Data Sync panel
- Set Start Date (defaults to 2022-01-01 if empty)
- Set End Date (defaults to current date if empty)
- Click "Sync Historical Transactions" to begin the process
Sync Status Monitoring
Monitor synchronization progress through the status grid displaying:
| Status | Description |
|---|---|
| Requested | Total number of orders found in selected date range |
| Completed | Successfully synchronized orders |
| Already Exists | Orders previously synchronized to Zamp |
| Failed | Orders that failed to synchronize |
Handling Failed Syncs
If synchronization fails for any orders:
- Check error logs in the Logs tab
- Common failure reasons:
- Invalid shipping address information
- Missing tax codes on products
- Network connectivity issues
- API token authentication errors
- Resolution steps:
- Verify order data completeness
- Ensure correct product tax codes are assigned
- Check API token validity
- Retry synchronization for the specific date range
Important: Failed synchronizations do not affect the original order data in Shopware. You can safely retry synchronization after resolving the underlying issues.
Accessing Sync Logs
- Navigate to the Logs tab
- Select the date of the sync attempt
- View detailed sync logs including:
- API request/response details
- Error messages
- Transaction IDs
- Sync status codes
- Download logs as PDF, if desired, for record keeping.