Observaciones Web Service

Electrodunas chatbot

STARTER
2021

1
 ÍNDICE

ÍNDICE 2

Resumen 3
Estandarización 3
Cambios 3
Observaciones 4
Pendientes 4

OBSERVACIÓN DEL CERTIFICADO SSL 5

DEFINICIÓN DE LOS WEBSERVICES 6

5.2 SERVICIO WEB “MontoVencimientoUltRecibo” 8
5.3 SERVICIO WEB “FechaCorte” 10
5.7 SERVICIO WEB “ValidarEventoRed” 12
5.8 SERVICIO WEB “ValidarEstadoNIS” 13
5.9 SERVICIO WEB “ValidarSolicitudNuevoNIS” 15
5.10 SERVICIO WEB “ValidarConsumoEnergiaNIS” 17
5.11 SERVICIO WEB “ValidarCantidadDeudaMesesNIS” 19
5.14 SERVICIO WEB “DescargarPDF” 21
5.15 SERVICIO WEB “VerLecturas” 24
5.16 SERVICIO WEB “DatosBasicosNIS” 25

Pág 2
 1. RESUMEN

Estandarización
Se recomienda que los siguientes servicios:

● 5.1 SERVICIO WEB “ValidarNroSumnistro”

● 5.2 SERVICIO WEB “MontoVencimientoUltRecibo”
● 5.3 SERVICIO WEB “FechaCorte”
● 5.7 SERVICIO WEB “ValidarEventoRed”
● 5.8 SERVICIO WEB “ValidarEstadoNIS”
● 5.9 SERVICIO WEB “ValidarSolicitudNuevoNIS”
● 5.10 SERVICIO WEB “ValidarConsumoEnergiaNIS”
● 5.11 SERVICIO WEB “ValidarCantidadDeudaMesesNIS”

Mantengan la misma estructura en la respuesta que dan:

Nombre Tipo Longitud Valores Descripción

terminoBien Entero 1 0o1 Flag que indica que la consulta fue
satisfactoria o no.
err_msg Cadena 250 cadena de texto Mensaje que emite el método cuando hubo
alfanumérico un error interno en la consulta.
mensaje Cadena 250 cadena de texto Mensaje que emite el método cuando se ha
alfanumérico retornado una respuesta exitosa.

*Los ejemplos se detalla en la sección “Definición de los webservices”

Además se recomienda que los siguientes servicios:

● 5.14 SERVICIO WEB “DescargarPDF”

● 5.15 SERVICIO WEB “VerLecturas”

Mantenga esta estructura en su respuesta:

Nombre Tipo Longitud Valores Descripción

terminoBien Entero 1 0o1 Flag que indica que la consulta fue
satisfactoria o no.
err_msg Cadena 250 cadena de texto Mensaje que emite el método cuando hubo
alfanumérico un error interno en la consulta.
ruta Cadena 250 cadena de texto Url que emite el método cuando se ha
alfanumérico retornado una respuesta exitosa.

*Los ejemplos se detalla en la sección “Definición de los webservices”

Pág 3
Cambios

● 5.7 en validar “eventoRED” recomendamos que “idSupply” pueda ser cambiado a

NIS para el cuerpo de la solicitud

Observaciones
● Los servicios 5.4 “ValidarPotencialFise”, 5.5 “ValidarAgenteFise” y 5.6
“ValidarAgenteFise” no se están incluyendo en esta versión del chatBot

● 5.14 el servicio “DescargarPDF” no trae rutas, intentamos con el NIS del ejemplo y
los de prueba. Tampoco nos trae información usando Fiddler.

● 5.16 el servicio “DatosBasicosNIS” nos devuelve los datos que faltan como “null”,
recomendamos que nos lo envíen como cadena de texto vacía ya que esta
información va a ser vista por los usuarios.

Ejemplo de la respuesta actual del servicio

Pág 4
Pendientes
● Quedan pendientes las credenciales de acceso.
● 5.12 Registro de Avisos en SGD / sigue pendiente ya que es depende de un tercero.
● 5.13 Enviar email / pendiente de corrección.

Pág 5
2. OBSERVACIÓN DEL CERTIFICADO SSL
Al momento de hacer una solicitud a los web services , esta responde un error SSL : “Unable to verify
the first certificate” que podría deberse a la falta de una de las configuraciones del certificado
intermedio de los web services.

Esta observación ocurre en todo los web services usados para el consumo desde el chatBot

WEB SERVICE DE PRUEBA:

WEB SERVICE ValidarNroSumnistro

API https://aplicacionesdev.electrodunas.com/ChatBotWeb/api/Cha
tBot/ValidarNroSuministro

Datos de Pruebas "NIS":"101002607"

Respuesta de la Prueba:

Posible Causa :

Pág 6
Referencia: https://qastack.mx/programming/31673587/error-unable-to-verify-the-first-certificate-in-nodejs

Pág 7
 3. DEFINICIÓN DE LOS WEBSERVICES

5.1 SERVICIO WEB “ValidarNroSumnistro”

Descripción Funcional:

Permite realizar la consulta del Número del Suministro de un Cliente, en función de los parámetros de entrada

Estructura de los Datos de Entrada:

Se enviará una estructura de datos en formato JSON con un solo atributo. Este atributo tiene el nombre NIS y
sus características se detallan a continuación:

Nombre: NIS
Descripción Número de Suministro que es el identificador del Cliente en el Sistema
Comercial
Tipo Cadena de texto
Longitud 9 caracteres
Valores Sólo contiene caracteres numéricos

Estructura de los Datos de Salida:

Se enviará una estructura de datos en formato JSON con los siguientes atributos: terminoBien, err_msg,
mensaje. Estos atributos y sus características se detallan a continuación:

Nombre Tipo Longitud Valores Descripción

terminoBien Entero 1 0o1 Flag que indica que la consulta fue
satisfactoria o no.
err_msg Cadena 250 cadena de texto Mensaje que emite el método cuando hubo
alfanumérico un error interno en la consulta.
mensaje Cadena 250 cadena de texto Mensaje que emite el método cuando se ha
alfanumérico retornado una respuesta exitosa.

Punto de Enlace para el Esquema del Servicio:

Ruta https://aplicacionesdev.electrodunas.com/ChatBotWeb/
Método POST
Llamada del Método https://aplicacionesdev.electrodunas.com/ChatBotWeb/api/ChatBot/ValidarNroSuministro
Cabecera User-Agent: Fiddler
Content-type: application/json; charset=utf-8
Host: aplicacionesdev.electrodunas.com
Content-Length: 25
Dato de Pruebas "NIS": "101002607"

Ejemplo de solicitud:

{
"NIS": "101002607"
}

Pág 8
Ejemplo de Resultado de la Ejecución

Recomendamos esta nueva estructura

{
"terminoBien": 1,
"err_msg": "",
"mensaje": "El NIS es válido"
}

{
"terminoBien": 0,
"err_msg": "El NIS no está registrado en el sistema",
"mensaje": ""
}

{
“terminoBien”: 0,
“err_msg”: "Hubo un error interno en el sistema",
“mensaje”: ""
}

Pág 9
5.2 SERVICIO WEB “MontoVencimientoUltRecibo”

Descripción Funcional:

Permite realizar la consulta del monto y vencimiento del último recibo del Suministro de un Cliente, en función
de los parámetros de entrada

Estructura de los Datos de Entrada:

Se enviará una estructura de datos en formato JSON con un solo atributo. Este atributo tiene el nombre NIS y
sus características se detallan a continuación:

Nombre: NIS
Descripción Número de Suministro que es el identificador del Cliente en el Sistema
Comercial
Tipo Cadena de texto
Longitud 9 caracteres
Valores Sólo contiene caracteres numéricos

Estructura de los Datos de Salida:

Se enviará una estructura de datos en formato JSON con los siguientes atributos: terminoBien, err_msg,
mensaje. Estos atributos y sus características se detallan a continuación:

Nombre Tipo Longitud Valores Descripción

terminoBien Entero 1 0o1 Flag que indica que la consulta fue
satisfactoria o no.
err_msg Cadena 250 cadena de texto Mensaje que emite el método cuando hubo
alfanumérico un error interno en la consulta.
mensaje Cadena 250 cadena de texto Mensaje que emite el método cuando se ha
alfanumérico retornado una respuesta exitosa.

Punto de Enlace para el Esquema del Servicio:

Ruta https://aplicacionesdev.electrodunas.com/ChatBotWeb/
Método POST
Llamada del Método https://aplicacionesdev.electrodunas.com/ChatBotWeb/api/ChatBot/MontoVencimientoUltRecibo

Cabecera User-Agent: Fiddler

Content-type: application/json; charset=utf-8
Host: aplicacionesdev.electrodunas.com
Content-Length: 25
Dato de Pruebas "NIS":"101002607"

Ejemplo de solicitud:

Pág 10
 {
"NIS": "101002607"
}
Actualmente nos el servicio da esta respuesta

Resultado:

Recomendamos esta nueva estructura

{
"terminoBien": 1,
"err_msg": "",
"mensaje": "el saldo actual de tu recibo 32166744 es S/40.20 con fecha de vencimiento 06/08/21"
}

{
"terminoBien": 0,
"err_msg": "Su recibo está pendiente de emisión",
"mensaje": ""
}

{
“terminoBien”: 0,
“err_msg”: "Hubo un error interno en el sistema",
“mensaje”: ""
}

Pág 11
5.3 SERVICIO WEB “FechaCorte”

Descripción Funcional:

Permite realizar la consulta de la fecha de corte aplicado al Suministro de un Cliente, en función de los
parámetros de entrada

Estructura de los Datos de Entrada:

Se enviará una estructura de datos en formato JSON con un solo atributo. Este atributo tiene el nombre NIS y
sus características se detallan a continuación:

Nombre: NIS
Descripción Número de Suministro que es el identificador del Cliente en el Sistema
Comercial
Tipo Cadena de texto
Longitud 9 caracteres
Valores Sólo contiene caracteres numéricos

Estructura de los Datos de Salida:

Se enviará una estructura de datos en formato JSON con los siguientes atributos: terminoBien, err_msg,
mensaje. Estos atributos y sus características se detallan a continuación:

Nombre Tipo Longitud Valores Descripción

terminoBien Entero 1 0o1 Flag que indica que la consulta fue
satisfactoria o no.
err_msg Cadena 250 cadena de texto Mensaje que emite el método cuando hubo
alfanumérico un error interno en la consulta.
mensaje Cadena 250 cadena de texto Mensaje que emite el método cuando se ha
alfanumérico retornado una respuesta exitosa.

Punto de Enlace para el Esquema del Servicio:

Ruta https://aplicacionesdev.electrodunas.com/ChatBotWeb/
Método POST
Llamada del Método https://aplicacionesdev.electrodunas.com/ChatBotWeb/api/ChatBot/FechaCorte

Cabecera User-Agent: Fiddler

Content-type: application/json; charset=utf-8
Host: aplicacionesdev.electrodunas.com
Content-Length: 25
Dato de Pruebas "NIS":"101002607"

Ejemplo de solicitud:

{
"NIS": "101002607"
}

Pág 12
Actualmente nos el servicio da esta respuesta

Resultado:

Recomendamos esta nueva estructura

{
"terminoBien": 1,
"err_msg": "",
"mensaje": "Estimado cliente su suministro N° 101002607 tiene fecha de corte: 09/06/21"
}

{
"terminoBien": 0,
"err_msg": "Estimado cliente su suministro aún no tiene fecha de corte. Gracias",
"mensaje": ""
}

{
"terminoBien": 0,
"err_msg": "Hubo un error interno en el sistema",
"mensaje": ""
}

Pág 13
5.7 SERVICIO WEB “ValidarEventoRed”

Descripción Funcional: Permite realizar la consulta y validación si un Suministro está comprendido dentro de
una Interrupción o Evento en la Red Eléctrica, en función de los parámetros de entrada

Estructura de los Datos de Entrada:

Se enviará una estructura de datos en formato JSON con un solo atributo. Este atributo tiene el nombre NIS y
sus características se detallan a continuación:

Nombre: NIS
Descripción Número de Suministro que es el identificador del Cliente en el Sistema
Comercial
Tipo Cadena de texto
Longitud 9 caracteres
Valores Sólo contiene caracteres numéricos

Estructura de los Datos de Salida:

Se enviará una estructura de datos en formato JSON con los siguientes atributos: terminoBien, err_msg,
mensaje. Estos atributos y sus características se detallan a continuación:

Nombre Tipo Longitud Valores Descripción

terminoBien Entero 1 0o1 Flag que indica que la consulta fue
satisfactoria o no.
err_msg Cadena 250 cadena de texto Mensaje que emite el método cuando hubo
alfanumérico un error interno en la consulta.
mensaje Cadena 250 cadena de texto Mensaje que emite el método cuando se ha
alfanumérico retornado una respuesta exitosa.

Punto de Enlace para el Esquema del Servicio:

Ruta https://aplicacionesdev.electrodunas.com/ChatBotWeb/
Método POST
Llamada del Método https://aplicacionesdev.electrodunas.com/ChatBotWeb/api/ChatBot/ValidarEventoRed

Cabecera User-Agent: Fiddler

Content-type: application/json; charset=utf-8
Host: aplicacionesdev.electrodunas.com
Content-Length: 25
Dato de Pruebas "idSupply":"401011270"

Ejemplo de solicitud:

{
"NIS": "401011270"
}

Actualmente nos el servicio da esta respuesta

Resultado : *idSupply debe ser cambiado a NIS para el cuerpo de la solicitud

Pág 14
Recomendamos esta nueva estructura

{
"terminoBien": 1,
"err_msg": "",
"mensaje": "Su suministro no cuenta con energía, por una Interrupción Imprevista, desde 18:51 hasta 22:31
ocasionado por Intervenci¢n en Suministro"
}

{
"terminoBien": 0,
"err_msg": "En estos momentos su suministro debe tener energía eléctrica. Gracias.",
"mensaje": ""
}

{
"terminoBien": 0,
"err_msg": "Hubo un error interno en el sistema",
"mensaje": ""
}

5.8 SERVICIO WEB “ValidarEstadoNIS”

Descripción Funcional: Permite realizar la consulta del Estado actual del Suministro en el Sistema Comercial, en
función de los parámetros de entrada

Estructura de los Datos de Entrada:

Se enviará una estructura de datos en formato JSON con un solo atributo. Este atributo tiene el nombre NIS y
sus características se detallan a continuación:

Pág 15
 Nombre: NIS
Descripción Número de Suministro que es el identificador del Cliente en el Sistema
Comercial
Tipo Cadena de texto
Longitud 9 caracteres
Valores Sólo contiene caracteres numéricos

Estructura de los Datos de Salida:

Se enviará una estructura de datos en formato JSON con los siguientes atributos: terminoBien, err_msg,
mensaje. Estos atributos y sus características se detallan a continuación:

Nombre Tipo Longitud Valores Descripción

terminoBien Entero 1 0o1 Flag que indica que la consulta fue
satisfactoria o no.
err_msg Cadena 250 cadena de texto Mensaje que emite el método cuando hubo
alfanumérico un error interno en la consulta.
mensaje Cadena 250 cadena de texto Mensaje que emite el método cuando se ha
alfanumérico retornado una respuesta exitosa.

Punto de Enlace para el Esquema del Servicio:

Ruta https://aplicacionesdev.electrodunas.com/ChatBotWeb/
Método POST
Llamada del Método https://aplicacionesdev.electrodunas.com/ChatBotWeb/api/ChatBot/ValidarEstadoNIS

Cabecera User-Agent: Fiddler

Content-type: application/json; charset=utf-8
Host: aplicacionesdev.electrodunas.com
Content-Length: 25
Dato de Pruebas "NIS":"101002607"

Ejemplo de solicitud:

{
"NIS": "101002607"
}

Actualmente nos el servicio da esta respuesta

Recomendamos esta nueva estructura

Pág 16
 {
"terminoBien": 1,
"err_msg": "",
"mensaje": "Estimado Cliente su Solicitud está siendo procesada y su Suministro N° 101002607 se
encuentra en el estado de: Suspendido por Impago"
}

{
"terminoBien": 0,
"err_msg": "Estimado Clientes Usted no tiene una Solicitud para procesar. Gracias.",
"mensaje": ""
}

{
"terminoBien": 0,
"err_msg": "Hubo un error interno en el sistema",
"mensaje": ""
}

5.9 SERVICIO WEB “ValidarSolicitudNuevoNIS”

Descripción Funcional: Permite realizar la consulta del Estado de la Solicitud de un Nuevo Suministro en el
Sistema Comercial realizada por un Cliente, en función de los parámetros de entrada

Estructura de los Datos de Entrada:

Se enviará una estructura de datos en formato JSON con un solo atributo. Este atributo tiene el nombre NIS y
sus características se detallan a continuación:

Nombre: NIS
Descripción Número de Suministro que es el identificador del Cliente en el Sistema
Comercial
Tipo Cadena de texto
Longitud 9 caracteres
Valores Sólo contiene caracteres numéricos

Estructura de los Datos de Salida:

Se enviará una estructura de datos en formato JSON con los siguientes atributos: terminoBien, err_msg,
mensaje. Estos atributos y sus características se detallan a continuación:

Pág 17
 Nombre Tipo Longitud Valores Descripción
terminoBien Entero 1 0o1 Flag que indica que la consulta fue
satisfactoria o no.
err_msg Cadena 250 cadena de texto Mensaje que emite el método cuando se ha
alfanumérico retornado una respuesta exitosa.
mensaje Cadena 250 cadena de texto Mensaje cuando el método cuando se ha
alfanumérico retornado una respuesta exitosa.

Punto de Enlace para el Esquema del Servicio:

Ruta https://aplicacionesdev.electrodunas.com/ChatBotWeb/
Método POST
Llamada del Método https://aplicacionesdev.electrodunas.com/ChatBotWeb/api/ChatBot/ValidarSolicitudNuevoNIS

Cabecera User-Agent: Fiddler

Content-type: application/json; charset=utf-8
Host: aplicacionesdev.electrodunas.com
Content-Length: 25
Dato de Pruebas "NIS":"101002607"

Ejemplo de solicitud:

{
"NIS": "101002607"
}

Actualmente nos el servicio da esta respuesta

Recomendamos esta nueva estructura

Pág 18
 "terminoBien": 1,
"err_msg": "",
"mensaje": "Estimado Cliente su Solicitud está siendo procesada y su Suministro N° 700086618 se
encuentra en el estado de: Pendiente de Conexión"
}

{
"terminoBien": 0,
"err_msg": "Estimado Clientes Usted no tiene una Solicitud de Nuevo Suministro. Gracias.",
"mensaje": ""
}

{
"terminoBien": 0,
"err_msg": "Hubo un error interno en el sistema",
"mensaje": ""
}

5.10 SERVICIO WEB “ValidarConsumoEnergiaNIS”

Descripción Funcional: Permite realizar la consulta del consumo de Energía de un Nuevo Suministro y la
respuesta dependerá de la Tarifa del Cliente en el Sistema Comercial, en función de los parámetros de entrada

Estructura de los Datos de Entrada:

Se enviará una estructura de datos en formato JSON con un solo atributo. Este atributo tiene el nombre NIS y
sus características se detallan a continuación:

Nombre: NIS
Descripción Número de Suministro que es el identificador del Cliente en el Sistema
Comercial
Tipo Cadena de texto
Longitud 9 caracteres
Valores Sólo contiene caracteres numéricos

Estructura de los Datos de Salida:

Se enviará una estructura de datos en formato JSON con los siguientes atributos: terminoBien, err_msg,
mensaje. Estos atributos y sus características se detallan a continuación:

Nombre Tipo Longitud Valores Descripción

terminoBien Entero 1 0o1 Flag que indica que la consulta fue
satisfactoria o no.
err_msg Cadena 250 cadena de texto Mensaje que emite el método cuando hubo
alfanumérico un error interno en la consulta.
mensaje Cadena 250 cadena de texto Mensaje que emite el método cuando se ha
alfanumérico retornado una respuesta exitosa.

Pág 19
Punto de Enlace para el Esquema del Servicio:

Ruta https://aplicacionesdev.electrodunas.com/ChatBotWeb/
Método POST
Llamada del Método https://aplicacionesdev.electrodunas.com/ChatBotWeb/api/ChatBot/ValidarConsumoEnergiaNIS

Cabecera User-Agent: Fiddler

Content-type: application/json; charset=utf-8
Host: aplicacionesdev.electrodunas.com
Content-Length: 25
Dato de Pruebas "NIS":"101002607"

Ejemplo de solicitud:

{
"NIS": "101002607"
}

Actualmente nos el servicio da esta respuesta

Resultado:

Recomendamos esta nueva estructura

{
"terminoBien": 1,
"err_msg": "",
"mensaje": "Estimado Cliente, el consumo en Kwh es 23 y el consumo en Soles es 40,2"
}

Pág 20
 "terminoBien": 0,
"err_msg": "Estimado Clientes Usted no tiene consumo en el presente mes. Gracias.",
"mensaje": ""
}

{
"terminoBien": 0,
"err_msg": "Hubo un error interno en el sistema",
"mensaje": ""
}

5.11 SERVICIO WEB “ValidarCantidadDeudaMesesNIS”

Descripción Funcional: Permite realizar la consulta de la deuda y cantidad de recibos que no paga por el
servicio de energía eléctrica de un Nuevo Suministro del Cliente en el Sistema Comercial, en función de los
parámetros de entrada

Estructura de los Datos de Entrada:

Se enviará una estructura de datos en formato JSON con un solo atributo. Este atributo tiene el nombre NIS y
sus características se detallan a continuación:

Nombre: NIS
Descripción Número de Suministro que es el identificador del Cliente en el Sistema
Comercial
Tipo Cadena de texto
Longitud 9 caracteres
Valores Sólo contiene caracteres numéricos

Estructura de los Datos de Salida:

Se enviará una estructura de datos en formato JSON con los siguientes atributos: terminoBien, err_msg,
mensaje. Estos atributos y sus características se detallan a continuación:

Nombre Tipo Longitud Valores Descripción

terminoBien Entero 1 0o1 Flag que indica que la consulta fue
satisfactoria o no.
err_msg Cadena 250 cadena de texto Mensaje que emite el método cuando hubo
alfanumérico un error interno en la consulta.
mensaje Cadena 250 cadena de texto Mensaje que emite el método cuando se ha
alfanumérico retornado una respuesta exitosa.

Punto de Enlace para el Esquema del Servicio:

Ruta https://aplicacionesdev.electrodunas.com/ChatBotWeb/
Método POST
Llamada del Método https://aplicacionesdev.electrodunas.com/ChatBotWeb/api/ChatBot/ValidarCantidadDeudaMesesNIS

Cabecera User-Agent: Fiddler

Content-type: application/json; charset=utf-8
Host: aplicacionesdev.electrodunas.com
Content-Length: 25
Dato de Pruebas "NIS":"101002607"
Ejemplo de solicitud:

Pág 21
 {
"NIS": "101002607"
}

Actualmente nos el servicio da esta respuesta

Recomendamos esta nueva estructura

{
"terminoBien": 1,
"err_msg": "",
"mensaje": "Estimado Cliente, el monto de su Deuda es de S/461.00 y la cantidad de meses que adeuda es
de 9 meses"
}

{
"terminoBien": 0,
"err_msg": "Estimado Clientes Usted no tiene deuda pendiente. Gracias.",
"mensaje": ""
}

{
"terminoBien": 0,
"err_msg": "Hubo un error interno en el sistema",
"mensaje": ""
}

Pág 22
5.14 SERVICIO WEB “DescargarPDF”

Descripción Funcional:
Permite obtener la ruta donde se encuentra el último recibo de un Cliente a través de los parámetros de
Entrada.

Estructura de los Datos de Entrada:

Se enviará una estructura de datos en formato JSON con un solo atributo. Este atributo tiene el nombre NIS y
sus características se detallan a continuación:

Nombre: NIS
Descripción Número de Suministro que es el identificador del Cliente en el Sistema
Comercial
Tipo Cadena de texto
Longitud 9 caracteres
Valores Sólo contiene caracteres numéricos

Estructura de los Datos de Salida:

Se enviará una estructura de datos en formato JSON con los siguientes atributos: terminoBien, err_msg, ruta.
Estos atributos y sus características se detallan a continuación:

Nombre Tipo Longitud Valores Descripción

terminoBien Entero 1 0o1 Flag que indica que la consulta fue
satisfactoria o no.
err_msg Cadena 250 cadena de texto Mensaje que emite el método cuando hubo
alfanumérico un error interno en la consulta.
ruta Cadena 250 cadena de texto Url que emite el método cuando se ha
alfanumérico retornado una respuesta exitosa.

Punto de Enlace para el Esquema del Servicio:

Ruta https://aplicacionesdev.electrodunas.com/ChatBotWeb/
Método POST
Llamada del Método https://aplicacionesdev.electrodunas.com/ChatBotWeb/api/ChatBot/DescargarPDF

Cabecera User-Agent: Fiddler

Content-type: application/json; charset=utf-8
Host: aplicacionesdev.electrodunas.com
Content-Length: 25
Dato de Pruebas "NIS":"101002767"

Ejemplo de solicitud:

{
"NIS": "101002607"
}

Actualmente nos el servicio da esta respuesta

** No nos devuelve algún mensaje correcto al momento de hacer las pruebas

Pág 23
Resultado:

Recomendamos esta nueva estructura

{
"terminoBien": 1,
"err_msg": "",
"ruta": "https://www.electrodunas.com/Recibos/101002767.pdf"
}

{
"terminoBien": 0,
"err_msg": "Usted aún no tiene recibos emitidos.",
"ruta": ""
}

{
"terminoBien": 0,
"err_msg": "Hubo un error interno en el sistema",
"ruta": ""
}

Pág 24
5.15 SERVICIO WEB “VerLecturas”

Descripción Funcional:
Permite obtener la ruta donde se encuentra la lectura actual y anterior de un Suministro a través de los
parámetros de Entrada.

Estructura de los Datos de Entrada:

Se enviará una estructura de datos en formato JSON con un solo atributo. Este atributo tiene el nombre NIS y
sus características se detallan a continuación:

Nombre: NIS
Descripción Número de Suministro que es el identificador del Cliente en el Sistema
Comercial
Tipo Cadena de texto
Longitud 9 caracteres
Valores Sólo contiene caracteres numéricos

Estructura de los Datos de Salida:

Se enviará una estructura de datos en formato JSON con los siguientes atributos: terminoBien, err_msg, ruta.
Estos atributos y sus características se detallan a continuación:

Nombre Tipo Longitud Valores Descripción

terminoBien Entero 1 0o1 Flag que indica que la consulta fue
satisfactoria o no.
err_msg Cadena 250 cadena de texto Mensaje que emite el método cuando hubo
alfanumérico un error interno en la consulta.
ruta Cadena 250 cadena de texto Url que emite el método cuando se ha
alfanumérico retornado una respuesta exitosa.

Punto de Enlace para el Esquema del Servicio:

Ruta https://aplicacionesdev.electrodunas.com/ChatBotWeb/
Método POST
Llamada del Método https://aplicacionesdev.electrodunas.com/ChatBotWeb/api/ChatBot/VerLecturas

Cabecera User-Agent: Fiddler

Content-type: application/json; charset=utf-8
Host: aplicacionesdev.electrodunas.com
Content-Length: 25
Dato de Pruebas "NIS":"101002767"

Ejemplo de solicitud:

{
"NIS": "101002607"
}

Actualmente nos el servicio da esta respuesta

Pág 25
Recomendamos esta nueva estructura

{
"terminoBien": 1,
"err_msg": "",
"ruta": "https://www.electrodunas.com/UltimasLecturas/10100276732153970.pdf"
}

{
"terminoBien": 0,
"err_msg": "Usted aún no tiene lecturas emitidas.",
"ruta": ""
}

{
"terminoBien": 0,
"err_msg": "Hubo un error interno en el sistema",
"ruta": ""
}

5.16 SERVICIO WEB “DatosBasicosNIS”

Descripción Funcional: Permite obtener los datos Básicos de un Cliente que tiene un Suministro a través de los
parámetros de Entrada.

Estructura de los Datos de Entrada:

Pág 26
Se enviará una estructura de datos en formato JSON con un solo atributo. Este atributo tiene el nombre NIS y
sus características se detallan a continuación:

Nombre: NIS
Descripción Número de Suministro que es el identificador del Cliente en el Sistema
Comercial
Tipo Cadena de texto
Longitud 9 caracteres
Valores Sólo contiene caracteres numéricos

Estructura de los Datos de Salida:

Adicional a los datos actuales,se enviará una estructura de datos en formato JSON con los siguientes atributos,
atributos y sus características que se detallan a continuación:

Datos de salida :

Nombre Tipo Valores

Nombres Cadena Nombres del Cliente que está registrado en el Sistema Comercial.
Apellido Paterno Cadena Apellido Paterno del Cliente que está registrado en el Sistema Comercial.
Apellido Materno Cadena Apellido Materno del Cliente que está registrado en el Sistema
Comercial.
Teléfono Cadena Teléfono del Cliente que está o no registrado en el Sistema Comercial.
Email Cadena Correo electrónico del Cliente que está o no registrado en el Sistema
Comercial.
Tipo Documento Cadena Tipo de Documento del Cliente que está o no registrado en el Sistema
Comercial.
Documento Cadena Documento del Cliente que está o no registrado en el Sistema Comercial.
FaltaDatoCell Entero Indicador de uno de los datos que queremos catastrar que tiene o no el
Cliente en el Sistema Comercial.
0 = No cuenta con el valor del Teléfono en el Sistema Comercial.
1 = Cuenta con el valor del Teléfono en el Sistema Comercial.
FaltaDatoEmail Entero Indicador de uno de los datos que queremos catastrar que tiene o no el
Cliente en el Sistema Comercial.
0 = No cuenta con el valor del Email en el Sistema Comercial.
1 = Cuenta con el valor del Email en el Sistema Comercial.
FaltaDatoTDoc Entero Indicador de uno de los datos que queremos catastrar que tiene o no el
Cliente en el Sistema Comercial.
0 = No cuenta con el valor del Tipo de Documento en el Sistema
Comercial.
1 = Cuenta con el valor del Tipo de Documento en el Sistema Comercial.
FaltaDatoDoc Entero Indicador de uno de los datos que queremos catastrar que tiene o no el
Cliente en el Sistema Comercial.
0 = No cuenta con el valor del Número de Documento en el Sistema
Comercial.
1 = Cuenta con el valor del Número de Documento en el Sistema
Comercial.
terminoBien Entero Flag que indica que la consulta fue satisfactoria o no
err_msg Cadena Mensaje que emite el método cuando se ha retornado una respuesta
exitosa.
mensaje Cadena Mensaje que emite el método cuando se ha retornado una respuesta
exitosa.

Punto de Enlace para el Esquema del Servicio:

Pág 27
 Ruta https://aplicacionesdev.electrodunas.com/ChatBotWeb/
Método POST
Llamada del Método https://aplicacionesdev.electrodunas.com/ChatBotWeb/api/ChatBot/DatosBasicosNIS
Cabecera User-Agent: Fiddler
Content-type: application/json; charset=utf-8
Host: aplicacionesdev.electrodunas.com
Content-Length: 25
Dato de Pruebas "NIS":"101002767"

Ejemplo de solicitud:

{
"NIS": "101002767"
}

Actualmente nos el servicio da esta respuesta

Resultado:

Recomendamos esta nueva estructura

{
"Nombres": "JUANA VILMA",
"ApellidoPaterno": "VENTE",
"ApellidoMaterno": "DE COLINA",
"Telefono": "null",
"Email": "mercegsc91@gmail.com",
"Tarifa": "BT5BR",
"TipoDocumento": "DNI",
"NroDocumento": "21420194",
"FaltaDatoCell": 0,
"FaltaDatoEmail": 1,
"FaltaDatoTDoc": 1,

Pág 28
 "FaltaDatoDoc": 1,
"terminoBien": 1,
"mensaje": "Los datos del Cliente han sido hallados en el Sistema Comercial."
}

{
"Nombres": "",
"ApellidoPaterno": "",
"ApellidoMaterno": "",
"Telefono": "",
"Email": "",
"TipoDocumento": "",
"NroDocumento": "",
"FaltaDatoCell": 0,
"FaltaDatoEmail": 0,
"FaltaDatoTDoc": 0,
"FaltaDatoDoc": 0,
"terminoBien": 0,
"mensaje": "No se encontraron datos del cliente."
}

{
"Nombres": "",
"ApellidoPaterno": "",
"ApellidoMaterno": "",
"Telefono": "",
"Email": "",
"TipoDocumento": "",
"NroDocumento": "",
"FaltaDatoCell": 0,
"FaltaDatoEmail": 0,
"FaltaDatoTDoc": 0,
"FaltaDatoDoc": 0,
"terminoBien": 0,
"mensaje": "Hubo un error en el sistema."
}

Pág 29