OCI server CDR

The Open Charging Interface (OCI) Server CDRs are generated when a subscriber purchases a data plan using the PCC platform.

Field Name Description

Subscriber ID

The MSISDN of the subscriber.

Service ID

The Tango Service ID. This is set to 30 for the OCI Server.

Transaction Type

The OCI transaction type.

possible values

1 = Charge Reservation
2 = Debit of Charge Reservation
3 = Direct Debit of a charge
4 = Direct Credit of a charge
5 = Loan request to Jhotpot interface

Tenant ID

Alphanumeric string that displays the ID of the network operator for which the CDR was produced.

Result Code

If successful, this is 0. Otherwise see OCI Server Result Codes.

CDR Generation Date

The date the CDR was generated. Format: DD/MM/YYYY.

CDR Generation Time

The time the CDR was generated. Format: hh:mm:ss.

Payment Method

The method of payment that was used.

possible values

-1 = unknown
0 = postpaid
1 = prepaid

Session ID

The Tango Internal Charging Interface (ICI) session ID.

IMSI

The IMSI of the subscriber who is charged.

Location Info

Location information on the subscriber such as roaming status.

Event Info

Additional information regarding the event that triggered the payment such as Plan Name, Plan ID, and Plan Booster Amount if applicable. The values are separated by a vertical delimiter. This field is empty if not provided by the client.

The information here comes from the SPCM and is not generated by the OCI itself. Example: TEST_1MB_1MIN_REC282904.

VAT Rate

The percentage added to the charge due to VAT.

This is empty if the unit type field is not a monetary value. The value is 0 if VAT does not apply.

Unit Type

The unit type of the transaction.

possible values

2 = Volume (bytes
3 = Time (seconds)
50 = Money

Units

The number of units reserved or charged. This is the exact value received by the OCI client.

Total Cost without Exponent

The value sent to the OCS after any VAT has been applied but before the costExponent has been applied.

Loan

The amount charged to the subscriber’s loan amount.

Retry Count

The number of times a direct debit retry was attempted.

Total Cost with Exponent

The value sent to the OCS after any VAT has been applied and after the costExponent has also been applied.

Transaction ID

The transaction ID is a value returned by the charging client when a plan is purchased successfully via a direct debit request.

The transactionId originates from the directDebitUnitRes ICI interface method.

Request ID

The requestId used in the ICI direct debit request.

The requestId originates from the directDebitRequest OCI server method.

This field is empty if not applicable.

Sample

OCI CDR Sample

00041008080001080404040609090901,30,3,tenant,0,02/06/2021,07:31:03,0,JINun34Wxk6awgqS,470021844469991,,100MB_carry_fwd_14hrs|438617677|,18.45,50,200,236.90,0,0,23690,,4xXOc9dwje9WOdeB

OCI Server Result Codes

Code Description

1

Protocol error detected by the charging gateway.

2

Protocol error detected by charging handler.

3

Release call issue by prepaid platform.

4

Subscriber has zero balance or balance has expired.

5

Unknown subscriber announcement received.

6

Prompt and collect user information.

This is probably due to a new subscriber.

7

Protocol error detected in SINAP/INAP/CAP server.

8

No data usage for a defined period of time.

9

Subscriber barred announcement played before release.

10

Subscriber barred announcement played before release.

11

An undefined announcement played before release.

12

Timeout waiting for the prepaid platform.

13

Failue in looking up subscriber database.

14

Invalid B-number.

15

Tariff not found.

32

Date proxy close received.

33

Failure to find suitable rating entry.

34

Insufficient balance.

48

Reserve request amount exceeded.

49

Error in indicated volume parameter.

50

Error in indicated charging information parameter.

51

Charging interface configurably blocked.

64

Reservation has expired.

80

Undefined network error.

81

Undefined subscriber error.