Outubro
Melhorias entregues até 22/10/2026
Obrigatoriedade do campo prestadorMunicipioCodigo no serviço de Notas Fiscais
Informamos que o campo prestadorMunicipioCodigo passa a ser de preenchimento obrigatório no serviço do Service Layer de Notas Fiscais (/notas-fiscais).
Métodos afetados:
- POST
- PUT
- PATCH
Requisições sem esse campo serão rejeitadas.
Motivo da alteração:
O sistema usa esse campo para identificar se o prestador é de dentro do município, e com isso, identificar quais notas fiscais podem ser listadas na geração da guia de pagamento pelo e-nota, uma vez que prestadores de fora do município a geração da guia é realizada pelo sistema Livro Eletrônico. Notas migradas sem esse campo não aparecem nessa listagem, o que impede a emissão correta das guias.
O que fazer:
- Revise as integrações e os processos de migração que usam o endpoint /notas-fiscais.
- Garanta que o campo prestadorMunicipioCodigo seja informado em todas as requisições de inclusão e de alteração.
Novos campos da Nota Técnica 004 no serviço de Notas Fiscais
Informamos que o serviço do Service Layer de Notas Fiscais (/notas-fiscais) passa a aceitar a migração de todos os campos do layout da Nota Técnica 004 que hoje ainda não estão disponíveis.
Serviços contemplados:
- Inserção (POST)
- Atualização (PUT e PATCH)
Motivo da alteração:
Com essa mudança, as informações exigidas pelo layout da NT 004 podem ser enviadas por completo, tanto na inclusão quanto na alteração das notas fiscais, permitindo assim a migração na íntegra das informações da nota fiscal que compete à Reforma Tributária.
Onde consultar os campos:
A relação completa está na guia Leiaute DPS_NFS-e - RTC.
O que fazer:
- Consulte o layout anexo e identifique os novos campos que se aplicam à sua integração ou migração.
- Ajuste as integrações e os processos de migração para enviar esses campos nas requisições de inserção e de atualização.
Nova API para consulta dos lotes
Foi disponibilizada uma nova opção para Consulta de lotes, que retorna o status do processamento do lote enviado de forma mais rápida e performática, conforme destacado na imagem abaixo.
Para utilizá-la, é necessário ser passado como parâmetro (onde consta o path) o nome do serviço utilizado anteriormente no processo de envio, seja para inserções, atualizações ou exclusões.
|
|---|
Exemplo de aplicação:
Realizado o envio pelo metodo POST do serviço de notas-fiscais (https://nota-eletronica.betha.cloud/service-layer/api/notas-fiscais)
Para consultar o status do processamento utilizando a nova API, a URL parametriza-se da seguinte forma: https://nota-eletronica.betha.cloud/service-layer/api/consulta/notas-fiscais/{idLote}
Importante: as integrações e os processos de migração atuais devem ser ajustados para utilizar a nova API de consulta de lotes, pois a API anterior será descontinuada a partir de 01/12/2026.
