Web Service Format

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:

satisfactoria o no.
ruta Cadena 250 cadena de texto Url que emite el método cuando se ha
*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:

satisfactoria o no.
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”
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
Nombre: NIS
Comercial

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

Content-Length: 25
Dato de Pruebas "NIS":"101002607"
Pág 10
{
"NIS": "101002607"
}
Actualmente nos el servicio da esta respuesta
Resultado:
{
"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”
Permite realizar la consulta de la fecha de corte aplicado al Suministro de un Cliente, en función de los
parámetros de entrada
Nombre: NIS
Comercial

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

Content-Length: 25
{
"NIS": "101002607"
}
Pág 12
Resultado:
{
"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

Nombre: NIS
Comercial


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

Content-Length: 25
Dato de Pruebas "idSupply":"401011270"
{
"NIS": "401011270"
}
Resultado : *idSupply debe ser cambiado a NIS para el cuerpo de la solicitud
Pág 14
{
"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,
"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

Pág 15
Nombre: NIS
Comercial


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

Content-Length: 25
{
"NIS": "101002607"
}
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,
"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
Nombre: NIS
Comercial
Pág 17
satisfactoria o no.
err_msg Cadena 250 cadena de texto Mensaje que emite el método cuando se ha
mensaje Cadena 250 cadena de texto Mensaje cuando el método cuando se ha
Método POST
Llamada del Método https://aplicacionesdev.electrodunas.com/ChatBotWeb/api/ChatBot/ValidarSolicitudNuevoNIS

Content-Length: 25
{
"NIS": "101002607"
}
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,
"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

Nombre: NIS
Comercial


satisfactoria o no.
Pág 19
Método POST
Llamada del Método https://aplicacionesdev.electrodunas.com/ChatBotWeb/api/ChatBot/ValidarConsumoEnergiaNIS

Content-Length: 25
{
"NIS": "101002607"
}
Resultado:
{
"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,
"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

Nombre: NIS
Comercial


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

Content-Length: 25
Pág 21
{
"NIS": "101002607"
}
{
"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,
"mensaje": ""
}
Pág 22
5.14 SERVICIO WEB “DescargarPDF”
Permite obtener la ruta donde se encuentra el último recibo de un Cliente a través de los parámetros de
Entrada.

Nombre: NIS
Comercial

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:

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

Content-Length: 25
{
"NIS": "101002607"
}
** No nos devuelve algún mensaje correcto al momento de hacer las pruebas
Pág 23
Resultado:
{
"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,
"ruta": ""
}
Pág 24
5.15 SERVICIO WEB “VerLecturas”
Permite obtener la ruta donde se encuentra la lectura actual y anterior de un Suministro a través de los
parámetros de Entrada.

Nombre: NIS
Comercial
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:

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

Content-Length: 25
{
"NIS": "101002607"
}
Pág 25
{
"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,
"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.
Pág 26
Nombre: NIS
Comercial

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
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
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
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.
Pág 27
Método POST
Llamada del Método https://aplicacionesdev.electrodunas.com/ChatBotWeb/api/ChatBot/DatosBasicosNIS
Content-Length: 25
{
"NIS": "101002767"
}
Resultado:
{
"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,
"FaltaDatoTDoc": 0,
"FaltaDatoDoc": 0,
"terminoBien": 0,
"mensaje": "No se encontraron datos del cliente."
}
{
"Nombres": "",
"ApellidoPaterno": "",
"ApellidoMaterno": "",
"Telefono": "",
"Email": "",
"TipoDocumento": "",
"NroDocumento": "",
"FaltaDatoCell": 0,
"FaltaDatoTDoc": 0,
"FaltaDatoDoc": 0,
"terminoBien": 0,
"mensaje": "Hubo un error en el sistema."
}
Pág 29

Web Service Format

Cargado por

Copyright:

Formatos disponibles

Web Service Format

Cargado por

Información del documento

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Web Service Format

Cargado por

Copyright:

Formatos disponibles

Observaciones Web Service

OBSERVACIÓN DEL CERTIFICADO SSL 5

DEFINICIÓN DE LOS WEBSERVICES 6

● 5.1 SERVICIO WEB “ValidarNroSumnistro”

Mantengan la misma estructura en la respuesta que dan:

Nombre Tipo Longitud Valores Descripción

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

Mantenga esta estructura en su respuesta:

Nombre Tipo Longitud Valores Descripción

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

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

Ejemplo de la respuesta actual del servicio

WEB SERVICE DE PRUEBA:

WEB SERVICE ValidarNroSumnistro

Datos de Pruebas "NIS":"101002607"

5.1 SERVICIO WEB “ValidarNroSumnistro”

Estructura de los Datos de Entrada:

Estructura de los Datos de Salida:

Nombre Tipo Longitud Valores Descripción

Punto de Enlace para el Esquema del Servicio:

Recomendamos esta nueva estructura

Estructura de los Datos de Entrada:

Estructura de los Datos de Salida:

Nombre Tipo Longitud Valores Descripción

Punto de Enlace para el Esquema del Servicio:

Cabecera User-Agent: Fiddler

Recomendamos esta nueva estructura

Estructura de los Datos de Entrada:

Estructura de los Datos de Salida:

Nombre Tipo Longitud Valores Descripción

Punto de Enlace para el Esquema del Servicio:

Cabecera User-Agent: Fiddler

Recomendamos esta nueva estructura

Estructura de los Datos de Entrada:

Estructura de los Datos de Salida:

Nombre Tipo Longitud Valores Descripción

Punto de Enlace para el Esquema del Servicio:

Cabecera User-Agent: Fiddler

Actualmente nos el servicio da esta respuesta

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

5.8 SERVICIO WEB “ValidarEstadoNIS”

Estructura de los Datos de Entrada:

Estructura de los Datos de Salida:

Nombre Tipo Longitud Valores Descripción

Punto de Enlace para el Esquema del Servicio:

Cabecera User-Agent: Fiddler

Actualmente nos el servicio da esta respuesta

Recomendamos esta nueva estructura

5.9 SERVICIO WEB “ValidarSolicitudNuevoNIS”

Estructura de los Datos de Entrada:

Estructura de los Datos de Salida:

Punto de Enlace para el Esquema del Servicio:

Cabecera User-Agent: Fiddler

Actualmente nos el servicio da esta respuesta

Recomendamos esta nueva estructura

5.10 SERVICIO WEB “ValidarConsumoEnergiaNIS”

Estructura de los Datos de Entrada:

Estructura de los Datos de Salida: