Agora no Bluesoft ERP, é possível registrar o recebimento de uma carga informando apenas o código do unitizador e a loja operacional de recebimento via API.

Como Irá Funcionar a Partir de Agora?

O fluxo da integração ocorre em duas etapas principais através das rotas públicas atualizadas:

1. Pré-sinalização e Elegibilidade (GET)

Ao consultar as cargas disponíveis no endpoint:

GET /api/compras/recebimentocargas

O sistema passa a retornar novas estruturas para orientar o integrador:

  • permiteRecebimentoPorUnitizador: Campo booleano que indica se a carga está aberta, apta a receber e com o parâmetro funcional ativo.
  • lojasRecebimento: Estrutura contendo a lista de chaves das lojas (lojaKey) e os códigos dos unitizadores (codigoUnitizador) vinculados tecnicamente às notas daquela carga.

2. Processamento do Recebimento (POST)

O registro é efetuado enviando uma requisição para o novo endpoint:

POST /api/compras/recebimentocargas/{movimentacaoCargaKey}/recebimento-por-unitizador

O payload deve conter obrigatoriamente as informações de identificação:

JSON

{
  "codigoUnitizador": 123456789,
  "lojaKey": 123
}

Ao receber a chamada, o ERP realiza as seguintes validações e ações em segundo plano:

  1. Validação de Carga e Parâmetro: Confere se a carga existe, está aberta e se o parâmetro “Permitir que a loja receba mercadoria enviada do CD escaneando o Utilizador utilizado na separação” está ativo no módulo.
  2. Bloqueio de Reprocessamento: Impede a execução caso o unitizador já tenha sido apropriado e processado anteriormente para a mesma carga.
  3. Separação de Itens: O sistema filtra e retira da apropriação automática as linhas de produtos que possuam qualquer restrição ou exijam atributos específicos.

Regras de Negócio e Tratamento de Pendências

Se o unitizador contiver mercadorias em conformidade e mercadorias com restrições, a API efetuará um recebimento parcial. Os produtos considerados não elegíveis para apropriação automática são:

  • Itens com data de validade vencida.
  • Produtos com lote obrigatório no cadastro, mas sem lote informado.
  • Produtos com validade obrigatória no cadastro, mas sem validade informada.
  • Itens que exijam controle de temperatura.
  • Itens que exijam data de fabricação.

⚠️ Nota Importante: Para todos os itens que ficarem retidos com pendências operacionais, o integrador receberá a lista detalhada no objeto itensPendentes com o respectivo motivo e a acaoNecessaria. A continuidade ou correção dessas pendências deverá ser realizada obrigatoriamente de forma manual pelo usuário logado diretamente na interface web do ERP. A API pública não disponibiliza rotas de alteração para correção de atributos retidos.

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