API CPLUG

API ATUAL

O que é uma API?

API é a sigla para Application Programming Interface, ou em português, Interface de Programação de Aplicações.

De forma simples, uma API é um conjunto de regras que permite que dois sistemas diferentes se comuniquem entre si.
Ela funciona como uma ponte, permitindo que softwares troquem informações de forma padronizada, segura e automatizada e sem necessidade de interação manual.

Por meio da API, é possível, por exemplo, cadastrar um cliente, consultar produtos em estoque ou enviar informações de vendas de forma direta entre sistemas diferentes, como um ERP e uma plataforma de e-commerce.


Funcionalidades da API atual da CPlug

Documentação API atual -> http://cdn.connectplug.com.br/apidoc/index.html

Nossa API permite que outros sistemas se conectem ao ecossistema CPlug para consultar, cadastrar, atualizar ou excluir dados. Veja tudo que ela já consegue fazer hoje:

? Clientes e Categorias
? Crédito do Cliente
? Formas de Pagamento
? Produtos e Cadastros Relacionados
? Vendas e Pedidos

Como liberar o uso da API atual?

Simples: basta solicitar a liberação diretamente pelo painel Admin do sistema.


Valor

A liberação da API tem um custo único de R$ 299/mês.

API NOVA (3.0)

O que é uma API?

API significa Application Programming Interface, ou Interface de Programação de Aplicações.
De forma objetiva, é um conjunto de padrões que permite que dois sistemas diferentes se comuniquem diretamente, de forma automática, segura e organizada.

Na prática, a API permite que desenvolvedores criem integrações com o sistema da CPlug para consultar, cadastrar, atualizar ou excluir dados, como clientes, produtos, vendas, entre outros.


Introdução

A API da ConnectPlug permite que parceiros utilizem diversos recursos da plataforma, como gerenciar lojas, pedidos e integrações.

A ConnectPlug oferece soluções para a operação e gestão de vendas, possibilitando integrar PDV/POS ou qualquer outro aplicativo.


Organização da Documentação

A documentação da API está organizada em categorias para facilitar a navegação:

? Acesse a documentação completa aqui:
? Documentação API NOVA (3.0)


O que muda na Nova API da CPlug?

A nova API da CPlug foi desenvolvida para atender demandas mais complexas e proporcionar maior controle e segurança nas integrações. Ela não substitui imediatamente a API anterior — ambas seguem ativas, mas com objetivos distintos.

Principais mudanças:

? Controle por integrador:
Agora, é necessário cadastrar o desenvolvedor como um integrador, com informações como nome, CNPJ, e-mail de desenvolvimento e telefone. Cada integrador recebe credenciais fixas e exclusivas (Client ID e Client Secret).

? Gerenciamento de múltiplas lojas:
Após o cadastro do integrador, as lojas são vinculadas a ele com base no schema e no e-mail do usuário principal da loja, o que permite centralizar o acesso em uma única conta (útil para quem integra várias lojas com um mesmo sistema).

? Autenticação mais robusta:
A autenticação é feita via Client ID + Secret + usuário e senha da loja, garantindo maior segurança e rastreabilidade.

? Envio de credenciais:
As credenciais são enviadas diretamente por e-mail aos desenvolvedor pelo responsável técnico Cplug.
O e-mail do desenvolvedor é essencial para o recebimento de logs e notificações de atualizações da API.


Funcionalidades da Nova API

A nova API possui todas as funcionalidades da versão anterior e novas funções em constante expansão.

? Importante:
Como a nova API está em evolução contínua, é fundamental que o desenvolvedor consulte regularmente a documentação oficial para acompanhar os recursos disponíveis.

Além disso, os desenvolvedores cadastrados recebem por e-mail notificações automáticas com logs de mudança e atualizações da API, garantindo que estejam sempre atualizados com as novidades.


Como liberar o uso da nova API?

Para liberar o uso da nova API, se faz necessário:

  1. Abrir um chamado no Movidesk destinado ao N2

  2. Utilizar a macro específica para nova API: [  (EXCLUSIVO SUPORTE) Solicitação para liberação de uso API V3.0 ]

  3. Preencher todas as informações obrigatórias:

    • Nome e CNPJ do integrador

    • E-mail de desenvolvimento

    • Telefone

    • Schema(s) da(s) loja(s) a serem vinculadas

    • E-mail do usuário principal da loja

Após o chamado ser recebido, o time N2 encaminhará a solicitação para o time de Produtos, que realizará as etapas técnicas de liberação:

  1. Cadastro do integrador, com as informações fornecidas

  2. Geração das credenciais exclusivas (Client ID e Client Secret)

  3. Vinculação das lojas ao integrador com base nos schemas e no usuário principal

  4. Criação do usuário da loja na API, com autenticação via e-mail e senha

✅ Após essas etapas, as credenciais da nova API serão enviadas diretamente por e-mail ao desenvolvedor responsável.

? Importante: o processo é manual e controlado pela equipe técnica para garantir segurança.


Valor

A liberação da API (tanto nova quanto antiga) tem um custo de R$ 299,00/mês.