FTP2SMS - mysms

Transcription

FTP2SMS - mysms
FTP2SMS
Parc Scientifique Créalys
Rue Camille Hubert, 15
B-5032 LES ISNES (GEMBLOUX)
+32 81 74 43 40
With Cloud Communication Solution (C.C.S)
Version : 1.0 February 2013
FTP2SMS
Content
To know before to be connected ................................................................................................... 2
FTP2SMS ......................................................................................................................................... 3
1.1
XML format to send ........................................................................................................ 3
1.2
File level 1 (ftp2sms.mt) ................................................................................................. 4
1.3
Ack response XML (ftp2sms.dc) ...................................................................................... 5
www.inforius.eu
Mail: [email protected]
Appréciez votre solution SMS
1
®Tous droits de reproduction et de représentation sont réservés et sont la propriété exclusive d’INFORIUS SPRL, en ce compris les
documents téléchargeables.
Parc Scientifique Créalys
Rue Camille Hubert, 15
B-5032 LES ISNES (GEMBLOUX)
+32 81 74 43 40
With Cloud Communication Solution (C.C.S)
Version : 1.0 February 2013
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: HTTPS://ECOM.INFORIUS.BE
www.inforius.eu
Mail: [email protected]
Appréciez votre solution SMS
2
®Tous droits de reproduction et de représentation sont réservés et sont la propriété exclusive d’INFORIUS SPRL, en ce compris les
documents téléchargeables.
Parc Scientifique Créalys
Rue Camille Hubert, 15
B-5032 LES ISNES (GEMBLOUX)
+32 81 74 43 40
With Cloud Communication Solution (C.C.S)
Version : 1.0 February 2013
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>2012-12-05T16:03:00</TimeToSend>
<TimeToLive></TimeToLive>
<CustomerReference>xxxxxxxxxxxx-yyyyyyyyyyyy</CustomerReference>
</Message>
</Messages>
www.inforius.eu
Mail: [email protected]
Appréciez votre solution SMS
3
®Tous droits de reproduction et de représentation sont réservés et sont la propriété exclusive d’INFORIUS SPRL, en ce compris les
documents téléchargeables.
Parc Scientifique Créalys
Rue Camille Hubert, 15
B-5032 LES ISNES (GEMBLOUX)
+32 81 74 43 40
With Cloud Communication Solution (C.C.S)
Version : 1.0 February 2013
<GSMNR>+324xxxxxxxx</GSMNR> = International format
<MsgContent>your content</MsgContent> = can be more than 160 characters
<TimeToSend>2012-12-05T16: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>
www.inforius.eu
Mail: [email protected]
Appréciez votre solution SMS
4
®Tous droits de reproduction et de représentation sont réservés et sont la propriété exclusive d’INFORIUS SPRL, en ce compris les
documents téléchargeables.
Parc Scientifique Créalys
Rue Camille Hubert, 15
B-5032 LES ISNES (GEMBLOUX)
+32 81 74 43 40
With Cloud Communication Solution (C.C.S)
Version : 1.0 February 2013
1.3 ACK RESPONSE XML (FTP2SMS.DC)
<?xml version="1.0" encoding="utf-16"?>
<DCS>
<DC>
<CustomerReference> xxxxxxxxxxxx-yyyyyyyyyyyy </CustomerReference>
<GSMNR>+32488914599</GSMNR>
<Level>3</Level>
<Code>0</Code>
<TimeStamp>2012-12-05T16:04:17.2488278+01:00</TimeStamp>
</DC>
</DCS>
www.inforius.eu
Mail: [email protected]
Appréciez votre solution SMS
5
®Tous droits de reproduction et de représentation sont réservés et sont la propriété exclusive d’INFORIUS SPRL, en ce compris les
documents téléchargeables.
Parc Scientifique Créalys
Rue Camille Hubert, 15
B-5032 LES ISNES (GEMBLOUX)
+32 81 74 43 40
With Cloud Communication Solution (C.C.S)
CODE
Version : 1.0 February 2013
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
www.inforius.eu
Mail: [email protected]
Appréciez votre solution SMS
6
®Tous droits de reproduction et de représentation sont réservés et sont la propriété exclusive d’INFORIUS SPRL, en ce compris les
documents téléchargeables.
Parc Scientifique Créalys
Rue Camille Hubert, 15
B-5032 LES ISNES (GEMBLOUX)
+32 81 74 43 40
With Cloud Communication Solution (C.C.S)
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
SENT
NOT_DELIVERED
DELIVERED
NOT_ALLOWED
Version : 1.0 February 2013
Not sent
Sent
Not delivered
Delivered
Not allowed
INVALID_DESTINATION_ADDRESS NULL
INVALID_SOURCE_ADDRESS
NULL
ROUTE_NOT_AVAILABLE
NULL
NOT_ENOUGH_CREDITS
NULL
INVALID_MESSAGE_FORMAT
NULL
www.inforius.eu
Mail: [email protected]
Appréciez votre solution SMS
7
®Tous droits de reproduction et de représentation sont réservés et sont la propriété exclusive d’INFORIUS SPRL, en ce compris les
documents téléchargeables.