Pré-requisitos para integração

Será preciso criar um usuário com permissões necessárias para utilização no processo de integração. Para isso:

• Acessar o SGU disponível na pasta de instalação do sistema;
• Cadastrar um novo usuário: Arquivo > Novo Usuário...
• Informar o nome e senha para o usuário;
• Desmarcar a opção para alterar e senha no próximo login;
• Verificar que o Status do novo usuário deve estar como Habilitado;
• Incluir o usuário no grupo de permissões correspondente. É necessário que o usuário ao menos possua permissões para incluir, alterar e excluir registros no sistema, como cadastros, notas fiscais, pedidos e títulos;
• O nome e senha do novo usuário deve ser repassado para a GAtec, que o utilizará para o acionamento dos web services.

Cadastre as informações que serão integradas, desde que estejam de acordo com os módulos adquiridos da GAtec.

1. Acessar pelo menu Cadastros > Integrações > Cadastro de Sistemas Integrados (F000SIS).
2. Informar um novo código para o sistema do Gestão de Campo.
3. Informar a descrição do sistema a ser integrado.
4. Informar a sigla do sistema a ser integrado. Neste caso, deverá ser GATEC conforme exemplo.
5. Informar o tipo de integração 08 - GAtec.
6. Informar a situação da integração como A - Ativo.

Configure as informações que serão consultadas para retornar valores aos web services. Para alguns tipos de informações, recomenda-se que seja criado um filtro na mesma tela:

1. Acessar Cadastros > Integrações > Configuração de Tipos de Informação (F000SXT).
2. Informar o Código conforme o cadastro efetuado na tela de Sistemas Integrados (F000SIS).
3. Informar a Filial que terá a integração. Poderá ser informada mais de uma filial, caso necessário.
4. Selecionar o Tipo de Informação que será integrada. Também será possível deixar este campo em branco, e ao pressionar Mostrar, serão exibidos os tipos disponíveis.
5. Na grade disponível, devem ser marcados os registros desejados para a integração. Estes registros devem estar com a situação = A- Ativo.
6. Processar as alterações.

Configure as informações que serão consultadas para retornar valores aos web services. Para alguns tipos de informações, recomenda-se que seja criado um filtro na mesma tela:

1. Acessar o menu Cadastros > Integrações > Configuração de web services (F000CWS)
2. No Cadastro de Famílias (F012FAM), definir nas famílias de produtos que são inerentes ao Agronegócio, o campo Integrar com Agronegócio = S
3. Na tela de Configuração de Web Services (F000CWS), porta Exportar, criar filtro para os produtos das famílias que integram com a GAtec

Algumas rotinas de processos automáticos são obrigatórias e devem ser configuradas para o funcionamento da integração, enquanto outras devem ser utilizadas conforme necessidade. Para fazê-lo:

• Entrar na tela Recursos > Processos Automáticos > Cadastro (F000AGE);
• Na aba Rotina, preencher as informações:
  • No campo Rotina Sapiens, informar o código da rotina;
  • Adicionar os parâmetros necessários em Parâmetros Rotina;
  • Clicar no botão Alterar para salvar as configurações;
  • Clicar no botão Agendar para configurar a execução do processo.

Os processos utilizados na integração com a GAtec são:

• Processo 82: Tornar pendentes as exportações não confirmadas (Obrigatório). Esse processo torna novamente pendente integrações que tenham sido enviadas ao sistema da GAtec e que não tenham sido confirmadas pelo mesmo:
  • Rotina Sapiens: 082;
  • Parâmetros Rotina: TEMPOVIDA=10.
• Processo 134: Saldo Contábil Mensal por Conta/Centro Custo/Origem (Obrigatório). Esse processo é responsável por efetuar o cálculo do saldo contábil mensal por Conta/Centro Custo/Origem. As informações geradas serão utilizadas para a exportação de dados para a GAtec.
  • Rotina Sapiens: 134;
  • Parâmetros Rotina:
    • AG_EMPRESA: informar o código da empresa em que o cálculo deve ser gerado;
    • AG_MESANO: informar o mês/ano para a base de cálculo. Opcional, por padrão assume a data atual;
    • AG_MESES_RETROATIVO: informar a quantidade de meses retroativos para execução do cálculo. Opcional.
• Processo 160: Limpeza da tabela E000CIX (Obrigatório). Este processo realiza a limpeza da tabela E000CIX e tabelas referenciadas. É necessário pois a tabela guarda registros já integrados e, após algum tempo, pode ficar com um grande volume de dados que já não são mais utilizados no processo e, portanto, ocupando espaço desnecessário.
  • Rotina Sapiens: 160;
  • Parâmetros Rotina:
    • DIAS: inserir um número maior que zero de dias para manter os dados na tabela. Dados mais antigos que esse número serão excluídos;
    • SITUACAO: opcionalmente, insira "P" para excluir apenas os registros pendentes de integração, ou "S" para excluir apenas os registros já exportados. Recomenda-se que, se filtrar apenas pelos registros "P", considerar o pior cenário de exportação possível (quanto tempo o registro ficará pendente antes de exportar) e ajustar o parâmetro DIAS de acordo. Sugerimos ao menos 60 dias. Se deseja excluir os dois tipos de registro, será necessário cadastrar duas vezes o processo automático, um para cada tipo. Para entender mais sobre esse processo, confira a página do processo automático.
• Processo 149: Baixa Automática de Títulos Contas a Pagar - Integração (Opcional). Esse processo é utilizado caso possua integração com módulo Commerce. Tem por objetivo efetuar de maneira automática a baixa de títulos sobre um título de Crédito/Adiantamento. Ou seja, faz o aproveitamento de crédito e faz baixa de títulos de contas a pagar com base no valor deste crédito.
  • Rotina Sapiens: 149;
  • Parâmetros Rotina:
    • AG_EMPRESA: define qual empresa a que pertencem os títulos;
    • AG_FILIAL: define qual filial a que pertencem os títulos;
    • AG_TNSCRE: transação a ser utilizada na baixa dos títulos de Crédito/Adiantamento;
    • AG_TNSDUP: transação a ser utilizada na baixa dos Títulos/Duplicatas;
    • AG_CODCRT: Código da Carteira. Se informada, não será realizada a baixa dos títulos efetivos dessa carteira.

No Gestão Empresarial | ERP Senior, os cadastros e movimentações operam com os conceitos de Empresa e Filial, sendo possível que uma empresa possua diversas filiais.

No cadastro de Produto:

• O código do produto pode possuir até 14 caracteres alfanuméricos;
• A Derivação pode possuir até 7 dígitos (mínimo de 1 dígito);
• Produto e Derivação são cadastrados por Empresa.

No GAtec – módulo VB, não existe o conceito nativo de Empresa/Filial e o campo destinado ao código do produto possui limite máximo de 10 caracteres.

Impacto na Integração

Nas integrações em que o GAtec (VB) precisa referenciar produtos do ERP, é comum utilizar uma chave concatenada para representar Produto + Derivação e, em alguns casos, também a Empresa.

No entanto, o limite de 10 caracteres do GAtec (VB) pode impedir a utilização completa dos códigos do ERP, resultando em riscos como:

• Colisão de chaves: produtos diferentes podem ser identificados como o mesmo código no GAtec;
• Cadastros divergentes entre empresas;
• Falhas de integração: necessidade de retrabalho após cadastros ou movimentos já existentes;
• Dificuldade de suporte e auditoria devido à inconsistência na identificação dos itens.

Cenários Comuns

Diretriz Obrigatória Antes do Início dos Cadastros

Antes de iniciar cadastros ou integrações, é obrigatório definir e registrar uma regra de chave de integração compatível com o limite de 10 caracteres do GAtec (VB), evitando mudanças após o cliente já estar operando.

Recomendações:

• Padronização de tamanhos no ERP: definir no projeto de implantação um limite máximo para cada componente da chave, garantindo compatibilidade com o GAtec (VB).
• Cenário A (unificado): codpro + separador + codder com limites internos (ex.: 8+1+1 ou 6+1+3).
• Cenário B (distinto): codemp + separador + codpro + separador + codder com limites reduzidos (ex.: 2+1+5+1+1).

Checklist de Validação (Consultor / Canal / Implantação)

Antes de liberar a integração em produção:

1. Confirmar se o cliente opera com empresa centralizadora ou cadastros distintos por empresa.
2. Definir e documentar a regra de chave que o GAtec (VB) utilizará para identificar os itens.
3. Validar que a chave sempre cabe em 10 caracteres, incluindo separadores.
4. Avaliar risco de duplicidade/colisão, principalmente no Cenário B.
5. Registrar a decisão no desenho de solução e orientar o cliente antes de iniciar cadastros em massa.

É necessário parametrizar as famílias de produtos e de serviços que tenham produtos e serviços, respectivamente, que devem ser integrados com a GAtec. Para isso:

• Acessar a tela Cadastros > Produtos e Serviços > Famílias (F012FAM);
• Informar "S" no campo Integra com Agronegócio.

Deve-se cadastrar os agrupamentos de produtos para estoque. Para tanto:

• Acessar a tela Cadastros > Produtos e Serviços > Produtos > Formas de Agrupamento > Individual (F013AGP);
• Informar o código do agrupamento. Os primeiros três dígitos devem ser iguais ao código da família de produtos que integra com o agronegócio. O Tipo deve ser sempre "E-Estoques".

É necessário associar as formas de agrupamento de produtos para estoque com os produtos que devem integrar com a GAtec. O procedimento é:

• Acessar a tela Cadastros > Produtos e Serviços > Ligações > Formas de Agrupamento X Produtos (F075AGP);
• Informar a família ser tratada;
• Escolher "Estoque" em Seleção;
• Na grade, informar o agrupamento dos produtos cujo agrupamento seja uma das variações de agrupamentos da família de produtos;
• Acessar a tela Cadastros > Integrações > Configuração de web services (F000CWS);
• Configurar o web service com.senior.g5.co.cad.produtos, porta Exportar_8;
• Adicionar a condição AND E075PRO.CODFAM IN (SELECT E012FAM.CODFAM FROM 012FAM WHERE 012FAM.INTAGR = `S`). Essa condição define que devem somente serem exportados os cadastros que foram configurados para Integrar com Agronegócio.

Para parametrizar os serviços que integram com a GAtec, os seguintes passos são necessários:

• Acessar a tela Cadastros > Integrações > Configuração de web services (F000CWS);
• Configurar o web service com.senior.g5.co.cad.servicos, porta Exportar.
• Adicionar a condição AND E080SER.CODFAM IN (SELECT E012FAM.CODFAM FROM 012FAM WHERE E012FAM.INTAGR = 'S'). Essa condição define que devem somente serem exportados os cadastros que foram configurados para Integrar com Agronegócio.

Parametrizar as transportadoras que devem integrar com o agronegócio:

• Cadastrar a transportadora como fornecedor, inclusive as definições nas quais são indicadas as empresas e filiais com que a transportadora atua;
• Acessar a tela Cadastros > Mercado e Suprimentos > Transportadoras > Cadastro (F073TRA);
• Informar o código do fornecedor como transportadora no campo Transportadora como Fornecedor.

Indicar quais espécies de bens de espécies do imobilizado não devem ser integrados com a GAtec. Para isso:

• Acessar a tela Controladoria > Gestão do Patrimônio > Controle de Bens > Bens > Individual (F670BEM);
• Chamar o bem que não deve ser integrado ao GAtec;
• Na aba Características, adicionar a característica "NAG - Não integra a agronegócio".

Parametrizar os centros de custos que são utilizados pelo agronegócio:

• Acessar a tela Cadastros > Centro de Custos > Cadastros (F044CCU);
• Informar no campo Integra com agronegócio o valor "S", nos centros de custos que serão utilizados com a GAtec.

Parametrizar os centros de custos que são utilizados pelo agronegócio:

• Acessar a tela Cadastros > Controladoria > Contabilidade > Plano Contábil / Plano de Contas (F045PLA);
• No campo Integra com agronegócio, informar "S", nas contas contábeis que serão utilizadas na GAtec;

• Acessar a tela Cadastros > Integrações > Configuração de web services (F000CWS);
• Configurar o web service com.senior.g5.co.mct.ctb.planocontacontabil, porta Exportar_2, e adicionar a configuração AND E045PLA.INTAGR = 'S', para exportar somente os cadastros que foram configurados para Integrar com Agronegócio.

Parametrizar os cadastros de moedas que são utilizados pelo agronegócio:

• Acessar a tela Cadastros > Finanças > Moedas e Índices > Cadastro / Atualização (F031AIM);
• No campo Integra com agronegócio, informar "S", para os cadastros que serão utilizados na GAtec;

Parametrizar os cadastros de históricos padrão que são utilizados pelo agronegócio:

• Acessar a tela Cadastros > Controladoria > Contabilidade > Históricos Padrão (F046HPD);
• No campo Integra com agronegócio, informar "S", para os cadastros que serão utilizados na GAtec;