Boundary Invoicing and the Final Bill
Boundary invoicing
A subscription whose price has at least one in-arrears line (any usage component, or a recurring component billed in arrears) is invoiced at the period boundary. One invoice carries:
- the next period’s in-advance lines, and
- the ended period’s in-arrears lines: usage, in-arrears recurring, events and pending charges.
A subscription with only in-advance recurring lines keeps the early renewal invoice, with the same amounts and timing as before.
What happens at the boundary
- The expiring-soon step sends the reminder. It raises no invoice.
- On the renewal date BillHive works out the ended period, rates its in-arrears lines and adds them, with all
PENDINGpending charges, to the renewal order. - It invoices the order, activates the next term and collects payment.
The invoice is due at the boundary plus the larger of the account’s net term days and the tenant’s renewal grace days. The subscription stays Active until then. With Auto Collect the payment is attempted at the boundary. See Billing Timing.
Each charge lands on exactly one invoice: usage rows are marked billed with the order id, and pending charges are claimed by one conditional update, so a retry never bills twice.
GST per line
GST is worked out per line. Each line’s amount and GST (taxable value, CGST, SGST, IGST) are rounded to paise, and the invoice total is the sum of the rounded lines. Pass-through lines follow the plan’s Charge GST on pass-through lines switch.
Example boundary invoice, INR, GST 18% (a ₹15 plan, 18,000 emails with 15,000 included at ₹0.004, and two ₹40 port-outs):
| Line | Billed | Amount | CGST 9% | SGST 9% |
|---|---|---|---|---|
| Rate plan, April | In advance | ₹15.00 | ₹1.35 | ₹1.35 |
| Emails, March (3,000 × ₹0.004) | In arrears | ₹12.00 | ₹1.08 | ₹1.08 |
| Port-out × 2 | Pending charge | ₹80.00 | ₹7.20 | ₹7.20 |
| Subtotal | ₹107.00 | |||
| GST | ₹19.26 | |||
| Total | ₹126.26 |
The final bill on cancel and expire
When a subscription is cancelled or expires, the final period’s in-arrears lines and pending charges are billed on a final invoice. Before, they were lost.
- Immediate cancel: usage is billed through the effective day, and recurring charges through the day before it. The existing cancellation credit refunds the effective day.
- End of Term and Specific Date cancels, and expiry: the final invoice is raised when the cancellation takes effect.
- The final bill carries any usage, in-arrears recurring and
PENDINGcharges. Nothing is left unbilled. - If the subscription has prepaid credits, the final bill is drawn down first, and what is left carries over. See Prepaid Credits.
- Once the subscription is Cancelled, Expired or Trial Expired, or its final bill is under way, a new pending charge is refused with
422.
Example final invoice (cancel at end of term, with March usage of 18,000 emails):
| Line | Amount | GST 18% |
|---|---|---|
| Emails (3,000 × ₹0.004) | ₹12.00 | ₹2.16 |
| Total | ₹14.16 |
- After a plan or frequency change that takes effect now, the closed period’s in-arrears lines are billed on the change order.
- A few days can go unbilled when the boundary has already run and a change is cancelled before it is invoiced. Voiding an invoice after a cancel does not hand usage or pending charges back.
- The cancel API accepts a request without
refundableCreditAction, and the order then fails in the workflow. Always send it.