Guides and field notes

Practical ideas for better service operations.

Explore how to evaluate workflows, plan transitions, and make operational information more useful to the people serving your customers.

Migration guide

How to validate billing before a system transition

Moving billing into a new system is a chance to make the process clearer. The strongest starting point is a shared definition of what the system should produce and a review process that makes differences visible before customers are charged.

Start with the rules your business uses.

An invoice is the result of several decisions: which services are active, the dates being billed, when a service changed, how an adjustment should apply, and which tax configuration is required. Before comparing output, document the rules that produce it.

Choose people who understand the billing process and the exceptions handled by the team. Agree on which source records matter and who can resolve questions about them. This gives the migration a practical reference point when two systems produce different results.

Choose representative examples.

A typical account is useful, but it does not describe the entire business. Include accounts with the variations your team actually handles: mid-cycle changes, multiple services, credits, overdue balances, different payment methods, and the relevant tax situations.

The purpose is to make the review reflect the operation. Define the population you are testing and keep a record of why it was chosen. A result from one sample should be described as a result from that sample.

Check the transferred records.

Before evaluating a calculation, check the information used to calculate it. A missing service date, an unmapped adjustment, or an account relationship can create a difference even when the calculation itself is working as designed.

Review identifiers, dates, services, balances, and the relationships between records. Keep historical invoices distinguishable from newly generated output. That makes it easier to investigate whether a difference comes from the transfer of information or from the billing rules.

Compare at the level where differences can be explained.

A total is a useful starting point. The line items, periods, quantities, adjustments, and configured taxes help explain why that total was produced.

Use a comparison format the billing team can read. Show the original or expected value, the new value, and the difference. Keep enough context to identify the account and billing period without forcing reviewers to assemble the information again.

Give every exception a clear treatment.

A mismatch does not explain itself. It may reflect a mapping problem, an incorrect rule, missing information, or an intentional change to the billing process. Reviewers need a place to record the explanation and the action required.

Useful exception fields include the account, the affected line or rule, the observed difference, the owner, and the decision. Keep unresolved questions visible. Agree on which issues must be corrected and which intentional differences need explicit approval.

Define what approval means.

A percentage alone is not an acceptance criterion. Review the types of remaining exceptions, their impact, and the checks required for the population moving into the new workflow.

The approval process should state who signs off, what they are approving, and the scope covered. It should also explain how the team will handle records outside that scope. This makes the decision understandable to billing, operations, and the people responsible for the cutover.

Plan the first live cycle.

The transition plan should identify which system owns billing for each account, when that responsibility changes, and how the team will monitor the first live activity. Document communication, escalation, and the recovery options available for the workflow.

Include a review after the first cycle. Capture what happened, what required attention, and which decisions should become part of the documented process. A useful migration leaves the team with a clearer understanding of billing as well as a new system.

Review your billing transition with us.

Bring the billing rules, representative examples, and questions your team wants to validate.

Discuss your migration
Operations field note

Make network status useful to the people acting on it

A status indicator helps a team decide what to do next. To be useful, it needs context: what was observed, where the information came from, and how recently it was checked.

Start with the decision.

The person looking at a status may be troubleshooting a customer call, reviewing an incident, or deciding whether a technician needs to visit. The display should help answer that person’s question.

A device being reachable does not describe every aspect of the customer’s experience. Likewise, a failed check may indicate a visibility problem that needs investigation. Clear labels help the team understand what the indicator actually represents.

Make the observation understandable.

Show what the system checked. Reachability, signal quality, an integration response, and application behavior are different observations. The right description helps the reader understand what can reasonably be concluded.

The label should be useful to the audience. An operations engineer may need the specific check. A service representative may need a plain-language explanation and a link to more detail. Both should be able to trace the information to its source.

Keep freshness visible.

Operational information can become outdated. A last-known healthy observation from an earlier period should be distinguishable from a recent successful check.

Include the time of the observation when it matters to the workflow. If the data is delayed or a new check failed, make that context visible. The team can then decide whether another check is needed before acting.

Give uncertainty a clear place.

There are times when the system does not have enough information to make a current statement. Treat that as useful operational context.

An unknown or stale state should explain what is missing and, where possible, what the team can do next. A label, timestamp, and short explanation are usually more informative than color alone. Consistent states also help people scan the page without guessing how to interpret an unusual result.

Connect the equipment to the service.

When relationships are mapped, equipment information becomes more useful to customer-facing teams. A site, device, or link can be associated with the services and accounts that depend on it.

Keep the relationship visible enough to inspect. The team should understand which customers are associated with an issue and where that association comes from. This is especially useful when deciding who needs an update or which service request belongs with an existing incident.

Give each team the next useful view.

Operations may need diagnostics. Support may need the incident context and customer message. Dispatch may need the reason for a visit and the work already completed.

Design the handoff around that next action. Keep the underlying information traceable while presenting the relevant details in the workspace the team uses. Good operational information helps people move from an observation to a responsible decision.

Review the language with the team.

Ask the people using the dashboard to explain what they think each state means. If they interpret the same indicator differently, the design needs clarification.

Use representative situations: a recent successful check, a failed observation, a delayed integration, and a customer report without a confirmed equipment issue. The goal is a display that supports consistent decisions across the service operation.

Bring operational context into your service workflow.

Explore how your team uses equipment information and what it needs to make the next decision.

Explore network operations

Put the ideas into your team's workflow.

Tell us which process you are working on. We will walk through the relevant Bavardio capabilities with you.