Interface description
Scope
This document explains valid BIND operations and specifies the combinations of TON and NPI settings that can be used
with Spirius SMPP interface. It also specifies the SMPP error codes given from Spirius in response to the
query_sm-command. In the response a message state will be given along with the error code. Available message states
are not specific to Spirius but specified in
the SMPP Protocol Specification v3.4 issue 1.2, section 5.2.28.
SMPP modes of operation
Valid bind combinations
The Bind operation may be viewed as a form of SMSC login request to authenticate the client wishing to establish a connection. A client to Spirius SMPP interface may bind as either transmitter, receiver or transceiver.
Valid BIND combinations for a client to Spirius SMPP interface are:
- Bind 1 Receiver
- Bind 1 Transmitter
- Bind both 1 Receiver and 1 Transmitter
- Bind 1 Transceiver (duplex mode)
A Spirius account holder can simultaneously bind maximum one receiver and one transmitter. A transceiver will be counted as one of each. Attempting to bind e.g. a transmitter and a transceiver from the same account will result in both sessions being disconnected.
Please refer to section 4 of the SMPP 3.4 specification for further information.
Type Of Number (TON) and Number Plan Indicator (NPI) settings
SMPP 3.4 specification in section 5.2.5 and 5.2.6 defines 7 different Type of Number (TON) and 10 different Number Plan Indicator (NPI) settings, but only the ones that are realistic to use for SMS services are supported by Spirius SMPP interface.
Below is the list different TON and NPI implemented by Spirius SMPP interface:
| Value | TON |
|---|---|
0 |
Unknown |
1 |
International |
2 |
National |
3 |
Network Specific |
5 |
Alphanumeric |
| Value | NPI |
|---|---|
0 |
Unknown |
1 |
ISDN (E163/E164) |
2 |
Accepted, No Error |
The combinations that are valid to use with Spirius SMPP component in combination with source address for the submit_sm command are:
| TON | NPI | Expected result |
|---|---|---|
0 - Unknown |
0 - Unknown |
Defined by the receiving SMSC |
1 - International |
1 - ISDN (E163/E164) |
Accepted, No Error |
2 - National |
1 - ISDN (E163/E164) |
Accepted, No Error |
3 - Network Specific |
0 - Unknown |
Accepted, No Error |
5 - Alphanumeric |
0 - Unknown |
Accepted, No Error |
The combinations that are valid to use with Spirius SMPP component in combination with destination address for the submit_sm command are:
| TON | NPI | Expected result |
|---|---|---|
0 - Unknown |
0 - Unknown |
Defined by the receiving SMSC |
1 - International |
1 - ISDN (E163/E164) |
Accepted, No Error |
2 - National |
1 - ISDN (E163/E164) |
Accepted, No Error |
Other combinations will result in one of the error-codes defined in the SMPP specification.
SMPP error codes
Mobile terminated messages
| Error | Code | Location Description |
|---|---|---|
0 |
Unknown | Unknown |
1 |
No location | No Error |
100 |
HLR | Pending |
101 |
HLR | System Failure |
102 |
HLR | Data Missing |
103 |
HLR | Unexpected Data Value |
104 |
HLR | Facility Not Supported |
105 |
HLR | Unknown Subscriber |
106 |
HLR | Teleservice Not Provisioned |
107 |
HLR | Call Barred |
108 |
HLR | Absent Subscriber |
199 |
HLR | Unknown |
198 |
HLR | Timeout |
200 |
MSC | Pending |
201 |
MSC | Subscriber Busy For MT-SMS |
202 |
MSC | Unidentified Subscriber |
203 |
MSC | Illegal Subscriber |
204 |
MSC | Illegal Equipment |
205 |
MSC | System Failure |
206 |
MSC | Data Missing |
207 |
MSC | Unexpected Data Value |
208 |
MSC | Facility Not Supported |
209 |
MSC | Message Waiting List Full |
210 |
MSC | SM Delivery Failure |
211 |
MSC | Absent Subscriber SM |
298 |
MSC | Timeout |
299 |
MSC | Unknown |
300 |
GMSC | Pending |
301 |
GMSC | Error |
302 |
GMSC | Expired |
304 |
GMSC | Queued |
305 |
GMSC | Waiting For Timeout |
398 |
GMSC | Timeout |
399 |
GMSC | Unknown |