Availability rules
The Availability screen holds rules that stop some of your products from being sold in an environment, country, currency or channel. Use it when a product must not be offered somewhere, for example outside the countries you are licensed in.
How a rule workslink
A rule blocks sales. When a request for one of your products matches every field the rule sets, that product is unavailable for the request. A field you leave empty matches anything.
For example, a rule in Live with product id PROD_1 and countries KE, UG stops PROD_1 being sold in Kenya and Uganda in production. It does not affect PROD_1 in other countries, and it does not affect your other products.
When a rule blocks a product, the Products screen shows it as Unavailable with the reason DENIED_BY_RULE: followed by the rule id.
What the list showslink
Use the Test and Live buttons at the top to choose an environment. The screen opens on Live.
The list shows every availability rule that names your company in that environment:
- Your rules, with their scope, which you can edit or delete.
- Platform-owned rules, which NetApps InsureTech created for your company. They show a Platform-owned badge and are read-only.
| Column | What it shows |
|---|---|
| Scope | The rule's scope, or Platform-owned. |
| Product type | The platform product type the rule applies to, if set. |
| Product | The product id the rule applies to, if set. |
| Environment | Test or Live. |
| Countries | The country codes the rule applies to, if set. |
| Currencies | The currency codes the rule applies to, if set. |
| Channels | The sales channels the rule applies to, if set. |
| Reason | Your note on why the rule exists. |
| Updated | When the rule last changed. |
To narrow the list, type a product type code in Filter by product type.
Add a rulelink
- Open Availability and choose Test or Live. The rule applies to the environment you choose.
- In Add a rule, set the fields you need. The table below describes each one.
- Select Add rule. The rule appears in the list.
| Field | What to enter |
|---|---|
| Product type | A platform product type, or leave it on Any product type. |
| Product id | One of your product ids, for example PROD_1. |
| Countries | Country codes separated by commas, for example KE, UG. Codes are saved in upper case. |
| Currencies | Currency codes separated by commas, for example KES, UGX. Codes are saved in upper case. |
| Channels | Channel names separated by commas, for example web, api. |
| Reason | An optional note for your team. |
Edit or delete a rulelink
- Find the rule in the list. Only your own rules show Edit and Delete.
- Select Edit. The form at the top changes to Edit rule with the rule's values.
- Change the fields and select Save, or select Cancel to leave it as it was.
To remove a rule, select Delete on its row.
Who can change ruleslink
Owners, admins and members with the Availability group can add, edit and delete your rules. Members with the Viewer group can see them.
Other reasons a product is unavailablelink
Availability rules are only one of the checks. A product can also be unavailable because its status in your API is not Active, your company status does not allow sales in that environment, or its commercial terms are not active in live. The Products and mapping guide lists every reason.