Agora no Bluesoft ERP, é possível permitir que a API pública de recebimento de cargas realize a exclusão de cargas que já tenham o recebimento iniciado (com data de abertura preenchida) ou que já possuam itens vinculados, desde que o integrador possua uma nova permissão complementar específica.

Como Irá Funcionar a Partir de Agora?

A exclusão continuará sendo centralizada e realizada através do mesmo endpoint existente:

  • DELETE /api/compras/recebimentocargas/{movimentacaoCargaKey}

O comportamento do sistema passa a ser controlado pela combinação de duas permissões:

  • Cenário 1 (Comportamento Padrão mantido): Se o integrador possuir apenas a permissão tradicional 4333 – API Recebimento Carga (Excluir), ele conseguirá excluir normalmente apenas as cargas que estejam abertas, sem início efetivo e sem itens lançados. Caso tente excluir uma carga iniciada ou com itens usando apenas essa permissão, o sistema retornará um erro funcional alertando sobre a necessidade da autorização complementar.
  • Cenário 2 (Novo Fluxo Liberado): Se o integrador possuir a permissão tradicional 4333 e também a nova permissão complementar 4651 – API – Excluir Recebimento de Carga Aberta e com Itens, o endpoint permitirá com sucesso a exclusão da carga mesmo que ela já possua data de abertura registrada e/ou produtos e quantidades vinculados. O sistema retornará o status 200 OK com a mensagem: “Carga de recebimento excluída com sucesso.”.

Observações Importantes!

  • Segurança e Regras Mantidas: Cargas de recebimento que já estejam com status finalizado, encerrado ou que possuam outros vínculos operacionais impeditivos continuarão sendo bloqueadas pelo sistema, mesmo se o usuário possuir a nova permissão complementar.
  • Dependência Estrita: A nova permissão complementar (4651) não substitui a permissão padrão (4333). Caso o integrador possua a nova permissão mas não possua a 4333, a operação será barrada com o erro 401 Unauthorized por ausência de acesso básico ao endpoint.

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 r371.01