Cadastros
Atenção!
- Esta documentação pontua o processo de integração de cadastros por meio do Protocolo REST. Acesse a documentação de parametrizações para mais informações sobre esse tipo de integração;
- A integração através do ETL ERP funciona somente como replicação de dados dos cadastros, assim como ocorre para qualquer outra integração do ERP com a XPlatform utilizando este componente. Por esse motivo, não será o foco principal nesta documentação.
Pré-requisitos
- Gestão Empresarial | ERP na versão 5.10.2.47 ou superiores;
- A tela F185CFG deve estar devidamente configurada e a etapa de configuração do KEYINT deve estar concluída e preenchida com o valor “;4;”, além dos demais valores de acordo com o processo de integração atual da base de dados. Veja mais em Integração de cadastros;
- As telas F000SIS e F000SXT devem estar devidamente parametrizadas. Mais informações no tópico Configuração da tabela E185CFG;
- Na XPlatform , é necessário realizar o cadastro de agendamentos para que as pendências de cadastros sejam consumidas. Clique aqui para acessar a configuração dos Agendamentos que precisam ser realizados.
Operação
- No caso da implantação da integração, onde os cadastros trafegam através do Protocolo REST e nunca foram integrados através do ETL ERP, é obrigatório que, após a devida configuração das telas F000SIS e F000SXT, seja realizada a Carga Inicial dos cadastros através da tela F000CIV;
- Se na base de dados do Gestão Empresarial | ERP existirem mais filiais da mesma empresa integradas com o sistema WMS, é obrigatório gerar a carga inicial pela tela F000CIV para todas as filiais integradas (mesmo que os cadastros integrados não variem de acordo com Empresa/Filial);
- Após a Carga Inicial dos cadastros, à medida que são cadastrados ou alterados novos produtos, são geradas pendências de integração. As pendências de integração são controladas de acordo com o processo padrão de integração via web service. Veja mais sobre isso no artigo da Base de Conhecimento do Suporte;
- As pendências de integração registradas na tabela E000CIX, são consumidas pelos agendamentos cadastrados na XPlatform(agendarRecuperarFornecedor, agendarRecuperarTransportadora, agendarRecuperarCliente, agendarRecuperarProduto). Por isso a importância de cadastrar esses agendamentos, pois sem eles, as pendências de integração da tabela E000CIX não seriam consumidas e os registros não seriam integrados para a Plataforma.
Pontos relevantes Em uma migração de processo de integração de Cadastros via ETL ERP para integração via Protocolo REST, deve-se levar em consideração de que os registros deixam de ser pendenciados através das Triggers com prefixo “RTC” e passam a ser pendenciados de acordo com a lógica de controle de exportação via web services. Portanto, caso existam customizações/integrações com o Gestão Empresarial | ERP construídas baseadas nas triggers “RTC” para exportação de registros para o WMS, essas customizações/integrações devem ser revistas para se adequarem a lógica de integração via WebServices. Pode-se utilizar as funções GerarPendênciaExportação e GerarPendênciaExportaçãoRet para tratar necessidades de criação de Pendências de forma personalizada em pontos específicos do sistema; Os cadastros trafegam pelo Monitor Logística e podem ser filtrados pelo campo Processo dentro do Monitor; Para integração com WMS SILT, conforme Documentação de Integração, deve ser ativada a geração de pendência de exportação (F000SXT) para o WMS apenas de cadastros de Produtos. Desta forma, no Monitor Logística não irão trafegar cadastros de Cliente, Fornecedor e Transportadora. Esses cadastros trafegam para o WMS SILT juntamente com o Documento no qual o cadastro está vinculado: Exemplo:
|
Importante
- O processo automático 165, quando executado, efetua apenas a replicação das configurações presentes na tabela E185CFG (que são gerenciadas pela tela F185CFG), além de processar as Ordens de Separação e de Recebimento que são armazenados nas tabelas E998OSC e E998ORC, respectivamente;
- Este processo não tem objetivo de enviar pendências de cadastros registrados na tabela E000CIX para a Plataforma (os Agendamentos da Plataforma fazem esse trabalho).
- Para garantir a integração adequada dos documentos de entrada e saída com o sistema Gestão de Armazenagem | WMS, é essencial cadastrar corretamente o cliente (F085CAD), fornecedor (F095CAD) e transportadora (F073TRA) no Gestão Empresarial | ERP. É fundamental preencher todas as informações, sejam de pessoas físicas, jurídicas, do mercado interno ou externo, com especial atenção para o endereço, número do logradouro e complemento. Caso seja detectada a falta de dados após a integração dos cadastros, acesse as telas de cadastros do sistema Gestão de Armazenagem | WMS para realizar os ajustes necessários ou reenviar a informação por meio da integração, alterando o cadastro no Gestão Empresarial | ERP;
- A integração dos cadastros de Clientes, Transportadoras, Fornecedores e Produtos ocorre do Gestão Empresarial | ERP para o Gestão de Armazenagem | WMS. Em outras palavras, esses cadastros devem ser realizados no Gestão Empresarial | ERP e não diretamente no Gestão de Armazenagem | WMS. Isso acontece porque, após as informações serem salvas no ERP, serão criadas pendências para a integração com o WMS.
Características de integração
Se a transportadora não for informada na Ordem de Recebimento/Separação (independentemente do documento de origem desta ordem), um erro de integração será exibido no Monitor Logística. Para incluir uma transportadora padrão nas Ordens de Recebimento/Separação, utilize o parâmetro dinâmico FILIAL.INTWMS.TRANSPORTADORAPADRAO no cadastro da filial (F070FCA). O valor definido para esse parâmetro será o código da transportadora que o sistema utilizará para a integração da Ordem de Recebimento/Separação.
Para personalizar o envio de informações de transportadoras do Gestão Empresarial | ERP para o WMS ALCIS, utilize o identificador de regras GER-000INWMS11. Este identificador é acionado quando o agendamento daplataforma solicita a exportação do cadastro através do ERP_Service.
Como a regra do identificador é acionada pela plataforma através do ERP_Service, ela não será ativada durante a geração da pendência de exportação da transportadora, mesmo que o arquivo LSP esteja configurado com o parâmetro Depurar arquivo. Este ponto de personalização não está disponível para integração com o WMS SILT, pois os dados da transportadora são transmitidos juntamente com a Ordem de Separação/Recebimento.
Importante
- Para documentos que não possuem definição de transportadora no Gestão Empresarial | ERP, mas que o sistema WMS exija essa informação, a definição deste parâmetro é obrigatória para que a integração da Ordem de Recebimento ocorra normalmente.
- Este parâmetro só tem efeito quando uma transportadora não foi definida no documento de entrada/saída que gerou a Ordem de Recebimento/Separação.
- É necessário que o produto esteja ligado a um depósito que integre com WMS e esse depósito deve estar ligado à filial configurada para a integração;
- A ligação do produto com o depósito é feita a partir da tela F210LPD, filtrando pelo produto e marcando o depósito que deseja fazer a ligação;
- É sugerido o uso do filtro de filial para apresentar somente os depósitos da filial que integra com o Gestão de Armazenagem | WMS;
- Todos os produtos ligados em algum depósito que integra com Gestão de Armazenagem | WMS, é candidato à exportação;
- Assim como ocorre na integração dos cadastros de clientes, fornecedores e transportadoras, a integração dos produtos também é realizada do Gestão Empresarial | ERP para o Gestão de Armazenagem | WMS. Em outras palavras, produtos inseridos manualmente diretamente no Gestão de Armazenagem | WMS não serão integrados ao Gestão Empresarial | ERP;
- Ao cadastrar um novo produto no Gestão Empresarial | ERP, garanta que todos os dados necessários para o Gestão de Armazenagem | WMS estejam devidamente preenchidos. Isso inclui as medidas físicas do produto (altura, peso e comprimento), unidade de medida e, principalmente, o código de barras do produto, para que a integração ocorra com sucesso;
- Um produto ou derivação gerará um cadastro de produto no Gestão de Armazenagem | WMS SILT ou ALCIS, com o código do produto e o código da derivação separados pelos caracteres “--”.
Importante
Para que o produto seja considerado integrável, é indispensável que ele tenha um código de barras e esteja vinculado a um depósito que integra com o Gestão de Armazenagem | WMS. Sem essas informações, o produto pode até ser pendenciado nas tabelas E000CIX/E000PRO para exportação para o WMS; no entanto, ao executar o agendamento agendarRecuperarProduto na Plataforma, um select será realizado na base de dados do ERP (via ERP_Service) e não encontrará esse produto para exportação, pois ele não atenderá aos requisitos mínimos para o processo.
Para a integração com o Gestão de Armazenagem | WMS Senior, é imprescindível preencher os campos da derivação do produto relacionados a peso e dimensões. Essa parametrização é realizada na guia Derivações da tela Cadastros > Produtos e Serviços > Produtos > Individual (F075PRO). Os campos necessários a serem parametrizados são:
Dimensão da Derivação:
- Largura da derivação;
- Altura da derivação;
- Comprimento derivação.
Importante
A parametrização das dimensões no Gestão Empresarial | ERP é comumente feita em centímetros (cm). Para assegurar a correta integração das dimensões com o sistema WMS, é essencial revisar a definição do parâmetro dinâmico EMPRESA.INTWMS.FATORCONVERSAODIMENSAOPRODUTO disponível na tela F070EMP;
Este parâmetro determina o fator de conversão das dimensões (altura/largura/comprimento) do produto/derivação. O valor definido será sempre multiplicado pela dimensão da derivação do produto. Para a integração com o Gestão de Armazenagem | WMS SILT, geralmente o valor é 10 (cm para mm); para o WMS Alcis, normalmente o valor é 1. Se o parâmetro não estiver definido ou estiver cadastrado com um valor vazio, o sistema considerará o fator de conversão como 1 (ou seja, multiplicação por 1).
Peso da Derivação:
- Peso Bruto;
- Peso Líquido.
Importante
A parametrização dos pesos no Gestão Empresarial | ERP é comumente feita em quilos (kg). Para garantir a correta integração dos pesos com o sistema WMS, é essencial revisar a definição do parâmetro dinâmico EMPRESA.INTWMS.FATORCONVERSAOPESOPRODUTO disponível na tela F070EMP;
Este parâmetro determina o fator de conversão dos pesos (Peso Bruto/Peso Líquido) do produto/derivação. O valor definido será sempre multiplicado pelos pesos da derivação do produto. Para a integração com o Gestão de Armazenagem | WMS SILT, geralmente o valor é 1000 (kg para gramas); para o WMS Alcis, normalmente o valor é 1. Se o parâmetro não estiver definido ou estiver cadastrado com um valor vazio, o sistema considerará o fator de conversão como 1 (ou seja, multiplicação por 1).
O preenchimento do código de barras da derivação é obrigatório para a integração com o Gestão de Armazenagem | WMS Senior. O sistema Gestão Empresarial | ERP realiza a exportação do código de barras para o WMS da seguinte maneira:
- O código de barras utilizado pelo ERP para exportação ao WMS é o campo Código Barras Livre da guia Derivação da tela F075PRO (campo E075DER.CodBa2). O código de barras (E075DER.CodBar) não é utilizado para enviar informações ao WMS. O código de barras do campo E075DER.CodBa2 é exportado como o Código de Barras do Produto;
- O código de barras definido na associação do produto com o código de barras na tela F075BAR é exportado pelo ERP como o código de barras da Embalagem para o WMS. Os registros feitos na tela F075BAR serão exportados como embalagens de um produto somente se a variável IntNExportarEmbalagem receber o valor 1 no identificador de regras GER-000INWMS16 para cada registro feito na tela F075BAR. (Para produtos que possuem mais de um código de barras, a execução do identificador ocorre para cada um dos códigos de barras).
Importante
Não existem identificadores de regras que permitem manipular diretamente o código de barras durante a exportação para o WMS. O ERP possibilita manipular dados relacionados à embalagem associada a um código de barras, mas não oferece a capacidade de alterar o próprio código de barras em si. Por exemplo, se o campo E075DER.CodBa2 estiver definido como "123456789" e for desejado alterar esse valor para "112233445566" apenas no momento da exportação por uma regra, o sistema não dispõe de uma funcionalidade para realizar essa alteração.
- O Gestão Empresarial | ERP exporta as embalagens para o WMS dentro da estrutura de exportação de cada produto. No entanto, as embalagens não são integradas automaticamente. Elas devem ser cadastradas manualmente no sistema WMS com o mesmo código de embalagem que tenha sido cadastrado no ERP;
- A manipulação de dados de embalagens via regra é efetuada através do identificador de regras GER-000INWMS16.
A exportação da descrição do produto segue nesta ordem:
- Se a derivação possuir Descrição Fiscal (E075DER.DesFis) preenchida e a empresa
utiliza código fiscal (campo Utiliza Código Fiscal da tela Cadastro de Parâmetros Fiscais (F070EPF)), esta descrição é
enviada. Senão;
- Se o produto possuir Descrição p/ Nota Fiscal (E075PRO.DesNfv), essa descrição é enviada. Senão;
- Se a derivação possuir Descrição (E075DER.DesDer) preenchida, esta é enviada. Senão;
- A Descrição do produto é enviada (E075DER.DesDer);
- Além disso, o identificador de regra GER-000INWMS09 permite que seja manipulado o conteúdo da descrição do produto através da variável IntADescricaoWms (neste identificador, as variáveis IntADescricaoProduto e IntADescricaoDerivacao são inicializadas com os valores obtidos dos campos E075PRO.DesPro e E075DER.DesDer respectivamente, e não recebem retorno de valor. O retorno se dá exclusivamente pela variável IntADescricaoWms).
Somente os primeiros 20 caracteres do Código de referência cadastrados na derivação do produto serão exportados.
Dependendo do tipo de produto, pode ser necessário realizar configurações adicionais diretamente no Gestão de Armazenagem | WMS. Se o produto for controlado por lote ou série no Gestão Empresarial | ERP, será necessário marcar esse indicador também no Gestão de Armazenagem | WMS;
No WMS Alcis, essa alteração só pode ser realizada quando não houver saldo do produto. No Gestão Empresarial | ERP, a alteração deste controle é permitida apenas se não houver movimentação do produto.
Importante
O uso indevido deste parâmetro no WMS Alcis pode gerar inconsistências na integração entre os sistemas;
O lote padrão definido no cadastro da Origem do produto não é exportado ao WMS, pois o mesmo é um lote intermediário, utilizado em casos onde não se tem um lote definido para o processo e é utilizado somente no ERP.
O produto pai não é exportado para o Gestão de Armazenagem | WMS Senior, apenas seus componentes. Portanto, ele deve ser cadastrado no Gestão Empresarial | ERP com o Tipo de Produto igual a "M - Montagem" e o indicador Produto Kit igual a "N - Não";
Para produtos indicados como Kit, somente o produto pai será integrado. Os componentes de um kit devem ser indicados manualmente no sistema WMS.
Manipulação de dados diversos: GER-000INWMS09;
Manipulação de dados de embalagens: GER-000INWMS16.
Para mais informações sobre o cadastro de produto, consulte a documentação relativa ao WMS integrado:
Para personalizar o envio de informações de Clientes e Fornecedores do Gestão Empresarial | ERP para o WMS ALCIS, utilize os identificadores de regras abaixo:
- Clientes: GER-000INWMS10;
- Fornecedores: GER-000INWMS12.
Esses identificadores são acionados quando o agendamento da plataforma solicita a exportação do cadastro através do ERP_Service.
Como a regra do identificador é acionada pela plataforma através do ERP_Service, ela não será ativada durante a geração da pendência de exportação do cliente/fornecedor, mesmo que o arquivo LSP esteja configurado com o parâmetro Depurar arquivo. Estes pontos de personalização não estão disponíveis para integração com o WMS SILT, pois os dados de clientes e fornecedores são transmitidos juntamente com a Ordem de Separação/Recebimento.