Best Practices
Recommended Configuration Settings
General Configuration
Enable the module and validate API credentials first:
Stores > Configuration > Sales > Tax > Zamp Configuration - Enable = Yes - API Token = [Your Zamp API token] - Test Connection to verify credentials
Configure tax calculation settings:
- Allow Zamp to handle your Tax Calculations = Yes - Choose your taxable states = [Select applicable states] - Default Product Tax Provider Tax Code = R_TPP
Logging Configuration
Enable logging for troubleshooting:
- Enable Logging = Yes - Log Entry Lifetime = 30 days (minimum)
Monitor
var/log/system.logandvar/log/exception.logfor errors if you experience any issues.
Performance Optimization Tips
Transaction Processing
Enable automatic transaction syncing for real-time processing
Schedule historical transaction syncs during off-peak hours
Use batch processing for large transaction volumes
Monitor sync queue status regularly
System Configuration
Optimize log retention period based on storage capacity
Enable caching for improved performance:
bin/magento cache:enable bin/magento cache:flush
Regular cleanup of transaction logs:
DELETE FROM zamp_transaction_log WHERE created_at < DATE_SUB(NOW(), INTERVAL 30 DAY);
Tax Code Management Strategies
Product Tax Codes
Use consistent tax codes across similar products
Document tax code assignments
Configure default tax codes at category level when possible
Regular audit of tax code assignments
Bundle Product Handling
Set appropriate tax codes on bundle components
Verify tax calculation on bundle products:
Fixed price bundles use bundle product's tax code
Dynamic price bundles use component tax codes
Transaction Sync Recommendations
Initial Setup
Verify API connectivity before syncing transactions
Start with small batches to validate sync process
Use test environment for initial configuration
Ongoing Management
Monitor sync queue regularly:
Sales > Zamp Historical Transactions > Queue
Review transaction logs daily:
System > Zamp Transaction Logs
Schedule regular maintenance:
Clear old transaction logs
Verify API connectivity
Check for failed transactions
Note: These best practices should be adjusted based on your specific business needs and transaction volume.
Error Handling Guidelines
Monitor error logs regularly
Set up alerts for failed transactions
Document resolution procedures for common issues
Maintain backup of transaction data