ESPECIFICACION DE MENSAJERIA VENTANILLAS MÓVILES DISPOSITIVO MOVIL HACIA HOST

Transcripción

1 ESPECIFICACION DE MENSAJERIA VENTANILLAS MÓVILES DISPOSITIVO MOVIL HACIA HOST Objetivo.- Especificar los elementos para el funcionamiento del servicio de ventanillas móviles, Indicando la mensajería utilizada para realizar la conexión entre el dispositivo móvil y institución financiera para realizar las transacciones de depósito o pagos de créditos. DESCRIPCION DE ACTORES A continuación se describen los actores involucrados en el ser DESCRIPCIÓN DE ELEMENTOS A continuación se muestra en la Figura 1. Los elementos que intervienen en el sistema de ventanillas móviles. Servidor Autenticación de Licencia la Figura 1. Elementos para el servicio de ventanillas móviles. Dispositivo Móvil.- Se considera al dispositivo que posea conexión a internet, Bluetooth, sistema operativo ANDROID con versión o 4.1 y la aplicación de móvil de ventanillas móviles. En el caso de requerir el programa con otra versión de ANDROID se debe anticipar las características para realizar las respectivas pruebas de funcionamiento.

2 Nube internet.- Servicio de acceso de internet u conexión de datos habilitado en el dispositivo, este servicio la institución financiera debe contratar directamente con el operador celular, se recomienda que para la contratación del ancho de banda se considere que el intercambio de datos entre el dispositivo y la institución es de 5 Kb por transacción (efectiva o no). Servidor Web HTTPS COONECTA.- Servidor web JBOSS designado por la cooperativa para que sea instalado el servicio de conexión para el envió de peticiones del dispositivo móvil a la interfaz autorizadora de la institución, este servicio puede ser configurado con un certificado autogenerado, o si la institución posee un certificado puede ser habilitado en el servidor servidor. Host Autorizador.- Interfaz autorizadora de la institución para realizar el procesamiento de peticiones de ingreso se sesión, depósitos y pagos de créditos. Servidor de Autenticación Licencia.- Utilizado para llevar un registro de los dispositivos móviles que utilizan la aplicación, y permite la habilitación o des habilitación del servicio al dispositivo. CONSIDERACIONES 1. Los usuarios son administrados por la institución. Cualquier cambio de clave debe de hacerlo mediante el autorizador financiero. 2. No existen la opción de reversos para las transacciones que el usuario realice desde el dispositivo, ya sea este por mala manipulación operacional del dispositivo. 3. La institución financiera debe habilitar el puerto de acceso mediante su firewall. 4. Los códigos de error son definidos por la institución financiera, tomando en consideración que al procesar una transacción correcta OK, la interfaz autorizadora responderá con código de error 0. o Cada campo a ser enviado va a ser separado por un tabulador \t. 6. Los campos necesarios que debe llevar el Boucher son: Nombre de la institución, tipo transacción, fecha, documento, monto, otros datos adicionales que la institución. 7. La aplicación puede estar sujeto a cambios y las nuevas versiones puede existir variación. REQUERIMIENTOS TÉCNICOS Servidor Transaccional Ventanillas móviles Procesador Core2duo 2.50 Ghz o superior Memoria RAM 4Gb Disco Duro 160 GB Sistema Operativo Windows 2008 Server Estándar

3 ESPECIFICACIÓN DE MENSAJERIA A continuación se presenta la especificación de mensajería utilizada para el servicio. Prueba de comunicación # Requerimiento 4. Utilizada para realizar la verificación de comunicación entre el dispositivo móvil y el host de la cooperativa. Defecto Numero de Terminal (4) Numero de Terminal Nombre de Usuario Nombre de Usuario AAA Proceso (2) Código de identificación para la transacción 4 Trama de requerimiento. T1 AAA 4 Verificación de Comunicación Respuesta. Numero de Terminal (4) Numero de terminal Proceso (2) Código de identificación del 4 proceso a realizar Código de Error (3) Código de error Descripción del Error (60) Descripción del Error Código char 1 Retorna 1 1 Ejemplo: Trama respuesta. T1 4 0 CONEXION ESTABLECIDA 1 Acceso al sistema # de Requerimiento 1. Utilizado para controlar el acceso al sistema mediante la validación del usuario y el terminal mediante el envío del nombre de usuario y contraseña.

4 Numero de terminal (4) Numero de terminal Nombre de Usuario Nombre de Usuario Proceso (2) Código de identificación de la operación a realizar Contraseña (15) Contraseña Ejemplo: Trama requerimiento. T1 lchuqui Trama de respuesta. Numero de Terminal (4) Numero de Terminal Nombre de Usuario Nombre de Usuario Proceso (2) Código de identificación de la operación a realizar Código de Error (3) Código de Error Descripción del Error (60) Descripción del error Nombres y Apellidos Nombres y Apellidos Ejemplo: Transacción OK T1 lchuqui 1 0 Ok Caja móvil Transacción con error T1 lchuq 1 50 Usuario No existe 1 1 Consulta Hoja Colecta. # Requerimiento 6 Permite consultar el número de transacciones que el usuario ha realizado en el PDA. Numero de Terminal (4) Numero de Terminal Nombre de Usuario Nombre de usuario Proceso (2) Código de identificación para la transacción Contraseña (15) Contraseña Oficina (10) Oficina del usuario 6 Respuesta

5 CAMPO Tipo Longitud Descripción Numero de Terminal (4) Numero de terminal Proceso (2) Identifica el tipo de proceso a realizar en este requerimiento Codigo de Error Char (3) Codigo de Error Descripción del error (60) Descripción del error Num. De trans. de Numeric (5) transacciones ingreso de ingreso Num. De trans. De Numeric (5) transacciones egreso de egreso Valor Inicial Numeric (16,2) Valor Inicial de la caja Valor de trans. De Numeric (16,2) Suma de las transacciones ingreso de ingreso del día Valor de trans. De Numéric (16,2) Suma de las transacciones egreso de egreso del día Saldo Numeric (16,2) Saldo de la diferencia de saldos de inicio + ingresos egresos 6 Búsqueda de clientes por nombres y apellidos. # Requerimiento 3 El autorizador realiza la búsqueda de coincidencias con los datos ingresados para presentar al usuario. Se envía el nombre del cliente y el apellido. El número de clientes que puede devolver son de 8 clientes. Numero de terminal (4) Numero de terminal Nombre de Usuario Nombre de Usuario Proceso (2) Código de identificación de la 3 operación a realizar Contraseña (15) Contraseña Nombres (30) Nombre parcial o completo Apellidos (30) Apellidos parcial o completo Ejemplo: T1 lchuqui luis C Respuesta

6 Numero de Terminal (4) Numero de Terminal Proceso (2) de la 3 transacción a realizar Código de Error (3) Código de Error Descripción del Error (60) Descripción del Error Nombres Completos (60) Retorna el nombre 1 del Cliente(1) completo del (13) del cliente Cliente(1) Char 1 R, C, P (1) Nombres Completos (60) Retorna el nombre 1 del Cliente(2) completo del (13) del cliente Cliente(2) Char 1 R, C, P (2) Ejemplo: Requerimiento sin error T1 3 0 OK Luis Miguel Chuqui Chicaiza C Luis Miguel Chuqui Chicaiza R Luis Felipe Carrera C Requerimiento con error. T CLIENTE NO EXISTE Búsqueda de clientes por número de documento # Requerimiento 22 El dispositivo envía el número de documento al autorizador, este procesa y envía respuesta el número mínimo de coincidencias para mostrar el sistema es de 8. Numero de terminal (4) Numero de terminal

7 Nombre de Usuario Nombre de Usuario Proceso (2) Código de identificación de la operación a realizar Contraseña (15) Contraseña Numero de (15) Numero de documento Documento. 22 Ejemplo T1 lchuqui Respuesta Numero de Terminal (4) Numero de Terminal Proceso (2) de la 22 transacción a realizar Código de Error (3) Código de Error Descripción del Error (60) Descripción del Error Nombres Completos (60) Retorna el nombre 1 del Cliente(1) completo del (13) del cliente Cliente(1) Char 1 R, C, P (1) Nombres Completos (60) Retorna el nombre 1 del Cliente(2) completo del (13) del cliente Cliente(2) Char 1 R, C, P (2) Ejemplo:

8 Respuesta sin error. T OK Luis Miguel Chuqui Chicaiza C Luis Miguel Chuqui Chicaiza R Respuesta con error T CLIENTE NO EXISTE Búsqueda de número de cuentas del cliente. # Requerimiento 10 Permite realizar la solicitud de búsqueda que el cliente puede tener para realizar un depósito. Numero de Terminal (4) Numero de Terminal Nombre de Usuario (15) Nombre de usuario Proceso (2) Código de identificación para 10 la transacción Contraseña (15) Contraseña Char (1) C, R, P (13) Ejemplo T1 lchuqui C Respuesta del autorizador Numero de terminal (4) Numero de terminal Proceso (2) del tipo de 10 proceso trans. A realizar Código de Error (3) Código de Error Descripción del Error (60) Descripción del Error Char (1) C,R,P (13)

9 Nombre de Cuenta (1) Cuenta (1) Saldo de la Cuenta (1) Nombre de Cuenta (2) Cuenta (2) Balance de cuenta (2) Numero de Nombre de Cuenta (3) Cuenta (3) Balance de la cuenta (3) Ej. (Ahorro especial, Ahorro Normal) Ej. ( ) Numéric Saldo de la cuenta Char (1) (13) Ej. Ahorro Especial Ej. (233333) Numéric Balance de cuenta Char (1) (13) Ej. Ahorro Programado Ej. ( ) Numéric Balance de la cuenta Respuesta sin error T OK C Ahorros a la vista C Ahorro Estudiantil Respuesta con error

10 T CLIENTE NO TIENE CUENTAS ACTIVAS PARA ESTE SERVICIO Consulta de cuenta de ahorro otro. # Requerimiento 30 Permite realizar la búsqueda del número de cuenta del cliente, se utiliza esta opción cuando se quiere distinguir un producto que tiene relación con una sola cuenta. Numero de Terminal (4) Numero de Terminal Nombre de Usuario Nombre de usuario Proceso (2) Código de identificación para 30 la transacción Contraseña (15) Contraseña Char (1) C, R, P (13) Ejemplo T1 lchuqui C Respuesta Numero de terminal (4) Numero de terminal Proceso (2) del tipo de 30 proceso trans. A realizar Código de Error (3) Código de Error Descripción del Error (60) Descripción del Error Char (1) C,R,P (13) Nombre de Cuenta (1) Ej. (Ahorro especial, Ahorro Normal)

11 Cuenta (1) Saldo de la Cuenta (1) Nombre de Cuenta (2) Cuenta (2) Balance de cuenta (2) Numero de Nombre de Cuenta (3) Cuenta (3) Balance de la cuenta (3) Ej. ( ) Numéric Saldo de la cuenta Char (1) (13) Ej. Ahorro Especial Ej. (233333) Numéric Balance de cuenta Char (1) (13) Ej. Ahorro Programado Ej. ( ) Numéric Balance de la cuenta Respuesta sin error T OK C Ahorro mensual Respuesta con error T CLIENTE NO TIENE CUENTAS ACTIVAS PARA ESTE SERVICIO

12 Deposito. # Requerimiento 7 Realiza un depósito en la cuenta y al cliente seleccionado. Numero de Terminal (4) Numero de terminal Nombre de Usuario Nombre de Usuario Proceso (2) Código de tipo de proceso para realizar la trans. De deposito Contraseña Char (15) Contraseña Char (1) (13) Cuenta (13) cuenta Monto a depositar numeric (13,2) Monto a depositar Monto Cheques numeric (13,2) Monto en cheques Numero cheques numeric (2) Numero de cheques a depositar Total Deposito numeric (13,2) Monto Total a Depositar Numero de Recibo (10) # de serial de la PDA PDA 7 C, R, P Ejemplo T1 lchuqui C Respuesta En el campo línea a la primera línea a va a ser el nombre de la institución. El tamaño máximo de cada una de las líneas que se desea va a ser de 32 caracteres. No se pueden enviar caracteres especiales ni tildes. Para. Numero de terminal (4) Numero de terminal Proceso (2) del tipo de 7 proceso a realizar Código de Error (3) Código de Error Descripción del Error (60) Descripción del Error Char (1) C, R, P (13)

13 Cuenta (13) Cuenta Monto a depositar Numeric 13 Monto a depositar Único identificador del movimiento Único identificador del movimiento Fecha de Proceso Fecha de Proceso Primera línea a 80 Primera línea a Imprimir Segunda línea a 80 Segunda línea a Ultima línea a 80 Ultima línea a Ejemplo Deposito sin error T1 7 0 Deposito realizado con Exito C /22/2014 8:46:32 PM COONECTA RTC TIPO: DEPOSITO FECHA: 2/22/2014 8:46:32 PM CLIENTE: NUM COMPROBANTE: MONTO TOTAL: 10.0 GUARDE ESTE COMPROBANTE ES SU UNICO RECIBO DE TRANSACCION Deposito con error T1 7 0 Transacción no permitida Otro deposito #Requerimiento 31 Permite realizar el depósito mediante la selección de la cuenta y el documento del cliente. Utilizado para diferenciar cuando el número de cuenta posee varios productos. Numero de Terminal (4) Numero de terminal Nombre de Usuario Nombre de Usuario Proceso (2) Código de tipo de proceso para realizar la trans. De deposito Contraseña (15) Contraseña char (1) (13) 31 C, R, P

14 Cuenta (13) cuenta Monto Efectivo numeric (13,2) Monto Efectivo Monto Cheques numeric (13,2) Monto Cheques Numero de Cheques numeric (2) Cheques depositados Total de Deposito numeric (13,2) Total de Deposito Numero de Recibo (10) # de serial de la PDA PDA Ejemplo T1 lchuqui C Respuesta de depósito código otro. En el campo línea a la primera línea a va a ser el nombre de la institución. El tamaño máximo de cada una de las líneas que se desea va a ser de 32 caracteres. No se pueden enviar caracteres especiales ni tildes. Para. Numero de terminal (4) Numero de terminal Proceso (2) del tipo de 31 proceso a realizar Codigo de Error (3) Codigo de Error Descripción del Error (60) Descripción del Error Char (1) C, R, P (13) Cuenta (13) Cuenta Monto a depositar numeric 13 Monto a depositar Único identificador del movimiento Único identificador del movimiento Fecha de Proceso Fecha de Proceso Primera línea a 80 Primera línea a Imprimir Segunda línea a 80 Segunda línea a Ultima línea a 80 Ultima línea a

15 Verificación de depósito # Requerimiento 40. Utilizado para indicar si el depósito se efectuó correctamente se debe enviar el número de secuencia del depósito. Campo Tipo Tamaño Descripción Numero de Terminal (4) Numero de terminal Nombre de Usuario Nombre de Usuario Proceso (2) Código de tipo de proceso para realizar la trans. De deposito 40 Contraseña (15) Contraseña Char (1) C, R, P (13) Cuenta (13) cuenta Total Deposito numeric (13,2) Total Deposito Numero de Recibo PDA (10) # de serial de la PDA Ejemplo T1 lchuqui C

16 Respuesta terminal (4) Numero de terminal Proceso (2) del tipo de 40 proceso a realizar Código de Error (3) Código de Error Descripción del Error (60) Descripción del Error Char (1) C, R, P (13) Cuenta (13) Cuenta Monto a depositar numeric 13 Monto a depositar Único identificador del movimiento Único identificador del movimiento Fecha de Proceso Fecha de Proceso Primera línea a 80 Primera línea a Imprimir Segunda línea a 80 Segunda línea a Ultima línea a 80 Ultima línea a Ejemplo Transacción sin error T confirmacion ok C /22/2014 8:46:32 PM COONECTA RTC TIPO: DEPOSITO FECHA: 2/22/2014 8:46:32 PM CLIENTE: NUM COMPROBANTE: MONTO TOTAL: 10.0 GUARDE ESTE COMPROBANTE ES SU UNICO RECIBO DE TRANSACCION Transacción con error T deposito no realizado

17 Verificación de otro depósito # Requerimiento 41 Campo Tipo Tamaño Descripción Numero de Terminal (4) Numero de terminal Nombre de Usuario Nombre de Usuario Proceso (2) Código de tipo de proceso para realizar la trans. De deposito 41 Contraseña (15) Contraseña Char (1) C, R, P (13) Cuenta (13) cuenta Total Deposito numeric (13,2) Total Deposito Numero de Recibo PDA (10) # de serial de la PDA Respuesta terminal (4) Numero de terminal Proceso (2) del tipo de 41 proceso a realizar Código de Error (3) Código de Error Descripción del Error (60) Descripción del Error Char (1) C, R, P (13) Cuenta (13) Cuenta Monto a depositar numeric 13 Monto a depositar Único identificador del movimiento Único identificador del movimiento Fecha de Proceso Fecha de Proceso Primera línea a Imprimir 80 Primera línea a

18 Segunda línea a 80 Segunda línea a Ultima línea a 80 Ultima línea a Búsqueda de préstamo cliente #Requerimiento 11 Búsqueda de préstamos que tiene el cliente por pagar. Además el usuario de la aplicación no debe aceptara una fracción del valor a pagar, se debe de cobrar la totalidad de la letra que indique el sistema. Numero de terminal (4) Numero de terminal Nombre de Usuario Nombre de Usuario Proceso (2) Codigo de Proceso para esta trans. Contraseña (15) Contraeña char (1) (13) 11 Trama T1 lchuqui C Respuesta Numero de Terminal (4) Numero de terminal Proceso (2) proceso para esta transacción Código de Error char (3) Código de Error Descripción del Error (60) Descripción del Error (13) Nombre del producto (1) Ej. (Préstamo Quirografario) Código de Préstamo (1) Ej. ( ) Balance del Préstamo 1 numéric Monto Original (1) numeric Cuota mínima a pagar (1) numeric 11

19 Numero de (13) Numero de (2) Nombre del Producto (2) Ej. (préstamo Emergente) Numero de Préstamo (2) Ej. ( ) Balance de Préstamo (2) numéric Monto Original (2) numeric Cuota mínima a pagar (2) numeric Numero de (13) Numero de (3) Nombre del Producto (3) Ej. (préstamo Emergente) Numero de préstamo (3) Ej. ( ) Balance de préstamo (3) numéric Monto Original (3) numeric Cuota mínima a pagar (3) numeric t OK Prestamo automovil A Prestamo Medicina B Selección del préstamo. # Requerimiento 12 Valida si el préstamo puede ser pagado o esta con algún error. Numero de terminal (4) Numero de Terminal Nombre de Usuario Nombre de Usuario Proceso (2) del tipo de proceso para este requerimien Contraseña (15) Contraseña (13) Numero de préstamo Ej. ( ) 12 Ejemplo t1 lchuqui A Respuesta Tipo Respuesta Campo Tipo Tama Descripción ño Numero de terminal (4) Numero de terminal Proceso (2) Proceso 12

20 Código de Error char (3) Código de Error Descripción del Error (60) Descripción del Error (13) Numero de préstamo Ej. ( ) Monto Original numeric Balance del préstamo Numérico Mensaje de prestamo (60) Mensaje de si el crédito esta (vencido), (pago adelantado), (normal) No definido Char 1 Espacio Espacio No definido Char 1 Espacio Espacio No definido Char 1 Espacio Espacio No definido Char 1 Espacio Espacio Mínimo valor a pagar (2) numeric Respuesta si error T cobrar A normal 30 T cobrar A vencido 30 T cobrar A Adelantado 30 Respuesta con error t error en proceso Pago de préstamo cuota mínima # Requerimiento 13 terminal (4) Terminal Nombre de Usuario Nombre de usuario proceso (2) Codigo de proceso que identifica al requerimiento Contraseña (10) Contraseña (13) Numero de préstamo Ej. ( ) 13

21 Monto Efectivo Numeric Monto Efectivo Monto Cheques Numeric Monto Cheques Monto Total Numeric Monto total de pago # de Recibo (10) # de recibo Ejemplo t1 lchuqui A Numero de terminal (4) Numero de terminal proceso (2) de proceso para este requerimiento Código de Error (3) Código de Error Descripción del Error (60) Descripción del Error (13) Numero de préstamo Ej. ( ) Monto a pagar Numeric Monto a para Identificador único de movimiento Identificador único de movimiento Fecha de proceso Fecha de proceso Primera liena a 80 Primera lijnea a Segunda línea a 80 Segunda línea a Ultima línea a 80 Ultima línea a 13 Respuesta sin error t Pago realizado con Exito A /25/2014 2:47:48 PM COONECTA RTC TIPO: PAGO PRESTAMO FECHA: 2/25/2014 2:47:48 PM CLIENTE: NUM COMPROBANTE: MONTO TOTAL: 200 GUARDE ESTE COMPROBANTE ES SU UNICO RECIBO DE TRANSACCION Respuesta con error

22 T PAGO NO REALIZADO Verificación de pago de préstamo # Requerimiento 42 Verificar si la transacción de préstamo fue realizado con éxito. Campo Tipo Tamaño Descripción Numero de terminal varchar (4) Numero de Terminal Nombre de Usuario varchar Nombre de usuario proceso varchar (2) Codigo de proceso que identifica al requerimiento 42 Contraseña varchar (10) Contraseña Numero de varchar (13) Numero de Numero de Prestamo Ej. ( ) Total a pagar numeric Monto a pagar # de Recibo varchar (10) # de recibo TRAMA ENVIO T1 lchuqui A Trama de respuesta Campo Tipo Tamaño Descripción Numero de terminal Varchar (4) Numero de terminal proceso Varchar (2) de proceso para este requerimiento 42 Código de Error Varchar (3) Código de Error Descripción del Error Varchar (60) Descripción del Error Varchar (13)

23 Numero de Prestamo Ej. ( ) Monto a pagar Numeric Monto a para Identificador unico de movimiento Varchar Identificador unico de movimiento Fecha de proceso Varchar Fecha de proceso Primera liena a Segunda línea a Varchar 80 Primera lijnea a Varchar 80 Segunda línea a Varchar 80 Varchar 80 Ultima línea a Varchar 80 Ultima línea a T PAGO REALIZADO VERIFICACION OK A /15/2015 2:30:41 PM COONECTA RTC TIPO: PAGO PRESTAMO FECHA: 5/15/2015 2:30:41 PM CLIENTE: NUM COMPROBANTE: 114 MONTO TOTAL: GUARDE ESTE COMPROBANTE ES SU UNICO RECIBO DE TRANSACCION TRAMA CON ERROR T PRESTAMO NO REGISTRADO A100022