Pular para o conteúdo principal

Changelog

Mudanças relevantes para quem integra com o Conota. Correções puramente ortográficas da documentação não entram aqui.


2026-09-03

Adicionado

  • GET /v1/empresas/numeracao — diz em que número cada sequência está: o número da última nota autorizada por empresa, tipo, série e ambiente. Homologação e produção vêm separadas. É consulta, não reserva. Ver Onboarding.
  • A mesma informação está disponível no MCP, como numeracao_das_notas.
  • Documentação em duas páginas: ReDoc para ler o contrato e Swagger UI para testar. /docs/json e /docs/yaml continuam respondendo nos mesmos endereços.
  • Este portal, em docs.conota.dev.

Alterado

  • CNPJ alfanumérico aceito em toda a API. Desde 31/07/2026 o CNPJ pode ter letras nas 12 primeiras posições. Todos os pontos que tratam documento — rotas, filtros, buscas, máscaras e o MCP — passaram a preservar letras. Antes, elas eram removidas em silêncio, o que podia levar à empresa errada.
    • GET /v1/cnpj/{cnpj} deixou de recusar com "CNPJ deve conter 14 dígitos".
    • Documento na URL agora aceita com ou sem máscara em todas as rotas.

Atenção

  • Bibliotecas de terceiros usadas na emissão ainda não suportam CNPJ alfanumérico. Emitir para ou por um CNPJ com letras depende dessa atualização, já mapeada.

Como usar esta página

Cada entrada indica o que mudou e, quando houver impacto, o que fazer. Mudanças que possam quebrar integrações existentes ficam em Mudanças incompatíveis.