Elige tu API

API HTTP-XML: confirmacion de entrega de envíos realizados

sdk-httpxml-a

1. Descripción

Mediante esta interfaz podrás obtener un informe detallado del histórico de reports 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

Petición de informe de Reports

URL:
https://www.descomsms.com/AP/dmapi.servlet.Servlet

Petición de envío

Para poder recibir el informe de los reports, deberás 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=”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>

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=”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>

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

GETR, obtener reports por 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

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>
<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>
.................................
</REPORTLIST>
</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 Reports:

El elemento <REPORTLIST> contiene como atributos :

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

Por cada report encontrado <REPORT>

Nombre Parámetro	Descripción	Posibles Valores	Tipo de Dato
nr	Número de registro del total encontrados, comenzando desde 1		Numérico
fecha_envio	Fecha de envío del report	Fecha en formato: dd/mm/yyyy hh:mm:ss	Fecha
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
estado	Estado actual del Report	PENDIENTE ENVIANDO FINALIZADO SIN SALDO PROGRAMADO ENVIANDO PROGRAMADO FINALIZADO
idenvio	Identificador externo del envío. El identificador que pasas cuando realizas el envío o que se genera automáticamente.		AlfaNumérico
total_mensajes	Total de mensajes del report		Numérico
total_contactos	Total de contactos del report		Numérico
total_creditos	Total de crédito del report
app	Nombre de aplicación de envío		AlfaNumérico
htexto	Texto en formato hexadecimal del texto enviado		Hexadecimal
hremitente	Texto en formato hexadecimal del remitente enviado		Hexadecimal
informe	Solicitud de iforme de entrega	0 -> No se ha solicitado informe 1 -> Sí se ha solicitado informe	Numérico
sin_confirmacion	Total de mensajes enviados correctamente de los que no se ha recibido todavía notificación de entrega		Numérico
confirmados	Total de mensajes enviados correctamente de los que se ha recibido notificación de entrega a operador o móvil		Numérico
errores	Total de mensajes enviados correctamente de los que hemos recibido notificación de rechazo o error de entrega		Numérico
sin_informacion	Total de mensajes sin información de envío disponible todavía o mensajes pendiente de enviar		Numérico

3. Ejemplos

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

4. Gráfico

Report-Envio

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