SMPP TON and NPI Reference

API Interface: SMPP API Version 3.4

TON (Type of Number)

The Type of Number (TON) setting is used to tell both your EMSE the format of the addressing (bind addressing) that will be processed for inbound messages as well as tell the Aerialink network (source and destination addressing) how it should be processed for submits. There are three separate pairs of TON and NPI values; receiving addressing, source addressing, and destination addressing. These definitions are derived from the ETSI GSM 03.40 specification, which defines the SMS protocol. The SMPP specification defines the following TON values:

If you wish to specific a special value for the TON, the available options are:

  • 0: Unknown
  • 1: International
  • 2: National
  • 3: Network Specific
  • 4: Subscriber Number
  • 5: Alphanumeric
  • 6: Abbreviated

Aerialink does not generally require specific TON values from your bind to our network. We store specific values as defaults for your routes, connections, and communication assets (Short Code, Long Code, Alphanumeric Code). See TON and NPI defaults below.

NPI (Numbering Plan Identification)

The Numbering Plan Identification setting is used to tell both your EMSE the numbering plan associated with your messaging. The SMPP specification defines the following TON values:

If you wish to specific a special value for the NPI, the available options are:

  • Unknown = 0
  • ISDN/telephone numbering plan (E163/E164) = 1
  • Data numbering plan (X.121) = 3
  • Telex numbering plan (F.69) = 4
  • Land Mobile (E.212) =6
  • National numbering plan = 8
  • Private numbering plan = 9
  • ERMES numbering plan (ETSI DE/PS 3 01-3) = 10
  • Internet (IP) = 13
  • WAP Client Id (to be defined by WAP Forum) = 18

TON and NPI Defaults

Aerialink will generally default both your TON and NPI to the values they should be to insure your messages are delivered properly. If you have special reasons for controlling these settings on your side, please contact the Aerialink Support Team. The default values used by Aerialink are as follows:

Short Code (3 digits to 8 digits in length)

If the source code/address is a Short Code

  • TON = 3
  • NPI = 0

Long Code (10 digits to 15 digits in length, excludes the plus sign)

If the source code/address is a Long Code the recommended settings and default settings that Aerialink will use are:

  • TON = 1
  • NPI = 1

Alphanumeric

If the source code/address is Alphanumeric (contains both letters and numbers or only letters)

  • TON = 5
  • NPI = 0

SMPP Official Specification

For details on the SMPP Specification, see SMPP 3.4 Official Specification.

Troubleshooting

If you are having trouble authenticating with the Aerialink API confirm that you have white listed your IP address and that your API credentials are correct. You can view the API Authentication Error Log under Reports in the APi section of the Platform portal. This will confirm whether your authentication requests are being rejected or not.

Support

If you require any additional assistance, please use one of these methods to contact the Aerialink Support Team.

This page was last updated 1515185923000