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, 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).
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.