Erroneous adjustment billing schedule details (BSDs) may arise primarily due to the following reasons:

  • Wrong entry in the record.
  • The wrong amount entered into the record.
  • Non-agreement of customers or internal business groups.
  • The record does not match the terms of the contract.

You can delete the unwanted adjustment BSDs within a billing schedule record (BSR), those across multiple BSRs of a single billing header (BH), or different billing headers. 

Prerequisites

  • The BSR is in Pending Billing status.
  • The adjustment BSD is in Draft status.

To Delete Adjustment Billing Schedule Details

  1. Call the Billing Management API, https://<URL_of_the_Instance>/api/billing/v1/schedules/delete-adjustments.
  2. Enter the values in the payload.
    [
      "6896e0ef-47b2-4734-b0e4-3139db68b079", // ID of the adjustment BSD
      "bf653603-b014-4755-b68f-0c813f787743" // ID of the adjustment BSD
    ]
    CODE
    The API deletes the BSDs whose IDs are entered in the payload.

For example, A subscription, with a quarterly billing frequency is sold for one year with a TCV (Sales) of USD 1,200.00. The contract start date is 01-July-2024 and the end date is 30-June-2025. The selling term is four (because the billing frequency is quarterly) and the net price is USD 300.00. You created an adjustment BSD of USD 50.00 for the first billing period.

The billing header is as follows:

BH ID

Current OLI

Parent OLI

ALI

Billing Start Date

Billing End Date

TCV (Sales)

Billable Amount for Current OLI

Total Invoiced Amount

Total Adjusted Amount

Total Bill Including Adjustments

Pending Invoice Amount

Status

BH-1OLI-12OLI-1ALI-101-July-202530-June-2025USD 1,200.00USD 0.00USD 0.00USD 50.00USD 1,250.00USD 1,200.00Active

The BSRs and BSDs are:

BSR ID

BSD ID

Record Type

Category

Period Start Date

Period End Date

Actual Fee Amount

Invoice Status

BSR-1BSD-1RegularFee01-July-202430-September-2024USD 300.00Pending Billing
BSD-1.aRegularAdjustment01-July-202430-September-2024USD 50.00Pending Billing
BSR-2BSD-2RegularFee01-October-202431-December-2024USD 300.00Pending Billing
BSR-3BSD-3RegularFee01-January-202531-March-2025USD 300.00Pending Billing
BSR-4BSD-4RegularFee01-April-202530-June-2025USD 300.00Pending Billing

Now you want to delete the adjustment BSD using the delete-adjustments API. 

The billing header is as follows:

BH ID

Current OLI

Parent OLI

ALI

Billing Start Date

Billing End Date

TCV (Sales)

Billable Amount for Current OLI

Total Invoiced Amount

Total Adjusted Amount

Total Bill Including Adjustments

Pending Invoice Amount

Status

BH-1OLI-12OLI-1ALI-101-July-202530-June-2025USD 1,200.00USD 0.00USD 0.00USD 0.00USD 0.00USD 1,200.00Active

The BSRs and BSDs are:

BSR ID

BSD ID

Record Type

Category

Period Start Date

Period End Date

Actual Fee Amount

Invoice Status

BSR-1BSD-1RegularFee01-July-202430-September-2024USD 300.00Pending Billing
BSR-2BSD-2RegularFee01-October-202431-December-2024USD 300.00Pending Billing
BSR-3BSD-3RegularFee01-January-202531-March-2025USD 300.00Pending Billing
BSR-4BSD-4RegularFee01-April-202530-June-2025USD 300.00Pending Billing

It is clear that the adjustment BSD created under BSR-1 is deleted and is not available in the table.