Petición de informe de Reports mediante interfaz HTTP

Mediante esta interfaz podrá obtener un informe detallado del histórico de reports 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 Reports
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=”GETR”>
         <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>
</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.
                <bnombre>          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>               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 Reports 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

<REPORTLIST periodo="" fini="" ffin="" ntotal="23" nfilas="23" ndesde="1">
<REPORT>
         <nr>1</nr>
         <fecha_envio>22/06/2009 13:41:51</fecha_envio>
         <idreport>28957</idreport>
         <estado>FINALIZADO</estado>
         <idenvio>28957-C747F022D</idenvio>
         <total_mensajes>84</total_mensajes>
         <total_contactos>84</total_contactos>
         <total_creditos>84.0</total_creditos>
         <app>DMW</app>
         <htexto> 4e415a4152454e4f530a4c6c656e6172207475206669636861206465204e617a </htexto>
         <hremitente>65h65f65f121</hremitente>
         <informe>0</informe>
         <sin_confirmacion>1</sin_confirmacion>
         <confirmados>74</confirmados>
         <errores>9</errores>
         <sin_informacion>0</sin_informacion>
</REPORT>
…………
…………
<REPORT>
</REPORT>
</REPORTLIST>
</RXENVIO>

El elemento <REPORTLIST> 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 reports encontrados en la búsqueda
nfilas                  - Registros REPORT mostrados en la trama devuelta
ndesde               - A partir de qué report se está mostrando en la trama devuelta

<REPORT>      - Registros por cada report encontrado en la búsqueda
El elemento <REPORT> contiene :
<nr>                                 - Número de registro del total encontrados, comenzando desde 1
<fecha_envio>              - Fecha de envío del report
<idreport>                      - Código de identificación del report
<estado>                        - Estado actual del Report
                                         PENDIENTE
                                         ENVIANDO
                                         FINALIZADO
                                         SIN SALDO
                                         PROGRAMADO ENVIANDO
                                         PROGRAMADO FINALIZADO

<idenvio>                       Código interno del envío
<total_mensajes>         Total de mensajes del report
<total_contactos>        Total de contactos del report
<total_creditos>            Total de crédito del report
<app>                             Nombre de aplicación de envío
<htexto>                         Texto en formato hexadecimal del texto enviado
<hremitente>                 Texto en formato hexadecimal del remitente enviado
<informe>                      0 -> No se ha solicitado informe de entrega de cada mensaje
                                         1 -> Sí se ha solicitado informe de entrega de cada mensaje

<sin_confirmacion>     Total de mensajes enviados correctamente de los que no se ha recibido todavía notificación de entrega
<confirmados>             Total de mensajes enviados correctamente de los que se ha recibido notificación de entrega a operador o móvil
<errores>                        Total de mensajes enviados correctamente de los que hemos recibido notificación de rechazo o error de entrega
<sin_informacion>       Total de mensajes sin información de envío disponible todavía o mensajes pendiente de enviar