Adjust Chargeable Event

The Customer Sales Representative or Finance Department User wants to via CRM / Finance system GUI adjust charge for given period. This operation is available in the CRM / Finance system GUI for users with correct privileges.

The CRM / Finance system via the RESTful API requests for charge adjustment in the OCS.io. The request body contains the Account details and details which charge and how should be adjusted.

The OCS.io adjusts the charge, then returns result of the operation as a payload of the response.

The CRM / Finance system presents the result of the operation to the User in the GUI.

Primary Actor

Customer Sales Representative or Finance Department User.

Basic Flow

Adjust Chargeable Event Basic Flow
Step Actor Action Description

1.

CSR / FIN User

Search Chargeable Event

Customer Sales Representative or Finance Department User via CRM / Finance GUI searches for a Chargeable Event to be adjusted.

2.

CRM / Finance

Display Search Chargeable Event

CRM / Finance System displays result of Search Chargeable Event to the User.

3.

CSR / FIN User

Request for Operation

Customer Sales Representative or Finance Department User via CRM / Finance GUI requests for Operation.

4.

CRM / Finance

Call adjustChargeableEvent API

CRM / Finance System calls xref:integration-guide:rm/billing-invoicing/ API exposed by OCS.io.

5.

OCS.io

Request Validations

OCS.io validates Request whether all mandatory attributes are populated, all data types are valid, ENUMs match with definition, etc.

Additionally, OCS.io validates Request against Business Logic. This typically includes, that referenced entity exists in the system, entity has proper state, etc.

6.

OCS.io

Perform Business Logic

OCS.io performs Business Logic implemented for the Use-Case.

7.

OCS.io

Publish Business Transaction

OCS.io publishes zero to many messages to Streaming Platform that impacted entities have been changed.

8.

OCS.io

Return adjustChargeableEvent Response

OCS.io returns Response to the CRM / Finance System.

Response codes are as follows:

  • 200 = OK

  • 400 = Request Validation failed

  • 500 = Internal error

9.

CRM / Finance

Result of Operation

CRM / Finance system displays result of the operation to the User.

10.

Finance System

Subscribe for Business Transactions

Finance System subscribes for Business Transactions to be delivered by Streaming Platform.

11.

Finance System

Process Business Transactions

Finance System process Business Transactions internally. This typically includes storing of changed entities, update indexes, update metrics, etc.

12.

DWH

Subscribe for Business Transactions

DWH subscribes for Business Transactions to be delivered by Streaming Platform.

13.

DWH

Process Business Transactions

DWH process Business Transactions internally. This typically includes storing of changed entities, update indexes, update metrics, etc.

Request Validations

The following validations are performed when adjusting a chargeable event:

Perform Business Logic

Publish Notification

Following Notifications will be published to Streaming Platform:

Publish Business Transaction

Following entities will be published to Streaming Platform as part of Business Transaction: