You are on page 1of 13

INTEGRACION CAJA GENERAL - NEW HOTEL

Esta interface aplica para Casas vacacionales, Hotel Almirante y Hotel Kualamana.
Bsicamente est interface funciona con el nmero de la reserva, el ao de la reserva y la
unidad hotelera a la cual pertenece la reserva. El usuario ingresa esta informacin y el
sistema de caja coloca un archivo plano con los datos ingresados en un recurso
compartido, el cual est siendo monitoreado todo el tiempo por un sistema. Cuando este
sistema detecta que all se coloc un archivo lo toma y el sistema destino devuelve una
respuesta al sistema de caja para continuar con la transaccin.
El sistema de caja despus de colocar el archivo queda en espera por 60 segundos de la
respuesta del sistema destino. Si al cabo de este tiempo no hay respuesta informa que no
existe comunicacin con el sistema destino, de lo contrario toma el archivo que dej el
sistema destino con la respuesta y contina la transaccin.
Una vez se recibe la respuesta, si la reserva no existe o no es posible el pago se informa
al usuario a travs de un mensaje. Si es posible su pago, se muestra la pantalla de
ingreso de formas de pago para diligenciar los datos. Una vez los datos son aceptados se
genera el recibo de caja correspondiente y a su vez se genera un archivo plano para
reportar el pago al sistema destino, este archivo de igual forma es colocado en un recurso
compartido para que el sistema que monitorea lo tome y lo reporte al sistema destino y all
quede el pago actualizado.

Existen tres carpetas para el intercambio de informacin, que se muestran en la siguiente


imagen:

Cuando se realiza una solicitud se coloca el archivo en la carpeta SOLICITUD.

El sistema destino deja la respuesta en la carpeta RESPUESTA.

Despus de efectuar el recaudo en el sistema de caja se coloca el archivo del


pago en la carpeta PAGOS.
Los servicios asociados a estos recaudos son los siguientes:
Sitio
Eventos
Hotel Kualamana
Hotel Almirante
Casas Vacacionales

Servicio
04
04
04
04

Tipo de
Ingreso
08
05
02
03

Clase de
Ingreso
01
11
61
67

Estructuras de los archivos de intercambio de informacin:


Datos de la reserva para solicitar informacin detallada de la reserva
Nombre
campo

Descripcin

Longitud

Tipo

Ejemplo
Valor

CDRESE
ARESE
CDHOTE

RESERVA
AO RESERVA
HOTEL

6,0
4,0
4,0

Numrico
Numrico
Numrico

CDHUSE

USUARIO

10

Alfanumric
o

001520
2015
2=Kualaman
a
CGCQ001

Datos de la reserva para poder realizar el pago


Nombre
campo

Descripcin

Longitud

Tipo

Ejemplo
Valor

CDRESE
SRRESE
NRHABI

RESERVA
AO RESERVA
NUMERO
DE
HABITACION
NOMBRE
CLIENTE

6,0
4,0
7

001520
2015

30

Numrico
Numrico
Alfanumric
o
Numrico

IDENTIFICACIO
N CLIENTE
VALOR DE LA
RESERVA
VALOR
DEPOSITO
HOTEL

25,0

Numrico

JAVIER
ANDRES,
CASTAEDA
RUIZ
11234567

15,0

Numrico

1000000

15,0

Numrico

4,0

Numrico

NBCLIE

NRIDEN
VRRESE
VRDEPO
CDHOTE

Datos del pago realizado a la reserva


Nombre
campo

Descripcin

Longitud

Tipo

Ejemplo
Valor

CDRESE
SRRESE
TPTRAN

RESERVA
AO RESERVA
TIPO
DE
TRANSACCION
NUMERO
DE
RECIBO
VALOR
DEL
PAGO

6,0
4,0
1,0

Numrico
Numrico
Numrico

001520
2015
1

12,0

Numrico

123783

15,0

Numrico

300000

NRRECI
VRRESE

CDHOTE
TXTDES

HOTEL
DESCRIPCION

4,0
40

CDHUSE

USUARIO

10

Numrico
Alfanumric
o
Alfanumric
o

CGCQ001

INTEGRACION SISTEMA DE CAJA ZEUS ONLINE (Pago reservas Hotel


Corales)

Esta integracin es exclusiva para los pagos de anticipos y totales de las reservas que se
realizan para el Hotel Corales.
La contabilizacin de estos recaudos se realiza como un ingreso para terceros, ya que
estos recursos se recaudan pero se deben entregar a Hotel Corales.
La forma actual de operacin es similar a la integracin de caja con New Hotel, sin
embargo en esta integracin es posible realizarla a travs del consumo de web services.
La diferencia en la forma de operacin con la integracin del sistema de caja New Hotel,
radica en que en este caso se recibe un anticipo para el cual se emite un recibo de caja y
cuando se recibe el saldo de la reserva se debe emitir un documento denominado factura
de venta, el cual es el soporte del cliente para el ingreso al Hotel. Cuando se recibe el
anticipo se debe validar que este no puede ser inferior al 30% del valor de la reserva. De
igual forma cuando se realiza el pago total o el saldo se verifica que efectivamente se
cubra la totalidad de la reserva y nicamente se recibe como pago el faltante, pues se
debe descontar el anticipo que fue recibido con anterioridad.
La factura que se emite debe realizar el desglose del valor del alojamiento, seguro
hotelero e IVA. El IVA se debe calcular nicamente sobre el valor del alojamiento, pues el
seguro hotelero no tiene IVA. Por lo tanto, es necesario que del valor total del alojamiento
se reste el seguro hotelero y sobre el excedente se calcule el IVA. Vale la pena resaltar
que el seguro hotelero se cobra por noche y por persona y que tiene un valor fijo de
$5.000 durante todo el ao (este puede cambiar en el momento en que el hotel lo decida).
Zeus On Line cuenta con el desglose del seguro hotelero.
Ejemplo:
Valor total de la reserva

$500.000 por dos personas durante dos noches

Desglose detallado del valor del hospedaje antes de IVA y seguro hotelero, aparte el
seguro hotelero y el IVA as:
CONCEPTO
FACTURA SERVICIO HOSPEDAJE HABITACIN

$413.793

SEGURO HOTELERO

$ 20.000

IVA 16%

$ 66.207

Esquema general del proceso

Una vez se verifican y digitan los valores en la condicin del pago final, actualmente se
genera la factura donde se muestra:

Servicio de Hospedaje
Valor del IVA

Esquema del proceso en trminos de sistemas.

Consulta de la informacin de la reserva a ZeusOnLine


Captura del pago en Caja General a travs del sistema ISERIES
Envo de informacin sobre el pago realizado a ZeusOnLine

Los Sistemas afectados son ISERIES(AS400), BIZTALK, ZeusOnLine

Supuestos y dependencias
La informacin que debe retornar el web service de consulta en ZeusOnLine son los
valores del alojamiento y del seguro hotelero.
Es necesario modificar la orquestacin de Biztalk para que transporte el campo adicional
del seguro hotelero.
Alcance

El clculo del IVA, se debe reflejar nicamente sobre el valor del alojamiento antes
de aplicar el seguro hotelero.
Desglosar en la factura los valores de:
o Alojamiento
o Seguros Hoteleros
o IVA

El documento de la definicin del web service de ZEUS es el siguiente:


Documento de Comunicacin Ws CAFAM.
Los servicios asociados a estos recaudos son los siguientes:
Sitio

Servicio

Hotel Corales Anticipos


Hotel
Corales
Facturacin

04
04

Tipo de
ingreso
18
18

Clase de
Ingreso
70
71

INTEGRACION SISTEMA DE CAJA PAGO SIMPLE

El objetivo de esta integracin es realizar el recaudo de la planilla Simple y


reportar el movimiento del da a Simple de acuerdo a estructura previamente
definida pro pago Simple. Esta integracin se realiza a travs del consumo de
web services.

A continuacin se describe el proceso que se lleva a cabo para este tipo de


recaudo:
1. Captura de cdigo de barras planilla
El proceso de recaudo de pagos inicia con la lectura del cdigo de barras de la planilla

Con la parte 2 del cdigo de barras se hace el consumo del web service el cual debe
recibir los siguientes parmetros:

RequestId: Nmero nico generado para el consumo del web service


SearchType: Debe ser 2
InvoiceId: Parte 2 del cdigo de barras
AgreementId: Cdigo del convenio, debe ser
CurrentDatetime: Fecha y hora de la peticin
InqDate: La misma fecha y hora del CurrentDatetime

Como respuesta del web service se obtiene una estructura con la


siguiente informacin:

<Status>

Char (1)

Obligatorio

Aceptado o rechazado
(0) Aceptado, (1)
Rechazado

<RequestId>

Numrico(1
8)

Obligatorio

Id de la solicitud que se
est respondiendo

<MessageCode
>

Char (2)

Opcional

Cdigo del mensaje: 0, 1,


2, 84

Varchar (50)

Opcional

Descripcin del mensaje:


0
Exitoso
1

descripcin
del
error
(Transaccin declinada,
Factura vencida, Factura
no
disponible.)
2
Factura ya pagada 84 -

<MesageText
>

Factura no existe
<CanalId/>

Char (1)

Obligatorio

Canal de liquidacin.
PAP (1) PAT (2)

<TotalValue/
>

Numrico
(18,0)

Obligatorio

Valor total a pagar

<InvoiceId>

Varchar (20)

Obligatorio

<Factura>

Varchar (20)

NIE

<Periodo>

Numrico
(6)

Periodo
salud

<idreference
>

Numrico
(18,0)

Obligatorio

Nmero de identificacin
nico

<ExpirationD
ate>

Varchar (20)
aaaa/mm/d
d

Obligatorio

Fecha de expiracin de
la factura

Factura

de

cotizacin

Si la respuesta es exitosa, se debe permitir el recaudo, en caso contrario


no se puede continuar con la transaccin. Los datos de la respuesta del
web service se requieren posteriormente para completar la transaccin.

Para consumir el web service Solicitud de recaudo se requieren los


siguientes datos:
RequestId: Nmero nico generado para el consumo del web service. Es
el mismo nmero que se enva cuando se realiza la consulta.
CurrentDatetime: Fecha y hora de la peticin
AgreementId: Cdigo del convenio, debe ser
IdReference: Nmero de referencia nico
PaidValue: Valor del pago

Como respuesta se obtiene:


Status: = 0 - pago exitoso, 1 - pago no exitoso.
RequestId: Nmero nico generado para el consumo del web service.
MessageCode: 0 - pago exitoso, 1 - pago no exitoso.
MessageText: Exitoso, Referencia rechazada.

Al finalizar el da se debe generar un archivo plano conformado de la


siguiente forma:

Campo

Nro Digitos

Posicion
Inicial

Decimales

Posicion
Final

Tipo Dato

Valor

Cero

1 Numerico

0' (cero)

Tipo Registro

2 Numerico

Tipo Registro = 1 Inicio archivo

NIT de Recaudador

10

12 Numerico

Fecha Transaccion

13

20 Numerico

Hora Transaccion

21

26 Numerico

27

107 Alfaumerico

Filler

Campo

Nro Digitos

Posicion
Inicial

Decimales

Posicion
Final

Tipo Dato

8600135703

Valor

Cero

1 Numerico

0' (cero)

Tipo Registro

2 Numerico

Tipo Registro = 2 Detalle movimiento

10

12

Fecha de la transaccion

13

20

Hora de la transaccion

21

26

Valor de la transaccion

10

27

36

Dependencia de recaudo

37

42

Terminal de pago

43

48

No es obligatorio

10

49

58

No es obligatorio

59

107

Referencia de Pago

Numero de transaccion
Filler

Campo

Nro Digitos

Posicion
Inicial

Decimales

Posicion
Final

Tipo Dato

Valor

Cero

1 Numerico

0' (cero)

Tipo Registro

2 Numerico

Tipo Registro = 3 Fin archivo

Total Registros

11 Numerico

Numero total de registros del archivo

18

12

29 Numerico

Sumatoria de todos los recaudos

30

107 Alfaumerico

Valor Total Recaudo


Filler

El archivo contiene la informacin de los recaudos realizados durante el


da.

El archivo se debe colocar en la librera SGLBF, este archivo tiene tres


tipos de registros (1,2 y 3) que identifican el inicio del archivo, el detalle
y el fin de archivo.
En el caso que un da no se registren transacciones, se debe generar el
archivo con los registros de inicio y fin de archivo.
El label del archivo es: PLAxxxx, en donde xxxx es el cdigo de la
dependencia que recauda, por ejemplo PLA2774.
La generacin del archivo de recaudos est en proceso de cambio por
parte de Simple.
En el documento: ARCHIVO DE RECAUDO Y WEB SERVICE
ENTIDADES RECAUDADORAS_CAJAS se encuentra el detalle del web
service y el archivo consolidado de recaudo.
Los servicios asociados a estos recaudos son los siguientes:
Sitio

Servicio

Recaudo Planilla Simple

09

Tipo de
Ingreso
02

Clase de
Ingreso
05

INTEGRACION SISTEMA DE CAJA - SUBSIDIO

Esta integracin bsicamente consiste en consumir el web service expuesto en


PI para identificar las siguientes caractersticas:
-

Categora del afiliado


Vigencia del afiliado
Si est retirado verificar si tiene menos de un ao despus de la fecha
de retiro.

Los anteriores datos son la base para liquidar el valor de algunos de los
servicios que actualmente se recaudan por el sistema de caja.
Esta
informacin tambin es requerida para determinar los usos de los servicios por
parte de los afiliados segn sus correspondientes categoras.
Los servicios que se liquidan de acuerdo las categoras estn asociados a una
lista de precios que incluye la categora y una vigencia.
En este punto es importante la impresin del detalle del documento que se le
entrega al cliente.
Es de anotar que el web service que se utiliza es solo para consultar
informacin del afiliado y su grupo familiar con el objetivo de determinar la
tarifa de cobro que se aplicar para el servicio.

INTEGRACION SISTEMA DE CAJA - SAC (Sistema de administracin de


cursos)
Esta integracin se utiliza para realizar la facturacin de los cursos ofrecidos
por Cafam y cuyas reservas por el tema de administracin de espacios se
registra en el aplicativo SAC.
Actualmente esta integracin funciona a travs de una conexin ODBC donde
SAC actualiza dos tablas en Iseries que contienen la informacin necesaria para
realizar el proceso de facturacin.
Una vez la informacin es actualizada en Iseries el cajero puede realizar la
correspondiente factura ingresando el nmero de identificacin de la persona a
la cual se le va a facturar el curso. Se verifican los datos y si son correctos se
genera el respectivo documento y se actualiza el estado del registro para que
no pueda volver a ser facturado.
En el sistema SAC existe la opcin de verificar los cursos que fueron pagados
por ambiente de caja con el fin de actualizar el estado del pago. Es de aclarar
que si el curso no fue pagado no se libera el cupo automticamente en el
sistema SAC.
Sin embargo esta previsto que con el proyecto que reemplazara los ambientes
de caja en Club Campestre y Madelena, esta integracin se va a realizar a
travs de web services.
En los diagramas de la parte inferior se muestra el esquema propuesto, sin
embargo se debe tener en cuenta que est en fase de diseo y validacin.

You might also like