Agora no Bluesoft ERP, é possível consultar informações detalhadas sobre a distribuição logística e mercadorias em trânsito de forma automatizada através de um novo endpoint de integração API.

Objetivo

O objetivo desta novidade é eliminar a necessidade de consultas manuais em telas do sistema, permitindo que ecossistemas externos sincronizem dados de estoque com maior precisão e agilidade.

O Que Mudou?

Agora: Foi disponibilizado o endpoint GET /api/estoque/distribuicao-logistica, que consolida os saldos conforme a prioridade logística (Pedido, Separado, Conferido ou Faturado) e permite a extração detalhada de dados via integração.

Como Irá Funcionar a Partir de Agora?

A consulta é realizada através do método GET, utilizando parâmetros de filtro para retornar uma lista de objetos com os detalhes da distribuição.

1. Parâmetros da Requisição:

  • cdOrigemKey: Identificador da unidade de origem (CD) – Obrigatório.
  • dataGeracaoInicio: Filtro por data inicial (Formato: dd/MM/yyyy) – Obrigatório.
  • dataGeracaoFim: Filtro por data final (Formato: dd/MM/yyyy).
  • produtoKey: Identificador interno do produto.
  • numeroLoteSeparacao: Identificador do lote de separação logística.
  • numeroNotaFiscal: Número da NF para itens em trânsito.
  • tipoDistribuicao: Filtro por tipo (Ex: PROGRAMADA, DEMANDA, FORCADA, TEMPORARIA, entre outros).
  • quantidadesSemArredondamento: Define se os valores de quantidade devem ser arredondados (Default: false).

2. Informações Retornadas: O retorno da API inclui dados cruciais para a gestão logística, como:

  • lojakeyDestino: Identificador da loja de destino.
  • gtin: Código de barras do produto.
  • dataGeracaoReserva: Data original da criação da reserva.
  • quantidades: Segregação entre as quantidades Pedida, Separada, Conferida, Cancelada e Faturada.

Observações / Validações

  • Permissão de Acesso: É necessário possuir a permissão específica: 4532 - API - Estoque - Distribuição Logística (Consultar).
  • Regras de Filtro: A consulta exige obrigatoriamente o cdOrigemKey e a dataGeracaoInicio. Caso a data inicial informada seja superior a 30 dias da data atual, o sistema retornará um erro de validação.
  • Paginação: O sistema utiliza paginação padrão com currentPage (base zero) e pageSize (máximo de 1000 itens por página).

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 r365.89