Billing Platform
Version 4.01 | February 2010
Abstract here. This Upgrade Guide is for the Client‟s convenience only and is not a part of
the Agreement between MACH and the Client MACH reserves the right to change, modify
and/or replace the Upgrade Guide at MACH‟s own discretion.
This document is the property of MACH and contains confidential information or Intellectual Property Rights, both protected by law. This
document is to be used only for the purpose for which it has been supplied and shall not be reproduced in whole or in part, published,
disclosed to others or used for any other purposes without the prior written permission of MACH.
Billing Platform – User Guide
2. Introduction ........................................................................................................ 5
1. Document Information
1.1 Revision Log
Terms/Abbreviations Acronyms
CDR Call Detail Record
CSF Client Specific Format, external file
format
EDI Electronic Data Interchange by a FTP
session
FCC File Control Center
M2T MBF to TAP files process/TAP creation
process
MBF Mach Billing Format, internal file format
OCC Online Control Center
2. Introduction
This Billing Platform User Guide is focused on the MACH Billing service providing you with an overview of the
application and the various reports.
The standard set of reports through MACH COM and by EDI is provided along with the TAP Creation service.
These reports are described in chapters 4 and 5.
The operators using MACH Billing Platform can also optionally subscribe to the Online Control Center, which
allows file and record level detailed reporting. This tool is described in chapter 6.
For further information of the service, please refer to the MACH Billing Platform Service Description.
MACH Portal is your online interface and provides you with access to information and reporting related to Data
Clearing and related Value Added Services from MACH.
*) Access to MACH Smart, Roaming Management System and Online Control Center is dependent on
subscription.
For more information on the individual applications or areas of information please see the relevant User Guides
made by MACH which can be downloaded via the Portal.
MACH Smart and Roaming Management System are described in the individual Service Descriptions and User
Guides.
MACH Portal is available via the „client log-in‟ area on www.mach.com or via Error! Hyperlink reference not
valid..pt.
To access the MACH Portal each user needs a user id and a password. Furthermore, MACH needs to register
our ip-address. Creation of user ids and registration of ip-addresses will be handled as part of the process
leading up to the upgrade.
3.2 Browsers
It is recommended that you use one of the following browsers (or higher version):
Microsoft Internet Explorer 6.0 SP1 and SP2
Netscape 7.2
Mozilla Firefox 1.07
The use of other makes or versions of Internet browser is not recommended and may result in limited nationality,
including suboptimal rendering (larger icons and texts).
On MACH Portal the client has the possibility to access some of the services by clicking “my pages”. For
instance, you can access Online Control Center service by clicking the OCC page.
F IGURE 3: MY PAGES
By Clicking “My Pages” you also have the possibility to access the Online Control Center (“OCC page”).
The MACH Com reports can be delivered via e-mail as scheduled reports or are available on-line via the MACH
Portal.
The following table lists the MACH COM reports and how they can be scheduled:
Report Scheduled
Camel Correlation Report Daily
M2T Report – Process Date Report Daily
Rejected Process Summary Report v 1.1 Monthly
Rejected, CDR Details Report Daily
Rejected, Missing CSF Files v1.1 Daily
TFG Delivery Report Daily Daily
Unprocessed CSF Files Daily
Unprocessed MBF Files Daily
The reports are available on the MACH Portal and can be accessed in the following way:
The MACH TAP Creation reports are available on the following path
MACH Smart>Shared Reports>MACH Com>MACH TAP Creation.
To run a report the user is suppose to answer some common prompts, to answer the prompts follow the below
procedure:
1. Select the appropriate report from the Mach Tap Creation folder.
NOTE: Prompts notated as *(Required) are mandatory and requires the user to response before the report will
launch.
If the prompt is not selected to a required prompt, the default values are used. The following message also
displays.
All MACH TAP Creation reports can be scheduled to be delivered by e-mail. Daily reports on the same time
every day and monthly reports on the same day every month. The setup of the E-mail Subscriptions needs to be
requested by Mach Client Support.
This report is a daily report providing a summary of the Camel Correlation process for the day before.
You are requested to choose at least one selection from all CSF File Status like:
Not available
Absent
Deleted
Submitted
Valid
Working
1. To select the elements, click on the elements in the Available combo box and move to Selected.
2. To move use the right arrow.
3. The report displays, a sample report is as below.
Sample Report
Number of Records Indeed Correlated Number of records correlated so far (grouped by correlation type
when relevant)
Number of Records not Correlated Number of records not correlated in the file at the end of the
processing. This number = 0, as long as the file is still stored for
correlation
Column Name Description
This report is a daily report showing all CSF files received, which have been converted into MBF files and which
have been processed by the TAP Creation process. For each CSF file is information about the TAP Creation
Processing Status, the File Record Types, the Number of Call Event Details, the Call Duration and the Volume
shown.
Sample report
Description
This report is a monthly report giving an overview of number of rejected records in the TAP Creation Process
within the last month. The report is also showing the reject types and if the rejected records potential could have
been giving a revenue (duration/volume in the records) if processed into TAP files.
Sample Report
Sample Report
NOTE: The call age = No of days from call time stamp to Report End date (Today -1) and not
to the current date (Today)
This report is a daily report giving a list of all CSF files that have been failing in the MBF conversion process,
have been missing in a file sequence or a duplicate to an existing CSF files received. It provides the CSF File
Name, the CSF File Status and the CSF File Receipt Timestamp.
Sample report
This report is a daily report giving an overview of all the CSF file streams received on the CSF file receipt dates
for the last 30 days. For each file stream are the number of files and the record count shown.
Sample report
This report is a daily report giving a lists of all CSF files, which haven‟t been converted into the MACH internal
file format (MBF) and older than 24 hours since the CSF File Receipt timestamp.
Sample report
Sample report
Upon completion of the TAP creation process, a TAP creation report is created and can be delivered to client via
the EDI link between MACH and the client or by e-mail.
The report guarantees transparency in the TAP creation process which is required by the client‟s revenue
assurance departments. In the report the following can be found:
1. Which switch file content goes into which TAP file. This is a many to many
relationship – overall transparency against the client is assured
2. The statistics for received switch files (including any erroneous CDR). The statistics
are intended to be utilized/processed by an application on the client side to compare
the figures against the files that have been sent to MACH
3. The statistics for the created TAP files directly after creation. Note that information
regarding the TAP files will be found in many standard MACH SMART/COM reports.
The report includes call dates, rating information, exchange rates, record types, durations, volumes and roaming
partner information.
The report file follows csv format, i.e. the fields within the file shall be separated by the semicolon “;” character.
The report is kept in that form to allow clients comfortable viewing of the report with Excel, as well as easy
processing by client applications.
Sample report
Where:
Example: M2T_ITA01_00001_2003052114.csv
MBF Average Call Age Metric This is the average call age in the received MBF file. Calculated as difference
between call record
end and the receipt of the MBF file. This column is to measure the performance
of the client in delivering the data.
TAP Record Count Metric Total number of TAP records
TAP Duration Metric Total duration of TAP records in seconds
TAP Volume In Metric Total volume in of TAP records in bytes
TAP Volume Out Metric Total volume out of TAP records in bytes
IOT Currency Metric Currency of IOT of client (3 char ISO code)
Exchange Rate Metric Exchange rate used to get TAP charges
TAP Net Charge Metric Total TAP charge (in TAP currency, the currency in defined in the TAP
Creation Status)
TAP Tax Metric Total TAP tax value
TAP Discount Metric Total TAP discount value
Key : a field attribute for a single line in the report. The metrics are summarized for each key.
Metric : a countable value which is usually aggregated at report level, such as the number of calls, minutes, or
charge.
Online Control Center (OCC) is an add-on service to the TAP Creation service. It’s therefore needed to
make a separated subscription in order to be given access to the below detailed features.
OCC provides self-service related functions and access to information on file detail level and CDR detail level.
OCC also provides extended search and filter functionalities in order to locate single files or records or simply to
get an overview of either files or records. Exporting results are supported by OCC as well, and are not subject to
the limitations in terms of rows retrieved, as mentioned in the following chapters.
Online Control Center will be activated by MACH Client Support and can be accessed via the Portal by clicking
“My Pages” as described in section 2.3.
The File Overview window is depicted below. Navigation to File Detail is achieved through the filename
hyperlink. Download is achieved via pictorial links next to each row. The maximum no. of rows retrieved in a
search is 500. The actual no of rows listed at a time is configurable, default is 20 rows.
The upper half of the window displays the file detail panel. CDR count fields, valid and error is hyperlinks to CDR
and window. The lower part of the window displays the resulting TAP files, if target is inbound CSF file. If target
file is inbound TAP the lower panel displays resulting CSF files. Each filename listed is a hyperlink to file detail
for the specific file. Navigation to CDR overview is achieved through the TAP rec. no hyperlink or the CSF
(Client Specific Format) Records parsed and CSF Records mapped hyperlinks. The CDR Overview is then
displayed with an empty list but with proper search criteria.
Navigation to CDR detail is achieved through the TAP rec. no hyperlink. Navigation to File Overview is achieved
through filename hyperlink. The maximum no. of rows retrieved in a search is 200,000 records. The actual no of
rows listed at a time is configurable, default is 20 rows.
The details display is a superset of the information from the CDR Overview form. CSF/TAP file names are
hyperlinks to the file details form.
The CDR Overview is used for handling test IMSIs and for handling of accumulated test call records.
The first component within CDR Overview contains the search fields. After the user performs a search, the
information table below the search fields displays the test CDRs found. After clicking on a CDR, CDR details
screen will be shown.
In the information table there is a checkbox near each of the found CDRs, by which the user are able to select
CDRs and perform actions as: create test file, Select all the CDRs or Deselect all the CDRs. A CSV export
button is placed below the search results box, allowing exporting of all found CDRs.
If the user just wants to view the CDRs irrespective of any partner, then he/ she can select from the partner filter
and this will be only a view for the user. The result can be exported to an excel document.
The test CDR details can be seen by clicking on the test CDR link in CDR overview panel
Selection of test calls is required for manual test file generation. It shall be possible to mark virtually unlimited
number of test records, preferable using iterative search and selection mechanisms. The user can select the test
CDRs to create a test file out of it. Test files can be created for a particular partner. The user is having the facility
of selecting or de selecting the test CDRs from the view.
The test file can be created by clicking on the Add to Test File button. Once the test file is generated the
reference number for the Test TAP file will appear in the screen, so that the user can search the same test file in
Test File History the reference, which is the request ID. The test file generated will appear in the history after 10
to 15 minutes delay.
The same test TAP file can be downloaded from File Overview to see the details of the test TAP File.
The user will able to upload/delete “Test IMSI‟s” through this interface. In order to upload IMSIs‟, the user needs
to follow 4 steps:
1. Select the Partner
2. On selection of partner, all existing IMSI‟s for that partner will be populated in the left hand Box
(labeled as “Existing IMSIs).
3. To be uploaded IMSI Numbers has to be given in right side Box (labeled as “To be Uploaded IMSI‟s)
a. Multiple IMSI(s) can be given with comma (,) as delimeter
4. Click on “Add IMSI(s) button
5. Response from System:
a. If the all the given IMSI(s) are correct, then user will be prompted with “Successfully Uploaded”
b. If any one of given IMSI is wrong then user will be prompted with “Imsi imsi no‟ Invalid
NB: NONE of the IMSI(s) will be uploaded to system until all the given IMSI(s) are correct
To delete the Existing Test IMSI(s) the user needs to follow these steps:
1. Select the partner
2. On selection of partner, all existing IMSIs for that partner will be populated in the left hand Box
(labeled as “Existing IMSI‟s).
3. Select the check box next to IMSI(s)
4. If all the shown IMSI(s) to be deleted, then user need to select the check box at “Mark for Deletion”
5. Click on “Delete Selected”
6. Response from System:
a. System will prompt “Do you really want to delete IMSI?” for confirmation
b. If the user selects “Yes” then the system will delete the selected
IMSI(s) and System will prompt “Successfully Deleted”
c. If the user selects “No” then system will NOT Delete IMSI(s)