Como integrar os dados da Control iD no Visio OS

Integrar os dados da Control iD no Visio OS começa pelo caminho que a documentação do REP iDClass descreve: web services REST em HTTPS POST, com sessão criada no equipamento e o arquivo AFD das marcações disponível para leitura. Na camada de Dados do Visio OS, esse dado entra por loja, na mesma linha do tempo da operação.

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 documentação pública do Control iD sobre o iDClass está em página da API do iDClass (consultada em 22/10/2026).

Por que o caminho de acesso do Control iD importa para a rede

Um REP iDClass produz marcação de ponto, e esse dado mora no equipamento. A página do iDClass mostra o caminho de saída e também o limite dele: a API cobre o relógio de ponto, e não um serviço em nuvem (consultada em 22/10/2026).

Para uma rede com várias lojas, a pergunta sobre o turno que estava na loja quando a venda caiu atravessa o ponto, a venda e a escala. Enquanto o arquivo do aparelho fica onde está, a pergunta atravessa lugares separados.

A camada de Dados do Visio OS é a camada 1 de 9 do Visio OS, a base de todas as camadas. O que ela faz com uma fonte como o ponto é o que faz com qualquer outra: o dado entra pelo caminho que existe, fica por loja, com uma definição por número, e sai pronta para ser consumida nas Tools da Visio, na sua IA pelo MCP e no seu aplicativo pela API.

O ponto deixa de ser um arquivo que alguém baixa para responder uma pergunta e passa a ser uma trilha na mesma linha do tempo da venda, da escala e do resto da operação, com a permissão de quem pergunta aplicada no dado.

Como avaliar o caminho do Control iD: 5 critérios

Cinco critérios separam um acesso que resolve de um acesso que só existe no papel. Cada um se confere na página do fornecedor e, no que ela não disser, vira pergunta para o mapeamento.

1. Quem libera o acesso. Na API do iDClass, a sessão é criada no próprio equipamento, por login.fcgi, e os chamados vão direto nele. A página não diz quem emite o login de cada aparelho (consultada em 22/10/2026), e essa pergunta vai para o mapeamento.
2. Que formato sai. O web service responde em JSON, em chamadas HTTPS POST, e há um comando que devolve o arquivo AFD das marcações, filtrável por data inicial ou por NSR, com um modo próprio para o formato da Portaria 671.
3. Se vem por loja. A página descreve a API do iDClass no equipamento. Para o grupo, a pergunta que sobra é como cada aparelho é identificado e amarrado à loja dele, para que a marcação não chegue solta.
4. Quem mantém a coleta. A página traz uma coleção Postman e um exemplo no GitHub e não diz quem cuida da coleta de cada aparelho depois de montada. Essa pergunta vai para o mapeamento.
5. O que fica de fora. A API cobre o relógio de ponto, e não um serviço em nuvem (consultada em 22/10/2026). O que a operação precisa além da marcação entra por outra fonte, na mesma linha do tempo.

Principais caminhos para os dados da Control iD

Quatro caminhos aparecem quando a pergunta é como os dados do iDClass chegam até uma análise. Os três primeiros são o que a página do fornecedor descreve ou deixa de descrever. O quarto é o desenho da camada de Dados do Visio OS.

1. A API que a documentação do iDClass descreve

A documentação é pública e trata do REP iDClass: web services REST em HTTPS POST, com JSON no corpo, chamados direto no equipamento, com sessão criada por login.fcgi. O comando get_afd.fcgi devolve o arquivo AFD das marcações, filtrável por data inicial ou por NSR, e aceita mode=671 para o formato da Portaria 671. A mesma página traz uma coleção Postman e um exemplo no GitHub.

A página é pública e declara o formato. O limite também está nela: a API cobre o equipamento, e não um serviço em nuvem. Numa rede, como juntar os equipamentos de cada loja é pergunta para o mapeamento.

2. A exportação

A página consultada em 22/10/2026 não menciona exportação de arquivo pelo iDClass. O caminho de exportação, se existir na conta ou na versão em uso, é pergunta para o mapeamento, e não uma afirmação que se possa fazer antes de olhar a operação.

A única saída em arquivo que a página descreve é o AFD que o comando get_afd.fcgi devolve. Na camada de Dados, o arquivo que a operação já usa entra como fonte, por loja.

3. O MCP do fornecedor

As páginas consultadas em 22/10/2026 não mencionam um MCP próprio do Control iD. Um MCP de fornecedor é o caminho da IA até aquele sistema e responde pelo que está nele, não pelas outras fontes da operação.

Onde um sistema já tem MCP próprio, o MCP da Visio opera esse MCP por trás, e a IA conecta uma vez. É assim que a camada evita uma conexão por fornecedor: você gerencia num lugar só.

4. O Control iD como fonte da camada de Dados do Visio OS

Aqui o dado do ponto entra pelo caminho que existe, por API onde há uma, por exportação onde não há, e por um caminho de extração homologado quando nenhum dos dois serve. O destino é o que muda: a marcação fica por loja, na mesma linha do tempo da venda e da escala, com uma definição por número escrita uma vez pela Visio.

A partir daí, a permissão vai junto. O gerente vê a loja dele; a gestão vê o grupo; a mesma regra vale para a IA de cada um, que responde com o login de quem pergunta. Cada consulta ao dado fica registrada, de forma centralizada, e o dado fica na nuvem que o grupo já usa, isolado por empresa e cifrado em repouso e no acesso.

O Visio OS transforma a decisão em tarefa certa, pra pessoa certa, e o ponto é uma das trilhas que explicam por que a venda de um turno se comportou de um jeito. Para ver o mecanismo inteiro, vale ler o que é camada de dados e, para o caso específico do ponto como fonte, como integrar os dados do ponto eletrônico.

Para saber como o ponto da sua rede entra na camada e o que ele responde ao lado da venda, fale com um especialista.

Comparativo: API do Control iD, exportação, MCP do fornecedor e camada de Dados

A tabela compara caminhos de acesso, não fornecedores. Onde a página do Control iD não traz o fato, a célula diz “Conforme o sistema”.

Critério	API do Control iD (iDClass)	Exportação	MCP do fornecedor	Camada de Dados do Visio OS
Quem libera	Conforme o sistema (a sessão é criada no equipamento por login.fcgi)	Conforme o sistema	Sem MCP próprio nas páginas consultadas em 22/10/2026	A Visio, no mapeamento das fontes da operação
Formato	JSON em HTTPS POST, com o AFD devolvido por comando próprio	Conforme o sistema	Conforme o sistema	Estruturado por loja, com uma definição por número
Por loja	Conforme o sistema	Conforme o sistema	Conforme o sistema	Sim, a loja é a unidade
Quem mantém	Conforme o sistema	Conforme o sistema	Conforme o sistema	A Visio roda a infraestrutura, e o builder constrói a ferramenta

Opinião do Head of Content

Lorenzo Lopez, Head of Content da Visio, observa que a página do iDClass descreve a leitura do equipamento. Para ele, a decisão do leitor está em onde o dado do ponto vai morar depois da leitura.

A posição dele é a de que o ponto é uma trilha da operação. Na leitura dele, o valor aparece quando a marcação chega por loja, com a mesma definição em cada unidade, e a permissão de quem pergunta viaja junto com a consulta, inclusive quando quem pergunta é a IA ligada pelo MCP.

Para Lorenzo Lopez, o que a página do fornecedor não cobre é o que acontece com o dado depois da leitura, e esse é o assunto do mapeamento.

Perguntas frequentes

Como a documentação do REP iDClass descreve o acesso aos dados?

A página descreve web services REST em HTTPS POST, com JSON, chamados direto no equipamento e sessão criada por login.fcgi. O comando get_afd.fcgi devolve o arquivo AFD das marcações, filtrável por data inicial ou por NSR, com mode=671 para o formato da Portaria 671, e a página traz coleção Postman e exemplo no GitHub (consultada em 22/10/2026).

O que fazer se a rede não quer depender da API do Control iD?

A página consultada em 22/10/2026 não descreve outro caminho de saída além do AFD que o comando get_afd.fcgi devolve. Na camada de Dados, a fonte entra por exportação ou relatório onde não há API, e por um caminho de extração homologado quando nenhum dos dois serve; o mapeamento define qual vale para cada aparelho da operação.

A rede precisa trocar o equipamento para o dado entrar na camada?

Não. A camada de Dados do Visio OS entra pelo caminho que existe: por API onde há uma, por exportação onde não há, e por um caminho de extração homologado quando nenhum dos dois serve. O que muda é o destino do dado, que passa a ficar por loja, na mesma linha do tempo da operação.

Como o ponto fica ao lado da venda por turno?

O ponto entra como fonte, como qualquer sistema que a loja roda, e fica na mesma linha do tempo da venda por hora daquela loja. “Quem estava no turno quando a venda caiu” deixa de ser projeto e vira pergunta na IA que você já usa, com o seu login, ou um número na ferramenta. O cruzamento do ponto com a venda por turno está descrito em como cruzar o ponto dos funcionários com as vendas por turno.

O que o mapeamento acrescenta ao que a página do Control iD já diz?

O mapeamento diz, fonte por fonte, como cada uma conecta e desde quando o dado é bom. A página do fornecedor conta como o equipamento é lido; o mapeamento conta quais aparelhos existem na operação, como cada um se liga à loja dele e o que fazer com o que a página não cobre, como a exportação e a credencial de cada equipamento.

Próximos passos

Para o mapeamento do Control iD, as perguntas que a página deixa abertas são estas. Quantos equipamentos iDClass existem na rede e como cada um se liga a uma loja. Se o AFD das marcações será lido por data inicial ou por NSR, os dois filtros que o comando get_afd.fcgi aceita. Se a operação precisa do formato da Portaria 671, que o parâmetro mode=671 devolve. Quem emite o login de cada equipamento, que a página não diz. Cada resposta entra no mapeamento da fonte, ao lado das demais fontes da operação, com a data da página consultada.

O próximo passo é o mapeamento: quais fontes a operação já tem, quais equipamentos existem em cada loja e como cada um conecta. 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.

Ver também

• Como juntar os dados de todas as lojas em um lugar só
• MCP é a mesma coisa que API?
• Como conectar a IA nos dados da minha loja

Conclusão

Integrar os dados da Control iD no Visio OS tem dois movimentos. O primeiro é ler as marcações pelo caminho que a documentação do REP iDClass descreve, com sessão criada no equipamento e o AFD disponível por comando próprio. O segundo é deixar esse dado estruturado por loja na camada de Dados, para a IA que você já usa ler com o seu login, dentro das suas permissões. 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.