8 Freeform Recharges

Overview

Introduction

This chapter defines the CCS EDRs for freeform recharges.

Freeform Recharge Succeeds using the GUI (EDR 8)

Mandatory EDR 8 fields

The recharge succeeds where the account is credited.

This list identifies the mandatory EDR record fields for a successful freeform recharge using the GUI (EDR type 8):

  • ACCOUNT_TYPE (Product Type ID)
  • ACS_CUST_ID (ACS Customer ID)
  • BALANCE_TYPES (existing account)
  • BALANCES (pre-transaction account balances)
  • BONUS_TYPE (name)
  • COSTS (rated calls)
  • CS (call status, S or D) (call status, S or D)
  • NEW_BALANCE_EXPIRIES (dates after voucher recharge)
  • OLD_BALANCE_EXPIRIES (dates before voucher recharge)
  • REFERENCE (operator freeform)
  • RELOAD_BONUS (promotion name)
  • RELOAD_BONUS_AMOUNT (amount applied)
  • RELOAD_BONUS_EXPIRY (date remaining bonus expires)
  • RELOAD_BONUS_LEFT (bonus amount remaining)
  • RESULT (voucher redemption, always Success)
  • TERMINAL (Network ID)
  • USER (operator logon name)
  • WALLET_TYPE (ID of wallet changed)

Optional EDR 8 fields

This list identifies the optional EDR record fields for a freeform recharge succeeds using the GUI (EDR type 8):

  • ADJUSTMENT (generated by an adjustment)
  • BEARER_TYPE (bearer type for promotions) (bearer type for rewards)
  • CHANNEL (for rewards) (for rewards)
  • REVERSE_CHARGE (generated by a reverse charge)
  • NEW_ACCT_STATE (after update)
  • OLD_ACCT_STATE (before update)

Note: The NEW_ACCT_STATE and OLD_ACCT_STATE tags will always be present when the freeform recharge causes a change to the wallet state.

MSISDN additional fields

If the MSISDN ccsCDRLoader plug-in is installed on the SMS, the following field will be present:

  • MSISDN (account calling number)

Example EDR 8 for freeform succeeds

BILLING_ENGINE_ID=21|SCP_ID=110537566|SEQUENCE_NUMBER=139450184|CDR_TYPE=8|RECORD_DATE=20040804132135|ACCT_ID=61|ACCT_REF_ID=61|USER=SU|TERMINAL=192.168.25.108|RESULT=Success|BONUS_TYPE=CUSTOM|CS=S|REFERENCE=FreeForm Recharge|ACCOUNT_TYPE=1|BALANCE_TYPES=1|BALANCES=1000|COSTS=-100|OLD_BALANCE_EXPIRIES=0|NEW_BALANCE_EXPIRIES=0|ACS_CUST_ID=1|WALLET_TYPE=1

Example MSISDN

BILLING_ENGINE_ID=21|SCP_ID=110537566|SEQUENCE_NUMBER=13950184|CDR_TYPE=8|RECORD_DATE=20040804132135|ACCT_ID=61|ACCT_REF_ID=61|USER=SU|RESULT=Success|CLI=1234|REFERENCE=FreeForm Recharge|ACCOUNT_TYPE=1|OLD_ACCT_EXPIRY=0|NEW_ACCT_EXPIRY=0|MAX_CONCURRENT=10|NEW_LAST_USE=20040804132122|BALANCE_TYPES=1|BALANCES=1000|COSTS=-100|OLD_BALANCE_EXPIRIES=0|NEW_BALANCE_EXPIRIES=0|ACS_CUST_ID=1|MSISDN=1234

Note

The sequence of all fields output in an EDR is not guaranteed.

Freeform Recharge Succeeds using PI (EDR 8)

Mandatory EDR 8 fields

The recharge succeeds where the account is credited.

This list identifies the mandatory EDR record fields for a successful freeform recharge using PI (EDR type 8):

  • ACCOUNT_TYPE (Product Type ID)
  • ACS_CUST_ID (ACS Customer ID)
  • BALANCE_TYPES (existing account)
  • BALANCES (pre-transaction account balances)
  • BUCKET_IDS (within balance type recharged)
  • COSTS (rated calls)
  • NEW_ACCT_EXPIRY (date after update)
  • NEW_BALANCE_EXPIRIES (dates after voucher recharge)
  • OLD_ACCT_EXPIRY (dates before update)
  • OLD_BALANCE_EXPIRIES (dates before voucher recharge)
  • PI (logon name and IP address)
  • RELOAD_BONUS (promotion name)
  • RELOAD_BONUS_AMOUNT (amount applied)
  • RELOAD_BONUS_EXPIRY (date remaining bonus expires)
  • RELOAD_BONUS_LEFT (bonus amount remaining)
  • WALLET_TYPE (ID of wallet changed)

Optional EDR 8 fields

This list identifies the optional EDR record fields for a freeform recharge succeeds using PI (EDR type 8):

  • BEARER_TYPE (bearer type for promotions) (bearer type for rewards)
  • CHANNEL (for rewards) (for rewards)
  • NEW_ACCT_STATE (after update)
  • OLD_ACCT_STATE (before update)
  • REFERENCE (from pi reference)

Note: The NEW_ACCT_STATE and OLD_ACCT_STATE tags will always be present when the freeform recharge causes a change to the wallet state.

MSISDN additional fields

If the MSISDN ccsCDRLoader plug-in is installed on the SMS, the following field will be present:

  • MSISDN (account calling number)

Platform dependant additional fields

Depending on the installed platform, the following field will be present:

  • COMPONENT (from pi command reference)

Example EDR 8 for freeform succeeds

BILLING_ENGINE_ID=21|SCP_ID=161986004|SEQUENCE_NUMBER=12|CDR_TYPE=8|RECORD_DATE=20070704141927|ACCT_ID=61|ACCT_REF_ID=61|ACS_CUST_ID=1|BALANCES=1000|BALANCE_TYPES=1|BUCKET_IDS=45844|COSTS=-100|NEW_BALANCE_EXPIRIES=|OLD_BALANCE_EXPIRIES=|PI=adminAT192.168.25.106|OLD_ACCT_EXPIRY=0|NEW_ACCT_EXPIRY=0|WALLET_TYPE=1|ACCOUNT_TYPE=1

Example MSISDN

BILLING_ENGINE_ID=21|SCP_ID=161986004|SEQUENCE_NUMBER=12|CDR_TYPE=8|RECORD_DATE=20040804141927|ACCT_ID=61|ACCT_REF_ID=61|ACS_CUST_ID=1|BALANCES=1000|BALANCE_TYPES=1|BUCKET_IDS=45844|COSTS=-100|CS=S|NEW_BALANCE_EXPIRIES=|OLD_BALANCE_EXPIRIES=|PI=adminAT192.168.25.106|REFERENCE=PIFreeForm|WALLET_TYPE=1|ACCOUNT_TYPE=1| LAST_USED=200401011234|MSISDN=1394111111

Note

The sequence of all fields output in an EDR is not guaranteed.

Freeform Recharge Succeeds using PI (EDR 2)

Mandatory EDR 2 fields

The recharge succeeds where the account is debited.

This list identifies the mandatory EDR record fields for a successful freeform recharge using PI (EDR type 2):

  • ACS_CUST_ID (ACS Customer ID)
  • BALANCE_TYPES (existing account)
  • BALANCES (pre-transaction account balances)
  • BONUS_TYPE (name)
  • COSTS (rated calls)
  • CS (call status, S or D) (call status, S or D)
  • NEW_BALANCE_EXPIRIES (dates after voucher recharge)
  • OLD_BALANCE_EXPIRIES (dates before voucher recharge)
  • PI (logon name and IP address)
  • REFERENCE (operator freeform)
  • RESULT (voucher redemption, always Success)
  • WALLET_TYPE (ID of wallet changed)

MSISDN additional fields

If the MSISDN ccsCDRLoader plug-in is installed on the SMS, the following field will be present:

  • MSISDN (account calling number)

Example EDR 2 for freeform succeeds

BILLING_ENGINE_ID=21|SCP_ID=161986004|SEQUENCE_NUMBER=13|CDR_TYPE=2|RECORD_DATE=20040804141927|ACCT_ID=61|ACCT_REF_ID=61|ACS_CUST_ID=1|BALANCES=1100|BALANCE_TYPES=1|RESULT=Success|COSTS=100|CS=S|NEW_BALANCE_EXPIRIES=|OLD_BALANCE_EXPIRIES=|PI=adminAT192.168.25.106|REFERENCE=PI FreeForm|WALLET_TYPE=1|BONUS_TYPE=CUSTOM|ACCOUNT_TYPE=1|OLD_ACCT_EXPIRY=0|NEW_ACCT_EXPIRY=0

Example MSISDN

BILLING_ENGINE_ID=21|SCP_ID=161986004|SEQUENCE_NUMBER=13|CDR_TYPE=2|RECORD_DATE=20040804141927|ACCT_ID=61|ACCT_REF_ID=61|ACS_CUST_ID=1|BALANCES=1100|BALANCE_TYPES=1|BUCKET_IDS=45844|COSTS=100|CS=S|NEW_BALANCE_EXPIRIES=|OLD_BALANCE_EXPIRIES=|PI=adminAT192.168.25.106|REFERENCE=PI FreeForm|WALLET_TYPE=1|ACCOUNT_TYPE=1|OLD_ACCT_EXPIRY=0|NEW_ACCT_EXPIRY=0|MSISDN=1394111111

Note

The sequence of all fields output in an EDR is not guaranteed.

Freeform Recharge Fails using PI (EDR 2, 8)

Mandatory EDR 2 fields

A EDR type 2 will be produced for a charge attempt, and a EDR type 8 will be produced for a refund attempt.

This list identifies the mandatory EDR record fields for an unsuccessful PI promotional recharge using PI:

  • ACCOUNT_TYPE (Product Type ID)
  • ACS_CUST_ID (ACS Customer ID)
  • BONUS_TYPE (name)
  • CS (call status, always D)
  • NACK (freeform recharge list)
  • PI (logon name and IP address)
  • REFERENCE (from pi reference)
  • RESULT (pi failure)
  • WALLET_TYPE (ID of wallet changed)

MSISDN additional fields

If the MSISDN ccsCDRLoader plug-in is installed on the SMS, the following field will be present:

  • MSISDN (account calling number)

Example EDR 8 for freeform fails

BILLING_ENGINE_ID=21|SCP_ID=161986004|SEQUENCE_NUMBER=12|CDR_TYPE=8|RECORD_DATE=20070704141927|ACCT_ID=61|ACCT_REF_ID=61|ACS_CUST_ID=1|BONUS_TYPE=CUSTOM|CS=D|PI=adminAT192.168.25.106|REFERENCE=PI FreeForm|WALLET_TYPE=1|NACK=WDISP|ACCOUNT_TYPE=1|RESULT=Frozen Wallet

Example MSISDN

BILLING_ENGINE_ID=21|SCP_ID=161986004|SEQUENCE_NUMBER=12|CDR_TYPE=8|RECORD_DATE=20040804141927|ACCT_ID=61|ACCT_REF_ID=61|ACS_CUST_ID=1|CS=D|PI=adminAT192.168.25.106|REFERENCE=PI FreeForm|WALLET_TYPE=1|NACK=NRCH|ACCOUNT_TYPE=1|MSISDN=1394111111

Note

The sequence of all fields output in an EDR is not guaranteed.