Este manual foi elaborado para auxiliar na implantação e suporte da integração entre o site Reserve e o Protheus, com o envio dos cadastros de Participantes, Centros de Custos e Clientes e recebendo do site os pedidos de: passagem aérea, passagem rodoviária, hospedagem, locação de veículos e seguro.
1. Para que a Protheus envie os dados dos centros de custos, é necessário preencher os seguintes campos:
CTT |
---|
CTT_CODIGO |
CTT_DESC01 |
CTT_CLASSE |
CTT_BLOQ |
CTT_INTRES |
Caso sejam exportados os centros de custos que não estão na tabela CTT, utilize o ponto de entrada FA655ICC que retorna um array com os centros de custo. Cada elemento será composto por um array que deve conter as informações na seguinte ordem:
Operação | 3-Inclusão/4-Alteração/5-Exclusão |
Código | Código do centro de Custo |
Descrição | Descrição do Centro de Custo |
Aprovador | Código (no Site Reserve) do Aprovador do Centro de Custo. |
Este ponto de entrada é executado após a exportação, sendo recebido o mesmo array, com o acréscimo de uma informação para indicar o sucesso, ou não, da operação com o centro de custo.
Exemplo:
#Include "Protheus.ch"
User Function FA655ICC ()
aProcesso := ParamIXB
Acc:= {}
If Empty(aProcesso) // não foi passado ao array de processamento
//Tratativas...
Aadd( aCC ,{ nOperação, cCentro de Custo, cDescCC, cAprovador})
Else
For nX := 1 to len(aProcesso)
If aProcesso[nX][5] // Se true sucesso na operação com o centro de custo
// Tratativas
Else // Não verdadeiro a operação falhou.
// Tratativas
endif
Next nX
endif
Return aCC
? Após o envio dos centros de custos, este ponto de entrada é chamado com o array original numa nova coluna informando caso a operação tenha sido bem-sucedida (.T.), ou não (.F.).
2. Para que o Protheus envie os dados do Cliente os seguintes campos devem estar preenchidos:
SA1 |
---|
A1_COD |
A1_LOJA |
A1_MSBLQ |
3. Para que o Protheus envie os dados do Participante, os seguintes campos devem estar preenchidos:
RD0 |
---|
RD0_NOME |
RD0_EMAIL |
RD0_CODIGO |
RD0_DDD |
RD0_DDI |
RD0_SEXO |
RD0_LOGINR |
RD0_IDRESE |
RD0_EMPANT |
RD0_FILANT |
RD0_CIC |
RD0_DTNASC |
RD0_NVLCAR |
RD0_CC |
RD0_FONE |
RD0_DVIAGE |
RD0_PERMAD |
RD0_APROPC |
RD0_APSUBS |
RD0_FORNEC |
RD0_LOJA |
4. Para realizar a integração o cadastro de Códigos BKO (FINA669) os campos abaixo devem ser preenchidos:
FL2_BKOAGE | Código da empresa no sistema da agência de viagem |
FL2_BKOEMP | Código da empresa no Protheus |
FL2_USER | Usuário de conexão ao Reserve (Fornecido pela equipe Reserve) |
FL2_PSWRES | Senha de conexão (Fornecida pela equipe Reserve) |
FL2_LICENC | Nome do Licenciado Reserve |
FL2_GRPEMP | Grupo de empresa no site Reserve |
FL2_CC | Indica se o CC do custo será exclusivo ou compartilhado no site |
FL2_CLIENT | Indica se o Cliente é exclusivo ou compartilhado no site |
É necessário configurar os parâmetros abaixo:
É necessário ter o Protheus 11.80 ou superior instalado.
1. Acesse o Configurador (SIGACFG) e crie um Agent padrão para o Schedule, para isto, acesse Ambiente/Schedule. Na parte superior esquerda clique na pasta Schedule/Agent/Cadastro.
Onde:
Usuário:
Usuário que será utilizado durante a execução da rotina.
Rotina:
Informe JOBRESIMP, sendo este o job de importação de pedidos do Reserve.
Data e Hora:
Data e hora prevista para a primeira execução do job.
Ambiente:
Nome do ambiente que o job será executado.
Empresa/Filiais:
Lista de empresas e filiais que serão processadas durante a execução do job.
Módulo:
Informe sempre 06 – Financeiro
Onde:
Usuário:
Usuário que será utilizado durante a execução da rotina.
Rotina:
Informe JOBRESEXP, sendo este o job de exportação de pedidos do Reserve.
Data e Hora:
Data e hora prevista para a primeira execução do job.
Ambiente:
Nome do ambiente que o job será executado
Empresa/Filiais:
Lista de empresas e filiais que serão processadas durante a execução do job.
Módulo:
Informe sempre 06 – Financeiro
É recomendável que o Jobs de integração sejam executados no máximo duas vezes por dia para reduzir o número de acessos ao site.
Acesse Detalhes e configure a recorrência do job de exportação de dados para o reserve, conforme o exemplo abaixo, configure as repetições diárias conforme desejado.
Com a crescente demanda por redução de custos a opção de Self Booking, em que o passageiro escolhe o voo e hospedagem, é preferência no mercado, sendo que o site Reserve é o líder neste setor, por causa das ferramentas que permitem a busca por menores tarifas e o controle da política de viagens da empresa, enquanto o Protheus mantém o controle financeiro e contábil das viagens.
A integração entre o Reserve e Protheus, é atuante no Protheus, suprindo a necessidade do contexto de negócio. Essa integração é realizada por meio de webservices do site www.reserve.com.br. O Protheus é responsável de acessar os os webservices e realizar as solicitações de informações, ou de atualização.
A integração pode ser realizada de forma on-line ou off-line. A integração on-line ocorre quando uma informação é alterada no Protheus e automaticamente é enviada para o Reserve por meio do webservice disponibilizado no site Reserve. Na integração off-line ocorre por meio de rotinas (Jobs) com execução agendada.
As integrações on-line estão disponíveis nas seguintes rotinas:
Cadastro de Centro de Custos (CTBA030)
O que a integração faz:
O que a integração não faz:
Cadastro de Participantes (APDA020)
O que a integração faz:
O que a integração não faz:
Cadastro de Clientes (MATA30)
O que a integração faz:
O que a integração não faz:
As integrações off-line são realizadas por duas rotinas, uma para a Exportação (JOBRESEXP) e outra para a Importação (JOBRESIMP). Ambas as rotinas são inseridas no Schedule do Protheus com um ambiente e empresa filial. Ao iniciar a rotin é acessada a tabela FL2 para obter a lista de empresas do Protheus que estão integradas, a seguir para cada Empresa / Filial da lista o processo de importação ou de exportação é realizado.
JOBRESEXP
O que a integração faz:
O que a integração não faz:
JOBRESIMP
O que a integração faz:
O que a integração não faz:
Pergunta: Quando os Pedidos com problemas serão reimportados ?
Resposta: Os pedido com problemas são gravados na tabela FL1, esta tabela será acessada na próxima execução da rotina de JOBRESIMP.
Pergunta: Por que os pedidos não são importados on-line?
Resposta: Como o número de pedidos pode ser grande e a gravação nas tabelas do sistema pode demorar, não foi incluída a opção on-line.
Pergunta: Como posso fazer a carga inicial dos cadastros?
Resposta: Atualize as versão do Protheus, ative os parâmetros de integração, configure o Schedule de exportação que o sistema exportará os cadastros automaticamente na próxima execução do job de exportação.
Informações não foram exportadas para o Reserve.
Pedidos não foram recebidos.
Email não foram enviados.