SOAP API - checkStatus
string checkStatus(string messageId)
Descriere:
Metoda este folosita pentru a urmari stadiul de livrare al unui SMS programat.
Parametri:
messageId – identificatorul unic al mesajului rezultat din apelul cu succes al uneia dintre metodele send.
Rezultat:
0. Nou
Mesajul nu a fost inca prelucrat in vederea trimiterii catre operator.
1. Livrat la operator
Mesajul a fot trimis de WEB2SMS si preluat de catre operatorul GSM. Operatorul nu a confirmat inca daca respectivul SMS a fost livrat catre client.
2. Livrat la client
SMS a fost livrat cu succes catre client
3. Eroare temporara
(ex: destinatarul are telefonul inchis). Se va reincerca trasmiterea lui catre destinatar. In cazul in care a fost specificata o valabilitate la programarea mesajului nu se va mai incerca transmiterea lui dupa expirarea acesteia. Daca nu se va specifica o valabilitate transmiterea lui se va incerca in functie de algoritumul de retry al operatorului / destinataului.
4. Respins
Mesajul a fost respins de catre operator. Numarul introdus este incorect (nu a fost configurat de catre operatori), sau pur si simplu, nu mai exista (a fost dezactivat).
In cazul in care acel numar aflat candva in status respins, urmeaza sa fie reactivat, este foarte posibil sa fie vorba de alt client. (perioada dupa care un numar inactiv se poate reactiva si intra din nou in circuitul comerical, este de 6 luni de zile).
5-6. Eroare permanenta
Destinatarul are telefonul inchis / probleme cu telefonul mobil / nu se afla in aria de acoperire, iar mesajul nu a putut fi preluat in status-ul eroare temporara.
Mesajul nu a fost livrat in termenul maxim de reincercari specific fiecarui operator (maxim un interval de 4 zile calendaristice), cel mai probabil clientul se afla in afara retelei, are telefonul inchis sau numarul respectiv nu mai este activ (a fost portat recent).
8. Respins SMSC MessageCarrier
- Acest status este rar intalnit fiind generat in general de faptul ca anumite range-uri de numere isi modifica reteaua de care apartin sau sunt retrase din folosire.
- Astfel, in cazul acesta este posibil ca eroarea sa fi fost generata de faptul ca anumite range-uri de numere de la operatorul Zapp au fost preluate de operatorul Cosmote iar aceasta informatie nu a fost propagata la toti messageCarrier pe care ii folosim.
- Eroarea nu este una a sistemului web2sms.ro ci una care rezulta din faptul ca in acest moment aceasta operatie de migrare/renuntare are loc intre Zapp si Cosmote.
13. Anulat
- Acest status reprezinta anularea SMS-urilor la nivelul aplicatiei web2sms si mutarea lor la SMSC-ul COSMOTE.
- Este o situatie punctuala care urmeaza a se solutiona imediat ce toate aspectele legate de mutarea range-urilor de numere de la Zapp la Cosmote se va fi terminat cu succes iar modificarile se vor fi propagat.
- Toate SMS-urile regasite in aceste status-uri nu se factureaza.
14. Verifica portabilitate
Status-ul de livrare - Verificare portabilitate, acesta actioneaza mai mult ca un flag, flow-ul fiind urmatorul:
- Se trimite un mesaj catre web2sms.
- web2sms receptioneaza mesajul si il livreaza catre operator.
- Mesajul nu este livrat pentru ca numarul este portat. In acest caz mesajul primeste status 14.
- web2sms va updata reteaua de care apartine numarul de telefon si va retrimite mesajul.
- Mesajul respectiv nu este taxat si in schimb este retrimis automat catre operatorul de telefonie mobila curent, identificat, in urma portabilitatii.
Astfel, in raportul detaliat pentru un numar la care aveti status-ul "Verificare portabilitate" (netaxabil) se va regasi inca un mesaj avand status-ul de livrare final (taxabil).
16. Numar incorect (sau conexiunea prin care se incearca trimiterea mesajului nu a fost configurata la nivelul contului web2sms)
Daca metoda esueaza serviciul web va intoarce un SOAP Fault. Codurile de eroare si mesajele aferente sunt prezentate in tabelul de mai jos:
Cod (zecimal) Cod (hexa) Mesaj
268435472 0x10000010 Parameter `messageId` has an invalid format
268435473 0x10000011 Specified `messageId` can not be found