Entry

An entry record contains the actual import data of interest. One entry record for each RCR.

An entry record has a Record Type of 'E'.

Table 1. Entry record field definition
Col Field name Data type Description Required?
0 Record Type Text 'E' for a CDR entry Yes
1 External Entry ID Text A unique identifier for the entry, generated by the external system No, defaults to Smile-generated ID (including line number and file)
2 SID Number The target service ID of the subscription. This must be blank or match the importers configuration. No, defaults to importer configuration
3 Identifier Text The “identifier” that is used to guide the entry to the right subscription. The "Charged party". Yes
4 Identifier Type Text Describes the type of Identifier in the “Identifier” field. Allowed values:
  • USN
  • Username. Depending upon importer configuration, this will look up the username, subservices or both
  • UoAttributeType = X (where X is the uoAttributeType codeName - this part is case sensitive)
 Yes
5 Start Timestamp Timestamp ISO Standard An ISO 8601 formatted timestamp, YYYY-MM-DDThh:mm:ss.sss+Z. For example: 2010-01-01T01:00:00.000+11:00 Yes
6 Call Type Text The type of activity record. Allowed values:
  • Data
  • SMS
  • MMS
  • Fax
  • WAP
  • Forwarded Voice
  • Voice
  • Event count
  • Unknown
  • Imported Charge
 Yes
7 CDR Caller Number Text The originator of this CDR, for example, the phone number that made the call.

See CDR Caller Type

 No
8 CDR Caller Type Text The type of the caller record. Allowed values:
  • E164 - ITU-T E.164 formatted phone number (e.g. 6121234678)
  • FNN - Australian Full National Number formatted phone number (e.g. 0212345678)
  • Untyped
Note: When using E164 or FNN, the caller field must contain only digits.		 If CDR Caller number is specified
9 CDR Called Number Text The destination of this CDR, for example, the phone number that received the call.

See CDR Called Type

 No
10 CDR Called Type Text The type of the called record. Allowed values:
  • E164 - ITU-T E.164 formatted phone number (e.g. 6121234678)
  • FNN - Australian Full National Number formatted phone number (e.g. 0212345678)
  • Untyped
 If CDR Called Number is specified
11 Bytes received Number The total bytes received from the subscription by the vendor. This number can be very large and must be non-negative. No
12 Bytes sent Number The total bytes sent to the subscription by the vendor. This number can be very large and must be non-negative. No
13 Duration Number The billable duration of the activity record, in seconds. This is the difference between the start timestamp and the time that the usage finished. Must be positive, zero second duration allowed. No, defaults to 1 second
14 Pages Number For fax services, the number of pages transmitted or received. Must be non-negative. No
15 Count Number If applicable, the event count. Must be non-negative No
16 External tariff code Text If available, the upstreams rating tariff code may be provided to Smile as a hint on how to rate the entry No
17 External wholesale charge Decimal (Unbounded) Decimal, ex-tax charge from the up-stream provider. Sometimes this is used for reconciliation or for charging a markup. No
18 Chargeable Text Whether this usage is chargeable or not. If the usage is not chargeable, Smile will not rate it. Allowed values:
  • true
  • t
  • false
  • f
 No, defaults to true
19 Role Text A flag indicating the role of the subscriber in this activity record (caller or called). “Source” for caller, “Destination” for called. Note: Only “Source” is currently supported. No, defaults to Source (caller)
20 IP Address Text The IP address allocated to the subscription for this session, if applicable No
21 Call ID Text If available, the SIP (or other) call ID No
22 External Session ID Number The session ID for this activity record. Multiple records with the same Session ID belong to the same session. The session ID must be unique globally to this importer. Note also that CDRs in the same session must have the same SID, identifier, identifier type, call type, caller, called, external tariff code, chargeable ip address and call ID. See “Notes on Session IDs and Flag-falls” below. No. If not provided, each entry is considered to be a separate session
23 Flagfall Text Whether this entry represents the start of a session. Rating configuration may cause flagfall charges to be raised. Note that only one entry in the same session may have flagfall = true. Allowed values:
  • true
  • t
  • false
  • f
See “Notes on Session IDs and Flag- falls” below. 		If External Session ID is specified, otherwise defaults to true
24 Source Text If applicable, a string representing the source of the call or session No
25 Destination Text If applicable, a string representing the destination of the call or session No
26 Description Text A textual description of the activity record. Text in this field will be preserved and included on an invoice. This field is mostly used for externally generated charges which should be on-billed. No
27 Extra Username Text If available, a textual identifier representing the end user. Not used for username lookups. No
28 Bytes sent rate Decimal (Unbounded) The bytes sent rate, usually a percentile rate. Must be non-negative. No
29 Bytes received rate Decimal (Unbounded) The bytes received rate, usually a percentile rate. Must be non-negative. No
30 Sample rate Decimal (Unbounded) An additional sample rate defined by the external system No