Especificacin de Acceso a Servicios Web

Url de Acceso
El servicio web de ENERCA SA ESP para el descargue de informacin de Tickets es
htp://tcketsws.enerca.com.co/WebServices/WSTicketNotfcaton.asmx
El Servicio Web estar restringido a un determinado Rango de IPs una vez termine el
periodo de pruebas y estabilizacin

Servicios Disponibles
NotfyOnAssigned
o Descripcion: Servicio para notfcar la asignacin de un Movil a un Ticket
o Parametros
tcketId (string)
Codigo del Ticket enviado por ENERCA SA ESP
movilId (string)
Numero o Codigo del Movil al cual se les asign la actvidad
commments (string)
Cualquier otra informacin que se considere pertnente para
la documentacin del tcket
o Retorno
Result (string), texto en XML con la siguiente estructura
<Respuestas>
<Respuesta>
<Id></Id>
<Resultado></Resultado>
<Mensaje></Mensaje>
</Respuesta>
</Respuestas>

Id, retorna un numero consecutvo nico que identfca la
transaccin
Resultado, las palabras OK o BAD indicando el estado de la
Operacin
Mensaje, Mensaje entregado por el servicio Web para
motvos de depuracion

NotfyInProgress
o Descripcion: Servicio para notfcar el inicio de la Operacin o tarea
o Parametros
tcketId (string)
Codigo del Ticket enviado por ENERCA SA ESP
movilId (string)
Numero o Codigo del Movil al cual se les asign la actvidad
Datetme (DateTime), fecha en la cual se inici la actvidad
commments (string)
Cualquier otra informacin que se considere pertnente para
la documentacin del tcket
o Retorno
Result (string), texto en XML con la siguiente estructura
<Respuestas>
<Respuesta>
<Id></Id>
<Resultado></Resultado>
<Mensaje></Mensaje>
</Respuesta>
</Respuestas>

Id, retorna un numero consecutvo nico que identfca la
transaccin
Resultado, las palabras OK o BAD indicando el estado de la
Operacin
Mensaje, Mensaje entregado por el servicio Web para
motvos de depuracion


NotfyOnCompleted
o Descripcion: Servicio para notfcar la fnalizacin de la Operacin o tarea
o Parametros
tcketId (string)
Codigo del Ticket enviado por ENERCA SA ESP
opDescripton
Descripcin General de la actvidad realizada
OpType (Numero en Formato String)
Tipo de Operacin
o 1 - Pendiente
o 2 - Programado
o 3 - Reprogramado
o 4 - Cancelado
o 5 - Cumplido
operatonsXML
Texto XML en el siguiente Formato
<Operaciones>
<Operacion>
<Id></Id>
<Cantidad></Cantidad>
<Descripcion></Descripcion>
</Operacion>
</Operaciones>

Un ejemplo del texto es el siguiente
<Operaciones>
<Operacion>
<Id>30</Id>
<Cantidad>2</Cantidad>
<Descripcion>Se instalo</Descripcion>
</Operacion>
<Operacion>
<Id>31</Id>
<Cantidad>4</Cantidad>
<Descripcion>Se instalo</Descripcion>
</Operacion>
</Operaciones>
El Id equivale al cdigo de la tabla Operaciones entregada,
Cantdad a la cantdad de veces que se hizo la tarea y
descripcin a un resumen de la actvidad

o Retorno
Result (string), texto en XML con la siguiente estructura
<Respuestas>
<Respuesta>
<Id></Id>
<Resultado></Resultado>
<Mensaje></Mensaje>
</Respuesta>
</Respuestas>

Id, retorna un numero consecutvo nico que identfca la
transaccin
Resultado, las palabras OK o BAD indicando el estado de la
Operacin
Mensaje, Mensaje entregado por el servicio Web para
motvos de depuracin

NotfyOnMaterialsReport
o Descripcion: Servicio para notfcar el descargue de los materiales
o Parametros
tcketId (string)
Codigo del Ticket enviado por ENERCA SA ESP
materialsXML
Texto XML en el siguiente formato
<Materiales>
<Material>
<Id></Id>
<CantidadEnerca></CantidadEnerca>
<CantidadCenercol></CantidadCenercol>
</Material>
</Materiales>

Un ejemplo del texto es el siguiente
<Materiales>
<Material>
<Id>1</Id>
<CantidadEnerca>2</CantidadEnerca>
<CantidadCenercol>3</CantidadCenercol>
</Material>
<Material>
<Id>90</Id>
<CantidadEnerca>1</CantidadEnerca>
<CantidadCenercol>6</CantidadCenercol>
</Material>
<Material>
<Id>80</Id>
<CantidadEnerca>30</CantidadEnerca>
<CantidadCenercol>3</CantidadCenercol>
</Material>
</Materiales>
El ID equivale al cdigo (Int) que se tene e la tabla
Materiales

o Retorno
Result (string), texto en XML con la siguiente estructura
<Respuestas>
<Respuesta>
<Id></Id>
<Resultado></Resultado>
<Mensaje></Mensaje>
</Respuesta>
</Respuestas>

Id, retorna un numero consecutvo nico que identfca la
transaccin
Resultado, las palabras OK o BAD indicando el estado de la
Operacin
Mensaje, Mensaje entregado por el servicio Web para
motvos de depuracin