← Knowledge base
Troubleshooting5 min read

How do you fix common AirBills problems?

Fix common AirBills problems: approval pending, restricted pages, missing bills, bills stuck in Draft or Flagged, failed payments, disconnects and false spikes.

Most AirBills problems fall into a few groups: you cannot get in, a bill is missing, a bill is stuck in a queue, a payment failed, or service was shut off. Each has a page that shows the cause and the next step. This article lists the symptom, where to look and what to do.

Quick reference

SymptomWhere to look
Every page shows Approval PendingAsk an AirBills administrator to approve your account
A receivables page says Access RestrictedAccountant › Settings › Permissions
A bill never arrivedMissed Bills (Utility Admin, Accountant and Account Payables)
A bill is not being paidPayables › Draft and Payables › Flagged
A funding payment failedPayables › Funding History or Payments
A resident payment was declinedResident › Transactions › Declined
A utility was shut offUtility Admin › Issues › Disconnects
A utility closed an accountUtility Admin › Issues › Final Bills
Too many or too few spike alertsSettings › Spike Threshold
An onboarding market is stuckOnboarding › Monitor › Issues and Execute › Go-Live Checklist

Why can't you get in?

Every page sends you to Approval Pending. New sign-ups cannot use AirBills until an AirBills administrator approves them. You receive an email once approved. If you were added on Onboarding › Prepare › Team Setup, that records you on the project but does not approve your login.

You had access and lost it. Access can carry an end date. Ask an AirBills administrator to extend it.

You see only one dashboard. Your account may be locked to a single dashboard. Ask an administrator for wider access.

A page says Access Restricted. In the Accountant role, Collections, Defaults, Aging and Cash Flow Forecast can be switched off.

  1. Open Accountant › Settings › Permissions.
  2. Switch the page back on, or click Reset All.

These switches apply in the current browser only.

Why is a bill missing?

  1. Open the Missed Bills page. It is under Reports in the Utility Admin role, Payables in the Accountant role and Dashboard in the Account Payables role.
  2. Find the home. The row shows the expected date, days overdue, status and when the last bill was received.
  3. Read the status. A bill is Late for its first 15 days overdue, then becomes Missing.
  4. Export the filtered list to chase by biller or property manager.

If one biller keeps missing bills, check Accountant › Payables › Billers for its missing rate against the target.

If the utility has stopped billing altogether, open Utility Admin › Reports › Arrears. It lists accounts more than 30 days behind, and you can file a ticket with the biller from the row.

If a bill type shows Missing on Utility Admin › Reports › Active Bills, the property does not have that bill type set up with AirBills. Pending means it is still being set up.

Why is a bill not being paid?

A bill is paid only after it is approved. Check the two holding queues.

  1. Open Payables › Draft (Review in the Accountant role). A bill lands here when one or two validation checks fail, or when it is prorated. Read the AI status to see which fields failed, then approve or flag the bill.
  2. Open Payables › Flagged. A bill lands here when its amount spikes past the approval threshold or three or more checks fail. Open Resolve, then approve it for payment or return it to the review queue. A note is required.

Flagged bills are not paid until someone resolves them.

If too many clean bills land in review, check Accountant › Settings › Approval Threshold. A rule that is switched off, a low dollar limit or a GL code that does not match will stop auto-approval. Also check that the bill type, biller or property has a code on Settings › GL Codes.

Why did a payment fail?

Funding payments. Open Account Payables › Payables › Funding History. Status is Pending once a payment is submitted, Posted when it clears, or Failed if it was rejected. Filter by status to list failures. Then check the funding account under Settings › Bank Accounts and the balance top-up under Settings › Payments.

Card payments to utilities. Open Accountant › Transactions › Declined. Each row shows the decline reason: Card Suspended, Insufficient Funds or Card not Active. Fixing the card or retrying the payment is not done from this page.

Resident payments. The resident opens Transactions › Declined to see the reason and the retry date. A declined payment with a retry date is retried automatically on that date. The resident should make sure the account has enough balance, and can change the bank account on Settings › Payment.

What do you do about a shutoff?

  1. Open Utility Admin › Issues › Disconnects. Occupied homes and the newest reports come first.
  2. If the disconnect is not listed, add it by hand or from a utility notice PDF.
  3. Escalate the disconnect to the utility from its row, and log progress notes on the case.
  4. Follow the restore status: Pending, In Progress, Escalated, Restored or Cancelled.

AirBills watches disconnect notices every day. An on-call person handles emergencies and pays to restore service the same day.

What do you do about a final bill?

A final bill means the utility closed an account.

  1. Open Utility Admin › Issues › Final Bills. Undecided bills and occupied homes come first.
  2. Choose Reactivate to restore service, or Disregard with a reason such as vacant home or lease properly terminated.

Occupied homes are flagged for reactivation automatically to prevent resident shutoffs. Disregarding a bill on an occupied home requires a comment.

Why are spike alerts wrong?

  1. Open Settings › Spike Threshold.
  2. Check the spike percentage, the dollar limit and the on or off switch for that utility type. Empty and occupied homes have separate rows.
  3. In the Property Manager role, use the preview while editing to see how many existing spikes the new percentage would flag.

Bill Trends and Spikes can disagree. Bill Trends uses a fixed rule: the latest bill is more than 25% above the 12-month average. Spikes uses the thresholds you set.

Residents set their own alert percentage on Settings › Spike Alert.

Why is the AI connector not working?

How AirBills handles it

AirBills expects a bill for every utility on every home, so a missing bill is listed instead of being overlooked. Bills that fail checks are held before money moves, and every held bill shows why.

Billing That Runs Itself

Automate tenant billing, cut disputes, and reclaim hours every week.

Book a Demo