Smile Guides

User Guide

The User Guide is for operators who use Smile to manage customers, services and billing. This guide helps you complete tasks such as:

  • creating and managing accounts and subscriptions
  • creating and dispatching invoices
  • processing automatic and manual payments
  • managing overdue accounts
  • using the helpdesk and other workflows
  • generating reports

Configuration Guide

The Configuration Guide is for administrators or managers who use Smile to manage customers, services and billing. This guide helps you complete tasks such as:

  • configuring accounts receivable and credit control
  • configuring communication preferences
  • creating and configuring services
  • creating and configuring packages and plans
  • configure payment processing
  • configuring user management and security
  • configuring RADIUS
  • configuring reports
  • configuring help desk
  • creating workflows

Developer Guide

The Developer Guide is for developers who write applications that programmatically interact with Smile, such as applications that:

  • integrate Smile into your existing enterprise architecture
  • provision customers
  • support business-to-business (B2B) and machine-to-machine (M2M) transactions
  • create quotes and add prepaid blocks for prepaid and self-serve wireless hotspots

Smile 6 Migration Guide

This guide is for Smile users and administrators making the transition from Smile 5.4 to Smile 6.0. This guide helps you navigate the new Smile interface, to locate existing Smile components and become familiar with new Smile functionality.

Quick Reference Guides

Quick reference guides provide an overview of the elements required to configure warnings, alerts and other processes in Smile. You may need to refer to the User Guide or the Configuration Guide to configure the individual elements involved.

Charges in Smile

This document provides an overview of Smile, a summary of the sources of charges that can be configured and examples of how charges can be applied.

Credit Card Expiry Warning

This document provides an overview of the Smile configuration necessary to issue a warning to a customer when their credit card is due to expire. Typically Smile is configured to send an email advising the customer of the impending expiry and asking them to provide the details of their replacement card.

Credit Control

This document provides an overview of the Smile configuration necessary to establish a credit control process to methodically communicate with customers to ensure the collection of accounts receivable. Credit control in Smile specifies one or more sets of accounting terms, treatment levels and actions triggered as the account's unpaid debts age.

Payment Declined Alerts

This document provides an overview of the Smile configuration necessary to establish an alert when payments are declined.

Reconciliation Report

This document provides an overview of the Smile configuration necessary to reconcile the payments it has recorded with your payment gateway(s). It will ensure that payments recorded in Smile and other payment handlers match. If errors or mis-matches are identified Smile will report a reconciliation failure, which can be investigated.

Usage Alerts for Data Services

This document provides an overview of the Smile configuration necessary to establish usage alerts. These alerts are emailed to customers of data services with alert messages according to their level of usage.

Smile SNMP MIB

This document describes how to use the Smile SNMP MIB.

This guide is to assist network management operators to use standard SNMP tools to monitor the status of Smile. The Smile Management Information Base (MIB) enables the monitoring and management of a Smile instance. SNMP can monitor:

  • Smile's internal radius server (not Federadius)
  • basic operating system statistics
  • CDR summary statistics, broken down by service, NAS, importer (not all importers are supported)
  • Smile version information

Flow Control SNMP MIB

This document describes how to use the Flow Control SNMP MIB.

This guide is to assist network management operators to use standard SNMP tools to monitor the status of Flow Control. The Flow Control MIB enables monitoring of software-related issues that may need administrative attention.

Format Guides

CDR Import Format

This document describes how to configure a Comma Separated Values (CSV) file to import billable events for subscriptions into Smile.

Closed User Group Import Format

This document describes how to configure a Comma Separated Values (CSV) file to add closed user group members into existing closed user group(s).

Custom Field Import Format

This document describes how to configure a Comma Separated Values (CSV) file to add, update and remove custom fields.

Note: Whilst there are many places where Smile uses custom fields, this importer is only used for account and subscription custom fields.

Flexible Charge Import Format

This document describes how to configure a Smile flexible importer to process a Comma Separated Values (CSV) charge import file.

The flexible charge importer provides a means for importing invoice line items into Smile from an external system and assigning them to particular accounts. The flexible charge importer uses JExpr to express how Smile should handle an imported CSV column.

Flexible CSV CDR Import Format

This document describes how to configure a Smile flexible importer to process a Comma Separated Values (CSV) CDR import file.

The flexible CSV CDR importer is a method of importing CSV CDR files into Smile without requiring a custom importer for the task. The flexible importer provides the ability to inform Smile what it should do with each column of a CSV - where in Smile the column is mapped, how to parse or convert the field information. The flexible importer uses JExpr to express how Smile should handle an imported CSV column.

Flexible Rate Card Import Format

This document describes how to configure a Smile flexible rate card importer to process a Comma Separated Values (CSV) rate card import file.

The flexible rate card importer provides a means for importing an entire rate card, including prefixes, tariffs and destinations into Smile, via a CSV file. Any prefixes, tariffs or destinations that do not already exist will be created. The flexible rate card importer uses JExpr to express how Smile should handle an imported CSV column.

Manual Import Export Format

This document describes how to configure Smile to export the details of payments processed through a Manual payment gateway into a Comma Separated Values (CSV), and import another CSV file with the results of the payments.

Payment Import Format

This document describes how to configure a Comma Separated Values (CSV) file with the results of externally initiated payments. These are payments not generated by Smile.

Rated CDR Import Format

This document describes how to configure a Comma Separated Values (CSV) file to import rated call records (RCRs) for our customers into Smile.

An RCR is a Call Detail Record (CDR) to which rating has been applied. In some circumstances, a CDR may be rated multiple times, in which case multiple RCRs will be provided to a customer over time. If a CDR is re-rated, then the total amount charged for the call is the sum of all RCRs issued.

Standard Charge Import Format

This document describes how to configure a Comma Separated Values (CSV) file to import invoice line items into Smile from an external system and assign them to particular accounts.

Unrated CDR Import Format

This document describes how to configure a Comma Separated Values (CSV) file to import unrated usage records (UURs) to end-users. The UUR is intended to provide an easy method with which customers can reconcile calls and adjustments against their own records.