To know before to be connected... 2 FTP2SMS XML format to send File level 1 ( ftp2sms.mt) Ack response XML ( ftp2sms.

Transcription

1 FTP2SMS

2 FTP2SMS Content To know before to be connected... 2 FTP2SMS XML format to send File level 1 ( ftp2sms.mt) Ack response XML ( ftp2sms.dc)

3 TO KNOW BEFORE TO BE CONNECTED ecommunication FTP2SMS service allows integrators to send SMS of more than 160 characters. More than 160 c. means more SMS credits used! What type of account? Prepaid credits: SMS no priority with variable Sender Id. Acknowledgement level 1. Concatenate SMS (more than 160 characters per SMS), SMS reply service only for messages sent out of Belgium. Prepaid credits: SMS low priority with fix Sender ID (short code). Acknowledgement level 1. Concatenate SMS (more than 160 characters per SMS), SMS reply service only for messages sent in Belgium. Pospaid credits: SMS high priority with fix Sender ID (short code). Acknowledgement level 3. Concatenate SMS (more than 160 characters per SMS), SMS reply service only for messages sent in Belgium. Prepaid credits: Voice Call and/or fax. SMS reply service : That feature allows to an SMS s recipient to answer a received message if the sender ID of the used account allows it. All the requests can be in http or https mode. Send your message over FTP The XML must be sent on a communicated FTP link with a required login and password communicated also by Inforius. The FTP tree is like this: XML deposit: URL\FTP2SMS\ID client For ( ftp2sms.mt) and ( ftp2sms.dc): URL\FTP2SMS\ Notification\ID client Client Dashboard can be used to manage the client account: 2

4 FTP2SMS XML type of request to deposit on the FTP2SMS server of INFORIUS Your FTP space is read only. 1.1 XML FORMAT TO SEND <?xml version="1.0" encoding="utf-8"?> <Messages> <Version>V1</Version> <Login>Your Login</Login> <Password>Your password</password> <PartnerId></PartnerId> <Message> <GSMNR>+324xxxxxxxx</GSMNR> <ShortCodeId></ShortCodeId> <OriginatorAddress></OriginatorAddress> <MsgTitle></MsgTitle> <MsgContent>your content</msgcontent> <MsgType>T</MsgType> <TimeToSend> T16:03:00</TimeToSend> <TimeToLive></TimeToLive> <CustomerReference>xxxxxxxxxxxx-yyyyyyyyyyyy</CustomerReference> </Message> </Messages> 3

5 <GSMNR>+324xxxxxxxx</GSMNR> = International format <MsgContent>your content</msgcontent> = can be more than 160 characters <TimeToSend> T16:03:00</TimeToSend> = can be NULL for immediate sending or with a postpone date and time. 1.2 File level 1 ( FTP2SMS.MT) Accepted or Error (see table page 6) <?xml version="1.0" encoding="utf-16"?> <ERRS> <ERR> <CustomerReference> xxxxxxxxxxxx-yyyyyyyyyyyy </CustomerReference> <Code>None</Code> <Reason>Accepted</Reason> <Level>1</Level> </ERR> </ERRS> 4

6 1.3 ACK RESPONSE XML ( FTP2SMS.DC) <?xml version="1.0" encoding="utf-16"?> <DCS> <DC> <CustomerReference> xxxxxxxxxxxx-yyyyyyyyyyyy </CustomerReference> <GSMNR> </GSMNR> <Level>3</Level> <Code>0</Code> <TimeStamp> T16:04: :00</TimeStamp> </DC> </DCS> 5

7 CODE REASON 1 Sent 2 Queued 3 Out of credit 4 Invalid target country 5 NULL 6 NULL 7 General error 8 NULL 9 NULL 10 NULL 11 NULL 12 NULL 13 NULL 1001 Recipient subscriber blocked 1002 No previous message originated 1003 Recipient subscriber number is invalid 1004 No mobile operator defined in the number 1005 Invalid GSM service request by SMS 1006 No reverse billing allowed on this number 4001 Message can't be delivered because recipient absent 4002 Delivery no possible 4003 Unknown recipient 4004 Recipient deactivated 4005 Mob. Op. SMSc fatal technical problem 4006 Recipient subscriber blocked by Mob. Op. 0 Message received by recipient E1 Internal error E3 Invalid Logon or password E2 No Logon or password E4 No GSMNR No recipient mobile number E5 Invalid GSMNR Invalid recipient mobile number E6 Message length is more than accepted number of characters E7 Date for sending is before date (today) E8 Hour is in the past Time for sending is before time (now) E9 Invalid datetime format E10 Not enough SMS credit to execute SMS job 6

8 E11 Batch fails to create message in the queue E12 Message syntax is not correct -1 Send Error -2 Not enough credits -3 Nework not covered -4 Socket exception -5 Invalid user or password -6 Missing destination address -7 Missing sms text -8 Missing sender name -9 Invalid destination address format -10 Missing username -11 Missing password -13 Invalid destination addresss NOT_SENT Not sent SENT Sent NOT_DELIVERED Not delivered DELIVERED Delivered NOT_ALLOWED Not allowed INVALID_DESTINATION_ADDRESS NULL INVALID_SOURCE_ADDRESS NULL ROUTE_NOT_AVAILABLE NULL NOT_ENOUGH_CREDITS NULL INVALID_MESSAGE_FORMAT NULL 7