Especificaciones Integracin SMS para Clientes

XML sobre HTTP

INTRODUCCIN
El objetivo del presente documento es especificar las posibilidades para lograr la interconexin
entre los sistemas de los clientes corporativos.
Esta interconexin tiene dos modalidades bsicas, el intercambio de archivos o un nico post
para envo masivo de SMS (bulk); y una serie de posts HTTP para intercambio de mensajes
individuales, como se describe a continuacin.
Operador
Celular

VPN

Gateway
SMS
Multicarrier

XML

smpp
HTTP

WS
EmpresaCliente

La plataforma de servicios de Telefnica es de naturaleza asncrona (store and forward). Todos

los servicios que se trafican desde carriers o hacia carriers son almacenados y luego despachados
hacia sus clientes.
Por cada accin solicitada por un cliente de un carrier la plataforma de Telefnica genera un
identificador de transaccin nico (IdTran) asociado a esa transaccin. El objetivo de ese IdTran
es garantizar que los servicios dados a los clientes correspondan con las limitaciones legales /
operativas impuestas por los distintos carriers a Telefnica.
Estas limitaciones se reflejan en los servicios expuestos a los socios externos por medio del
IdTran nico. Esto en ambos protocolos de integracin.
Para lo que son transacciones interactivas la relacin de los MOs con los MTs debe ser en relacin
uno es a dos a lo ms (1 MO por 2 MTs). Esta relacin se cambiara en caso de que un carrier lo
requiera y en los tiempos que el carrier exija que se realice el cambio a Telefnica.
La tendencia en los operadores es tener una relacin 1 MO por 1 MT, el integrador debe tener
esto presente.

Pgina 1 de 6

PROTOCOLO XML sobre HTTP

El protocolo XML sobre HTTP trabaja usando los servicios de Internet. A continuacin se describen
los casos posibles presentes en este escenario.
La implementacin se basa en el uso de HTTP/XML y es totalmente asincrnico.

SMS MO
REQUEST:
Recibido un MO que debe ser reenviado al "Integrador Externo" el GW Telefnica enviar por
HTTP la siguiente informacin:

<?xml version="1.0"?>
<MORequest>
<Servicio Id=string/>
<Telefonomsisdn=string IdTran=number/>
<Contenido>Text</Contenido>
</MORequest>

Pgina 2 de 6

Donde:
Servicio ID:
Es el servicio y carrier desde donde se origin el mensaje. Este servicio deber ser devuelto en la
transaccin MT tal cual se enva.
Telfono MSISDN:
Telfono del usuario.
Telfono IdTran :
Id de transaccin, generado por Telefnica y utilizado para mantener identificadas las cadenas de
eventos generadas por este MO, numrico.
Contenido :
Contenido del SMS MO, mensaje enviado por un usuario desde su telfono celular.

Ejemplo :
<?xmlversion="1.0"?>
<MORequest>
<Servicio Id=20500.personal.ar/>
<Telefonomsisdn=1129292929IdTran=12345678/>
<Contenido>Quiero conocer el saldo de mi producto 2944</Contenido>
</MORequest>
RESPONSE:
A este request el servidor del "Integrador Externo" deber responder con un cdigo 200 HTTP.
Cualquier otra respuesta ser considerada errnea y, si el servicio contempla una notificacin de
error, se le enviar un MT al usuario con un texto como Servicio no disponible por el momento.

SMS MT
REQUEST:
Para el envo de MT desde el servidor del "Integrador Externo" a un usuario, el "Integrador
Externo" har el siguiente request HTTP con contenido XML:

<?xmlversion="1.0" encoding="ISO-8859-1"?>
<MTRequest>
<Proveedor Id=EMOBILE Password=ps29292/>
<Servicio Id=20500.movistar.ar ContentType=0/>
<Telefonomsisdn=1138945612 IdTran=12345678/>
<Contenido>Elpassword es: 78dgydfgd6</Contenido>
Pgina 3 de 6

</MTRequest>
Donde:
Proveedor ID:
Nombre de identificacin del proveedor. Provisto por Telefnica
Proveedor Password:
Password del proveedor. Provisto por Telefnica
Servicio ID:
Cdigo de identificacin del servicio y carrier. El MT es una o varias respuestas al MO-SMS de
entrada, el campo servicio deber corresponder en forma exacta con este.
Servicio ContentType:
Descriptor del tipo de contenido en el mensaje.
Los mensajes podrn consistir en texto plano, ringtones monofnicos, logo de operador, Wap
Push, otros.
El mensaje de tipo binario (Content Type=1) a enviar se deber pasar en codificacin
hexadecimal.
Content Type

Descripcin

Texto plano

Binario, formateado en hexadecimal

Enviar como WapPush

EnvaWapPush usando PPG

Telefnica solo convierte el binario formateado a hexadecimal solo al momento de enviar para el
caso de los Content Type=1.
Telfono / MSISDN:
Telfono al que se le enviar el mensaje. Este telfono debe corresponder al telfono que gener
el MO, no se deben agregar formatos de numeracin o quitar ceros o modificar el nmero en
forma alguna respecto al envo del MO.
Telfono IdTran:
IdTran del MO que origina este MT , obligatorio. Este identificador debe ser enviado y es la
caracterstica que limita el trfico entre los clientes y los integradores externos. La cantidad de
MTs que se pueden enviar en funcin de un MO generado es por defecto dos (2) en la plataforma.
Contenido:
Mensaje a enviar para la comunicacin.
RESPONSE:

Pgina 4 de 6

La respuesta de Telefnicaante un MTRequest seria:

<MTResponse>
<Transaccion estado=number IdTran=number Fecha=datetime/>
<Texto>string</Texto>
</MTResponse>
Donde Cdigo y Texto son cdigos de respuesta segn la tabla siguiente.
Cdigo Estado

Texto Estado

Ok

Usuario/Password Invlida

XML Invlido

Otro, ver texto en transaccin

Ejemplo:

<MTResponse>
<Transaccion estado=0IdTran=12345678Fecha=2005-02-01 20:40:30/>
<Texto>OK : Transaccion Exitosa</Texto>
</MTResponse>

Pgina 5 de 6

Ejemplo en Unix para enviar un MT-SMS va un POST XML usando Curl:

'<MTRequest>
<Proveedor Id="IdPartner" Password="UsrPassword"/>
<Servicio Id="5050.movistar.ar" ContentType="0"/>
<Telefonomsisdn="117272727" IdTran="39"/>
<Contenido>Test de Envio de Texto Plano</Contenido>
</MTRequest>
'
En este ejemplo se ve el programa curl de unix enviando un MT-SMS va un POST XML a la
URL_PARTNER que es asignada por Telefnica y al puerto 80, que tambin es asignado por
Telefnica. El IdPartner, el UsrPassword, el PORT TCP y el URL_PARTNER son asignados por
Telefnica.
Ntese que el formato de envo debe respetar el MO-SMS recibido va XML, en cuando al Serviciod
Id , Telfono MSISDN y el IdTran , esos valores vienen en el MO-SMS entregado en el XML al
partner y deben ser devueltos tal cual a la plataforma de Telefnica para su adecuado Ruteo.

Preguntas Frecuentes
P. Por qu hace falta una direccin URL para conectarse tanto en Movilgate como en
elCliente para la mensajera?
R. Porque el protocolo es asncrono, y los mensajes de tipo MTRequest y MORequest son
independientes entre si. Movilgate debe comunicarse con el cliente para enviar elMORequest, y
luego de procesar el mensaje, el cliente debe conectarse a Movilgate
P. Envo un mensaje a la URL de Movilgate y la respuesta no es de transaccin exitosa.
El XML est bien formado. Qu sucede?
R.Revise los headers de la transaccin, estos tienen informacin acerca de los erroresdetectados.
Para todos los otros casos extraordinarios no enmarcados en este documento se debe tratar con
la Gerencia Comercial.

Pgina 6 de 6