Professional Documents
Culture Documents
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.
Servicio
04
04
04
04
Tipo de
Ingreso
08
05
02
03
Clase de
Ingreso
01
11
61
67
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
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
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
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
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
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
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
Servicio
04
04
Tipo de
ingreso
18
18
Clase de
Ingreso
70
71
Con la parte 2 del cdigo de barras se hace el consumo del web service el cual debe
recibir los siguientes parmetros:
<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
Varchar (50)
Opcional
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
<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
Campo
Nro Digitos
Posicion
Inicial
Decimales
Posicion
Final
Tipo Dato
Valor
Cero
1 Numerico
0' (cero)
Tipo Registro
2 Numerico
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
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
Total Registros
11 Numerico
18
12
29 Numerico
30
107 Alfaumerico
Servicio
09
Tipo de
Ingreso
02
Clase de
Ingreso
05
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.