When the status of a BSR is changed from Pending Billing to Invoiced, the Total Invoiced Amount field on the BH shows the cumulative rolled-up amounts of all the BSRs in Invoiced status. The Pending Invoiced Amount field on the BH contains the total contract value less the invoiced amount.
You must call the billing services API to change the status of the BSR from Pending Billing to Invoiced.
Suppose the order line item for a standalone product has the following details:
Order No. | Order Line No. | Product | Billing Frequency | Start Date | End Date | Quantity | List price | Net Price |
|---|
| O-1 | OLI-1 | Service | Half-yearly | | | 1 | USD 1,200.00 | USD 1,200.00 |
When Billing is initiated, the resulting Billing Header will contain the Price Type as Evergreen instead of Recurring. The billing header shows:
Billing header ID | Order No. | Current Order Line | Product | Status | Billing Frequency | Billing Rule | Start Date | End Date | Quantity | Net Unit Price | Total Invoiced Amount | Pending Invoiced Amount |
|---|
| BH-1 | O-1 | OLI-1 | Service | Active | Half-yearly | Bill In Advance | | | 1 | USD 1,200.00 | USD 0.00 | USD 1,200.00 |
Two BSRs are generated in pending billing status.
(BSD is not shown here to keep the example simple. It is assumed that the BSD is approved and the fee amount is rolled up to the BSR.)
Billing Schedule Record No | Billing header ID | Period Start Date | Period End Date | Actual Fee Amount | Ready for Invoice Date | Status |
|---|
| BSR-1 | BH-1 | | | USD 600.00 | | Pending Billing |
| BSR-2 | BH-1 | | | USD 600.00 | | Pending Billing |
You called the Update Invoice API to change the status of BSR-1. The status of BSR-1 is changed to "Invoiced".
Billing Schedule Record No | Billing header ID | Period Start Date | Period End Date | Actual Fee Amount | Ready for Invoice Date | Status |
|---|
| BSR-1 | BH-1 | | | USD 600.00 | | Invoiced |
| BSR-2 | BH-1 | | | USD 600.00 | | Pending Billing |
The following fields on BH are updated:
| BH Total Invoiced Amount | BH Pending Invoiced Amount |
|---|
| USD 600.00 | USD 600.00 |
Hence, the Total Invoiced Amount field on the BH is updated with the cumulative rolled-up amounts of all the BSRs in Invoiced status. The Pending Invoiced Amount field on the BH contains the total contract value less the invoiced amount.
