Zamp for Adobe Commerce: Best Practices

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.log and var/log/exception.log for 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

Error Handling Guidelines

• Monitor error logs regularly
• Set up alerts for failed transactions
• Document resolution procedures for common issues
• Maintain backup of transaction data