Axxess Services and Products - Version 7.1

Overview

The Axxess Services and Products collector retrieves client service allocation and subscription data from the Axxess Reseller Control Panel (RCP) platform using the Axxess REST API.

This collector provides visibility into active client services, product subscriptions, and recent service changes across all managed clients, enabling resellers to validate allocations, reconcile usage, and bill customers within Varibill.

The collector retrieves unrated allocation data, meaning no monetary values are supplied by the source system. Pricing and billing calculations are applied within Varibill based on configured contracts and pricing rules.

This is a point-in-time collector, meaning each execution retrieves the current state of client services and allocations at the time of collection. The collector also captures recent service change records (topups) for the current and previous months.

For general instructions on creating and running Source Collectors, see: Configuring a New Cloud Source Collector

Collector Summary

About Axxess

Axxess is a South African internet service provider and telecommunications company that provides connectivity products and services including mobile data, fibre, ADSL, LTE, VoIP, and fixed wireless solutions.

The Axxess Reseller Control Panel (RCP) is a management platform for Axxess resellers and channel partners. It enables resellers to manage their client base, provision services, monitor subscriptions, and track product allocations across their customer portfolio.

Resellers use the RCP to manage client accounts, assign and monitor service subscriptions, view product catalogues, and track service changes such as topups and upgrades for their customers.

Data Collected

The Axxess Services and Products - Version 7.1 collector retrieves unrated service allocation data from the Axxess Reseller Control Panel. The collector captures two categories of data:

Active Service Records

For each active client, the collector retrieves the current state of their subscribed services. Each record represents a service allocation — a product or subscription assigned to a client.

The collector processes the following data for each active service:

• Client details — client name, site or branch name, and client identifier
• Product details — the product associated with the service, resolved from the Axxess product catalogue where available
• Service quantity — the current quantity allocated for the service
• Service status — only active, non-suspended services are included

The following filtering is applied during processing:

• Only active clients are included (inactive clients are excluded)
• Services with a suspend reason of 3 are excluded
• Only standalone services are included (linked or bundled child services are excluded)

Service Change Records (Topups)

For each active service, the collector also retrieves service change history for the current and previous months. Only changes of type Topup are included. These records capture recent service additions or modifications and are submitted as separate allocation records.

Prerequisites

Before configuring this collector, ensure that:

• You have an Axxess reseller account with access to the Reseller Control Panel (RCP)
• You have API authentication credentials (API username and password) provided by Axxess for REST API access
• You have client login credentials (client username and password) for your reseller account
• You have noted the API host URL for your Axxess RCP environment
• You have access to the Varibill Source Collector configuration screen

Configuration Parameters

The parameters below are entered when configuring the collector in Varibill. They are grouped by function.

Connection Parameters

These parameters identify and authenticate against your Axxess Reseller Control Panel environment. The collector uses a two-level authentication model: API-level authentication (HTTP Basic Auth) and a client-level session login.

Billing Parameters

These parameters control how Product Identifiers and Record Identifiers are constructed in the data submitted to Varibill.

Operational Parameters

These parameters control file management behavior.

Axxess References

The following resources may assist with locating values or configuring your Axxess reseller access.

Axxess Documentation (External)

• Axxess Website
• Axxess Reseller API Documentation - Axxess API Documentation is gated behind a Business Partner Control login. Access should be requested directly from this Vendor.

Configuration Steps

Step 1: Prepare Your Axxess Environment

1. Log in to the Axxess Reseller Control Panel.
2. Confirm that you have API authentication credentials (API username and password) for REST API access. If not, contact your Axxess account representative to obtain them.
3. Confirm that you have client login credentials (client username and password) for your reseller account.
4. Note the API host URL from your browser’s address bar (for example, https://rcp.axxess.co.za/).

Step 2: Configure the Collector in Varibill

1. In the Varibill User Interface, open the Source Collector configuration screen.

2. Enter the required field values under the Details tab:

   • Hosting Provider: Select Varibill Cloud
   • Source Collector Name: Select Axxess Services and Products - Version 7.1

3. Enter the connection parameters:

   • Axxess API Authentication User: The API username for HTTP Basic Authentication
   • Axxess API Authentication Password: The API password for HTTP Basic Authentication
   • Axxess API Host: The base URL of the Axxess RCP (for example, https://rcp.axxess.co.za/)
   • Axxess Client User: The client username for session login
   • Axxess Client Password: The client password for session login

4. Configure the billing parameters:

   • Use Description as Product Identifier: Set to true to use human-readable product descriptions, or false to use product GUIDs
   • Include Client Name in Record Identifier: Set to true to include the client name prefix, or false for product name only

5. Save the collector configuration.

Step 3: Run the Collector

Run or schedule the collector according to your standard Source Collector execution process.

For detailed instructions, see: Configuring a New Cloud Source Collector

Troubleshooting

If the collector fails to connect to the Axxess API, verify that:

• The Axxess API Host URL is correct, includes https://, and includes the trailing slash.
• The Axxess API Authentication User and Axxess API Authentication Password are correct and the API credentials have not been revoked.
• The Axxess Client User and Axxess Client Password are correct and the client credentials have not been revoked or expired.
• No firewall or IP restriction rules are blocking the Varibill collector’s IP address from reaching the Axxess API host.

If the collector connects successfully but returns no data, verify that:

• Your reseller account has active clients with at least one active service subscription.
• The Axxess Reseller Control Panel is accessible and returning data correctly.
• Client services are not all suspended with suspend reason 3, which would cause them to be excluded from collection.