Histórico de mudanças
Mudanças que afetam respostas da API /api/v1, da mais recente para a mais antiga.
17/11/2026 — Textos de orientação e documentação pública
- Orientações de rejeição mais claras. A explicação em português de duas recusas do governo deixou de citar etapas internas da notem.
codigo,campoe status não mudaram:- E0714: agora orienta "Confira se o certificado digital da empresa está válido e corresponde ao CNPJ antes de repetir a emissão."
- E0855: agora termina com "Se a obrigatoriedade do IBS/CBS na notem ainda não começou para este ambiente, fale com o suporte da notem."
- Especificação OpenAPI. Grupos por assunto,
operationId, descrições e exemplos fictícios em todas as 40 operações. Os esquemas passaram a descrever exatamente as respostas atuais (sem mudança de comportamento): empresa com camposnull,pendenciasna situação da empresa, itens dos catálogos, corpo parcial na alteração de serviço,pode_solicitar_analisenos detalhes de erro e o eventonota.desbloqueada_prefeiturana lista de webhooks. - Documentação pública em https://docs.notemfiscal.com.br.
16/11/2026 — Mensagens de validação e identificadores
- Mensagens de validação em português. As mensagens em
detalhes[].mensagemde400 REQUISICAO_INVALIDAe422 REGRA_DE_NEGOCIOque antes saíam em inglês agora são escritas pela notem, em português. Exemplos: "Required" → "Campo obrigatório."; "Unrecognized key(s) in object: 'x'" → "Campo não aceito: x."; "Invalid enum value…" → "Valor inválido. Use: a, b ou c."; "String must contain at most 200 character(s)" → "Use no máximo 200 caracteres."; "Invalid uuid" → "Identificador inválido (UUID).". Códigos (codigo), status ecamponão mudaram. - Campo não aceito. A mensagem cita no máximo 5 nomes de campo, cada um com até 60 caracteres (cortado com "…"), e informa quantos faltam ("e mais N").
- UUID no padrão RFC 9562. Identificadores fora do padrão (por exemplo
00000000-0000-0000-0000-000000000001, ou texto que não é UUID) são recusados com400 REQUISICAO_INVALIDAe ocampopreenchido:- no corpo (ex.:
empresa_id): antes, o formato frouxo passava e a resposta era404; - no caminho (
/empresas/{id},/empresas/{id}/servicos/{servico_id},/empresas/{id}/tomadores/{tomador_id},/empresas/{id}/notas-recebidas/{nota_id},/notas/{id}): antes,404 NAO_ENCONTRADO; - na consulta (
GET /notas?empresa_id=): já era 400; a mensagem agora é "Identificador inválido (UUID).". - Todo identificador emitido pela notem já segue o padrão, então nenhum registro existente é afetado. UUID válido inexistente ou de outra organização continua
404 NAO_ENCONTRADO.
- no corpo (ex.:

