# 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: - **Autenticação**: Endpoints para obter tokens de acesso - **Catálogo de Produtos**: Gerenciamento de produtos, categorias e unidades - **Produtos - Funcionalidades Descontinuadas**: ⚠ Endpoints que serão removidos em breve - **Aplicativos**: Gerenciamento de aplicativos e disponibilidade de produtos - **Financeiro**: Pagamentos, contas bancárias e transações - **Vendas**: Pedidos, vendas e promoções - **Estoques**: Gerenciamento de estoque e compras - **Empresa**: Configurações da empresa e periféricos - **Relatórios**: Relatórios de vendas e estatística **Acesse a documentação completa aqui:** [Documentação API NOVA (3.0)](https://cplug.redocly.app/openapi) --- ##### 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 \]** Preencher todas as informações obrigatórias: - *CNPJ do integrador:* - *Nome Fantasia do integrador:* - *Razão social do integrador:* - *E-mail de desenvolvimento (onde serão enviadas as credenciais):* - *Nome completo do desenvolvedor responsável (Pessoa Física — não preencher com o nome da empresa):* - *Telefone/WhatsApp de contato do desenvolvedor:* - *Schema(s) da(s) loja(s) a serem vinculadas* 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**.