Adjustment Rules

Admin UI for the `json-rules-engine` registry that drives governed bill adjustments.

Step 1

Rules Workbench

Start with a list view of every adjustment rule. This gives ops a quick way to scan rule purpose, status, decision path, and next action before editing details.

Total rules

All draft and live adjustment rules

Enabled

Currently active in the rules engine

Draft

Saved but not active yet

RuleStatusDecisionPriorityActions

Data overage — full credit

Extra Data Charge Credit · OVERAGE_RELIEF · overage-relief-full-credit

Enabled

auto_approve

Edit

International roaming — CSR review

International Roaming Dispute · ROAMING_DISPUTE · roaming-dispute-review

Enabled

csr_review

Edit

Data overage — goodwill review for large overage

Goodwill Credit · GOODWILL_CREDIT · overage-large-goodwill-review

Enabled

csr_review

Edit

Rule source of truth

Adjustment rules admin

Edit the live `json-rules-engine` rule registry here. Changes are saved back to the JSON rules file and affect the bill adjustment workflow.

overage-relief-full-credit

Enabled

Top-level fields

idnameenabledpriorityireason_codereason_labeldecisionrecommended_amount_strategyrecommended_amount_value

rationale

One line per array item.

conditionsi

Match all of these

conditions JSON preview

{
  "all": [
    {
      "fact": "charge_code",
      "operator": "equal",
      "value": "DATA_OVERAGE"
    },
    {
      "fact": "overage_gb",
      "operator": "greaterThan",
      "value": 0
    }
  ]
}

Full rule preview

{
  "id": "overage-relief-full-credit",
  "name": "Data overage — full credit",
  "enabled": true,
  "priority": 50,
  "reason_code": "OVERAGE_RELIEF",
  "reason_label": "Extra Data Charge Credit",
  "decision": "auto_approve",
  "recommended_amount_strategy": "full_amount",
  "recommended_amount_value": null,
  "rationale": [
    "Charge is standard data-overage billing.",
    "Overage usage was confirmed on the bill.",
    "Full credit applies per current overage-relief policy."
  ],
  "conditions": {
    "all": [
      {
        "fact": "charge_code",
        "operator": "equal",
        "value": "DATA_OVERAGE"
      },
      {
        "fact": "overage_gb",
        "operator": "greaterThan",
        "value": 0
      }
    ]
  }
}

roaming-dispute-review

Enabled

Top-level fields

idnameenabledpriorityireason_codereason_labeldecisionrecommended_amount_strategyrecommended_amount_value

rationale

One line per array item.

conditionsi

Match all of these

conditions JSON preview

{
  "all": [
    {
      "fact": "charge_category",
      "operator": "equal",
      "value": "ROAMING"
    }
  ]
}

Full rule preview

{
  "id": "roaming-dispute-review",
  "name": "International roaming — CSR review",
  "enabled": true,
  "priority": 50,
  "reason_code": "ROAMING_DISPUTE",
  "reason_label": "International Roaming Dispute",
  "decision": "csr_review",
  "recommended_amount_strategy": "cap",
  "recommended_amount_value": 15,
  "rationale": [
    "Charge falls under international roaming or travel-pass usage.",
    "Roaming charges are commonly disputed and need manual confirmation of travel dates and plan coverage.",
    "Credit is capped at $15 pending CSR review."
  ],
  "conditions": {
    "all": [
      {
        "fact": "charge_category",
        "operator": "equal",
        "value": "ROAMING"
      }
    ]
  }
}

overage-large-goodwill-review

Enabled

Top-level fields

idnameenabledpriorityireason_codereason_labeldecisionrecommended_amount_strategyrecommended_amount_value

rationale

One line per array item.

conditionsi

Match all of these

conditions JSON preview

{
  "all": [
    {
      "fact": "charge_code",
      "operator": "equal",
      "value": "DATA_OVERAGE"
    },
    {
      "fact": "overage_gb",
      "operator": "greaterThan",
      "value": 5
    }
  ]
}

Full rule preview

{
  "id": "overage-large-goodwill-review",
  "name": "Data overage — goodwill review for large overage",
  "enabled": true,
  "priority": 80,
  "reason_code": "GOODWILL_CREDIT",
  "reason_label": "Goodwill Credit",
  "decision": "csr_review",
  "recommended_amount_strategy": "cap",
  "recommended_amount_value": 50,
  "rationale": [
    "Overage usage significantly exceeds typical monthly patterns (over 5 GB).",
    "Large overage credits should be reviewed before crediting to rule out a billing or plan-configuration error.",
    "Goodwill credit capped at $50 pending CSR confirmation."
  ],
  "conditions": {
    "all": [
      {
        "fact": "charge_code",
        "operator": "equal",
        "value": "DATA_OVERAGE"
      },
      {
        "fact": "overage_gb",
        "operator": "greaterThan",
        "value": 5
      }
    ]
  }
}