Integração com ERP (Gestão Empresarial | ERP)

A integração entre o Senior WMS Alcis Web e o ERP (Gestão Empresarial | ERP) é fundamental para garantir a sincronização eficiente dos processos logísticos e empresariais. Este manual aborda detalhadamente os passos necessários para configurar essa integração, incluindo os tipos de instalação, ativação das APIs, e os fluxos de comunicação entre os sistemas. Através desta documentação, espera-se proporcionar uma visão clara e prática para a correta implementação e operação do sistema integrado.

Macro Fluxo do Processo de Integração ERP (Gestão Empresarial | ERP) x Senior WMS Alcis Web

Primeiros passos

1. Reunião entre Departamento Comercial e Departamento de Projetos

   O Departamento Comercial realiza uma reunião com o Departamento de Projetos para alinhar o escopo do projeto.

2. Solicitação de Base

   O Gerente de Projetos acessa o link de solicitação de base e informa os dados necessários para a criação da base da aplicação que será usada no projeto.

   

3. Tipos de Instalação
   • Instalação da API de Integração em um Servidor: Manual de Instalação da API de Integração em um Servidor.
   • Instalação On-Premise (Local): Manual de Configuração das Notificações dentro do WMS Full – On-Premise.
4. Criação da Base e Documentação

   A equipe de Cloud recebe o formulário eletrônico com os dados da base que precisa ser criada, efetua a criação da base e envia um e-mail com a documentação dos acessos da base solicitada. O e-mail será enviado com o assunto Entrega de Ambiente – EMPRESA XXXXXXX e em anexo haverá as informações da base solicitada, incluindo links, urls, usuários e senhas.

Integração via API

Dados para Conexão das APIs

• URL: https://apihml.alcis.com.br:4434
• Usuário: usuario
• Senha: senha
• Alias: alias

Ativação das APIs

WMS - Configuração da URL da API

Na tela Configuração do Sistema (SD900), no campo Variável, deve-se consultar por URL_NOTIFICATION e no campo Valor, inserir a URL da API.

Postman

A equipe de projetos pode realizar testes internos para garantir que as APIs estão ativas no WMS. Para isso, deve-se efetuar o download das APIs padrão da aplicação.

• Acesse o link da documentação da API enviado no documento de liberação de base.
• Realize o download das APIs padrão e parametrize as APIs que serão utilizadas.

APIs Sentido IN | ERP (Gestão Empresarial | ERP) envia para o Senior WMS Alcis Web

APIs Sentido OUT | Senior WMS Alcis Web envia para o ERP (Gestão Empresarial | ERP)

Tabela de Endpoints

Na tela Configuração de URL de Notificação (SD314), deve-se efetuar a parametrização das APIs e informar a URL de Notificação que será utilizada.

Processo Integrado (Automático) com Origem no ERP (Gestão Empresarial | ERP)

APIs - Dados Mestres (ERP x WMS)

CLIENTES

Quando o ERP registra a inclusão ou alteração de um cliente, o sistema ERP envia o cadastro para a fila da API CLIENTES para envio ao WMS.

FORNECEDOR

Quando o ERP registra a inclusão ou alteração de um fornecedor, o sistema ERP envia o cadastro para a fila da API FORNECEDOR para envio ao WMS.

TRANSPORTA

Quando o ERP registra a inclusão ou alteração de uma transportadora, o sistema ERP envia o cadastro para a fila da API TRANSPORTA para envio ao WMS.

PRODUTOS

Quando o ERP registra a inclusão ou alteração de um produto, o sistema ERP envia o cadastro para a fila da API PRODUTOS para envio ao WMS.

• Produto Padrão

  

• Produto com Gestão de Lote

  

Processo integrado (automático) com origem no ERP (Gestão Empresarial | ERP) e Retorno do Senior WMS Alcis Web

Recebimento

Quando o ERP registra a inclusão de uma nova NFe de recebimento, a API é enviada para o WMS.

API RECEBIMENT (ERP x WMS)

Recebimento Finalizado

API CONFRNF (WMS x ERP)

Quando o WMS finaliza o processo de recebimento, a API é enviada para o ERP.

Registro integrado no ERP

O ERP efetua o GET para obter os dados referentes à NFe recebida.

Pedido de saída

Quando o ERP registra a inclusão de uma nova pré-fatura ou NFe de venda, a API é enviada para o WMS.

API PEDIDOS (ERP x WMS)

API STATPED (WMS x ERP)

A API é enviada para o ERP indicando o status do pedido no WMS a cada etapa do processo de saída. Os status dos pedidos no WMS são:

• 25 – Planejamento Concluído
• 35 – Reservado
• 54 – Em Curso de Separação
• 55 – Separado
• 74 – Em Curso de Conferência
• 75 – Conferido
• 95 – Expedido
• 84 – Cancelado

API CONFPED (WMS x ERP)

Quando o WMS finaliza o processo de conferência de um pedido, a API é enviada para o ERP.

O ERP efetua o GET para obter os dados referentes à conferência efetuada.

Faturamento

API FATURAMENT (ERP x WMS)

Quando o ERP efetua a emissão da NFe da Pré-Fatura envia para o WMS essa API.

Os dados da NFe são gravados no detalhe do pedido/expedição.

Solicitação de Cancelamento

API SOLICITACA (ERP x WMS)

Essa API é enviada automaticamente pelo ERP no caso de um cancelamento de Nota Fiscal.

Cancelamento (WMS x ERP)

Se houver a necessidade de efetuar algum cancelamento no WMS, seja no processo de recebimento ou saída que o ERP já tenha enviado a API para o WMS, deve ser dado algum tipo de aviso. O processo no WMS não pode ser cancelado sem a autorização do cliente.

CANCRNF - Recebimento

Quando o WMS efetua o processo de cancelamento de um registro de entrada, será enviada para o ERP essa API.

CANCPED – Pedido

Quando o WMS efetua o processo de cancelamento de um registro de saída, será enviada para o ERP essa API.

Bloqueio e Desbloqueio de estoque

API BLOQDES (WMS x ERP)

Deve existir a mesma correlação do motivo de avaria/bloqueio do WMS com o ERP, para que o processo de bloqueio e desbloqueio seja realizado com sucesso entre o WMS e o ERP.

WMS - Código de bloqueio	Descrição	ERP - Código de Bloqueio	Imagem do registro no ERP
AM	Amassado	AM
DC	Descarte	DC
FU	Furado	FU
QB	Quebrado	QB

Inventário

API AJSTINVSNR (WMS x ERP)

API responsável por retornar os valores do ajuste de inventário realizado no WMS Alcis. O envio dessa API ocorre quando existe uma divergência na quantidade aferida na execução do inventário ou num ajuste de estoque, seja essa quantidade positiva ou negativa. Caso não haja divergência, a API não é enviada.

A API pode ser enviada por dois processos distintos no WMS:

• Processo de Inventário
  • Ao realizar a validação do plano de inventário, se houver divergência no estoque aferido, seja ela positiva ou negativa, é realizado o envio da API AJSTINVSNR.
• Processo de Ajuste de Estoque
  • Processo realizado pelo Coletor de Dados (RF) / Coletor Web / TellNet, acessando o menu 1. Admin/Inv > 2. Inventario/Estoque > 2. Ajuste Estoque.
    • O envio da API AJSTINVSNR acontece apenas quando é realizado o ajuste de quantidade, seja ela positiva ou negativa.

Exemplos do envio da API:

• Estoque Livre com ajuste positivo: o campo tipoDeAjuste é enviado como P.

  

• Estoque Livre com ajuste negativo: o campo tipoDeAjuste é enviado como N.

  

• Estoque Bloqueado com ajuste positivo: o campo tipoDeAjuste é enviado como N e o campo Indicador de Bloqueio é enviado como 90. Os campos codigoBloqueio e motivoBloqueio também são preenchidos.

  

• Estoque Bloqueado com ajuste negativo: o campo tipoDeAjuste é enviado como N e o campo Indicador de Bloqueio é enviado como 90. Os campos codigoBloqueio e motivoBloqueio também são preenchidos.