Skip to main content

Administrative Interface

Guide to the Adobe Commerce (Magento) admin screens for historical transaction sync, sync queue, and Zamp API logs.

Administrative Interface

Historical Transaction Management

Location and Access

  • Navigate to Sales > Zamp Historical Transactions > Sync

  • Requires permission: ATF_Zamp::historical_transaction

Transaction Grid

The transaction grid provides a comprehensive view of orders that can be synced with Zamp:

  • Columns include:

    • Order ID

    • Purchase Date

    • Bill-to Name

    • Ship-to Name

    • Grand Total

    • Status

  • Filter options:

    • Date range picker for Purchase Date

    • Order status filter

    • Store view filter

Available Actions

  • Mass Actions:

    • Sync: Send selected transactions to Zamp

  • Search functionality for finding specific orders

  • Re-sync capability for failed transactions

Queue Management

Location and Access

  • Navigate to Sales > Zamp Historical Transactions > Queue

  • Requires permission: ATF_Zamp::historical_transaction_sync_queue

Queue Management Interface

  • Grid displays:

    • Queue ID

    • Date

    • Order Number

    • Transaction Type (Invoice/Refund)

    • Batch ID

    • Status

  • Status indicators:

    • Pending

    • Synced

    • Error

Monitoring Progress

  • Real-time progress indicator shows sync status

  • Background processing via cron job

  • Visual progress bar for batch processing

  • Automatic status updates every 5 seconds

Queue Issue Resolution

  • Failed transactions can be identified by status

  • Detailed error messages in transaction logs

  • Manual re-sync capability for failed items

  • Batch processing controls to manage load

Transaction Logs

Location and Access

  • Navigate to System > Zamp Transaction Logs

  • Requires permission: ATF_Zamp::transaction_log

Log Entry Details

  • Each log entry contains:

    • Log ID

    • Date/Time

    • Status (Success/Error)

    • API Request Data

    • API Response Data

    • Endpoint URL

    • HTTP Method

Log Maintenance

Configure log settings under Stores > Configuration > Sales > Tax > Zamp Configuration:

  • Enable/disable logging

  • Set log retention period (minimum 30 days)

  • Automatic cleanup via cron job

Troubleshooting with Logs

  • View detailed API request/response data

  • Track transaction processing history

  • Identify API errors and issues

  • Export functionality for external analysis

Note: Access to different sections of the administrative interface is controlled by ACL permissions. Ensure users have appropriate permissions assigned to access these features.

Did this answer your question?