[Woo POS] Coupons: Show error when coupons are disabled in core

[iamgabrielma]

Partially closes: #15348

Description:

This PR takes a first go to handling coupons being enabled or disabled in core. When coupons are disabled, we show an error screen prompting the user to enable them. Once done, we can refresh and coupons will load.

Screen.Recording.2025-04-02.at.09.56.30.mov

Next steps:

I think we have two options to move forward:

1. Current approach: The error message just tell the merchant "Please enable coupons in WooCommerce Settings, and retry", then wait until they do so in the web and retry.
2. A continuation is the CTA showing "Retry" and which would call enableStoreCouponSettings at some point, which enables this setting and refreshes the view automatically. This would need some refactor around how we retry errors in the dashboard view, or perhaps add a secondary action that we can use for coupons only.

In both cases we'd still need a way for the user to switch between products and coupons, this should not be an issue with the latest designs, as both are in the navigation bar, so there's no need for dismissal/close button.

Testing information

• Load POS, go to coupons, see how they load
• In WooCommerce Settings > General > Disable "Enable the use of coupon codes" and save changes
• Reload the view in POS, observe how the error is displayed
• Re-enable coupons, reload the view in POS, observe how coupons are loaded.

---

• I have considered if this change warrants user-facing release notes and have added them to RELEASE-NOTES.txt if necessary.

Reviewer (or Author, in the case of optional code reviews):

Please make sure these conditions are met before approving the PR, or request changes if the PR needs improvement:

• The PR is small and has a clear, single focus, or a valid explanation is provided in the description. If needed, please request to split it into smaller PRs.
• Ensure Adequate Unit Test Coverage: The changes are reasonably covered by unit tests or an explanation is provided in the PR description.
• Manual Testing: The author listed all the tests they ran, including smoke tests when needed (e.g., for refactorings). The reviewer confirmed that the PR works as expected on all devices (phone/tablet) and no regressions are added.

[iamgabrielma]

This is not used at the moment, happy to remove it or keep it if you prefer that we handle the enable action via CTA on this same PR 👍

[staskus]

If we're not handling enabling on this PR, then let's remove it. 👍

[iamgabrielma]

Done! d2619de

[wpmobilebot]

📲 You can test the changes from this Pull Request in WooCommerce iOS Prototype by scanning the QR code below to install the corresponding build.

	App Name	WooCommerce iOS Prototype
	Build Number	29133
	Version	PR #15468
	Bundle ID	com.automattic.alpha.woocommerce
	Commit	d2619de
	Installation URL	49mim6k5ccff8

Automatticians: You can use our internal self-serve MC tool to give yourself access to those builds if needed.

[staskus]

Thanks for starting to tackle this.

According to the requirements (pdfdoF-6BG-p2), the expectation is:

Coupons disabled (WooCommerce > Settings > General > Enable coupons):
Show a message and CTA to enable coupon functionality. Reload the list once the setting is enabled.

This is what we have in IPP right now, and that would be an expectation:

Simulator.Screen.Recording.-.iPad.Air.11-inch.M2.-.2025-04-02.at.09.57.07.mp4

This would need some refactor around how we retry errors in the dashboard view, or perhaps add a secondary action that we can use for coupons only.

Yes. It will probably require some refactoring:

• Products / Coupons switch should be visible when error appears
• Coupon disabled error should have a specific handler for enabling a setting and only then refreshing the view

[staskus]

Thanks!

Since the title of PR is "Show error when coupons are disabled", the goal is fulfilled.

On the next PR, the rest of the things can be handled as I mentioned in the previous comment.

[staskus]

If we're not handling enabling on this PR, then let's remove it. 👍

[dangermattic]

	1 Warning
⚠️	This PR is assigned to the milestone 22.1. This milestone is due in less than 2 days. Please make sure to get it merged by then or assign it to a milestone with a later deadline.

Generated by 🚫 Danger

[iamgabrielma]

Thanks for the review!

Yes. It will probably require some refactoring:

- Products / Coupons switch should be visible when error appears
- Coupon disabled error should have a specific handler for enabling a setting and only then refreshing the view

Perfect, I'll merge this for the moment and log/handle the "enable coupons" action separately 👍