Histórico da Página
| Âncora | ||||
|---|---|---|---|---|
|
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
requisito :Cliente deve possuir acesso ao plug-in do multiclube.
As faixas etárias não podem sobrepor umas as outras(definir bem os períodos de adulto e criança)
Todos os valores devem este preenchidos , não pode está vazio.
Ventilação
O processo de ventilação é basicamente "abrir" todos os lançamentos que estão contidos dentro de uma diária e fazer o lançamento de cada "parte" que forma a diária, onde cada lançamento que compõe esse valor de diária deve ser enviado ao Multiclube.
Internamente esse processo é executado em 2 momentos :
processo 1 – A integração separa todos os valores a serem gerados lançamentos na conta do hóspede.
Processo 2- O VHF recebe as informações do processo 1 , e envia para a conta do hóspede e faz o envio para o Multiclube.
Esses lançamentos são enviados para a pulseira do hóspede principal, ou caso não seja enviada para essa conta do hóspede tem a opção de enviar para uma conta avulsa cadastrada no multiclube.
A identificação desse lançamento informando que não foi enviado ao multiclube é "MC-V-N" na coluna documento. Em caso do envio sendo feito aparece na coluna documento o nome "MC-V" + Código da pensão a ser feito + versão do plug-in.
No caso o valor da diária é formado pelos valores de diária + pensão + bilhete (diária + café + almoço + jantar + Bilhete). O valor completo da diária o sistema possui gravado na tabela orçamento reserva.
O valor da diária a ser lançado é subtraído pelo somatório dos valores das "partes" que formam o lançamento da diária.(Esse processo ocorre no momento da auditoria)
A ventilação ocorre somente nas reservas que estão check-in e os hóspedes que possuem pulseira liberada para uso, ou seja, contas avulsas não são usadas.
As ventilações obedecem uma sequencia : CAJB. (C=café | A=Almoço | J=Jantar | B=Bilhete )
O processo de ventilação é feito depois da auditoria com as pensões de café e almoço.(na madrugada)
No fim do dia antes de rodar a auditoria para encerramento do dia , processar janta e bilhete.
Configurações para Ventilação
Caminho :
Sistema > Utilitários -> Multiclube> 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 (Não usado na ventilação)
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 (Não usado na ventilação)
Código do Cliente é passado pelo multiclube, identificação interna do multiclube para o cliente
Chave Bilhete (Não usado na ventilação)
A chave do bilhete é reponsável por buscar os dados do bilhete. Essa funcionalidade ocorre no momento do check-in.
Nome Hotel Origem (Não usado na ventilação)
Descrição do Hotel (Não utilizado)
Categoria Cliente (Não usado Na ventilação)
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 (Não usado na ventilação)
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 (Não utilizado na ventilação)
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.
Cadastro dos itens de ventilação
Caminho :
Sistema > Utilitários -> Multiclube> parâmetro -> clicar no botão ("Cadastro itens de ventilação")
A tela de cadastro de ventilação , é onde VHF irá receber qual Tipo DC será gravado no lançamento da conta do hóspede.
Cada cadastro deve corresponder a um tipo de ventilação , atualmente temos 4 tipos de ventilação : C=Café A=Almoço J=Jantar e B=Bilhete . Onde cada tipo de ventilação deve está associado a um Pensão do VHF.
Essa Pensão VHF é buscada na orçamento reserva.(Não usar a opção de M = Meia Pensão)
Explicando cada campo :
Descrição de Item de Ventilação
Nome do item de ventilação
Idade Inicial e Idade Final
Período que corresponde a faixa etária desse item de ventilação.(Importante que essa faixa etária não pode uma sobrepor a outra)
Código Multiclubes Pensão
Esse código corresponde ao valor desse item ventilação no multiclube. Quando é feito o envio desse item para o multiclube, por esse código é feito a associação.
Tipo de Ventilação
Os tipo de pensão tem como funcionalidade classificar os itens de ventilação.
As classificações são associadas as nossas pensões + bilhete.
A = Almoço / C = Café / J= Jantar / B=Bilhete
As ventilações são feitas pelo tipo ventilação e data desejada.
Lista de Pensão VHF
A seleção da lista de pensão VHF , corresponde as pensões cadastradas na orçamento reserva . Dessa forma conseguimos informar ao sistema, a partir de que pensão do orçamento reserva será feita a ventilação.
Não usar a opção de meia pensão.
Exemplo :
A refeição Café existe em todas as pensões(opção café deve está marcada todas as opções)
A refeição almoço deve está marcado somente café e almoço.
Tipo DC
O tipo DC é responsável por informar o tipo Dc usado na conta do hóspede.
Valor ventilação Normal
Esses é o preços para os dias normais (não estão contidos o primeiro e último dia)
Esse valor será o valor do lançamento feito na conta do hóspede
Valor Ventilação (Primeiro Dia)
Esse é o preço para o primeiro dia.
Esse valor será o valor do lançamento feito na conta do hóspede
Valor Ventilação (Último Dia)
Esse é o preço para o Último dia.
Esse valor será o valor do lançamento feito na conta do hóspede
Caso o valor da diária seja igual zero:
Tipo DC Pensão Diaria zero
O tipo DC é responsável por informar o tipo Dc usado na conta do hóspede.(Caso o valor da diária seja igual zero)
Valor Pensão
Caso a diária seja zero , a ventilação será feita com esse valor.
Código Multiclubes Pensão
Caso a diária seja zero , a ventilação usará esse código multiclubes pensão.
Caso não deseja fazer o envio para o multiclube , o código Multiclubes pensão deve ser valor 1.
Processo de Ventilação
Caminho :
Sistema > Utilitários -> Multiclube> Lançamento de Pensão Check-in
Essa uma tela que utiliza as configurações de itens de ventilação, reservas check-in, orçamento reserva e suas pensões , o cadastro de hóspede e suas datas de nascimento.
É importante informar , as questões em relação aos lançamentos das ventilações :
A pensão da orçamento reserva sendo Nenhuma , não ocorre ventilação
O desconto das pensões no primeiro dia é feito por todas as pensões que correspondem a sua pensão.
No primeiro dia :
A conta somente pode fazer ventilação de Pensão ( J ) + Bilhete ( B )
No último dia :
O último dia é o complemento de pensões do primeiro dia.
Caso o dia tenha diária igual a zero :
Será feito o lançamento da pensão e caso esteja configurado será feito o estorno.
A flag Permite Ventilação tem como funcionalidade informar se terá envio para ventilação para a conta do hóspede ou não. Sendo marcada a opção de ventilação , somente depois de fazer todos os lançamentos nas contas dos hóspedes é feito o envio para o multiclube.
Seguindo essa sequência de CAJB, a auditoria somente é executada quando a última ventilação feita for a B de Bilhete. O Sistema guarda todas as ventilações feitas, com isso ao rodar a auditoria o sistema usa o valor da orçamento reserva e subtrai todas os tipos de ventilação possíveis na reserva de acordo com a pensão cadastrada na orçamento reserva.
No primeiro momento o documento desse lançamento possui o valor de MC-V-N , com essa opção dessa forma , ainda não houve o envio de dados , o lançamento sendo enviado o documento fica com o novo valor de MC-V. Dessa forma , caso não tenha conseguido enviar para o multiclube , a conta do hóspede já possui todos os lançamentos.
Toda essa operação cria um log dos dados que serão enviados ao multiclube exibe quais lançamentos são feitos na conta e temos log de desconto de diária.
Busca Lançamentos não Enviados MC
Caminho :
Sistema > Utilitários -> Multiclube> parâmetro -> clicar no botão ("Busca Lançamentos não Enviados MC")
Essa tela é responsável por enviar os lançamentos na conta do hóspede, que ainda possuem o documento com o valor de MC-V-N. Esses filtros podem ser feitos por data ou documento.
Clicando em confirmar lançamento o sistema envia esses valores para o multiclube. Esses lançamentos são enviados para o multiclube e para a conta multiclube avulsa neutra (tela de parâmetros), não mais para a conta do hóspede.
Log de ventilação de diária
Caminho :
Sistema -> Utilitários -> Multiclube -> Log de ventilação de diária
Temos o filtro para fazer a data pesquisada.
O primeiro grid corresponde as ventilações a serem feitas.
O segundo grid corresponde aos lançamentos já efetuados.
O terceiro grid corresponde aos descontos de diária feitos.
Ao clicar em Exibir ventilações pendentes, ocorre a validação se aquela linha desejada possui o lançamento feito.
Visão das API
Visão das tabelas
Import HTML Content
Visão Geral
Conteúdo das Ferramentas