menzzo:v2:sales:check-disabled-import

Overview

Checks the disabled sales import alert lifecycle without importing Magento orders.

This command must be scheduled every 30 minutes. It is intentionally separate from menzzo:v2:sales, so the importer only imports and the monitor only monitors.

Schedules

1. */30 * * * * - Required production schedule

Command Details

1. menzzo:v2:sales:check-disabled-import

Intent & Purpose

The command ensures the MZ_ACTIVATE_SALES_IMPORT config row exists, reads whether sales import is enabled, and delegates the alert lifecycle to SaleImportMonitoringService.

It never launches Magento import, never reads the Magento cursor through SaleService::getLastMagentoId(), and never imports orders.

Workflow

Operator Notes

• Alerting starts only if MZ_ACTIVATE_SALES_IMPORT stays disabled for more than 30 minutes.
• SystemAlertService::add() deduplicates the open SaleImportDisabledAlert by model, info, and unresolved state, so repeated monitor runs do not create repeated alerts while one is already open.
• When the import flag is re-enabled, the next monitor run resolves matching open disabled-import alerts automatically.
• Microsoft Teams notification remains optional and non-blocking. If MZ_TEAMS_ALERT_WEBHOOK_URL is empty, no Teams message is sent; Teams delivery failures are logged and do not block the system alert path.
• The command is scheduled in docs/system-crontab.md and must run every 30 minutes in production.