Acceso Area de ClienteArea Cliente LLamanos al 965 861 024965 861 024

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 PHPdescargar ejemplos en PHP.

4. Gráfico

Report-SMS

Soporte Técnico:

ic-email Esta dirección de correo electrónico está siendo protegida contra los robots de spam. Necesita tener JavaScript habilitado para poder verlo.

Nagios

Nagios

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