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-10-29​

Corrigido​

  • Quebra de linha nas informações complementares da NF-e. Um infCpl com mais de uma linha chegava ao XML só com a primeira, sem aviso. Agora o texto vai inteiro, com cada quebra convertida em ; . Ver Informações complementares (OBS).

Adicionado​

  • danfe_config.quebrar_linha_obs (NF-e): quebra a linha do DANFE em cada ; das informações complementares.

2026-10-20​

Adicionado​

  • NFS-e Nacional pelo motor próprio. A DPS é montada e conferida contra o XSD oficial antes de ir para a Sefin, e cada erro volta com o caminho do campo. Ver NFS-e Nacional — motor próprio.
    • POST /v1/nfse-nacional/emitir, POST /v1/nfse-nacional/condominios/emitir e POST /v1/nfse-nacional/validar.
    • Campo versao para escolher o leiaute: 1.01 (padrão), 1.01-20261020 (XSD oficial de 20/10/2026) e 1.01-nt009 (condomínios, provisório).
    • A validação não consome cota nem numeração.

Atenção​

  • No leiaute 1.01-20261020, finNFSe sai de IBSCBS e vai para infDPS, e CST e cClassTrib sobem de IBSCBS.valores.trib.gIBSCBS para IBSCBS.valores.trib. O payload do leiaute 1.01 é recusado nesse leiaute.
  • A rota POST /v1/nfse/emitir não mudou. As integrações existentes continuam funcionando sem ajuste.

2026-09-25​

Adicionado​

  • Notas recebidas (captura). As NF-e e NFS-e que fornecedores emitem contra as suas empresas, baixadas das fontes oficiais — SEFAZ para NF-e e o Ambiente de Dados Nacional para NFS-e. Ligar e desligar por empresa e por tipo, consultar, baixar o XML e receber aviso por webhook. Incluída por plano. Ver Notas recebidas.
    • GET e PUT /v1/captura, GET /v1/captura/notas, GET /v1/captura/notas/xml, PUT /v1/captura/webhook e POST /v1/captura/webhook/segredo.
    • Referência própria, gerada do código: api.conota.dev/v1/captura/docs.
    • No MCP: estado_da_captura, listar_notas_recebidas, xml_da_nota_recebida e ligar_ou_desligar_captura.

Atenção​

  • O webhook das notas recebidas não usa o mesmo contrato do webhook de emissão: headers X-Conota-*, chave de assinatura por conta e assinatura sobre <timestamp>.<corpo>. Ver Webhook das notas recebidas. O webhook de emissão não mudou.

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 passou a tolerar pontuação. Exceção importante: a barra da máscara do CNPJ é separador de caminho e continua quebrando a rota — em parâmetro de caminho, envie sem ela. Em query string e no corpo, a máscara completa é aceita.

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.

Última atualização em