Plugin Integração XML PMS Opera Back Hotal Full

CONTEÚDO

Controle de versões

VISÃO GERAL

Realização da importação dos XMLs provenientes do PMS Ópera, relativo a recebimentos à faturar, recebimentos em cartão de crédito e a contabilização da receita.

ACESSO

Acesse o módulo "FaturaHotel"

Passo	Ação	Descrição
1	Clique na label de menu "Plug-in"	O sistema exibirá o submenu com a label "Opera"
2	Clique na label de submenu "Opera"	O sistema exibirá o submenu com a label "Integração PMS Opera XML"
3	Clique na label de submenu "Integração PMS Opera XML"	O sistema exibirá a tela de integração

PARAMETRIZAÇÕES

No sistema Global CM

Acessar o Cadastro da empresa em (Sistema > Utilitários > Altera Dados Empresa Proprietária);
Na aba Configurações da Empresa Proprietária, deve ser inserido o código da Empresa no PMS Ópera;
Ao final, selecione o botão Confirmar, para salvar o registro atualizado.

No FaturaHotel

Cadastro de Tipo de Débito e Crédito

É necessário a indicação no campo Código Reduzido no cadastro de Tipo de Débito e Crédito com o código do transaction code do PMS Ópera.

ex.: Tipo de Débito e Crédito Diária

Acessar o menu cadastros > Tipo de débito e crédito;
Selecione o botão Procurar, selecione o tipo de débito e crédito Diária e e selecione o botão editar;
Indique no campo Código Reduzido o código do transaction code Diária no PMS Ópera.

Essa equivalência deve ser realizada em TODOS os tipos de debito e crédito, para garantir que erros de localização não ocorram durante a importação.

PMS Ópera	Back Hotal - Fatura Hotel

Cadastro de Cliente

É necessário a indicação no campo Código Correspondente, do cadastro de Cliente que podem ser faturados, do código equivalente do cliente no PMS Ópera.

ex.: Cliente CVC

Selecione o botão Procurar e selecione o cliente e selecione o botão editar;
Acessar o menu cadastros > Clientes > Dados do Cliente > Dados Gerais;
Indique no campo Cód. Correspondente o código do cliente no PMS Ópera.

PMS Ópera	Back Hotal - Fatura Hotel

Essa equivalência deve ser realizada em TODOS os clientes, para garantir que erros de localização não ocorram durante a importação.

No Contas a Receber

Cadastro de Tipo de Documento

Se o desejo é possibilitar o agrupamento dos cartões importados, deve-se no cadastro do tipo de documento associado ao tipo de debito/credito dos cartões de créditos, marcar a flag que permite de forma default o agrupamento (Sempre Engloba/Parcela) ou que permita o usuário decidir (Definido pelo usuário).

No Plugin

Acessar o Plugin;
Acessar a aba Parâmetros;

Código Hotel - Conteúdo exibido em base ao que foi indicado no campo correspondente preenchido no sistema Global em Cadastro da empresa em (Sistema > Utilitários > Altera Dados Empresa Proprietária);

Tipo D/C a Faturar - Conteúdo exibido em base ao tipo de debito/credito à faturar (com a flag código para faturar marcada);

Caminho do Arquivo XML - Indicar o diretório de rede, para que a busca dos arquivos XML seja direcionada para esse caminho;

Tipo de Operação - Indicar o tipo de operação que ocorre na importação do movimento contábil, recomenda-se, criação de um especifico para facilitar a emissão de relatórios, pois essa estrutura, é filtro em muito dos relatórios contábeis. Sua criação é feita no Global em (Cadastros > Tipo de Operação). Caso ocorra erro de importação, revalide esse campo; selecione novamente o registro. Após essa revalidação a visualização desse campo poderá ser do código relacionado ao Tipo de Operação ou da descrição relacionada ao Tipo de Operação.
A RECOMENDAÇÃO É QUE SEJA UTILIZADA EM TODAS AS EMPRESAS UM TIPO DE PROCESSO CRIADO EXCLUSIVAMENTE PARA IMPORTAÇÃO XML ÓPERA, NÃO SENDO USADO OUTROS, POIS NA ROTINA DE EXCLUSÃO DO REGISTRO CONTÁBIL, PODERÁ HAVER EXCLUSÃO DE REGISTROS INDEVIDOS.

Nome do arquivo Faturamento - O plugin fará a leitura do arquivo de faturamento, dos arquivos que tiverem o conteúdo informado, conforme a estrutura do nome exportada <NOMEEMPRESA>_<DATAGERACAO>_<NOMODOARQUIVOFATURAMENTO>.XML,

Nome do arquivo Cartão de Crédito - O plugin fará a leitura do arquivo de cartão de crédito, dos arquivos que tiverem o conteúdo informado, conforme a estrutura do nome exportada <NOMEEMPRESA>_<DATAGERACAO>_<NOMODOARQUIVOCARTAODECREDITO>.XML;

Nome do arquivo Contabilidade - O plugin fará a leitura do arquivo de Contabilidade, dos arquivos que tiverem o conteúdo informado, conforme a estrutura do nome exportada <NOMEEMPRESA>_<DATAGERACAO>_<NOMODOARQUIVOCONTABILIDADE>.XML;

Inverter valores ao importar Cartão de Crédito - selecionar caso os valores de recebimentos no arquivo XML Opera, forem exportados com sinal negativo;

Sumariza Cartões de Crédito com Tipo de Débito/Crédito iguais - selecionar caso os registros no arquivo XML Opera, forem exportados sem essa sumarização;

Considerar data do arquivo para data do faturamento/lançamento - Cenário Latam, onde é necessário que a data do arquivo seja considerada a data de faturamento e lançamento e não a data de checkout;

OPERAÇÃO

A importação se dará pelo leitura 3 arquivos procedentes do PMS Ópera:

Em base a imagem da anterior da guia parâmetros, temos:

H7547_20210901_BILLS.xml - contem os registros para importação de recebimento de faturamento do dia;

H7547_20210901_CUSTOMER.xml - contem os detalhe dos clientes faturados, necessário que este arquivo esteja no mesmo diretório do arquivo BILLS.XML, pois é verificado os tipos de clientes que serão importados. A conteúdo da tag do XML "Corporate_id" é que deverá estar no campo do código correspondente;

H7547_20210901_BILLS_CARTOES - contem os registros para importação de recebimento de cartões do dia;

H7547_20210901_REVENUE.xml - contem os registros para importação de contabilização da receita do dia.

H7547 - código da empresa

20210901 - data da geração do arquivo

Em base a imagem da anterior da guia parâmetros,

Faturamento

Para a importação do faturamento, deve ser indicado o XML BILLS, no campo Faturamento. Selecione o ícone , para exibir a árvore de diretório, indique o arquivo.

Para o processamento da importação somente do recebimento à faturar, selecione o botão Processar.

No processo de importação:

01.- Realizada a leitura do código interno do Cliente no XML BILLS;

02.- deste código é feita validação no arquivo também exportado pelo OPERA, XML CUSTOMER, que deve estar junto com o arquivo XML BILLS; se é um dos tipos é apto a importação (Company, Agency travel ou Source);

03.- após, é validado se o código do cliente esta vinculado a algum cliente no cadastro de clientes do Back Hotel;

04.- na sequencia, é validado se o cliente possui contrato padrão, se não houver, valida se possui contrato normal e realiza a importação, caso contrario, retorna mensagem de erro.

05.- se houver o mesmo documento importado para o mesmo cliente, o processo de importação é abortado.

Cartão de Crédito

Para a importação do faturamento, deve ser indicado o BILLS_CARTOES, no campo Cartão de Crédito. Selecione o ícone , para exibir a árvore de diretório, indique o arquivo.

Para o processamento da importação somente do recebimento em cartão de crédito, selecione o botão Processar.

No processo de importação:

01.- Realizada a leitura do código transaction code no BILLS_CARTOES e comparado com o código reduzido no cadastro de tipo de debito e credito no Back Hotal;

02.- após validação, a importação é processada, caso contrario, retorna erro.

obs. importante ressaltar, que a importação segue a dedução da comissão do cartão de crédito e o prazo de pagamento, indicados no cadastro do cliente.

Contabilidade

Para a importação do movimento de contabilidade, deve ser indicado o XML REVENUE, no campo contabilidade. Selecione o ícone , para exibir a árvore de diretório, indique o arquivo.

Após escolha do arquivo, para a importação, selecione o botão Processar.

No processo de importação:

01.- Realizada a leitura do código transaction code no XML REVENUE e comparado com o código reduzido no cadastro de tipo de debito e credito no Back Hotal;

03.- após validação, a importação é processada, caso contrario, retorna erro.

importante que seja criado um tipo de operação especifica para essa importação, pois assim a planilha criada estará vinculada a esse tipo de operação, facilitando a retirada de relatorios (razões) e como critério na necessidade de exclusão da planilha pelo plugin.

obs. se houver uma planilha já importada na mesma data, para evitar duplicidade, será feita a exclusão, seguindo os critérios da planilha contábeis do dia do XML e que tiverem o tipo de lançamento indicado no parâmetro do plugin.

Para promover uma segurança maior em relação às integrações contábeis, no momento da importação o sistema insere a descrição XML OPERA no campo identificação individual, que esta localizado na aba Detalhes subconta plano referencial, na tela de lançamento. Desta forma quando for necessário o processo de exclusão da planilha contábil, a planilha que será apagada será aquela que tiver essa indicação.