2N® NetStar Billing Data

A billing line is an ASCII character string of variable length, with each line ending in CR LF (or optionally, LF in LINUX). A billing line is divided into sections by colons ‘:’ and individual parts of each section are divided by ‘-’. Missing data may be found by finding the respective position of ‘-’ or ‘:’, which remains even if the data are missing.

The billing line is divided into the following sections: record identification : date and time : caller A : caller B : status : billing data

Billing line example
34-28:1.3.2010-9.31.43:I-N6-201-Alice-201-200:O-N5-201-Bob-200-200:N:2-2-0-N-0-2

The importance of individual sections is described in the following chapters:

Record Identification

The record identification contains two numbers: I-C

I – represents an unambiguous number of line record (32-bit number), used to store the REFERENCE item from the billing record. The entry is used for the clear identification of a billing line.

C – call reference; used for matching multiple lines related to a single call; an unambiguous number generated upon call initiation. For example, when calling a group, an n number of lines for each extension within the group will be generated, with the number being identical for all of these lines.

Date and Time

This section has the following format: day.month.year – hour.min.sec

day.month.year – represents the date entered at the end of the billing line, i.e. the charging date.

hour.min.sec – represents the time of call termination; the time of call initiation may be obtained by subtracting the ringing time and the call time from this number (and/or date).

Caller

There are two callers in every call, A and B. The call may either be placed through a port or a DISA-type service. The first letter in the section determines the type of caller. There are several caller types, always distinguishing between an incoming and outgoing call. It might seem that caller A is always incoming and caller B always incoming, but this is not always so, especially due to call switching. Let us imagine the following situation: an operator calls an outside number, speaks for a while, then dials another outside number and puts them through together. Both callers still have to be charged as outgoing calls. The called to be charged for the call must be determined by the billing software.

O – caller is an outgoing call on a port.

I – caller is an incoming call on a port.

S – caller is a service.

D – caller is a DISA.

C – caller is the 2N® Contact Centre Solution.

U – caller unknown; this letter should never appear.

Call on port

For a port call, the section format is as follows: O[oIi] – A[N]port – realclip – user – CLIP – CPN

port – ID of the port through which the call was made; the letter before the port indicates whether the port has been accounted or not. Therefore, A means Accounted and N means Not Accounted.
realclip – real caller identification.
user – name of the calling user.
CLIP – caller identification; in the case of an incoming call it is the number that arrives in the port; in the case of an outgoing call it is the number sent to the port as an ID. This parameter contains the user CLI from NetStar version 3.0.0 (if the call is routed from or to one of the user's extension).
CPN – caller identification; in the case of an incoming call it is the number actually dialled by the caller; in the case of an outgoing call it is the number sent to the port as the target destination.

Service

For a service call, the section format is as follows: S – service identifier – service parameter

Each service is identified by a 4-letter identifier and has its own parameter. A service parameter is a number generated for the service. The meaning of each number is explained in the 2N® NetStar service manual. The following 4-letter service identifiers have been defined:

FWUN – forward user – unconditional

FCUN – cancel user forwarding – unconditional

FWBU – forward user – busy

FCBU – cancel user forwarding – busy

FWNA – forward user – no answer

FCNA – cancel user forwarding – no answer

FCAL – cancel all user forwarding

ASST – take over from extension

ASUS – take over from user

ASGR – take over from group

ASMG – take over from my group

ALRM – alarm

ALCN – cancel alarm

CTID – DTMF to CTI

UREN - ring at call to user

URDI – do not ring at call to user

STLI – extension login

STLO – extension logout

STLG – extension login as guest

UCHP – change PIN

PRMS – private call from my extension

PRCL – private call

CTOR – call to order

PARK – park

UPRK – unpark

CFCD – create conference on demand

BSLI – bundle extension login

BSLO – bundle extension logout

BULI – bundle user login

BULO – bundle user login

ACLI – ACD group login

ACLO – ACD group logout

AGLI – all ACD groups login

AGLO – all ACD groups logout

VMSU – forward user to voicemail – unconditional

VMRU – cancel user forwarding to voicemail – unconditional

VMSB – forward user to voicemail – busy

VMRB – cancel user forwarding to voicemail – busy

VMSN – forward user to voicemail – no answer

VMRN – cancel user forwarding to voicemail – no answer

VMRA – cancel all user forwarding to voicemail

VMGR – record voicemail greeting

VMGD – delete voicemail greeting

VMGP – play voicemail greeting

CTOC – connect to call

ACPF – activate profile

DCPF - deactivate profile

SUPR – set presence

STIM – set time

SDAT – set date

PRGR – record progress

PRGP – play progress

PRGD – restore default progress

CFAC – add to conference

CFRO – call to conference room

CLRE – enable CLIR

CLRD – disable CLIR

VMEN – voicemail entry

VMEA – authorised voicemail entry

SWRS – set switch router

SWRG – get switch router

EALR – emergency alarm

EALC – cancel emergency alarm

REUS – user reservation

CBIN – internal callback

LEXP – licence expired

EMMO – emergency mode

RBST – ring back to extension

RBNU – ring back to user

DISA

For a DISA call, the section format is as follows: D – DISA id – number dialled in DISA

2N® Contact Centre Solution

For a CCS call, the section format is as follows: C – CCS id – dialled number

Status

The following call statuses are relevant:

Normal

N – The call was dispatched in the usual manner: i.e., caller A picked up the phone and dialled caller B’s number. In such case, caller A has an outgoing call and caller B has an incoming call.

Forwarded

F – C[I]r – In the case of a forwarded call it is necessary to know the reference line from which it has been forwarded. Reference r is used for this purpose. In case there is a letter I before the reference, it refers to the call; the letter C refers to the billing line.

Switched

T – C[I]r – C[I]r – In case of a switched call, two references are required, with the same meaning as in the case of a forwarded call.

Message

M – indicates a message (SMS or email).

Billing Data

The last section of billing line contains following: ringing time – call time – tariff impulses – private – order – cause
ringing time – duration of ringing until call was accepted.

call time – call duration in seconds; 0 indicates that the call has not taken place, i.e. has been recorded as unaccepted.

tariff impulses – number of tariff or pseudo-tariff pulses during a call (or during ring tone as well in case of simulated ringing through DISA).

private – calls identified as private are marked P; all the other calls are marked N.

order – an entry used to break down each line into individual orders, projects, etc. Before, during or after the call, the service will allow to identify the order to which the call should be charged. For example, Cornet phones allow you to select an order from the Order List in the phone menu.

cause – cause of call termination; a number from 0 to 255 (1 byte) which identifies the cause of call termination in accordance with the ITU Q850 and ETSI 300.102 standards.

 

Code meanings:

0 – NONE – Internal auxiliary cause.

1 – ANY_OTHER – Internal auxiliary cause.

2 – NORMAL_CALL_CLEARING – The call was terminated normally, the user hung up.

3 – USER_BUSY – The called user is busy.

4 – USER_NOT_RESPONDING – The called user fails to answer (the ringing timeout has elapsed)

5 – CALL_REJECT – The call was rejected by the user.

6 – UNSELECTED_USER_CLEARING – Multiple user calling; one user answered and the others are ended with this cause.

7 – DESTINATION_UNKNOWN – The destination is not known (unknown routing).

8 – DESTINATION_INVALID – The destination is invalid (wrong number/url format).

9 – DESTINATION_INCOMPATIBLE – The destination is incompatible (no codec match, url message sent to incompatible GSM).

10 – DESTINATION_DISABLED – The destination is disabled.

11 – DESTINATION_FORWARDED – The destination has been forwarded.

12 – NO_FREE_CIRCUIT_LOCAL – The local network is busy.

13 – NO_FREE_CIRCUIT_REMOTE – The remote network is busy.

14 – PROTOCOL_ERROR – Unspecified protocol stack error.

15 – NO_DIAL_TONE – No dial tone has been detected.

16 – INVALID_STATE – Invalid connection state for this operation.

17 – NETWORK_OUT_OF_ORDER – The destination is out of order temporarily.

18 – NO_CREDIT – The credit is insufficient for the call.

19 – MONITOR_NOT_READY – The call cannot be monitored.

20 – USER_IN_DND_MODE – The user is in the DND mode.

21 – USER_00 – User cause 00

22 – USER_01 – User cause 01

23 – USER_02 – User cause 02

24 – USER_03 – User cause 03

25 – USER_04 – User cause 04

26 – USER_05 – User cause 05

27 – USER_06 – User cause 06

28 – USER_07 – User cause 07

29 – USER_08 – User cause 08

30 – USER_09 – User cause 09

31 – USER_10 – User cause 10

32 – USER_11 – User cause 11

33 – USER_12 – User cause 12

34 – USER_13 – User cause 13

35 – USER_14 – User cause 14

36 – USER_15 – User cause 15