Tutorial de Integrações - ChipWeb Manual

Bem-vindo ao Tutorial de Integrações!

Nesta seção, você aprenderá como integrar dados de sistemas externos com o ChipWeb-VoyAGE. As integrações permitem sincronizar informações de fornecedores, bilhetes, passageiros e reservas de forma automática e eficiente.

💡 O que você vai aprender:

Como acessar o módulo de Integrações
Como filtrar dados por fornecedor e período
Como integrar por Bilhete, Localizador, Pax ou Venda
Como visualizar resultados de integração
Como monitorar ocorrências de integração
Como resolver problemas de integração
Como agendar integrações automáticas
Como gerar relatórios de integração

Conceitos Básicos de Integrações

O que é Integração?

🔗 Definição

Integração é o processo de sincronização de dados entre o ChipWeb-VoyAGE e sistemas externos (fornecedores, GDS, APIs). Permite atualizar automaticamente informações de bilhetes, reservas e passageiros.

✨ Benefícios

• Sincronização automática de dados
• Redução de erros manuais
• Economia de tempo
• Rastreamento de ocorrências
• Relatórios detalhados

Tipos de Integração

🎫 Por Bilhete

Integra dados baseado no número do bilhete. Ideal para sincronizar informações de bilhetes específicos.

Exemplo: Bilhete 0012345678901

📍 Por Localizador

Integra dados baseado no localizador de reserva. Sincroniza todas as informações relacionadas à reserva.

Exemplo: Localizador ABC123

👤 Por Pax (Passageiro)

Integra dados baseado no passageiro. Sincroniza todas as reservas e bilhetes do passageiro.

Exemplo: João Silva

💰 Por Venda

Integra dados baseado na venda. Sincroniza todas as informações financeiras da venda.

Exemplo: Venda #12345

Campos Principais

🏢 Fornecedor

Sistema externo de origem dos dados (GDS, API, Sistema de Fornecedor).

Exemplo: Amadeus, Sabre, Galileo

📅 Emissão

Data de emissão do bilhete ou data da reserva. Usado para filtrar dados.

Exemplo: 14/01/2026

📋 Tipo da Reserva

Categoria da reserva (Corporativo, Lazer, etc). Define como os dados serão processados.

Exemplo: Corporativo, Lazer, Grupo

💡 Dicas Úteis

✅ Escolha o tipo de integração mais apropriado para seu caso
✅ Sempre especifique o período (data de emissão) para filtrar dados
✅ Verifique o fornecedor antes de integrar
✅ Monitore as ocorrências após cada integração
✅ Mantenha um histórico de integrações para auditoria
✅ Agende integrações em horários de baixo uso do sistema

Passo a Passo para Integrar Dados

Siga os passos abaixo para realizar uma integração bem-sucedida.

Etapas da Integração:

1

Acesse o Módulo de Integrações

No menu lateral, clique em "Rotinas" → "Integrações"
2

Selecione o Fornecedor

Escolha o sistema externo de origem dos dados (Amadeus, Sabre, etc)
3

Especifique a Data de Emissão

Defina o período que deseja integrar (data inicial e final)
4

Escolha o Tipo de Integração

Selecione entre: Bilhete, Localizador, Pax ou Venda
5

Defina o Tipo da Reserva

Selecione a categoria (Corporativo, Lazer, etc)
6

Clique em "Buscar"

O sistema buscará os dados que correspondem aos critérios
7

Revise os Resultados

Verifique a tabela de resultados com os dados encontrados
8

Clique em "Integrar"

Confirme a integração dos dados no sistema
9

Aguarde a Confirmação

O sistema processará a integração e exibirá mensagem de sucesso
10

Verifique as Ocorrências

Monitore a seção de ocorrências para verificar se há problemas

⚠️ Atenção Importante

⚠️ Verifique sempre os dados antes de integrar
⚠️ Não integre dados duplicados
⚠️ Respeite os limites de integração por período
⚠️ Monitore as ocorrências após cada integração
⚠️ Faça backup antes de integrações em massa
⚠️ Integre em horários de baixo uso do sistema

Monitoramento e Ocorrências

Acompanhe o status das integrações e resolva problemas através do monitoramento de ocorrências.

Resultado de Busca

📊 Tabela de Resultados

Exibe todos os registros encontrados que correspondem aos critérios de busca.

Colunas principais:

• Numerador: ID do registro

• Localizador: Código de reserva

• Bilhete: Número do bilhete

• Nome do Passageiro: Identificação do pax

• Tipo: Categoria da reserva

• Trechos: Segmentos da viagem

• Tarifa: Valor da tarifa

• Outros Valores: Taxas, emolumentos, etc

• Saldo: Saldo financeiro

Ocorrências Sistêmicas

⚠️ O que são Ocorrências?

Ocorrências são eventos registrados durante o processo de integração. Podem ser avisos, erros ou informações importantes.

📝 Tipos de Ocorrências

• Erro: Problema que impediu a integração
• Aviso: Situação que requer atenção
• Informação: Dados importantes sobre o processo
• Sucesso: Integração realizada com êxito

🔍 Colunas de Ocorrências

• Descrição: Detalhes da ocorrência
• Usuário: Quem realizou a ação
• Criação: Data e hora do evento

Como Resolver Problemas

🛠️ Passos para Resolver

1. Verifique a seção de Ocorrências
2. Identifique o tipo de erro
3. Analise a descrição da ocorrência
4. Corrija os dados se necessário
5. Tente integrar novamente
6. Registre o problema se persistir

📋 Erros Comuns

• Dados Duplicados: Registro já existe no sistema
• Formato Inválido: Dados não estão no formato correto
• Fornecedor Indisponível: Sistema externo offline
• Permissão Negada: Usuário sem acesso
• Timeout: Integração demorou muito

💡 Boas Práticas

✅ Revise sempre as ocorrências após integrar
✅ Mantenha um log de todas as integrações
✅ Resolva problemas imediatamente
✅ Comunique erros críticos ao suporte
✅ Faça testes com pequenos volumes primeiro
✅ Documente procedimentos de integração
✅ Agende integrações automáticas quando possível

❓ Perguntas Frequentes

Qual é a diferença entre integrar por Bilhete vs Localizador? +

Bilhete integra dados de um bilhete específico. Localizador integra todos os bilhetes relacionados à reserva. Use Bilhete para dados pontuais e Localizador para sincronizar toda a reserva.

Posso integrar dados históricos? +

Sim, você pode integrar dados de qualquer período especificando as datas de emissão. Porém, respeite os limites de volume por integração.

O que fazer se a integração falhar? +

Verifique a seção de Ocorrências para identificar o erro. Corrija os dados se necessário e tente novamente. Se o problema persistir, contate o suporte.

Posso agendar integrações automáticas? +

Sim, o sistema permite agendar integrações automáticas em horários específicos. Consulte o administrador do sistema para configurar.

Como monitorar o progresso de uma integração? +

Verifique a tabela de resultados para ver quantos registros foram encontrados. Após clicar em "Integrar", o sistema exibirá o progresso e resultado final.

Posso integrar dados de múltiplos fornecedores? +

Sim, mas você precisa fazer uma integração por fornecedor. Selecione um fornecedor, complete a integração, e depois repita para outro fornecedor.

O que significa "Tipo da Reserva"? +

Tipo da Reserva define a categoria (Corporativo, Lazer, Grupo, etc). Isso afeta como os dados serão processados e quais regras serão aplicadas.

Há limite de registros por integração? +

Sim, há limites para não sobrecarregar o sistema. Se você precisa integrar muitos registros, divida em múltiplas integrações com períodos menores.