Agora no Bluesoft ERP, é possível retornar o status de um pedido de venda balcão para SEPARADO através de uma atualização via API.

O Que Mudou?

A API de atualização de status foi flexibilizada para permitir o retrocesso do pedido ao status SEPARADO, desde que ele esteja em etapas específicas de integração. Isso garante resiliência ao processo de venda balcão, permitindo que falhas técnicas no PDV sejam contornadas sem a perda do pedido original.

Benefícios:

  • Resiliência Operacional: Permite a recuperação de pedidos em caso de erros de integração no PDV.
  • Rastreabilidade: Registro automático da data de alteração e do usuário responsável pela troca de status.
  • Integridade de Dados: Validações rígidas impedem transições de status não autorizadas.

Como Irá Funcionar a Partir de Agora?

A atualização é realizada através do endpoint de troca de status, que agora inclui o novo valor no seu enumerador genérico.

  1. Requisição: Deve ser enviado um método POST para o endpoint:/api/venda/pedidovenda/{pedidoVendaKey}/status.
  2. Payload: O corpo da requisição (JSON) deve conter obrigatoriamente o novo status:{ "status": "SEPARADO" }.
  3. Regras de Transição: A alteração para SEPARADO só será autorizada se o status atual do pedido no banco de dados for:
    • INTEGRADO_PDV
    • ENVIADO_PDV
  4. Auditoria Automática: Ao processar a troca, o sistema atualizará automaticamente o campo dataAlteracao no formato DD/MM/AAAA HH:MM.
  5. Identificação: O usuário que realizou a chamada será registrado no log de auditoria.

Observações / Validações

  • Tratamento de Erros: Caso o pedido esteja em status como FECHADO ou CANCELADO, a API retornará HTTP 400 Bad Request com a mensagem: “Atualização de Status não permitida. O pedido deve estar em INTEGRADO_PDV ou ENVIADO_PDV para retornar a SEPARADO.”.
  • Permissões: É obrigatório que o usuário/token possua a permissão 4157 – API Pedido Venda (Alterar).
  • Validação de Existência: O sistema valida se o pedidoVendaKey informado existe na base de dados antes de qualquer operação.

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