Agora no Bluesoft ERP, é possível realizar a confirmação automática das notas fiscais de recebimento de mercadorias vinculadas a uma carga assim que o recebimento for finalizado sem divergências via API.

O objetivo desta melhoria é garantir a consistência e a simetria entre o fluxo operacional realizado manualmente no ERP e o fluxo executado via integração com sistemas externos, eliminando a necessidade de uma etapa manual posterior para a confirmação fiscal das notas.

Como Irá Funcionar a Partir de Agora?

A partir desta atualização, o endpoint de fechamento de carga existente foi evoluído para suportar, de forma automatizada e opcional (no modelo opt-in), a continuidade do fluxo fiscal.

Após a consolidação dos dados operacionais, o sistema passará a decidir se executa ou não a confirmação automática das notas com base em duas chaves de ativação obrigatórias e combinadas:

  1. O parâmetro do ERP: A opção “Confirmar o recebimento de notas fiscais de recebimento de mercadorias assim que a carga sem divergência for finalizada” deve estar devidamente ativa no sistema.
  2. A nova permissão da API: O usuário integrador responsável pela chamada deve possuir a nova permissão de acesso 4640 habilitada.

Além disso, o endpoint foi otimizado para retornar um objeto no corpo da requisição que lista o status de processamento de cada uma das Notas Fiscais (notasFiscalRecebimento), facilitando a depuração e o acompanhamento das integrações.

Observações Importantes!

  • Garantia de Retrocompatibilidade: Para os clientes atuais que não ativarem o parâmetro ou não concederem a nova permissão ao usuário da API, o endpoint continuará operando exatamente como antes, limitando-se apenas ao fechamento físico da carga, sem gerar erros adicionais ou quebras de contrato.
  • Processo Não-Bloqueante: O processo de fechamento das notas ocorre em segundo plano de forma não-bloqueante. Isso significa que, caso alguma nota fiscal encontre um impedimento de negócio já previsto nas regras do ERP, a carga permanecerá fechada com sucesso e o erro de confirmação da nota ficará visível no retorno da API para tratativa, sem reverter o encerramento da carga.
  • Elegibilidade Fiscal: O sistema reutiliza as regras nativas do ERP para validar se as notas possuem certificado digital válido e se cumprem os requisitos fiscais para a confirmação automática.

Para conhecer mais sobre como é a utilização dessa ferramenta, clique aqui.

Para saber mais sobre a utilização das APIs do ERP, clique aqui.

Disponível a partir da versão r370.19