Agora no Bluesoft ERP, é possível automatizar o fluxo de devolução de estoque de trocas entre lojas e Centros de Distribuição (CDs) através de integração via API.

Essa nova funcionalidade permite realizar a consulta de notas fiscais de transferência de entrada e processar a emissão da nota de devolução de forma totalmente integrada ao ERP.

Objetivo

O objetivo desta novidade é permitir que clientes que utilizam sistemas externos ou processos automatizados possam realizar a devolução de produtos do Estoque de Troca sem a necessidade de intervenção manual na tela do ERP, garantindo agilidade e integridade no controle de saldos.

Como Era o Processo Antes?

Anteriormente, a devolução de estoque de trocas era um processo estritamente manual. O operador precisava:

  1. Acessar o módulo Estoque e NF-e.
  2. Seguir o caminho: Transferência entre Lojas > Devolução > Estoque de Troca.
  3. Filtrar as notas fiscais de transferência de entrada, selecionar os itens e processar o faturamento da nota de devolução manualmente. Este cenário gerava um gargalo para operações de grande volume que demandavam automação via sistemas externos ou integradores.

Como Irá Funcionar a Partir de Agora?

A nova integração foi estruturada em um fluxo de chamadas sequenciais para garantir que a devolução ocorra com segurança:

  1. Consulta de Notas Elegíveis: Através do endpoint GET /api/estoque/operacoes-entre-lojas/devolucao-troca, o sistema lista as notas fiscais com saldo de troca disponível para o período informado (limite de até 1095 dias de intervalo) ou conforme parâmetro no ERP.
  2. Execução da Devolução: O endpoint POST /api/estoque/operacoes-entre-lojas/devolucao-troca/devolver processa a solicitação.
    • Validação Síncrona: O sistema verifica se há saldo de estoque de troca suficiente
    • Processamento Assíncrono: A API retorna um requestId.
  3. Monitoramento: O status da emissão da nota fiscal (Sucesso ou Rejeição Sefaz) deve ser consultado no endpoint GET /api/monitoramento/async/{requestId}.

Exemplo de JSON:

{
  "lojaOrigemKey": 4,
  "lojaDestinoKey": 9,
  "nfKey": 120433,
  "itens": [
    {
      "notaFiscalItemKey": 105378,
      "quantidadeDevolver": 1
    }
  ]
}

Observações Importantes!

  • Segurança: Para utilizar os novos endpoints, são necessárias as permissões 4504-API Devolução de entrada (Consultar) e 4505-API Devolução de entrada (Incluir).

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