🔎 Visão Geral
A Tela de Integrações é o ponto central dentro do Paytrack para:
- Consultar o histórico de integrações;
- Realizar reprocessamentos;
- Acompanhar o status das solicitações integradas com sistemas externos (ERP, APIs, etc).
👥 Quem tem acesso?
O acesso à tela de integrações é restrito e controlado por grupo de permissões. Apenas usuários que fazem parte de grupos com a permissão ativa poderão visualizar e interagir com a funcionalidade.
A permissão pode ser concedida:
- Diretamente ao perfil administrador;
- Ou por meio da criação de grupo de permissão específicos para usuários que necessitam acesso.
⚠️ Importante: É necessário adicionar todas as empresas ao grupo de permissão selecionado. Caso contrário, as pendências de integração das empresas que não estiverem vinculadas a esse grupo não serão exibidas na tela de integrações.
⚙️ Permissões necessárias:
📍 Como acessar a tela de integrações?
Caminho:
Menu → Gestão → Integrações
🖥️ Sobre a Tela
Ao abrir a tela, será exibida inicialmente a aba Geral, com os registros de integração em situação pendente, devido a um filtro padrão já aplicado.
A tela é composta por duas abas principais:
- Geral
- Configurações
📁 Aba "Geral" – Consulta de Logs de Integração
Nesta aba são listados todos os registros de log, contendo informações de sucesso ou falha das integrações realizadas.
🔍 Filtros de Pesquisa
Os filtros têm como objetivo facilitar a busca e análise dos registros de integração.
Filtro Origem
Permite filtrar logs pela origem da integração, como:
- Relatório (ex: integração financeira)
- Fatura (ex: fatura conciliada)
Filtro Integração
Filtra por tipo de integração, geralmente relacionada ao tipo de pagamento no Paytrack.
Exemplo: Integrações de reembolso podem estar vinculadas ao tipo de pagamento "Despesas do colaborador".
⚠️ Importante: Consulte o analista responsável para validar quais tipos estão sendo utilizados.
Filtro Situação
Filtra pela situação atual do registro:
- Sucesso
- Falha
- Pendente
- Cancelado
- Concluído manualmente
Filtro Período
Filtra os registros por intervalo de datas (início e fim) da integração.
Outros filtros
- Unidade de Negócio
- Fluxo
Esses filtros são funcionais, mas menos utilizados. O uso mais comum ocorre por relatório, integração, situação e período.
🔘 Botões da Tela de Filtros
- Adicionar Filtro: Insere novos filtros na consulta.
- Pesquisar: Executa a consulta com os filtros aplicados.
- Limpar: Remove os filtros aplicados.
Os filtros padrão (Origem e Integração) são mantidos mesmo após limpar.
🧾 Grid de Logs
O grid(tabela) apresenta os registros de integração com as seguintes informações:
- Código: código do relatório ou fatura, conforme a origem do registro;
- Descrição: descrição do relatório ou fatura;
- Integração: tipo de integração executada;
- Situação: status atual do registro;
- Último Log: data e hora da última execução da integração;
- Ações: botões para realizar ações no registro;
- Visualização do Log: botão entre último log e ação para acessar o histórico detalhado da integração.
📜 Histórico de Log de Integração
Clicando no botão entre as colunas “Último log” e “Ação” irá abrir uma nova tela, clicando em “Mais detalhes”, é possível visualizar:
- Mensagem de retorno;
- Payload enviado;
- Detalhes da requisição e resposta da integração.
🛠️ Botões de Ações
Os botões de ação permitem interagir diretamente com o registro de integração:
- Reintegrar
Retorna o registro para a situação Pendente, permitindo uma nova tentativa de integração. - Concluir Manualmente
Finaliza a pendência de integração, marcando o registro como Concluído Manualmente, impedindo novas tentativas automáticas. - Cancelar
Cancela definitivamente a pendência de integração, alterando a situação para Cancelada.
⚙️ Aba "Configurações"
Essa aba permite o gerenciamento de informações fixas da integração, oferecendo mais autonomia ao cliente, sem necessidade de suporte técnico para alterações.
Exemplos de configurações possíveis:
- Credenciais de API (usuário/senha);
- URLs e endpoints de integração;
- Parâmetros fixos utilizados nas integrações.