ZenotiHelp

Earnings Dashboard β€” Drill-Down Error and Retry State

ZTZenoti Docs Team Updated October 16, 2026 3 min readGuide

When a drill-down screen in the Earnings Dashboard fails to load its data, MyZen displays an error state with a Retry button so you can reload the screen without losing your place in the navigation flow.

Audience: Employees (service providers, front desk staff, managers) who use the Earnings Dashboard to review commissions, invoices, and tenure bonuses in MyZen.

Before you begin

  • Your center must have the Show Earnings Dashboard in MyZen setting enabled. For center configuration, see the relevant topic in your configurations documentation.
  • You must have an active network connection. MyZen requires a live connection to load earnings data.
  • The Earnings Dashboard drill-down screens covered in this article are: commission type detail, invoice list, invoice detail, and tenure bonus detail.

Steps

Encounter an error on a drill-down screen

When a drill-down screen fails to fetch data β€” for example, due to a temporary network interruption β€” the screen displays an error state instead of the data you requested.

  1. Open MyZen and navigate to the My Money tab.
  2. Open the Earnings Dashboard and tap the drill-down screen where you want to view details (for example, a commission type, invoice list, invoice detail, or tenure bonus).
  3. If the data fetch fails, the screen displays an error state. No data from any previous fetch is shown while you are in this error state.

Note: The drill-down screen does not display stale data from an earlier session. If the fetch fails, the screen remains blank until a successful load completes.

Retry a failed data fetch

  1. On the error state screen, tap Retry.
  2. A loading indicator appears while MyZen re-fetches the data.
  3. If the fetch succeeds, the drill-down screen displays the requested data.
  4. If the fetch fails again, the error state returns and Retry becomes available once more.

Important: While a retry is in progress, the Retry button is suppressed. You cannot trigger a second fetch until the current one completes. Wait for the loading indicator to finish before attempting another retry.

Understand the loading state on first open

When you open a drill-down screen for the first time in a session:

  1. MyZen immediately shows a loading indicator.
  2. No data is displayed while the initial fetch is in progress.
  3. Once the fetch completes successfully, the screen renders the data.
  4. If the fetch fails, the screen transitions to the error state described above.

Note: The loading indicator and the suppressed Retry button apply equally to the first load and to any subsequent retry attempt. In both cases, only one fetch runs at a time.

Tips

  • Check your connection first. Most fetch failures on drill-down screens are caused by a dropped or weak network connection. Before tapping Retry, confirm that your device has an active connection.
  • Stay on the screen. Tapping Retry re-fetches data without navigating away from the drill-down screen. You do not need to go back and re-open the screen to try again.
  • Wait for the loading indicator to clear. If you tap Retry and see a loading spinner, wait for it to finish. The button is intentionally suppressed during a fetch so that duplicate requests do not occur.

Troubleshooting

Problem Resolution
Retry does not respond when tapped A fetch is already in progress. Wait for the loading indicator to disappear, then tap Retry again.
The error state returns after every retry attempt Check your device's network connection. If the connection is stable and retries continue to fail, close and reopen MyZen, then navigate back to the drill-down screen.
The screen shows no data and no error message or Retry button The initial fetch is still in progress. Wait for the loading indicator to finish. If the indicator does not clear after several seconds, check your network connection and restart MyZen if needed.
Was this article helpful?
Your feedback helps us improve our documentation.