Como integrar os dados do CPlug no Visio OS
Integrar os dados do CPlug no Visio OS começa pelo caminho que o CPlug documenta: cadastro no portal CPlug Developer, aprovação da ConnectPlug, Client ID e Client Secret, e cada loja liberada pelo ID do tenant. O dado entra por loja, com uma definição por número, e a IA lê pelo MCP da Visio, 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. O CPlug é o ERP da ConnectPlug, e a camada de Dados do Visio OS, a camada 1 de 9 do sistema, é onde o dado dele passa a ficar por loja, na mesma linha do tempo das outras fontes.
Por que os dados do CPlug importam para a rede
A página do manual da API do CPlug, consultada em 22/10/2026, lista o que o integrador alcança: autenticação, produtos, financeiro, vendas, estoques, empresa e relatórios de vendas. É por aí que o dado do ERP entra na conversa de uma rede de lojas.
O ponto é que um número de ERP não responde sozinho a pergunta que a rede faz. Quando a venda de uma loja cai, a resposta não está no dado de venda: está no tapume na frente da loja, na chuva, na mudança de preço, e cada uma dessas trilhas mora num lugar diferente. Sem elas juntas, por loja, a pergunta atravessa sistemas e começa por uma extração.
A página também mostra como o acesso é organizado. O integrador cadastra a conta no portal CPlug Developer, aguarda a aprovação da ConnectPlug e recebe Client ID e Client Secret; cada loja é liberada pelo ID do tenant, no ERP, na área de Configurações, em Integrações, em Integrações via API; e a autenticação soma as credenciais ao usuário e senha da loja. Quem toca várias lojas lê esse desenho como ele é: a liberação acontece loja a loja.
É nesse ponto que a camada de Dados do Visio OS entra. O dado do CPlug passa a ficar por loja, na mesma linha do tempo das outras fontes, com uma definição por número escrita uma vez e a permissão de quem pergunta dentro da consulta, por usuário, por loja e por app. A pergunta deixa de começar por uma extração e passa a ser feita na IA que a rede já usa.
Como avaliar o caminho do CPlug: 5 critérios
Cinco critérios mostram o que o caminho do CPlug entrega para uma rede. Cada um tem a resposta que a página consultada em 22/10/2026 dá; onde ela não dá, o critério vira pergunta para o mapeamento.
- Quem libera o acesso. A liberação passa pelo portal CPlug Developer e pela aprovação da ConnectPlug antes de o integrador receber Client ID e Client Secret. É um caminho de credenciamento, com etapas do lado do fornecedor.
- Que dado a página descreve. As categorias da API NOVA 3.0: autenticação, produtos, financeiro, vendas, estoques, empresa e relatórios de vendas. É essa a lista que o manual entrega a quem vai integrar.
- Se a leitura é loja a loja. Cada loja é liberada pelo ID do tenant, e a autenticação soma as credenciais ao usuário e senha da loja. A página não diz como a rede libera várias lojas de uma vez; essa pergunta vai para o mapeamento.
- Quem mantém e o que é cobrado. A página não diz quem mantém o cadastro e as credenciais depois da aprovação. Ela diz que a liberação da API, nova ou antiga, é cobrada por mês; as condições vêm do fornecedor.
- O que a página não trata. O que a página consultada em 22/10/2026 não trata vira pergunta do mapeamento: a saída por arquivo, o MCP oficial do fornecedor e o que cada loja já tem liberado.
Principais caminhos para os dados do CPlug
1. A API NOVA 3.0, como o manual descreve
A página do manual da API (manual da API do CPlug), consultada em 22/10/2026, descreve a API NOVA 3.0 com categorias de autenticação, produtos, financeiro, vendas, estoques, empresa e relatórios de vendas. O caminho tem três passos: o integrador cadastra a conta no portal CPlug Developer, aguarda a aprovação da ConnectPlug e recebe Client ID e Client Secret; cada loja é liberada pelo ID do tenant, no ERP, na área de Configurações, em Integrações, em Integrações via API; e a autenticação soma as credenciais ao usuário e senha da loja. A página diz também que a liberação da API, nova ou antiga, é cobrada por mês.
2. A exportação de arquivo
O manual da API consultado em 22/10/2026 não menciona exportação de arquivo nem relatório pronto. Para a rede que prefere não depender da API, a saída por arquivo é uma pergunta do mapeamento: é lá que se confirma, loja a loja, o que o sistema entrega em arquivo e em que frequência.
3. O MCP oficial do fornecedor
A mesma página consultada em 22/10/2026 não menciona um MCP oficial do CPlug. Um MCP de fornecedor é um fato sobre aquele fornecedor, e não sobre a Visio. Na camada de Dados, a sua IA lê a operação, com o CPlug ao lado do PDV, do banco, da nota e do delivery, tudo por loja, pelo MCP da Visio, com um login só.
4. O CPlug como fonte da camada de Dados do Visio OS
Na camada de Dados do Visio OS, o CPlug entra como fonte, e o que muda está no que acontece depois da leitura. O dado de cada loja fica na mesma linha do tempo das outras fontes, com uma definição por número escrita uma vez pela Visio, e a permissão de quem pergunta vai dentro da consulta, por usuário, por loja e por app. A loja é a unidade: a pergunta sobre uma unidade junta o ERP, o PDV, o banco, a nota e o que o time faz trabalhando.
A leitura pela IA acontece pelo MCP da Visio, com o seu login e as suas permissões, só leitura: a IA lê a métrica já calculada, e cada consulta ao dado fica registrada, de forma centralizada. O aplicativo do builder lê o mesmo dado estruturado por loja pela API, com a mesma permissão do login da operação, e a documentação por fonte vem no mapeamento.
Para ver o que o caminho do CPlug muda na operação da sua rede, Fale com um especialista.
Comparativo: API do CPlug, exportação, MCP do fornecedor e a camada de Dados
A tabela compara os quatro caminhos pelo que a página do CPlug sustenta e pelo que a camada de Dados entrega. Onde não há fato na página, a célula diz conforme o sistema.
| Critério | API do CPlug | Exportação | MCP do fornecedor | Camada de Dados do Visio OS |
|---|---|---|---|---|
| Quem libera | Cadastro no portal CPlug Developer e aprovação da ConnectPlug | Conforme o sistema | Conforme o sistema | Conforme o sistema |
| Formato | API NOVA 3.0, com autenticação, produtos, financeiro, vendas, estoques, empresa e relatórios de vendas | Conforme o sistema | Conforme o sistema | Dado estruturado por loja; a IA lê a métrica pronta pelo MCP e o aplicativo lê pela API |
| Por loja | Cada loja liberada pelo ID do tenant | Conforme o sistema | Conforme o sistema | Por loja, na mesma linha do tempo, com uma definição por número |
| Quem mantém | Conforme o sistema | Conforme o sistema | Conforme o sistema | Conforme o sistema |
Opinião do Head of Content
Lorenzo Lopez, Head of Content da Visio, observa que, na integração do CPlug, a decisão é onde o dado dele passa a morar depois da leitura. Para ele, a pergunta que decide é o que acontece com o número quando ele sai do sistema: se ele chega solto num arquivo, cada pergunta recomeça; se ele chega por loja, com definição escrita e permissão dentro da consulta, a rede ganha uma base para comparar unidades.
Na leitura dele, o caminho de acesso e o lugar do dado são decisões separadas. O manual do CPlug descreve a primeira: o credenciamento no portal, a aprovação e a liberação por loja. A segunda fica com a camada de Dados do Visio OS, onde a loja é a unidade, a definição de cada número é escrita uma vez e a IA que a rede já usa lê pelo MCP com o login de quem pergunta.
Perguntas frequentes
Preciso ser parceiro do CPlug para ler os dados por API?
O caminho que a página do manual da API, consultada em 22/10/2026, descreve é o de credenciamento: o integrador cadastra a conta no portal CPlug Developer, aguarda a aprovação da ConnectPlug e recebe Client ID e Client Secret. Cada loja ainda é liberada pelo ID do tenant, e a autenticação soma as credenciais ao usuário e senha da loja. Quais lojas da rede já estão liberadas por esse caminho é pergunta para o mapeamento.
O que fazer se a rede não quer depender da API do CPlug?
A primeira decisão é onde o dado vai morar depois de sair do CPlug. Na camada de Dados do Visio OS ele fica por loja, na mesma linha do tempo das outras fontes, com uma definição por número e a permissão dentro da consulta, e a pergunta passa a ser feita na IA que a rede já usa. A saída por arquivo, que a página consultada em 22/10/2026 não menciona, é uma pergunta do mapeamento.
Como o CPlug se encaixa na pergunta que atravessa várias fontes?
O CPlug é uma das trilhas. A pergunta que atravessa fontes, como o que aconteceu na loja na terça e por quê, junta o ERP, o PDV, o banco, a nota, o delivery, o ponto e o que a câmera detecta, todos por loja, na mesma linha do tempo. É essa junção que a camada de Dados do Visio OS faz, com uma definição por número; a pergunta deixa de começar por uma extração.
Existe MCP do próprio CPlug para a minha IA ler?
A página do manual da API consultada em 22/10/2026 não menciona um MCP oficial do CPlug. Um MCP de fornecedor, quando existe, é um fato sobre aquele fornecedor e responde pelo que está no sistema dele. A leitura da operação que está na camada, com o seu login, é o que o Visio MCP faz, e 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 CPlug não diz?
O mapeamento olha a operação, não a página: quais fontes a rede já tem, quais lojas cada uma libera, em que frequência o dado chega e desde quando ele é bom. É lá que se confirma o que a página consultada em 22/10/2026 não menciona, como a exportação de arquivo e o MCP oficial,.
Próximos passos
O próximo passo é o mapeamento das fontes: quais sistemas a rede já tem, quais lojas cada um libera 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.
Para o mapeamento do CPlug, as perguntas que a página deixa abertas são estas: quem na rede cadastra a conta no portal CPlug Developer e acompanha a aprovação da ConnectPlug; qual é o ID do tenant de cada loja, que o ERP mostra em Configurações, Integrações, Integrações via API; quais das categorias da API NOVA 3.0 (produtos, financeiro, vendas, estoques, empresa, relatórios de vendas) a rede quer ler; e como a cobrança mensal da liberação, que a página cita para a API nova e para a antiga, entra na decisão.
Ver também
- Como juntar os dados de todas as lojas em um lugar só
- Como integrar PDV, ERP, banco e nota fiscal
- Como ter o mesmo número para todo mundo na rede
Conclusão
Integrar os dados do CPlug no Visio OS é ligar o caminho que o CPlug documenta ao lugar onde o dado vira número por loja: o credenciamento no portal, a aprovação e a liberação por tenant resolvem a saída, e a camada de Dados do Visio OS resolve a estrutura, a permissão e a leitura pela IA que a rede já usa. O que a página consultada em 22/10/2026 não trata se confirma no mapeamento, fonte por fonte. 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.