Introdução ao Conota
O Conota é uma plataforma de infraestrutura fiscal para desenvolvedores. A API concentra em uma única integração as operações necessárias para que sistemas, ERPs, plataformas SaaS e aplicações próprias trabalhem com documentos fiscais sem precisar implementar individualmente a comunicação com cada autorizador.
A integração principal é feita por API REST, com requisições e respostas em JSON.
O Conota também disponibiliza uma integração via Model Context Protocol (MCP). Com ela, assistentes e agentes de IA compatíveis consultam informações fiscais, localizam emissões, analisam rejeições e executam fluxos suportados a partir de linguagem natural.
Quatro superfícies, quatro papéis
Nada aqui é redundante — cada endereço responde um tipo diferente de pergunta.
| Onde | Para quê |
|---|---|
| docs.conota.dev (aqui) | como integrar: conceitos, fluxos, decisões |
| api.conota.dev/docs | o contrato exato: endpoints, campos, tipos, enums |
| api.conota.dev/swagger | console para disparar chamadas com a sua chave |
| mcp.conota.dev | as ferramentas publicadas para agentes de IA |
Quando você precisar do nome exato de um endpoint, dos campos aceitos ou do schema de uma resposta, vá à Referência da API. Este portal não copia tabelas de campos: elas são geradas do código do gateway, e uma cópia manual envelheceria em silêncio.
Endereço da API
https://api.conota.dev
Os domínios api.conota.com.br, api.pluganota.com e api.qualyfiscal.com.br são aliases do
mesmo serviço. Nenhuma integração existente precisa mudar de endereço.
Escolha seu caminho
- Quero integrar o Conota ao meu sistema: siga para Onboarding da integração.
- Quero consultar os endpoints: abra a Referência da API.
- Quero testar uma chamada agora: abra o Swagger.
- Quero conectar um assistente de IA: veja o Conota MCP.
O Conota valida estrutura, assina e executa a comunicação fiscal. A definição tributária da operação — CFOP, CST/CSOSN, alíquotas, NCM — continua sendo da sua regra de negócio. Esta documentação diz explicitamente onde essa fronteira passa, em vez de fingir que tributação é genérica.