Agora no Bluesoft ERP, é possível realizar o cancelamento de pedidos de venda do Força de Vendas e de notas fiscais de venda e-commerce diretamente por meio de integração via API.

Como Irá Funcionar a Partir de Agora?

A partir desta versão, foram disponibilizados dois novos endpoints para que os sistemas integrados realizem essas operações de forma automática e segura:

1. Cancelamento de Pedido E-commerce por API

  • Endpoint: POST /venda/pedidovenda/e-commerce/cancelar
  • Funcionamento: O sistema externo envia no payload os campos obrigatórios ecommerceKey (identificador da integração) e numeroPedido (número do pedido externo).
  • Regras de Negócio e Validações:
    • O ERP localiza o pedido correspondente e realiza as mesmas validações funcionais já aplicadas no cancelamento manual via tela (bloqueia se o pedido já estiver faturado, entregue, em faturamento ou já cancelado).
    • Se o pedido estiver no status de Separado no WMS, o cancelamento via API irá desfazer a ordem de separação vinculada e cancelar a reserva temporária de estoque, devolvendo o saldo comprometido.
    • Caso o pedido seja cancelado com sucesso, o status do pedido do cliente muda para Cancelado e, caso todos os clientes do pedido do Força de Vendas sejam cancelados, o pedido principal também será atualizado para Cancelado.

2. Cancelamento de Nota Fiscal de Venda E-commerce por API

  • Endpoint: POST /estoques/notas-fiscais/cancelar
  • Funcionamento: Permite solicitar o cancelamento de uma nota fiscal de venda e-commerce. O sistema localiza o documento fiscal através de uma das seguintes formas de identificação enviadas no payload:
    • Por meio do identificador interno da nota (nfKey);
    • Por meio da chave de acesso da NF-e (chave, contendo exatamente 44 caracteres numéricos);
    • Por meio da combinação de origem do e-commerce (ecommerceKey) e número do pedido (numeroPedido).
  • Validações: O campo justificativa é obrigatório (deve conter entre 15 e 255 caracteres). O processamento ocorre de forma assíncrona, e a API retorna um requestId para acompanhamento do status do cancelamento na fila.

Observações Importantes!

  • Permissões de Acesso: Para utilizar os novos endpoints, as credenciais de API precisam possuir as respectivas permissões de segurança liberadas:
    • Permissão 4667 - API Pedido Venda e-commerce (Cancelar).
    • Permissão 4668 - API Notas Fiscais (Cancelar).
  • Regras Fiscais: O cancelamento de nota fiscal por API respeita todas as travas fiscais do ERP. A operação será rejeitada caso a nota fiscal já esteja cancelada ou se a escrita fiscal referente ao período já tiver sido apurada.
  • Logs e Observabilidade: Todas as tentativas de cancelamento via API geram logs detalhados no ERP, registrando a origem (API), o motivo enviado, as credenciais utilizadas e o resultado da operação (sucesso ou falha com a mensagem correspondente).

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

Disponível a partir da versão r371.01