Como integrar os dados da Convenia no Visio OS
A Convenia entra na camada de Dados do Visio OS pela API que ela documenta: o perfil de DP/RH cria um token em Configurações, escolhe as categorias de dados que ele alcança, e a documentação v3 é pública. O dado de pessoas fica por loja, e a IA que você já usa lê tudo com o seu login.
Visio aqui é a Visio de operação de lojas (visio.ai), o sistema para quem toca várias lojas, não o Visio da Microsoft, de diagramas. A Convenia é uma fonte de RH, e o que ela guarda entra na camada de Dados do Visio OS como fonte de gente: colaboradores, benefícios, departamentos, centros de custo e os avisos de admissão, desligamento, férias e afastamento. A página da Convenia, consultada em 22/10/2026, descreve o caminho de acesso dela; o que muda na camada é onde esse dado passa a morar, por loja, na mesma linha do tempo da venda e da escala.
Por que os dados da Convenia importam para a rede
Quem toca várias lojas toma decisão de gente com número de gente: quantas pessoas no turno, quanto custa a equipe de cada loja, quem entrou e quem saiu, qual loja segura o time e qual perde gente. Nenhuma dessas perguntas se responde só com o cadastro de colaboradores. Elas atravessam a venda por hora, a escala do turno e o custo por loja.
O sistema de RH e o ponto eletrônico são fontes de gente da camada de Dados, e entram pelo caminho da fonte. Lá dentro, ficam ao lado da escala e da venda por turno, na mesma linha do tempo da loja. É essa junção que faz a pergunta valer. A ideia inteira está em como juntar os dados de todas as lojas em um lugar só.
Integrar a Convenia na camada significa que a fonte entra uma vez, a definição de cada número é escrita uma vez, e a pergunta seguinte não custa uma extração nova.
Há ainda a permissão. Folha, benefício e custo de pessoal não são dado para todo mundo ver, e a camada aplica a permissão no dado, por usuário, por loja e por app. O gerente vê a loja dele; a gestão vê o grupo; a IA responde com o login de quem pergunta.
Como avaliar o caminho da Convenia: 5 critérios
Cinco critérios mostram o que a página do fornecedor entrega e o que fica para o mapeamento. Cada um se confere na página do fornecedor, com a data da consulta ao lado.
- Quem libera o acesso. Na Convenia, o token de integração é criado pelo perfil de DP/RH, em Configurações, na área de API, e esse token carrega a escolha das categorias de dados que ele pode acessar. O acesso, portanto, nasce dentro da empresa, com o perfil que cuida do departamento pessoal.
- Que formato sai. A documentação da API v3 é pública em docs-api.convenia.com.br, em REST com respostas em JSON. A página consultada em 22/10/2026 não menciona exportação por arquivo: o que ela descreve é a API.
- Se vem por loja. A Convenia organiza colaboradores, departamentos e centros de custo. Se cada loja é um centro de custo ou um departamento é uma decisão da rede, e o mapeamento responde isso antes de o dado entrar.
- Quem mantém o quê. A própria página diz que a Convenia não desenvolve integrações nativas: o trabalho fica com a TI da empresa ou com o sistema parceiro.
- O que fica de fora. A API é limitada a 50 requisições por minuto, e a página não lista quais campos vêm em cada conjunto. O que a página não lista vai para o mapeamento.
Principais caminhos para integrar os dados da Convenia
Quatro caminhos aparecem quando a pergunta é como levar o dado de pessoas para junto do resto. Cada um responde a uma necessidade diferente, e nenhum deles é melhor em tudo.
1. A API v3, como a página da Convenia descreve
A página consultada em 22/10/2026 descreve assim: o token de integração é criado pelo perfil de DP/RH em Configurações, na área de API, com a escolha das categorias de dados que ele pode acessar, e vai num cabeçalho de nome token. A documentação da API v3 é pública, em REST com JSON, e cobre colaboradores, benefícios, departamentos, centros de custo e webhooks de admissão, desligamento, férias e afastamentos, com limite de 50 requisições por minuto. Cada um desses pontos está na página da Convenia, consultada em 22/10/2026.
2. A exportação
A página consultada em 22/10/2026 não menciona exportação por arquivo, e por isso não há o que afirmar sobre formato, periodicidade ou quais relatórios saem. Quando a rede não quer depender da API, o caminho se decide no mapeamento: qual dado precisa sair, com que frequência e quem do lado da empresa faz a ponte. O que se pode dizer desde já é o destino: o que sai por arquivo também termina por loja, com a mesma definição de cada número.
3. O MCP do fornecedor
A Convenia não publica um MCP próprio nas páginas consultadas em 22/10/2026. Um MCP de fornecedor é o caminho pelo qual a IA que você já usa lê aquele sistema. Onde o sistema do cliente já tem MCP próprio, o MCP da Visio opera esse MCP por trás, e a IA conecta uma vez. Nas páginas consultadas, o caminho documentado é a API.
4. A Convenia como fonte da camada de Dados do Visio OS
Aqui a Convenia deixa de ser um sistema isolado e vira uma fonte da camada. Ela entra pelo caminho que existe, na frequência de extração da fonte, e o dado cai por loja, na mesma linha do tempo da venda, do ponto e da escala, com uma definição por número escrita uma vez. A partir daí, dois caminhos de consumo: tudo no Visio OS, ou na sua IA, via MCP, com o seu login. O que a camada faz está descrito em o que é camada de dados.
Quem mantém a infraestrutura é a Visio: não há nuvem para dimensionar nem pipeline para manter do lado da rede. O próximo passo é o mapeamento de quais fontes a operação já tem e de como cada uma conecta. Para ver o que o mapeamento devolve na sua operação, fale com um especialista.
Comparativo: API do Convenia, exportação, MCP do fornecedor e camada de Dados
A tabela compara caminhos de acesso, não fornecedores. Onde a página do fornecedor não traz o fato, a célula diz “Conforme o sistema”.
| Critério | API do Convenia | Exportação | MCP do fornecedor | Camada de Dados do Visio OS |
|---|---|---|---|---|
| Quem libera | O perfil de DP/RH, em Configurações, escolhendo as categorias de dados | Conforme o sistema | Conforme o sistema | O login da Visio, com permissão por usuário, por loja e por app |
| Formato | REST em JSON, com colaboradores, benefícios, departamentos, centros de custo e webhooks | Conforme o sistema | Conforme o sistema | Dado estruturado por loja, lido pela IA pelo MCP ou pelo aplicativo pela API |
| Por loja | Conforme o sistema | Conforme o sistema | Conforme o sistema | A loja é a unidade, com uma definição por número |
| Quem mantém | A TI da empresa ou o sistema parceiro, como a página diz | Conforme o sistema | Conforme o sistema | A Visio roda a infraestrutura |
Opinião do Head of Content
Lorenzo Lopez, Head of Content da Visio, observa que, pela página da Convenia, o token é criado pelo perfil de DP/RH e carrega a escolha das categorias de dado que ele alcança. Para ele, isso cobre o acesso, e a outra metade da decisão é onde o dado de pessoas passa a conviver com venda, escala e ponto.
A posição dele é a de que a decisão do leitor não está em escolher entre a API e a camada, e sim em saber quem responde pela estrutura. Na leitura dele, uma rede que lê colaboradores e benefícios ao lado da venda por turno precisa que a mesma pergunta devolva o mesmo número para todo mundo, e isso é trabalho de definição, não de conexão. É o mesmo raciocínio que está em como ter o mesmo número para todo mundo na rede.
Perguntas frequentes
Como a documentação da Convenia descreve o acesso à API?
A página consultada em 22/10/2026 diz que o token de integração é criado pelo perfil de DP/RH, em Configurações, na área de API, com a escolha das categorias de dados que ele pode acessar, e que ele vai num cabeçalho de nome token. A documentação da API v3 é pública, em REST com JSON, cobre colaboradores, benefícios, departamentos, centros de custo e webhooks de admissão, desligamento, férias e afastamentos, e tem limite de 50 requisições por minuto.
O que fazer se a rede não quer depender da API da Convenia?
A página consultada em 22/10/2026 não menciona exportação por arquivo, então o caminho alternativo se define no mapeamento: qual dado precisa sair, com que frequência e quem faz a ponte do lado da empresa. A própria página diz que a Convenia não desenvolve integrações nativas e que o trabalho fica com a TI da empresa ou com o sistema parceiro, o que ajuda a dimensionar de quem é a tarefa.
Como a Convenia se encaixa na pergunta que atravessa várias fontes?
Ela entra como fonte de gente da camada de Dados, ao lado da venda por hora, da escala e do ponto, tudo por loja e na mesma linha do tempo. É essa junção que responde perguntas como a venda do turno contra o número de pessoas naquele turno, ou o custo de pessoal de uma loja contra o resultado dela.
A Convenia publica um MCP próprio, como o de outras fontes?
As páginas consultadas em 22/10/2026 não mencionam um MCP próprio da Convenia. O caminho documentado por ela é a API v3. Onde o sistema do cliente já tem MCP próprio, o MCP da Visio opera esse MCP por trás, e a IA conecta uma vez.
Como o mapeamento resolve o que a página da Convenia não diz?
O mapeamento é o passo em que a Visio olha quais fontes a operação já tem e como cada uma conecta. É ali que se decide o que a Convenia entrega pela API naquele grupo, se cada loja vira um centro de custo ou um departamento, qual frequência de extração atende o trabalho, e desde quando o dado de cada fonte é bom o bastante para entrar numa comparação.
Próximos passos
Para o mapeamento da Convenia, as perguntas que a página deixa abertas são estas. Quais categorias de dados o token precisa alcançar, já que o perfil de DP/RH as escolhe ao criá-lo. Como o limite de 50 requisições por minuto se encaixa na frequência de extração de que a operação precisa. Quais dos webhooks de admissão, desligamento, férias e afastamentos interessam à pergunta da rede. Cada resposta entra no mapeamento da fonte, ao lado das demais fontes da operação, com a data da página consultada.
O caminho para colocar o dado de pessoas ao lado do resto é o mapeamento: quais fontes a operação já tem, como cada uma conecta e o que cada uma entrega de fato. Para o dado de pessoas, vale olhar junto o ponto eletrônico, que é a outra fonte de gente da mesma linha do tempo. Fale com um especialista.
Ver também
- Como conectar a IA nos dados da minha loja
- Como juntar os dados de todas as lojas em um lugar só
- O que é camada de dados
- Como integrar os dados do ponto eletrônico
Conclusão
A Convenia se integra pelo caminho que a própria página dela documenta: um token criado pelo perfil de DP/RH, com as categorias de dado escolhidas, e uma API v3 pública em REST com JSON, que cobre colaboradores, benefícios, departamentos, centros de custo e os webhooks de admissão, desligamento, férias e afastamentos. Na camada de Dados do Visio OS, esse dado passa a morar por loja, com uma definição por número, permissão por usuário, por loja e por app, e a IA que você já usa lê o resultado com o seu login. Fale com um especialista da camada de Dados do Visio OS.
Dados deixam tudo pronto pra usar. O Visio OS transforma em tarefa certa, pra pessoa certa.