Guide

Common Errors

ABM Warranty is designed to surface errors clearly without crashing, blocking the interface, or silently failing. Errors are scoped to the active tenant and are recorded in both the Status Dashboard and Logs.

Most issues fall into a small number of predictable categories. Understanding how they are handled helps distinguish between configuration problems and temporary service interruptions.

Credential & Authentication Errors

Credential-related errors occur when ABM Warranty cannot successfully authenticate with Apple Business Manager. Common causes include:

  • Incorrect Client ID or Key ID
  • A PEM private key that does not match the selected Key ID
  • An expired or revoked API key in Apple Business Manager
  • PEM file access or permission issues

Authentication failures are treated as hard failures. When they occur, ABM Warranty stops the import immediately, records the error for the active tenant, and disables further API requests until the credential issue is resolved.

These failures are surfaced prominently in the Status Dashboard and logged with diagnostic detail.

API, Rate Limit & Network Errors

Transient errors such as network interruptions, HTTP 429 rate limits, or Apple server errors (HTTP 5xx) are handled automatically.

ABM Warranty applies adaptive retry logic with backoff and reduced concurrency. Imports pause and resume safely without blocking the user interface or corrupting data.

Retry counts, throttling events, server errors, and cumulative backoff time are tracked per tenant and visible in the Status Dashboard.

Coverage Retrieval Issues

Some devices may temporarily return no coverage data. These devices are marked as having No Data and remain part of the device inventory.

Coverage retrieval failures do not remove devices, invalidate existing coverage information, or require reloading the full inventory. Coverage can be retried independently as data becomes available.

Inactive Devices

Devices that are no longer returned by Apple Business Manager are not deleted. Instead, they are marked as Inactive and retain their last known data.

Inactive devices continue to appear in diagnostics, filters, exports, and historical views to preserve accuracy over time.

Sample & Diagnostic Data Mode

When valid credentials are not configured, ABM Warranty may operate using sample or diagnostic data. In this mode, live imports are disabled and the UI clearly indicates that displayed data is not sourced from Apple Business Manager.

Sample data is intended to support evaluation, UI exploration, and troubleshooting without making live API requests.

Getting Help

If an issue persists, review the Status Dashboard and Logs for the active tenant. Logs can be filtered by tenant and exported for review when seeking assistance.

Providing logs and diagnostic exports greatly improves the ability to identify and resolve issues.