Elige tu API

API HTTP-XML: confirmación de entrega de SMS

sdk-httpxml-a

1. Descripción

Mediante esta interfaz podrás obtener un informe detallado del histórico de mensajes enviados desde tu cuenta. Para ello debes enviar tus datos de autenticación y los parámetros de búsqueda de informes.

2. Documentación

URL:

http://www.descomsms.com/servlet/dmapi.servlet.Servlet

Petición de envío

Para poder recibir el informe de los reports, deberán de acceder al URL arriba indicada proporcionando la siguiente información en formato POST:

Definición de trama de autentificación

Parámetros POST:

Nombre	Descripción
xml	Trama XML con los datos de autentificación y acciones a realizar

Estructura básica XML de petición:

Etiqueta Raiz: <TXEnvio>

Esta etiqueta debe envolver todos los datos XML de la llamada.

<TXEnvio> Tus datos.... </TXEnvio>

Trama completa de petición de Report:

<TXEnvio>
 <Autentificacion>
    <Usuario>login usuario</Usuario>
    <Passwd>contraseña de usuario </Passwd>
    <Idcli>código de cliente</Idcli>
    <Remitente>texto remitente</Remitente>
</Autentificacion>
<Reportget  accion=”GETM”>
     <idreport>id de report</idreport>
     <periodo>periodo de tiempo a buscar </periodo>
     <fini>dd/mm/yyyy</fini>
     <ffin>dd/mm/yyyy</ffin>
     <nfilas>limte de filas a obtener</nfilas>
     <ndesde>punto desde donde obtener registros, comenzando en 1</ndesde>
     <orden>asc, desc</orden>
     <busqueda>
          <bidsend></bidsend>
          <bnombre></bnombre>
          <bmovil></bmovil>
          <blista></blista>
          <btexto></btexto>
          <bestado></bestado>
      </busqueda>
</Reportget>
</TXEnvio>

Definición de trama de autentificación:

Deberás pasar en primer lugar el nodo de autentificación, donde figurarán sus credenciales en Descom SMS

<Autentificacion>
    <Usuario>login usuario</Usuario>
    <Passwd>contraseña de usuario </Passwd>
    <Idcli>código de cliente</Idcli>
    <Remitente>texto remitente</Remitente>
</Autentificacion>

Donde:

Nombre Parámetro	Descripción	Posibles Valores	Tipo de Dato
Usuario	Identificador de Usuario en Descom SMS	Nombre de usuario	Alfanumérico en Hexadecimal
Passwd	Contraseña de acceso	Contraseña	Alfanumérico en Hexadecimal
IdCli	Identificador de Cliente en Descom SMS	Identificador	Numérico

Definición de trama de parámetros de Acciones

<Reportget  accion=”GETM”>
     <idreport>id de report</idreport>
     <periodo>periodo de tiempo a buscar </periodo>
     <fini>dd/mm/yyyy</fini>
     <ffin>dd/mm/yyyy</ffin>
     <nfilas>limte de filas a obtener</nfilas>
     <ndesde>punto desde donde obtener registros, comenzando en 1</ndesde>
     <orden>asc, desc</orden>
  <busqueda>
          <bidsend></bidsend>
          <bnombre></bnombre>
          <bmovil></bmovil>
          <blista></blista>
          <btexto></btexto>
          <bestado></bestado>
      </busqueda>
</Reportget>

Tipos de informes en parámetro “acción”:

GETM, Obtener mensajes por report y fecha

El elemento <Reportget> contiene :

Nombre Parámetro	Descripción	Posibles Valores	Tipo de Dato
idreport	Código numerico de report a obtener		Numérico
periodo	Periodo del cual obtener los datos	D -> Día actual S -> Semana actual M -> Mes actual T -> Todo Si se deja en blanco se obtiene todo
fini	Fecha de inicio de búsqueda	Fecha en formato: dd/mm/yyyy
ffin	Fecha de fin de búsqueda	Fecha en formato: dd/mm/yyyy
nfilas	Límite de filas a obtener, máximo 100 por petición	1..100	Numérico
ndesde	Punto desde donde obtener registros, comenzando en 1		Numérico
orden	Ordenación de registros según fecha	Asc -> en modo ascendente Desc -> en modo descendente

El elemento <busqueda> contiene :

Nombre Parámetro	Descripción	Posibles Valores	Tipo de Dato
bidsend	Identificador del mensaje a buscar		Numérico
bnombre	Parte o todo el nombre de contacto a buscar		Hexadecimal
bmovil	Parte o todo el número de móvil a buscar		Numérico
blista	Código de grupo a los que pertenecen los contactos a buscar		Numérico
btexto	Parte del mensaje a buscar.		Hexadecimal
bestado	Estado de los mensajes a buscar	0 -> Sin información de envío todavía. 1 -> Enviado, sin confirmación de entrega 2 -> Entregado, con confirmación de entrega a operador o a móvil 3 -> Rechazado o información no disponible.

Respuesta de envío.

Estructura básica XML de respuesta:

Etiqueta Raiz: <RXEnvio>

Esta etiqueta envuelve todos los datos XML del resultado.

<RXEnvio> Tus datos.... </RXEnvio>

Todas las peticiones serán respondidas con un documento XML, conteniendo la siguiente estructura.

Trama completa de respuesta de Report:

<RXEnvio>
 <Autentificacion>
    <Usuario>8865736572303038</Usuario>
    <Resultado>1</Resultado>
    <Comentario>Autentificacion satisfactoria.</Comentario>
 </Autentificacion>
<MENSAJELIST periodo="" fini="" ffin="" ntotal="1497" nfilas="50" ndesde="1">
    <MENSAJE>
        <nm>1</nm>
        <fecha_enviado>22/06/2009 13:41:52</fecha_enviado>
        <idsend>10216527</idsend>
        <idreport>28957</idreport>
        <movil>0034660371432</movil>
        <htexto>4e415a404e617a6172656573206d616e646120756e2066616d696c6961722e</htexto>
        <nmens>1</nmens>
        <hremitente>3633334hf3431</hremitente>
        <hcname>4d236726527a 0527562e96e206cf37065</hcname>
       <hcapellidos/>
       <estado>ENTREGADO</estado>
       <estadocod/>
       <estadohdesc>456e7472656761646f20612044657374696e61746172696f</estadohdesc>
       <fecha_entregado>22/06/2009 13:41:57</fecha_entregado>
      <fecha_confirmado>22/06/2009 13:42:02</fecha_confirmado>
</MENSAJE>
……………................
<MENSAJELIST>
</RXENVIO>

Definición de trama de autentificación :

En primer lugar recibirás el resultado de tu autentificación Descom SMS.

Nombre Parámetro	Descripción	Posibles Valores	Tipo de Dato
Usuario	Identificador de Usuario en Descom SMS	Nombre de usuario	Alfanumérico en Hexadecimal
Resultado	Resultado de la autentificación en Descom SMS	1-> autentificación correcta 0->Fallo en la autentificación	Numérico
Comentario	Texto descriptivo del resultado de la autentificación		Alfanumérico

Definición de trama de Mensajes:

El elemento <MENSAJELIST> contiene como atributos :

Nombre Parámetro	Descripción	Posibles Valores	Tipo de Dato
fini	Fecha de inicio de la búsqueda	Fecha en formato: dd/mm/yyyy	Fecha
ffin	Fecha de fin de la búsqueda	Fecha en formato: dd/mm/yyyy	Fecha
ntotal	Total de mensajes encontrados en la búsqueda		Numérico
nfilas	Registros MENSAJE mostrados en la trama devuelta		Numérico
ndesde	A partir de qué mensaje se está mostrando en la trama devuelta		Numérico

Por cada mensaje encontrado <MENSAJE>

Nombre Parámetro	Descripción	Posibles Valores	Tipo de Dato
nm	Número de registro del total encontrados, comenzando desde 1		Numérico
fecha_enviado	Fecha de envío del mensaje	Fecha en formato: dd/mm/yyyy hh:mm:ss	Fecha
idsend	Identificador numérico del mensaje enviado. Este es el identificador proporcionado por Descom SMS para poder usarlo a posteriori a la hora de obtener información acerca de este mensaje.		Numérico
idreport	Identificador numérico del envío. Este es el identificador proporcionado por Descom SMS para poder usarlo a posteriori a la hora de obtener información acerca de este envío.		Numérico
movil	Número de móvil en formato internacional al que se ha enviado el mensaje		Numérico
htexto	Texto del mensaje enviado		Hexadecimal
nmens	Número de SMS empleados para enviar este mensaje		Numérico
hremitente	Texto del remitente enviado		Hexadecimal
hcname	Nombre del contacto		Hexadecimal
hcapellidos	Apellidos del contacto		Hexadecimal
estado	Estado actual del mensaje	0 : Sin información, información de envío no disponible todavía o mensaje pendiente de enviar. 1: Enviado, el mensaje ha sido enviado con éxito hacia el destinatario. En este estado el mensaje puede haber sido entregado aunque no hayamos recibido notificación de entrega. 2 : Entregado, el mensaje ha sido entregado en el destinatario o en el operador. Entregado a Destinatario: El mensaje ha sido entregado en el móvil y hemos recibido confirmación de entrega. Enviado a Operador: El mensaje ha sido entregado con éxito en el operador, la no recepción de la notificación de entrega a Destinatario no indica que no se haya entregado el mensaje. La no recepción de notificación no indica que no se haya entregado el mensaje. 3: Rechazado, ha ocurrido un error entregando el SMS en el destinatario.	Numérico
estadocod	Código de estado si procede, para más información remita este código a Descom		Numérico
estadohdesc	Texto con los detalles del estado del mensaje		Hexadecimal
fecha_entregado	Fecha y hora en el que el SMS ha sido entregado al operador - Tiempo transcurrido entre el envío y la entrega	Fecha en formato: dd/mm/yyy hh:mm:ss	Fecha
fecha_confirmado	Fecha y hora de recepción de la confirmación de entrega. Esta confirmación es suministrada opcionalmente por el operador de telefonía - Tiempo transcurrido desde que el mensaje es entregado hasta que se recibe la confirmación de entrega del operador.	Fecha en formato: dd/mm/yyy hh:mm:ss	Fecha

3. Ejemplos

Descarga nuestros ejemplos o accede a una demo online: demo online PHP, descargar ejemplos en PHP.

4. Gráfico

Report-SMS

Soporte Técnico:

Esta dirección de correo electrónico está protegida contra spambots. Usted necesita tener Javascript activado para poder verla.

Ahora puedes enviar también los mensajes SMS con Outlook, de forma fácil y segura.

Nagios

Recibe las alertas por SMS, integrando el envío de mensajes en las notificaciones de Nagios.
[más info]


Descom.es	Hosting	SMS	Backup
Centro de Datos	Hosting sin Límites	Enviar SMS	Backup Remoto Online
Virtualización	Hosting a Medida	Recibir SMS	Server Backup, Backup de FUTURO
Cloud Computing	Email	Aplicaciones con SMS	Data Backup
	Dominios	SDK SMS	Restauración: Cloud Server