Vetor Web - Integrações

A tela "Integrações" no Vetor Web proporciona o controle completo de todas as integrações realizadas entre o sistema Vetor e outros sistemas catalogados no banco de dados. Seu principal objetivo é fornecer um gerenciamento flexível e completo, com níveis de permissão ajustáveis conforme o perfil do usuário. Dessa forma, é possível cadastrar, editar, visualizar e monitorar as integrações conforme as permissões atribuídas. Além disso, o usuário pode acompanhar a execução das integrações em tempo real e baixar os arquivos gerados durante o processo. 

O sistema também possibilita a configuração detalhada de cada tipo de integração, assegurando que cada processo seja personalizado e adequadamente adaptado às necessidades específicas da operação. Atualmente, a Zetti Tech oferece aos seus clientes a oportunidade de integração com mais de 20 opções de integração com sistemas parceiros, são elas:

Neste artigo, vamos mostrar como realizar a integração com essas plataformas. Confira os passos a seguir:

Pré-requisitos

1. Para o procedimento de cadastro de uma nova integração, é fundamental que o cliente tenha contratado o serviço com a empresa fornecedora  do sistema desejado. Após a contratação do serviço, o cliente receberá os parâmetros de configuração que permitirão a integração entre os sistemas. Além disso, o cliente deverá adquirir a funcionalidade de integração junto à Zetti Tech, entrando em contato com a equipe comercial para as tratativas necessárias. Com os parâmetros de configuração em mãos e após a contratação da funcionalidade, um agente da equipe de Suporte da Zetti será responsável por realizar o cadastro e a configuração adequada dos parâmetros de integração entre os sistemas.

Permissões de usuários

1. Os "Agentes de Suporte da Zetti Tech" possuem permissões administrativas para todas as funcionalidades oferecidas pela tela, no entanto, com foco nos processos de cadastros, alterações cadastrais, visualização de todas as integrações e funcionalidades relacionadas a este processo.
2. Os "Clientes" têm permissões voltadas especificamente ao gerenciamento de suas integrações. Eles podem visualizar os cadastros, baixar arquivos gerados pelas integrações, acessar os logs da integração e forçar manualmente, com base em um intervalo de datas, a execução de determinadas integrações, incluindo: Dito, Audit, Smarket, Propz, LinkedFarma (Gruppy), ScannTech, IQVIA API, Trivio e Proffer. 
   
   

   O cliente pode enviar para processamento, informações de vendas retroativas de até 31 dias por processamento, desde que utilize uma das integrações para as quais esse recurso está disponível: Dito, Audit, Smarket, Propz, LinkedFarma (Gruppy), ScannTech, IQVIA API, Trivio e Proffer. Caso o cliente opte por solicitar que o procedimento seja realizado pela equipe da Zetti Tech, mesmo havendo autonomia para execução diretamente pelo sistema, o atendimento será prestado mediante contratação de serviço, conforme estabelecido em proposta comercial.

Como acessar

1. Realize o login no Vetor Web;
2. Acesse o menu lateral: Cadastro >> Parâmetros do sistema >> Integrações.

Ao acessar a tela, o agente de suporte poderá acompanhar o primeiro passo, que oferece instruções sobre como cadastrar integrações com base nos tipos catalogados no banco de dados, visualizar e alterar os cadastros existentes e conforme necessário, acompanhar as etapas do passo seguinte. Já o cliente pode clicar aqui para avançar para o segundo passo, onde receberá as orientações necessárias para o gerenciamento de suas integrações.

1º Passo - Cadastro e Alteração de integração

• Cadastro

O cadastro de integração é flexível, adaptando-se às necessidades específicas de cada integração. Para cadastrar uma nova integração, comece clicando no botão "Cadastrar integração", localizado no canto superior direito da tela.

A seguir, preencha o campo "Descrição", com um nome que identifique claramente a integração a ser cadastrada. É recomendável inserir um nome que descreva a função ou o tipo de dados da integração, para facilitar a localização do cadastro no sistema.

Ao lado, selecione o tipo de integração. Esse tipo é catalogado no banco de dados e pode representar diferentes sistemas ou processos com os quais a integração será realizada. 

No campo "Situação" defina o status atual da integração, ou seja, se a execução da integração estará ativa ou inativa após o cadastro. O status proporciona o controle sobre quando a integração será executada.

A seguir, informe no campo "Intervalo tarefa (minutos), o tempo que será considerar para a execução das integrações. Ou seja, defina o intervalo, em minutos, entre cada execução da integração, ajustando o sistema para realizar a tarefa de integração de acordo com a periodicidade especificada.

Na seção "Filiais", selecione as filiais específicas para as quais a integração será aplicada. A escolha das filiais permite que o processo de integração seja realizado de maneira personalizada para diferentes unidades, garantindo que a integração atenda às necessidades específicas de cada filial. 

Caso a integração envolva todas as filiais, é possível selecioná-las simultaneamente. Para isso, marque o campo "Nome", assim, todas as filiais serão selecionadas.

Por outro lado, para localizar mais facilmente as filiais de interesse na lista, é possível reordená-la em ordem crescente ou decrescente. Para isso, basta clicar na seta "" ao lado do campo "Nome", que mudará de orientação conforme seleção, indicando a ordem de exibição da lista. Se preferir exibir na lista apenas as filiais de interesse, clique no ícone de filtro "" para visualizar o menu de opções em tamanho reduzido, assim, basta marcar as filiais de interesse e clicar em "Ok" para aplicar. Ao fazer isso apenas as filiais marcadas serão reveladas.

Após definir as informações iniciais, a próxima etapa é realizada na aba "Configurações", onde é possível configurar os parâmetros necessários para a execução das integrações, de acordo com o tipo de integração selecionado. Nessa etapa, o agente deve fornecer os "Valores" para as "Chaves" correspondentes. Para fazer isso, na coluna "Valor", clique na linha referente a "Chave" que deseja configurar e insira o valor correspondente. Essa informação é fornecida ao cliente pela empresa após a contratação do sistema de integração.

Integração Proffer

A configuração dos parâmetros que habilita a integração com a Proffer utiliza um valor de chave padrão. Para consultar quais são,  clique aqui (visualização disponível apenas para agentes Zetti Tech).

Uma vez habilitada, a integração ocorre automaticamente todos os dias. Seguindo o seguinte processo principal:

1. Envio diário de arquivos: O sistema transmite para a Proffer os dados cadastrais dos produtos, bem como as movimentações de venda (sell-in/sell-out).
2. Recebimento de preços sugeridos: A Proffer devolve as recomendações de preços para todos os produtos enviados.
   1. Essas informações ficam disponíveis na tela Alteração de Preço/Oferta (Vetor Farma). Nessa tela, um novo botão será exibido (ativado pela integração), permitindo que o usuário:
      • Defina o período de consulta dos retornos de preços;
      • Selecione a zona de preço, isto é, o grupo de lojas que receberá as recomendações;
      • E, por fim, realize a atualização dos preços conforme a necessidade.

Integração Boavista

A configuração dos parâmetros da integração com a Boavista requer o preenchimento da Chave de Acesso e da Chave Secreta, informações fornecidas pela integradora. Após a habilitação, a integração ocorre diariamente e de forma automática. O fluxo de integração entre o sistema Vetor Farma e o sistema Boavista para conciliação de vendas segue as etapas abaixo:

1. Envio de vendas:
   O sistema Vetor Farma envia as informações das vendas realizadas para a Boavista por meio de integração direta via aplicação de serviço.
   Esse envio ocorre a cada 4 horas, entre 4h e 20h, contemplando as vendas com D-2 (realizadas há dois dias).

2. Consulta de conciliação:
   No dia seguinte ao envio, o sistema Vetor Farma realiza uma consulta automática à Boavista, buscando o status das vendas com D-3 (realizadas três dias antes).
   Esse processo garante que as vendas enviadas no D-2 sejam retornadas com o status atualizado da conciliação, permitindo verificar e validar as transações registradas.

3. Consultas de pagamentos e vendas:
   São processadas diariamente, com execução inicial às 4h da manhã.

Para visualizar mais detalhes sobre o processo de conciliação de vendas via integração Boavista, clique aqui.

Além disso, esse tipo de integração também possui a chave de configuração "email_notificacao", que permite registrar um endereço de e-mail. Ao preencher esse campo, as notificações serão enviadas automaticamente para o e-mail informado.

Inseridas e configuradas todas as informações solicitadas na tela, salve o novo cadastro clicando em "Cadastrar".

A seguir, uma mensagem de sucesso será exibida no topo da tela e o novo cadastro será exibido na lista de integrações cadastradas.

Sempre que necessário, clique no botão de atualização "" para refletir novos cadastros/atualizações na lista.

Acompanhe no passo a seguir, como gerenciar o cadastro das integrações.

2º Passo - Gerenciamento de Integrações: consultar, alterar, executar integração, visualizar tarefas e logs 

• Consultar

Ao acessar a tela, o sistema exibirá a lista das integrações já cadastradas. Para encontrar uma integração específica, o usuário pode navegar pela lista utilizando as páginas de registro.

No rodapé da tela, em "Registros por página", perceba que os registros são inicialmente distribuídos em 10 itens por página. Quando há um maior número de registros, para facilitar a busca, é possível ajustar a quantidade de itens exibidos por página, selecionando uma das opções disponíveis: 25, 50 ou 100 itens. Outra alternativa é navegar pelas páginas utilizando as setas de navegação, localizadas ao lado de "Página 1 de ...", que indicam o número total de páginas. Clique nas setas para avançar ou retornar às páginas.

Também é possível localizar o cadastro pelo nome da integração. Para isso, digite o nome completo ou, apenas as primeiras letras no campo de pesquisa. Dessa forma, o sistema filtrará automaticamente os resultados, exibindo apenas os cadastros cujos nomes correspondam ao termo informado. Ao localizar o registro, clique duas vezes sobre ele para abri-lo diretamente ou, se preferir, clique no botão "Ações" correspondente e selecione a opção "Editar"

Ao selecionar a integração desejada, a aba de "Cadastro" será exibida permitindo que o usuário visualize os dados cadastrais da integração. 

Caso haja a necessidade de realizar algum tipo de alteração no cadastro, o usuário (cliente) deverá entrar em contato com um agente de Suporte da Zetti Tech para solicitar a alteração.

• Alterar

Conforme a necessidade do cliente e/ou da funcionalidade de integração, o agente poderá alterar qualquer informação cadastral, efetuando o preenchimento e/ou seleção dos campos conforme demonstrado no primeiro passo. Após realizar qualquer tipo de modificação, será preciso clicar no botão "Salvar" para registrar as alterações.

Além de realizar alterações, ao consultar o cadastro de uma integração o usuário também pode executar outras ações voltadas ao monitoramento e acompanhamento de processos. Confira a seguir.

• Executar integração

Ao detalhar o cadastro de uma integração, será apresentado no canto superior direito da página o botão "Executar integração", que possibilita ao usuário forçar manualmente a execução de determinadas integrações, como Dito, Audit, Smarket, Propz, LinkedFarma (Gruppy), ScannTech, IqviaAPI, Trivio e Proffer. Em outras palavras, essa funcionalidade possibilita forçar o envio de informações de vendas sempre que necessário.

O sistema permite o envio retroativo de informações de vendas para integrações com parceiros externos, com um limite de até 31 dias por processamento. Dessa forma, o próprio cliente pode executar o procedimento diretamente no sistema. O envio pode abranger qualquer período desejado, desde que seja realizado mês a mês, respeitando o limite técnico de 31 dias por envio.

Atualmente, esse recurso está disponível para as integrações: Dito, Audit, Smarket, Propz, LinkedFarma (Gruppy), ScannTech, IqviaAPI, Trivio e Proffer. Caso o cliente opte por solicitar que o procedimento seja realizado pela equipe da Zetti Tech, mesmo havendo autonomia para execução pelo próprio sistema, o atendimento será prestado mediante contratação de serviço, conforme estabelecido em proposta comercial.

Ao clicar nesse botão, será exibida uma janela auxiliar chamada "Executar integração", na qual o usuário deverá informar o período de movimentação que deseja consultar, preenchendo os campos "Data inicial mov." e "Data final mov." com as datas correspondentes.

É importante que o intervalo de datas informado não coincida com o período de uma integração que ainda esteja pendente de processamento. Do contrário, a solicitação de processamento não será concluída.

Após inserir as datas, clique em "Processar".

Se o intervalo de datas informado estiver válido, o sistema exibirá no canto superior direito da página a seguinte mensagem: "Solicitação enviada para a fila de processamento." Essa mensagem indica que a solicitação foi registrada com sucesso e que a integração será executada conforme a ordem de processamento definida pelo sistema.

Se as o intervalo de datas coincidir com o período de uma integração que ainda esteja pendente de processamento, o sistema exibirá o seguinte alerta: "O intervalo informado está em conflito com a tarefa XXX (código da tarefa), que ainda está pendente de processamento." Esse aviso tem como objetivo evitar sobreposição de execuções e garantir que as integrações sejam processadas corretamente, sem duplicidade de dados ou erros de sincronização.

Além disso, se já houver uma solicitação de processamento para a tarefa selecionada, um alerta informativo também será exibido, veja um exemplo:

Essas integrações, em geral, realizam a consulta das movimentações dentro do período informado e geram arquivos correspondentes para envio às respectivas plataformas. Após forçar a execução de uma integração, o sistema criará automaticamente uma tarefa, que será exibida na aba "Tarefas". O usuário poderá acompanhar o andamento da execução atualizando a lista de tarefas ou acessando a aba "Logs da integração", onde são apresentados os registros detalhados do processamento. Acompanhe a seguir

• Visualizar Tarefas

A aba "Tarefas", permite ao usuário consultar as tarefas executadas pelas integrações do sistema. Nessa área são exibidas todas as tarefas geradas automaticamente por processos de integração, como o envio ou a geração de arquivos para outras plataformas. Para manter a lista sempre atualizada, refletindo as solicitações de processamento, clique no botão de atualização "" sempre que necessário, enquanto a página estiver aberta.

A relação de últimos processamentos da integração apresenta as seguintes informações:

• Código e  Dt. cadastro: exibe o código de cadastro da tarefa executada pela integração, juntamente com a data e a hora em que o processamento foi realizado. Essas informações permitem verificar quando o arquivo foi gerado e ajudam a monitorar a periodicidade das execuções.
• Dt. inicial mov e Dt. final mov:  indicam, respectivamente, o intervalo de movimentações considerado no processamento da integração, ou seja, o período de dados enviados.
  Usuário: identifica o responsável pela execução/solicitação da integração, possibilitando rastrear quem iniciou o processo.
• Situação: exibe o status atual da integração que pode ser: "Pendente" de processamento, "Enviada" para indicar que o arquivo foi corretamente enviado e processado pelo sistema, "Concluída, para indicar que o processamento ocorreu com sucesso" e "Falha no envio" indicando que a integração não foi bem-sucedida e o arquivo não foi enviado corretamente. 
  

• Motivo falha: nos casos em que ocorre uma falha, esta coluna apresenta uma descrição detalhada da inconsistência, explicando as causas do erro no envio ou no processamento do arquivo. Essa informação é útil para diagnóstico e correção de problemas nas integrações.

  Clique aqui e veja um exemplo.

   

Para cada tarefa listada, o usuário pode acessar o menu de "Ações", que disponibiliza duas opções: "Reprocessar tarefa" e "Arquivos gerados".

Para localizar uma tarefa com mais facilidade, utilize o campo "Pesquisar tarefas" e digite algum caractere que faça parte das informações do registro, como por exemplo o código ou o nome do funcionário, correspondente à tarefa desejada.

• Reprocessar tarefa

Conforme a necessidade, o usuário pode solicitar o reprocessamento de uma tarefa, cuja integração não foi bem-sucedida. Para isso, o usuário pode selecionar uma tarefa com status "Falha no envio", acessar o menu de "Ações" e escolher a opção "Reprocessar tarefa".

Se já houver uma solicitação de processamento para a tarefa selecionada, um alerta informativo será exibido, veja um exemplo:

• Arquivos gerados

Para fins de backup e armazenamento, análise de dados, auditoria, entre outros motivos, o usuário poderá acionar a opção "Arquivos gerados" para visualizar e fazer o download dos arquivos gerados pelas integrações assim que o processo for concluído. 

Ao clicar nessa opção, será exibida a tela auxiliar "Arquivos gerados para a tarefa". Nessa tela, são apresentados os arquivos associados à tarefa, caso existam. O sistema disponibiliza os últimos 7 (sete)  arquivos gerados, em tempo real para que o usuário possa acessá-los imediatamente. Essa funcionalidade é essencial para a obtenção rápida dos dados provenientes das integrações, permitindo que o usuário os utilize de forma imediata.

De acordo com sua preferência, o usuário pode personalizar a visualização da lista, exibindo apenas os registros desejados. Para isso, basta clicar no ícone de filtro "" ao lado da descrição de cada coluna. Isso abrirá um menu de opções em tamanho reduzido. Em seguida, o usuário pode selecionar as opções desejadas e clicar em "Ok" para aplicar o filtro.

Para facilitar a identificação e o download do arquivo desejado, a tela auxiliar exibe as seguintes informações:

• Arquivo: identificação do arquivo.
• Situação: exibe o status atual da integração que pode ser: "Pendente" de processamento, "Enviada" para indicar que o arquivo foi corretamente enviado e processado pelo sistema, "Concluída, para indicar que o processamento ocorreu com sucesso" e "Falha no envio" indicando que a integração não foi bem-sucedida e o arquivo não foi enviado corretamente. 
  

• Motivo falha: nos casos em que ocorre uma falha, esta coluna apresenta uma descrição detalhada da inconsistência, explicando as causas do erro no envio ou no processamento do arquivo. Essa informação é útil para diagnóstico e correção de problemas nas integrações.

• Ações: menu que disponibiliza a opção de "Download" do arquivo.

Caso a tela exiba uma lista extensa de arquivos, o usuário pode utilizar o campo "Pesquisar arquivos" para localizar rapidamente o arquivo desejado.

Para visualizar todas as colunas da tela auxiliar, mova a barra de navegação.

Após localizar o arquivo desejado, clique no botão de ações, representado por três pontos "" e, em seguida, clique em "download" para baixar e salvar o arquivo no computador. O arquivo será então salvo em uma pasta compactada (.zip) na pasta de Downloads do seu computador.

Para finalizar o gerenciamento da integração escolhida, o usuário poderá acompanhar o andamento da execução dos processamentos acessando a aba "Logs da integração", onde são apresentados os registros detalhados do processamento, veja a seguir.

• Logs da integração

Para fins de monitoramento, o cliente pode acessar a aba seguinte para visualizar os logs da integração. Esta aba permite ao usuário monitorar os logs gerados durante a execução das integrações em tempo real. Os logs fornecem um registro detalhado de todas as ações e eventos relacionados à integração, e o acompanhamento em tempo real possibilita que o usuário identifique rapidamente o andamento do processo durante a execução da integração.

Experiências  

Serão exibidas a seguir experiências vivenciadas, acompanhadas das tratativas aplicadas em cada caso. O objetivo é compartilhar experiências práticas que possam oferecer aprendizados úteis para a operação da loja e apresentar possíveis dificuldades pontuais, juntamente com os caminhos adotados para resolvê-las. Com isso, esperamos contribuir para que você consiga antecipar dificuldades semelhantes e conduzir suas ações com mais segurança e eficiência no uso do sistema.

Nota final  

Este tópico tem como objetivo esclarecer pontos específicos e complementares relacionados à documentação, oferecendo informações adicionais que contribuem para uma melhor compreensão do conteúdo apresentado.

Explore outros conteúdos e descubra o passo a passo da operação.