Telecommunication Operators
Welcome to the Sentinal® Integration Documentation for Telecommunication Operators. This guide is specifically tailored for Telecommunication Operators seeking to integrate seamlessly with the Sentinal® system for the purpose of tax monitoring, fraud prevention, and regulatory compliance. The Sentinal® API and supporting systems are designed around REST and SFTP principles, ensuring a predictable, secure, and standardized data ingestion experience.
This documentation outlines the responsibilities of telecom operators when submitting Call Detail Records (CDRs), as well as the specific interfaces available for integration.
What are Telecommunication Operators in the Sentinal® Ecosystem?
Telecommunication Operators play a vital role in enabling and recording digital communication across national networks. They are responsible for maintaining accurate records of call and data activity, which must be reported for taxation, audit, and regulatory purposes.
In the context of Sentinal®, operators submit detailed CDRs to the Operator Revenue Auditing System (ORAS), which verifies and monitors the integrity, consistency, and tax implications of all submitted records. This enables national authorities to maintain visibility over telecom-related revenue and detect fraudulent behaviour or data omissions.
Responsibilities of Telecommunication Operators Integrating with Sentinal®
As a telecom operator integrating with the Sentinal® system, you are responsible for:
CDR Submission: Submit all relevant Call Detail Records for voice and data communication events via the supported integration channels. This includes both completed and attempted calls where relevant.
Data Integrity: Ensure that the CDRs submitted are complete, unaltered, and accurately reflect call duration, costs, origin, destination, and type. The system will perform automated checks to flag inconsistencies or signs of manipulation.
Timely Uploads: Submit CDRs in real time via REST or in scheduled batches via SFTP. Operators must adhere to submission frequency guidelines agreed upon with the regulatory authority.
Respond to Exceptions: Review and resolve flagged records returned in validation reports. This includes correcting and resubmitting invalid or suspicious CDRs.
Key Integration Methods for Telecom Operators
To fulfill your responsibilities, you can integrate with Sentinal® using one of the following methods:
1. CDR Submission via REST API
Endpoint:
/v1/telecom/recordCDR
Method:
POST
Description: Submit individual CDRs in real time. Recommended for real-time or event-driven environments.
Integration Details: CDR API Integration Details
2. CDR Submission via SFTP (Preferred for Batch Uploads)
Directory:
/cdr/incoming/
File Format:
.csv
Description: Upload batches of CDRs for periodic processing. Recommended for high-volume submissions.
Integration Details: CDR API Integration Details
Compliance and Oversight
All submitted CDRs are stored in an auditable, tamper-evident system. Sentinal® and its partners work closely with national authorities to ensure tax obligations are met and to identify any attempts at fraud or data suppression.
By integrating with the Sentinal® system, operators ensure alignment with national regulatory requirements and contribute to a transparent, accountable telecom ecosystem. If you have questions, need onboarding assistance, or run into any issues, please contact our integration team at [email protected].
Last updated