Operador logístico
Tipo de operação logística que envolve um armazém geral, destinado à guarda e conservação de produtos de terceiros. O recebimento e a expedição das mercadorias são gerenciados pelo Gestão de Armazenagem | WMS Senior, que efetua o registro das notas fiscais emitidas nos respectivos processos de entrada e saída. Além disso, é responsável pelo gerenciamento dos saldos de estoque das mercadorias, conforme as movimentações.
Saiba mais sobre o fluxo de operação em Armazenagem geral.
Como funciona?
O Gestão Empresarial | ERP recebe as notas fiscais de entrada e saída, assim como os saldos físicos de estoque, controlados pelo Gestão de Armazenagem | WMS Senior, para realizar a integração com o módulo de tributos.
A integração no modelo Operador Logístico está disponível apenas entre o Gestão Empresarial | ERP e o Gestão de Armazenagem | WMS Senior (SILT), não sendo compatível com o WMS ALCIS.
Pré-requisitos
- Gestão Empresarial | ERP na versão 5.10.3.86 ou superior/5.10.4.32 ou superior
- Gestão de Armazenagem | WMS Senior na versão 8.12.7.449 ou superior, obrigatoriamente configurado com as integrações utilizando o protocolo REST.
Importante
O Gestão de Armazenagem | WMS Senior deve obrigatoriamente estar configurado para que as integrações utilizem o protocolo REST.
Componentes
O componente ERP Service é responsável pela comunicação entre o Gestão Empresarial | ERP e o serviço de integração ISL. Para que a integração funcione corretamente, é essencial que esse serviço esteja devidamente configurado e ativo.
Caso não esteja em execução, consulte o Manual de Instalação – ERP Service e siga o procedimento de ativação.
O componente ETL ERP é responsável pela limpeza da tabela de pendências (RTC_PENDENCIES) que já foram integradas, garantindo a estabilidade e a performance do processo.
Caso o componente não esteja ativo, acesse o Manual de Instalação – Integrador e siga o procedimento de ativação.
Parametrizações
Essas configurações devem ser realizadas em conjunto para garantir os fluxos de integração, após levantamento das necessidades processuais.
Configurações de conectividade
O processo a seguir deve ser realizado apenas em ambientes onde nunca tenha ocorrido integração entre o Gestão Empresarial | ERP e o Gestão de Armazenagem | WMS Senior.
- Na plataforma, acesse Tecnologia > Administração > Gerenciamento de aplicações.
- Clique em Nova aplicação.
- Informe o Nome e a Descrição para identificá-la.
- Na Geração de tokens, selecione a opção “Reutilizar o mesmo token para as múltiplas sessões de aplicação”.
- Clique em Salvar.
- Copie a Chave de acesso e o Secret para mantê-los em local seguro, pois ao finalizar esse processo, não será mais possível recuperá-los.
- Clique novamente em Salvar.
Saiba mais em Gerenciamento de aplicações.
- Na plataforma, acesse Tecnologia > Administração > Autorização > Gestão dos papéis.
- Clique em Novo papel.
- Informe o Nome do papel e a Descrição do papel para identificá-lo.
- Na guia Permissões, filtre pelo domínio/serviço erp_isl / int_integrador.
- Expanda o serviço listado e marque a caixa de seleção de todos os recursos apresentados.
- Na guia Aplicações, associe a aplicação desejada ao papel.
- Clique em Salvar.
Saiba mais em Gestão dos papéis.
- Acesse Configuração de Integração.
- Informe o Nome do tenant, Chave de acesso a plataforma e Chave secreta de acesso.
- Clique em Validar e aguarde a mensagem "Autenticação na Plataforma SeniorX realizada com sucesso".
Configurações de integração
- Acesse Cadastros > Integrações > Gestão de Armazenagem | WMS Senior > Configurações (F185CFG).
- Defina a Empresa e a Filial que será realizada a integração.
- Defina as parametrizações apenas nas guias listadas abaixo. As demais guias não contêm configurações utilizadas na integração do modelo de Operador Logístico.
- Em Tipo de Operação WMS, indique “1 - Operador Logístico".
- Em Destino WMS, indique "1" que trata-se do Gestão de Armazenagem | WMS Senior;
- No campo Url WMS, informe a API de acesso para envio/retorno de dados;
- Preferencialmente, a Url deve ser configurada com uso do IP externo onde as API´s do WMS Silt respondem. O uso da Url sem IP, pode ocasionar problemas de comunicação da Senior X com WMS Silt. Exemplo: http://wmssilt.meuambiente.com.
- Ao final da Url, deve existir obrigatoriamente uma barra (/). Exemplo: http://201.16.222.65:8080/siltwms/.
- Esta informação pode ser cadastrada em dois lugares: na tela Integração - Cadastros - Configurações - Configuração de integração ERP WMS (F185CFG) do ERP, guia Login WMS, campo Url WMS, e também na plataforma no caminho Tecnologia -> Configuração -> Por Tenant, na sessão Domínios e Serviços, opção "erp_isl". No serviço int_integrador, selecione a opção "Editar", guia Sistema, campo URL do servidor WMS. A rotina de integração utilizará, em primeiro lugar, o que estiver cadastrado na Integração - Cadastros - Configurações - Configuração de integração ERP WMS (F185CFG) e, caso não exista, será utilizado o que estiver cadastrado no XPlatform.
- Determine o Tipo de Login igual a "2" com Token;
- No Token WMS preencha a ApiKey de acesso ao sistema que deve ser gerado no Gestão de Armazenagem | WMS Senior;
- Informe o CNPJ do depositante no campo Código/CNPJ Depositante. Essa informação é obrigatória.
| Observação |
|
|
| Observação |
|
Esta informação pode ser cadastrada em dois lugares: na tela Integração - Cadastros - Configurações - Configuração de integração ERP WMS (F185CFG) do ERP, guia Login WMS, campo Token WMS, e também na plataforma no caminho Tecnologia -> Configuração -> Por Tenant, na sessão Domínios e Serviços, opção "erp_isl". No serviço int_integrador, opção "Editar", guia Sistema, campo WMS API Key. A rotina de integração utilizará, em primeiro lugar, o que estiver cadastrado na Integração - Cadastros - Configurações - Configuração de integração ERP WMS (F185CFG) e, caso não exista, será utilizado o que estiver cadastrado no XPlatform. |
| Observação |
|
O CNPJ deve ser inserido obrigatoriamente com somente números, sem a definição de pontos ou barras. |
Importante
Solicitar ao Gestão de Armazenagem | WMS Senior a configuração dos ganchos e url para autenticação na Senior X.
- Em Destino WMS, indique "2" que trata-se do WMS Alcis;
- No campo Url WMS, informe a API de acesso para envio/retorno de dados;
- Determine o Tipo de Login igual a "1", onde deverá ser informado usuário e senha;
- Preencha o Usuário WMS e a Senha WMS de acesso ao sistema;
- Insira a Alias WMS do banco de dados;
- Informe o site ou o CNPJ do armazém a partir do campo Site/CNPJ armazém;
- Código/CNPJ Depositante;
- Informe o CNPJ do depositante no campo Código/CNPJ Depositante. Essa informação é obrigatória e neste caso, o código do depositante deve ser o mesmo que o código da filial cadastrada no Gestão Empresarial | ERP;
- No campo Integra com Aduaneiro, indique se há a integração de cadastros com o WMS Alcis Aduaneiro, no qual só utilizará a integração de cadastros e pedido de serviço.
| Observação |
|
Esta informação pode ser cadastrada em dois lugares: na tela Integração - Cadastros - Configurações - Configuração de integração ERP WMS (F185CFG) do ERP, guia Login WMS, campo Url WMS, e também na plataforma no caminho Tecnologia -> Configuração -> Por Tenant, na sessão Domínios e Serviços, opção "erp_isl". No serviço int_integrador, selecione a opção "Editar", guia Sistema, campo URL do servidor WMS. A rotina de integração utilizará, em primeiro lugar, o que estiver cadastrado na Integração - Cadastros - Configurações - Configuração de integração ERP WMS (F185CFG) e, caso não exista, será utilizado o que estiver cadastrado no XPlatform. |
| Observação |
|
O CNPJ deve ser inserido obrigatoriamente com somente números, sem a definição de pontos ou barras. |
Nota!
Quando os campos acima tratam-se de WMS na nomenclatura, as informações devem ser fornecidas pela equipe do WMS.
Em Depósito para inventário fiscal, informe o depósito que será utilizado para a escrituração dos saldos físicos.
Configurações fiscais
- Acesse Cadastros > Empresas > Fiscais > Cadastro de Parâmetros Fiscais (F070EPF).
- Em Código Fiscal Produto, indique “7 - Código do operador logístico”.
A parametrização do Código Fiscal do Produto não deve ser alterada e deve sempre permanecer como “7 - Código do operador logístico” para empresas que utilizam o modelo de Operador Logístico. Isso garante a integridade das informações trafegadas e assegura que o Código Fiscal do Produto utilizado no WMS seja o mesmo utilizado no ERP.
Ligações para cadastro de produto
- Acesse Cadastros > Integrações > Gestão de Armazenagem | WMS Senior > Operador Logístico > Classificação Fiscal x Família (F185CFF).
- Selecione a Empresa que será realizada a integração.
- Preencha o relacionamento entre as classificações fiscais e família.
As classificações fiscais devem ser as mesmas cadastradas no Gestão de Armazenagem | WMS Senior, realizando o vínculo com as famílias existentes no Gestão Empresarial | ERP. Consulte a documentação sobre a integração de Nota Fiscal e Inventário Fiscal para maiores detalhes sobre o cadastramento de produtos.
Processos automáticos e agendamentos
Acesse a documentação sobre Agendamentos e ative os agendamentos da Plataforma senior X e os processos agendados do ERP XT, que são essenciais para o funcionamento da integração.
Perguntas frequentes
Acesse a documentação da API de Integração ERP Senior x WMS Senior. Em Parametrizações, consulte o Cadastro de Depositante para verificar se as exportações estão configuradas com o protocolo Rest Sinal SeniorX.
A integração no modelo Operador Logístico ocorre exclusivamente via protocolo REST.
Não. Nenhum identificador de regras é acionado nesse processo, e não é possível realizar personalizações por meio de regras para esse tipo de integração.
Não. Nativamente, o sistema não possui esse comportamento.
Não. O ERP não realiza nenhum tipo de cálculo de impostos nesse processo. Todos os valores e cálculos tributários são efetuados no WMS e enviados diretamente ao ERP Senior.
Caso seja necessário ajustar o cálculo de impostos, essas configurações devem ser feitas diretamente no WMS.
Para documentos que já foram integrados ao ERP e que necessitam de correção nos valores ou impostos, é possível realizar ajustes pontuais por meio das telas do módulo de Tributos no ERP.
Não. Não há integração entre o WMS e o eDocs para emissão e armazenamento das NF-e geradas no processo de Operador Logístico.
Para centralizar o armazenamento dos arquivos XML no eDocs, é possível utilizar o recurso de importação manual de documentos. Consulte o Manual do Usuário do eDocs para mais informações.
Atualmente, não existe nenhuma rotina nativa automatizada para esse tipo de importação.
|
Veja também: |
English
Español
English
Español


