Petición de informe de Mensajes enviados mediante interfaz HTTP

Mediante esta interfaz podrá obtener un informe detallado del histórico de mensajes enviandos desde su cuenta. Para ello debe enviar sus datos de autenticación y los parámetros de búsqueda de informes.

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

Petición de informe de Mensajes
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:

Parámetros POST:
xml: Trama XML de petición de búsqueda de reports

Definición de trama de autentificación

<TXEnvio>
<Autentificacion>
         <Usuario>login usuario</Usuario>
         <Passwd>contraseña de usuario </Passwd>
         <Idcli>código de cliente</Idcli>
</Autentificacion>
………

El elemento <Autentificacion> contiene :
<usuario>        - Login  del usuario en formato hexadecimal
<passwd>       - Password del usuario en formato hexadecimal
<idcli>               - Código numérico de Cliente al que pertenece el usuario

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>
</TXEnvio>

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

• GETR, get reports por fecha
• GETM, get mensajes por report y fecha

El elemento <Reportget> contiene :
<idreport>             código numerico de report a obtener
<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 en formato dd/mm/yyyy
<ffin>                    Fecha de fin de búsqueda en formato dd/mm/yyyy
<nfilas>                 limite de filas a obtener, máximo 100 por petición
<ndesde>              punto desde donde obtener registros, comenzando en 1
<orden>                 Ordenación de regitros según fecha
         Asc -> en modo ascendente
         Desc -> en modo descendente
<busqueda>         Sólo válido para la búsqueda de mensajes.
                <bidsend>            Identificador del mensaje a buscar
                <bnombre>          En Hexadecimal, parte o todo el nombre de contacto a buscar
                <bmovil>              parte o todo el número de móvil a buscar
                <blista>                 código de lista a los que pertenecen los contactos a buscar
                <btexto>               En Hexadecimal, parte del mensaje a buscar.
                <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.
</busqueda>

Definición de Trama de Respuesta de Mensajes enviados:

<RXEnvio>
<Autentificacion>
         <Usuario>8865736572303038</Usuario>
         <Resultado>1</Resultado>
         <Comentario>Autentificacion satisfactoria.</Comentario>
</Autentificacion>

El elemento <Autentificacion> contiene :
<Usuario>         - Login  del usuario en formato hexadecimal
<Resultado>     - resultado de la autenticación:
                            1 -> autenticación correcta
                            0 -> fallo de autenticación
<Comentario>  comentario del resultado de la autenticación

<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>
……………..
……………..
<MENSAJE>
</MENSAJE>
<MENSAJELIST>
</RXEnvio>

El elemento <MENSAJELIST> contiene :
Parámetros:
periodo              - periodo solicitado de la búsqueda
fini                      - Fecha de inicio de la búsqueda en formato dd/mm/yyyy
ffin                     - Fecha de fin de la búsqueda en formato dd/mm/yyyy
ntotal                 - Total de Mensajes encontrados en la búsqueda
nfilas                  - Registros MENSAJES mostrados en la trama devuelta
ndesde               - A partir de qué mensaje se está mostrando en la trama devuelta

<MENSAJE>    - Registros por cada mensaje encontrado en la búsqueda
El elemento <MENSAJE> contiene :
<nm>                              - Número de registro del total encontrados, comenzando desde 1
<fecha_enviado>         - Fecha del mensaje enviado
<idsend>                         - Identificador numérico del mensaje enviado
<idreport>                      - Identificador numérico del report al que pertenece el mensaje
<movil>                          - número de móvil en formato internacional al que se ha enviado el mensaje
<htexto>                         - Texto en formato hexadecimal del mensaje enviado
<nmens>                        - Número de SMS enviados para enviar este mensaje
<hremitente>                 - Texto del remitente enviado en formato hexadecimal
<hcname>                      - Nombre del contacto en formato hexadecimal
<hcapellidos>               - Apellidos del contacto en formato 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 a Red, 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.
                                         Si desea más detalles consulte con Descom Mensajes.

<estadocod>                - Código de estado si procede, para más información remita este código a Descom
<estadohdesc>              - Texto en formato hexadecimal con los detalles del estado del mensaje
<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_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.