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 parametro de forma de busca saldo deve ser Associação Débito/Crédito (Parametros do Multiclube)
Funcionalidades do cartão ou pulseira deve ser configurada (0 ou 2)
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 parametros 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 pulseria 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ópede 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.
Configurações Integração Vhf + VHFCaixa + 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 é reponsá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 – Tipo DC 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çao 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)
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 subtraido o valorde 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 é reponsá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 tipo dc 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 tipo dc 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.