HOTELARIA - FRONT OFFICE - Plugin - Integração VHF com PDV Multiclubes

Pré-requisitos Obrigatórios:
O Multiclube deve está configurado para utilizar a funcionalidade (Getconsumption).
O Multiclube deve está configurado para não gravar dados na pulseira, usando somente o Id do NFC da pulseira.
O VHF deve possuir as tabelas que possuem o Multiclubes.
O Cliente deve possuir permissão para usar o plugin.
O Cliente deve possuir framework .net 4.0 ou superior.
O parâmetro de forma de busca saldo deve ser Associação Débito/Crédito (Parâmetros do Multiclube)
Funcionalidades do cartão ou pulseira deve ser configurada (0 ou 2)
O campo do parâmetro Chave Bilhete – Serve para buscar o bilhete para fazer a compra ingresso (Processo interno do Multiclube). É importante padronizar o nome desse Bilhete:
Nome Hotel + Numero dias + "Dias".
Ex.: Hotbeach 1 Dia, Hotbeatch 2 Dias
Essa chave Bilhete é usado no momento do checkin.
O multiclube deve ter um ambiente de homologação.
Validar se tem emissão de cupom fiscal pelo multiclube.
Controles do Multiclube que não são contemplados na integração:
Controle de Ingresso
No ambiente inicialmente implantado, o cliente não possui controle de Ingresso.
Controle de Saldo
No ambiente inicialmente implantado, o cliente não possui um controle de saldo. (a cada busca saldo efetuado "zeramos seu saldo de débito")

A integração com o multiclube tem por finalidade:

*Criar contas no multiclube dos hóspedes
A reserva é feita de forma normal.
A particularidade para o multiclube é que o hóspede deve possuir data de nascimento, e essa data tem que está relacionada a faixa etária e a UH já deve está selecionada.
Os parâmetros em relação a faixa etária , podem ser visto na tela de parâmetros -> Aba geral.
Em relação ao multiclube é necessário separar as crianças dos adultos , logo usamos o valor de criança1. O valor menor dessa idade é criança , em caso de maior é adulto.
Essa funcionalidade é feita depois de fazer a reserva , tem a opção de fazer o cartão de identificação, nessa tela temos botão de pulseiras MC-NFC.


Com essa tela aberta , temos todos os hóspedes da reserva , e o usuário pode selecionar quais hóspedes desejam fazer a pulseira (esses devem ser selecionados).
Essa tela quando configurada para o multiclube exibe um botão na tela Pulseira MC-NFC.
Esse botão é responsável pela gravação das pulseiras, nesse processo são criadas as contas no multiclube.
Ao término da gravação as pulseiras feitas , passam a exibir o número de identificação de sua conta no multiclube.

Essa tela pode ser acessada pelo botão chave\Cartão -> menu cartão consumo (tela cartão consumo).
Aparecendo esses números , as contas no multiclube estão geradas com sucesso e prontas para utilizar para o consumo do multiclube.
Nesse processo de fazer a conta do multiclube , também é feito o processo de gravar a pulseira ou cartão como cartão consumo, dessa forma pode usar a pulseira como cartão consumo no VHFCaixa.

*Criar contas no multiclube de contas avulsas
Essa funcionalidade é feita na tela de manutenção de contas.
Essa função é feita normal.
Caso tenha necessidade fazer a pulseira clique em editar e depois clicar em pulseira MC-NFC.
Dessa forma , será criada uma conta do multiclube para essa pulseira e o cartão consumo associado a conta do hóspede.

Mesclagem de Ficha :
A Mesclagem de ficha do hóspede já contempla as tabelas do multiclube. (não alterando o processo atual)

VHFCaixa + Multiclube
No VHFCaixa temos 2 momentos :
Extrato de conta + Busca Saldo (Operacional)
Encerramento das Pulseiras (Automático)
Extrato de conta + Busca Saldo (Operacional)
O consumo feito no multiclube fica guardado no multiclube. Nesse momento o VHF não tem conhecimento do valor ou itens consumidos.
O VHFCaixa com integração ao multiclube possui um botão chamando (Extrato Multiclube). Esse botão tem como funcionalidade , abrir a tela extrato de conta , onde também possui a funcionalidade de busca saldo.
A funcionalidade de extrato de conta, caso o hóspede tenha feito consumo no multiclube , esse produto irá aparecer na tela. O usuário tem a opção de imprimir o extrato.
Usuário tem a opção de filtros como : nome do hóspede e/ou uma data específica.
Os lançamentos feitos no extrato de conta não são gravados em nosso banco de dados , são somente acessados pela API. No caso do multiclube em caso da conta ser encerrada não se possui acesso ao extrato de conta multiclube.
A funcionalidade de Busca saldo , caso possua item de extrato na conta , este irá gerar um novo lançamento na conta de hóspede , com o valor total de consumo feito até o momento de buscar o saldo. Esse lançamento somente é feito caso o saldo da conta do multiclube seja negativo . Em caso de crédito irá aparecer uma mensagem na tela informando para ser consumido o saldo , e depois sim pode ser encerrado.
O Tipo DC gravado na conta do hóspede nesse lançamento, pode variar de acordo com a configuração feita. (Podem ser usados o tela de parâmetro do Multiclube (Tipo Débito e Crédito) ou Tipo DC do cadastro TipoDC x CNPJ)
O Lançamento na conta do Hóspede feito pelo multiclube na coluna documento é gravado com MC-S (Multiclube Saldo)
O Comportamento ao buscar do saldo Multiclube é zerar o saldo do multiclube, quando é feito esse lançamento na conta, porém não ocorre o encerramento da conta.
Com esse lançamento feito os dados de extrato continuam aparecendo normal.
Na tela de extrato de conta ainda temos 2 totais : Total reserva + total Multiclube.
O total geral representa o valor que o hóspede tem em aberto até o momento.


Segue abaixo , tela de extrato de conta :

*Buscar saldo de consumo do Multiclube + Lançamento na conta
A função de buscar saldo tem por finalidade , buscar o valor total de consumo da conta no multiclube e fazer o valor desse lançamento ser gravado na conta do hóspede.

*Encerramento das contas no multiclube
Essa funcionalidade tem por finalidade encerrar a conta no multiclube, mediante o encerramento de uma conta de hóspede ou avulsa. Outro momento que pode ocorrer é no liberar UH.
Caso o hóspede possua saldo em aberto no multiclube , o sistema exibe uma mensagem solicitando ao hóspede para buscar o saldo , antes do encerramento.(Essa mensagem serve para encerramento de conta e Liberar UH)
As contas do multiclube não aceitam ser encerradas com saldo na conta do multiclube.
Encerrando as contas do multiclube o Hóspede não pode fazer consumo pelo multiclube.
Em caso de Liberar UH é feita uma mensagem se deseja liberar pulseira ou não.
Nesse processamento inclui o processo de desassociação entre o hóspede e a pulseira feita no multiclube.



Endereço SOAP Hotel
URL do Hotel de integração entre VHF e Multiclube.
Endereço SOAP Ticket
URL do Ticket de integração entre VHF e Multiclube.
Tipo Débito e Crédito
Informação do oriunda do cadastro de Tipo débito Crédito.
Esse é o tipo DC é usado na integração, para ser lançado na conta do hóspede para buscar o saldo. Essa configuração é usada quando não existe cadastro na tela TipoDC x CNPJ, ou quando um CNPJ não é encontrado nessa tabela.
Código do Cliente
Código do Cliente é passado pelo multiclube, identificação interna do multiclube para o cliente
Chave Bilhete
A chave do bilhete é responsável por buscar os dados do bilhete. Essa funcionalidade ocorre no momento do check-in.
Nome Hotel Origem
Descrição do Hotel (Não utilizado)
Categoria Cliente
A categoria do cliente é responsável pelo o cadastro do cartão consumo .
Motivo Estorno (Não utilizado em caso de Integração Multiclube)
Cadastrar na tabela motivo VHF.
Conta Multiclube Ventilação (Não utilizado em caso de Integração Multiclube)
Essa conta é responsável por receber os dados enviados da ventilação do multiclube.
Essas conta é usada para receber os dados do multiclubes , pela tela Busca lançamentos não enviados MC.
Tipo DC – Débito Desconto Diária (Não utilizado em caso de Integração Multiclube)
Parâmetros de Configuração
Enviar Pagamento
Busca saldo das pulseiras no momento da auditoria.
Lançar somente Diária – sem café e pensão (Não utilizado em caso de Integração Multiclube)
Ao lançar diária na auditoria , com essa flag marcada será descontado os valores das ventilações feitas.
Permite Estorno (Não utilizado em caso de Integração Multiclube)
Essa informação sendo habilitada , caso a diária seja zero , será lançado na conta do hóspede , um lançamento com o Tipo DC cadastrado na tela de cadastro de ventilação
Funcionalidade Cartão Pulseira
Essa configuração é responsável pela forma leitura e gravação da pulseira no momento da reserva.
No momento tenho 3 opções :
0 – SmartReader Leitura
Usado quando possui pulseira sem NFC ou RFID.
Essa opção usa a leitura da smartreader.dll. (a mesma usada no cartão consumo)
1 – SmartReader Leitura + NFC Leitura e Gravação (Descontinuado)
Essa opção usa 2 formas de leitura . Temos a leitura da smartreader.dll e NFC (essa é feita pela multiclubeinterop.dll do multiclube).
O sistema faz as 2 leituras para que funcione o cartão consumo.
A NFC gravação é feita por que com essa opção , multiclube gera uma chave para ser gravada no chip do NFC.
2 – Smartreader + NFC Leitura (MultiClube sem retorno)
Essa opção usaremos somente a leitura NFC e SmartReader .
Com essa opção não teremos nenhum retorno vindo do multiclube.
Caso utilize NFC instalar :

Esses são alguns pacotes necessários para que funcione a leitura e gravação do NFC.
É necessário usar o registraMultiNFC.Bat, (validar se os diretórios estão corretos)


Cadastro de TipoDC x CNPJ
Essa tela é acessada pelo botão – Busca Saldo – TipoDC CNPJ
Esse cadastro deve corresponder exatamente aos dados que vão aparecer no XML, onde são buscados os saldos.
Essa tela é responsável por fazer a associação entre o TipoDC x CNPJ.
Esse tipo DC associado é o lançado na conta do hóspede.



Troca ou Perda de Pulseira
Essa tela em caso do hóspede , querer trocar a pulseira por algum defeito ou perda física da pulseira.
Ao escolher a UH (essa deve está check-in) ou número da reserva.
Deve selecionar a linha da pulseira desejada a cancelar , manualmente ou em caso de querer localizar pela pulseira , pode usar o botão localizar e depois pegue a pulseira nova e clique no trocar.
Em caso a conta possui saldo exibe a mensagem na tela , solicitando usar o busca saldo para depois cancelar.
A opção de cancelar pulseira somente, somente faz o cancelamento.



Logs Integração VHF + VHFCaixa + Multiclube
Todas as operação que são feitas por integração ente os sistemas , a comunicação é feita por arquivos XMLs. Todos esses arquivos são guardados em log.
Para exibir as mensagens exibidas nas requisições entre o VHF e VHFCaixa em relação ao Multiclube foram criados logs.
No caminho : Sistema -> Utilitários -> Multiclubes -> Log MultiClubes XML

Na coluna campo pesquisa existe todas colunas para serem filtradas
Essa tela permite usar a opção fazer filtro sobre filtro.
A opção cancelar filtro , desfaz todos os filtros.
O Primeiro grid exibe a lista de logs de acordo com o filtro realizado.
O Campo dados é o texto usado de envio e recebimento.
No caso no primeiro grid temos o NomeApi que as requisições feitas pelo VHF e VHFCaixa.
As requisições feitas são descritas com o nome de "Before" + nome API (informação preenchida na coluna nomeapi)
O retorno das API tem o nome "After" + nome API. (informação preenchida na coluna nomeapi)

Log Saldo Auditoria
Em relação ao Busca Saldo temos a opção de ser feito pela auditoria.
Nesse log exibimos se tinha saldo e o Lançamentos front efetuado.
Ao fazer o Busca saldo e criado um novo lançamento na conta , a coluna documento fica preenchida com o valor MC-A(multiclube auditoria).
Esse busca saldo somente é cria um novo lançamento na conta em caso do saldo ser negativo.
No log de Busca saldo , em uma única funcionalidade conta , são feitas 3 chamadas :
Requisição :
GetConsumption (Buscar o Saldo)
GetBalance (Busca saldo novamente)
Pay (Zerar o saldo contido no multiclube)



Ventilação das Pensões
Essa funcionalidade é uma opção onde é possível separar as pensões incluídas no valor da diária.As pensões são definidas na orçamento reserva. A ventilação é feita antes da auditoria , logo antes do lançamento da diária. Essa ventilação possui uma sequencia CAJB (café-almoço-jantar-bilhete). A cada execução é feito um lançamento na conta do hóspede correspondente a pensão , dessa forma quando lançar a diária , o valor da mesma , deve ser subtraído o valor de todos as refeições lançadas .

Essa tela é responsável configurar , quais ventilações serão feitas e fazer um associação ao tipo débito e crédito a ser utilizado. Importante nessa tela é a associação entre o tipo de ventilação e as pensões do VHF.
Solicito que não utilize a meia opção como M(Meia) , pois dessa forma o sistema não sabe reconhecer se é de almoço o jantar, nesse caso é interessante usar sempre a opção A (almoço) ou J (Jantar).
Ter cuidado com preenchimento da Faixa etária , as pensões não podem ter ventilações onde os intervalos entre eles tenham períodos em comum.


Tela de Parâmetro

Endereço SOAP Hotel
URL do Hotel de integração entre VHF e Multiclube.
Endereço SOAP Ticket
URL do Ticket de integração entre VHF e Multiclube.
Tipo Débito e Crédito
Informação do oriunda do cadastro de Tipo débito Crédito.
Esse é o tipo DC é usado na integração , para ser lançado na conta do hóspede para buscar o saldo.
Código do Cliente
Código do Cliente é passado pelo multiclube, identificação interna do multiclube para o cliente
Chave Bilhete
A chave do bilhete é responsável por buscar os dados do bilhete . Essa funcionalidade ocorre no momento do check-in.
Nome Hotel Origem
Descrição do Hotel (Não utilizado)
Categoria Cliente
A categoria do cliente é responsável pelo o cadastro do cartão consumo .
Motivo Estorno
Cadastrar na tabela motivo VHF.
Descontinuado.
Conta Multiclube Ventilação
Essa conta é responsável por receber os dados enviados da ventilação do multiclube.
Essas conta é usada para receber os dados do multiclubes , pela tela Busca lançamentos não enviados MC.
Tipo DC – Débito Desconto Diária
Descontinuado.
Parâmetros de Configuração
Enviar Pagamento
Busca saldo das pulseiras no momento da auditoria.
Lançar somente Diária – sem café e pensão
Ao lançar diária na auditoria , com essa flag marcada será descontado os valores das ventilações feitas.
Permite Estorno
Essa informação sendo habilitada , caso a diária seja zero , será lançado na conta do hóspede , um lançamento com o TipoDC cadastrado na tela de cadastro de ventilação
Forma Busca Saldo
Essa configuração é responsável por informar a forma que busca saldo de uma conta no multiclube. Existem 2 opções :
Único tipo dc
Com essa configuração a integração com o multiclube busca o saldo e ao lançar na conta do hóspede é usado o TipoDC configurado Tipo Débito e Crédito.
Associação
Com essa configuração a integração com o multiclube busca o saldo , nesse momento busca os valores e os CNPJ da empresa . A partir dessas informações , o CNPJ é pesquisado no sistema . O cadastro dos CNPJ é feito na tela de associação Busca Saldo Tipo DC x CNPJ.

Essa tela acima exibe a associação entre o tipo débito e crédito e o CNPJ. Esse tipo débito e crédito é que irá aparecer no lançamento da conta. Na coluna documento do lançamento da conta é exibido o CNPJ da empresa associada. Caso não encontre o CNPJ será lançado o tipo débito e crédito da tela de parâmetro.
Somente com essa opção habilitada o botão de Busca saldo TipoDC x CNPJ.
Funcionalidade Cartão Pulseira
Essa configuração é responsável pela forma leitura e gravação da pulseira no momento da reserva.
No momento tenho 3 opções :
0 – SmartReader Leitura
Essa opção usa a leitura da smartreader.dll. (a mesma usada no cartão consumo)
1 – SmartReader Leitura + NFC Leitura e Gravação
Essa opção usa 2 formas de leitura . Temos a leitura da smartreader.dll e NFC (essa é feita pela multiclubeinterop.dll do multiclube).
O sistema faz as 2 leituras para que funcione o cartão consumo.
A NFC gravação é feita por que com essa opção , multiclube gera uma chave para ser gravada no chip do NFC.
2 – SmartReader + NFC Leitura (MultiClube sem retorno)
Essa opção usaremos somente a leitura NFC e SmartReader .
Com essa opção não teremos nenhum retorno vindo do multiclube.

Lançamento de Saldo por arquivo
Caminho
Sistema -> Utilitários -> Multiclubes -> Lançamento de Saldo por arquivo
Esse processo é usado em caso de falta de lançamento em conta.
O lançamento é feito na conta do hóspede principal.
O tipo DC usado é que na configuração do parâmetro do Multiclubes(Sistema - > Utilitários->Multiclubes -> parâmetros ).
Essa tela surgiu como Emergencial em caso de falta de pagamento.

As configurações do arquivo são passados na segunda mensagem , é importante validar essa configuração do arquivo.
O valor total usado nesse arquivo é o que será usado na conta.

O Usuário garantido a configuração acima , é confirmando a pergunta a seguir é iniciado o processo.


Enviar Pagamento Ventilação
Essa opção no menu multiclube foi criada , por que foi verificado que sistema ao buscar saldo pelo VHFCaixa o sistema não estava fazendo o envio do pagamentos para as contas , com o valor total igual a 0.
Essa funcionalidade tem como responsabilidade buscar o saldo do multiclube e enviar pagamento(inclusive para as contas com saldo 0).
O Pagamento com saldo igual a zero é realizado para que os cupons das ventilações(café , almoço e jantar) feitas sejam impressos

Visão de API do Multiclube

Visão Tabelas