Como integrar os dados do Secullum no Visio OS
Integrar os dados do Secullum começa pelo caminho que a própria página do fornecedor descreve: o Ponto Web oferece um webservice para listar, salvar e excluir empresas, funcionários e horários, com documentação Swagger e exemplo público no GitHub, e os cálculos de ponto saem por relatório, com um layout próprio para a folha Domínio. A conta precisa ter o banco do Ponto Web ativo no plano PRO ou superior, e a integração habilitada em Manutenção, Integração com Sistemas.
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.
Por que integrar os dados do Secullum importa para a rede
Uma rede que usa Secullum tem ali o registro de quem estava no turno. Esse dado, sozinho, responde pouco: a pergunta que interessa é a venda por hora contra a escala daquele turno, e ela atravessa o ponto, o PDV e a ferramenta que monta a escala.
Cada uma dessas fontes vive num lugar: o ponto no Secullum, a venda no PDV, a escala na ferramenta que a monta. Responder à pergunta atravessa os três. Por exemplo, uma rede que vai montar a escala de uma loja reúne os dados e as restrições de cada funcionário, o horário da loja, a contagem na porta, o clima, os pedidos de folga e a legislação trabalhista. São trilhas de lugares diferentes, e a decisão só fica boa quando elas estão juntas.
O que muda quando o ponto entra na camada é a junção. O ponto eletrônico e o sistema de RH são fontes de gente da camada: entram pelo caminho da fonte e ficam ao lado da escala e da venda por turno, na mesma linha do tempo da loja. A pergunta sobre o turno deixa de ser projeto e vira uma pergunta na IA que a rede já usa.
Como avaliar o caminho de acesso ao Secullum: 5 critérios
Os critérios abaixo são os que decidem se o dado do ponto chega utilizável. Cada um pode ser conferido na página do fornecedor ou virar pergunta no mapeamento.
- Quem libera o acesso. A página exige conta Secullum com banco do Ponto Web ativo no plano PRO ou superior e a integração habilitada em Manutenção, Integração com Sistemas. Antes de planejar qualquer coisa, vale confirmar quem na rede administra essa conta e essa habilitação.
- Que formato sai. Pelo webservice, o retorno é o da documentação Swagger publicada pelo fornecedor; pelos relatórios, os cálculos de ponto saem por Relatórios, Cálculos, Exportação de cálculos, com layout para a folha Domínio, que a página descreve como integração em beta.
- Se vem por loja. A página lista empresas, funcionários e horários como o que o webservice alcança. Como cada loja da rede se organiza dentro disso é o que o mapeamento precisa responder antes de o dado virar comparação.
- Quem mantém. A página descreve o webservice, a documentação e a habilitação na conta, e não diz quem cuida da integração depois de feita (consultada em 22/10/2026). Essa pergunta vai para o mapeamento.
- O que fica de fora. A página não cita AFD nem AEJ. Também não menciona MCP próprio. O que a página não diz vai para o mapeamento.
Os cinco critérios separam duas perguntas que se confundem. A primeira é se o dado do Secullum sai do sistema, e ela se responde na página do fornecedor. A segunda é se esse dado chega utilizável à análise, e essa depende do que cada operação tem: quantas lojas, quais fontes ao lado do ponto, qual definição de cada número. É o mapeamento que fecha a segunda.
Principais caminhos para os dados do Secullum
Os caminhos abaixo seguem a ordem em que a página do fornecedor os apresenta.
1. O webservice do Ponto Web, como a página descreve
A página do Secullum, consultada em 22/10/2026, descreve um webservice do Ponto Web para listar, salvar e excluir empresas, funcionários e horários, com documentação Swagger e exemplo público em github.com/Secullum/PontoWebIntegracaoExternaExemplo. As requisições usam TLS 1.2 ou superior.
O webservice alcança o que a página lista, e o resto fica para o mapeamento.
2. A exportação dos cálculos de ponto
Quem não tem time de TI encontra na própria página um segundo caminho: os cálculos de ponto saem por Relatórios, Cálculos, Exportação de cálculos, com layout para a folha Domínio. A página descreve essa integração como beta.
É o caminho de quem quer o número fechado do período, e não o cadastro.
3. O MCP do fornecedor
As páginas do Secullum consultadas em 22/10/2026 não mencionam um MCP próprio. O que existe é o webservice e o caminho de exportação descritos acima.
Um MCP é o caminho da sua IA até a fonte. Onde o sistema já tem MCP próprio, o MCP da Visio opera esse MCP por trás, e a IA conecta uma vez.
4. O Secullum como fonte da camada de Dados do Visio OS
A camada de Dados do Visio OS não é uma lista fixa de conectores: toda fonte que a loja roda entra pelo caminho que existe, e a documentação por fonte vem no mapeamento. O ponto eletrônico entra como fonte de gente, fica ao lado da venda por hora da mesma loja, na mesma linha do tempo, e a permissão de quem pergunta vai dentro da consulta, por usuário, por loja e por app.
O que a resposta sobre o turno ganha ali é a definição. Uma definição por número, escrita uma vez, e as fontes juntas por loja: a venda vem do PDV, o ponto vem do Secullum, a escala vem da ferramenta que a monta, e a pergunta sobre quem estava no salão no pico é uma pergunta, não um projeto de planilha. A estrutura completa da camada está em o que é camada de dados.
Para ver o que a sua operação ganha quando o ponto entra ao lado do resto, fale com um especialista.
O que muda quando o ponto entra por loja
Integração traz um dado que já existe; a camada não inventa o registro do turno. O que ela faz é pôr esse dado no lugar em que a comparação acontece: cada fonte por loja, na mesma linha do tempo, com uma definição por número escrita uma vez. O ponto passa a falar a mesma língua da venda, da escala e do resto da operação.
A permissão é parte do desenho. Um login para a operação, com permissão por usuário, por loja e por app, aplicada no dado: a resposta vem com o login de quem pergunta, inclusive quando quem pergunta é a IA. A conversa fica com a IA que a pessoa já usa, e cada consulta ao dado fica registrada, de forma centralizada.
O mapeamento diz, fonte por fonte, desde quando o dado de cada uma é bom, e a sua IA respeita isso.
A leitura pelo MCP é só leitura, dentro das permissões.
Comparativo: os caminhos do Secullum e a camada de Dados
A tabela compara o que cada caminho entrega. Onde a página do Secullum não traz o fato, a célula diz “Conforme o sistema”.
| Critério | API do Secullum | Exportação | MCP do fornecedor | Camada de Dados do Visio OS |
|---|---|---|---|---|
| Quem libera | Conta com banco do Ponto Web ativo no plano PRO ou superior, integração habilitada em Manutenção | Conforme o sistema | Conforme o sistema | O mapeamento das fontes da operação |
| Formato | Documentação Swagger publicada pelo fornecedor | Exportação de cálculos, com layout para a folha Domínio | Conforme o sistema | Dado estruturado por loja, com uma definição por número |
| Por loja | Empresas, funcionários e horários, como a página lista | Conforme o sistema | Conforme o sistema | Cada fonte por loja, na mesma linha do tempo |
| Quem mantém | Conforme o sistema | Conforme o sistema | Conforme o sistema | A Visio, com a documentação por fonte no mapeamento |
Opinião do Head of Content
Lorenzo Lopez observa que a página do Secullum descreve dois caminhos de acesso: o webservice documentado, com exemplo publicado, e o relatório de cálculos.
Para ele, a decisão difícil vem depois. Um dado de ponto só ajuda a rede quando responde à pergunta que atravessa sistemas, e essa pergunta pede que o ponto, a venda e a escala signifiquem a mesma coisa por loja. Na leitura dele, é aí que a camada de Dados do Visio OS justifica o desenho: a definição escrita uma vez, as fontes na mesma linha do tempo e a permissão dentro da consulta. O critério prático que ele propõe é este: quando a resposta exige exportar de dois sistemas e juntar em algum lugar, o problema não está no Secullum nem no PDV, está na falta de um lugar em que as fontes já estejam juntas.
Lorenzo Lopez lembra ainda que a resposta não termina numa tabela. O Visio OS transforma a decisão em tarefa certa, pra pessoa certa, e o dado de ponto é um dos insumos disso.
Perguntas frequentes
Como a documentação do Secullum descreve o acesso à API?
A página do Secullum, consultada em 22/10/2026, descreve um webservice do Ponto Web para listar, salvar e excluir empresas, funcionários e horários, com documentação Swagger e um exemplo público no GitHub do fornecedor. O uso exige conta com banco do Ponto Web ativo no plano PRO ou superior e a integração habilitada em Manutenção, Integração com Sistemas, com requisições em TLS 1.2 ou superior.
Existe exportação dos dados do Secullum para quem não tem time de TI?
A mesma página descreve a saída dos cálculos de ponto por Relatórios, Cálculos, Exportação de cálculos, com layout para a folha Domínio, e trata essa integração como beta (consultada em 22/10/2026). É o caminho de quem precisa do número fechado do período sem escrever código.
Como o Secullum se encaixa na pergunta que atravessa várias fontes?
O ponto entra como uma das trilhas da loja, ao lado da venda por hora e da escala do turno. Quando o ponto, a venda e a escala ficam por loja na mesma linha do tempo, com uma definição por número, a pergunta sobre quem estava no salão no pico deixa de exigir extração e passa a ser feita na IA que a rede já usa.
O Secullum tem MCP oficial?
As páginas do Secullum consultadas em 22/10/2026 não mencionam um MCP próprio. O que elas documentam é o webservice do Ponto Web e a exportação dos cálculos. Onde o sistema já tem MCP próprio, o MCP da Visio opera esse MCP por trás.
Como o mapeamento resolve o que a página do Secullum não diz?
O mapeamento responde o que a página não traz: como as lojas da rede se organizam dentro do cadastro do sistema, desde quando o dado de cada fonte é bom e por qual caminho cada fonte conecta. É o passo que transforma a classe da fonte numa ligação definida para aquela operação.
Próximos passos
O caminho para integrar o Secullum começa pelo mapeamento: quais fontes a operação já tem, como cada uma conecta e desde quando o dado de cada uma é bom. Integra com todos os bancos do Brasil e com centenas de ERPs. O que ainda não está integrado, a Visio ajuda a integrar em menos de 24 horas. Fale com um especialista para ver como o ponto da sua rede entra ao lado do resto.
Para entender por que o ponto sozinho rende pouco, leia como integrar os dados do ponto eletrônico. Para o mesmo molde aplicado a outro fornecedor de ponto, veja como integrar os dados do Pontomais.
Ver também
- Como juntar os dados de todas as lojas em um lugar só
- Como integrar os dados do ponto eletrônico
- Como integrar os dados do Pontomais
- O que é camada de dados
Conclusão
Integrar os dados do Secullum tem dois tempos. O primeiro é o caminho que a página do fornecedor documenta, com o webservice do Ponto Web, a habilitação na conta e a exportação dos cálculos. O segundo é o que decide o uso: o ponto por loja, na mesma linha do tempo da venda e da escala, com uma definição por número, lido pela IA que a rede já usa com o login de quem pergunta. Fale com um especialista para começar pelo mapeamento das fontes da sua operação.
Dados deixam tudo pronto pra usar. O Visio OS transforma em tarefa certa, pra pessoa certa.