Histórico da Página
Integração BackOffice RM x SigaMNT
Contexto de negócio
O objetivo da integração do SIGAMNT x BackOffice RM é viabilizar que de forma automática os cadastros gerenciados pelo BackOffice sejam replicados no vertical e, de forma similar, que os processos geridos pelo Gestão de Ativos/Gestão de Frotas tenham suas informações levadas ao BackOffice. Desta forma as bases de dados se mantém espelhadas, atualizando estoque, permitindo emissão de notas fiscais e demais processos no BackOffice.
Sistemas Envolvidos
Descrição dos sistemas envolvidos no contexto de negócio (e que serão envolvidos na integração).
...
* Disponível a partir da versão 12.1.15.160 do RM.
Instalação/Atualização
Protheus
Visando maior facilidade na implantação da integração está disponível abaixo um CheckList com os passos padrão necessários para implantação e parametrização da integração no Protheus.
PENDENTE - VERIFICAR COM O PROTHEUS
CheckList de Implantação | ||
---|---|---|
Índice | Tarefa | Anexo |
Preparação do Ambiente | ||
1 | Pendente - Verificar com a equipe do Protheus | |
RM
Visando maior facilidade na implantação da integração está disponível abaixo um CheckList com os passos padrão necessários para implantação e parametrização da integração no RM.
CheckList de Implantação | ||
Índice | Tarefa | Anexo |
Preparação do Ambiente | ||
1 | Instalação/Atualização da Biblioteca RM |
|
1.1 | Conferir arquivos *.Config e Alias.dat | |
2 | Instalação e configuração do IIS | Manual de instalação do TBC |
3 | Instalação e configuração do TBC | |
3.1 | Instalar o TBC na mesma versão da Biblioteca RM | |
3.2 | Configuração do Web.Config | |
3.2.1 | Configurar o Web.Config conforme o RM.Host.*.Config e Rm.Exe.Config | |
3.2.2 | Configurar Tag “DefaultDB” no Web.config com o Alias desejado | |
4 | Atualização da base de dados (Caso ainda não esteja na versão necessária) | Manual do RM Atualizador |
4.1 | Efetuar Backup da base de dados | |
4.2 | Executar o RM Atualizador na base de dados | |
4.3 | Conferir se o Dicionário de Dados do Protheus possui compartilhamento por Empresa/Filial igual ao RM para os cadastros integrados. | |
Ativação da Integração | ||
5 | Instalação e parametrização do pacote de integração no RM | |
5.1 | Parametrizar os Tipos de Movimento utilizados na integração | Parametrização dos Movimentos |
5.2 | Executar o configurador da integração |
|
5.3 | Parametrizar a URL do WebService Protheus | |
5.4 | Informar os parâmetros da integração | |
5.5 | Cadastrar De-Para de Coligada e Filial | Anexo DI0001_TOTVS_Gestao_de_Frotas-BackofficeRMxProtheusSigaMNT |
5.6 | Importar as Fórmulas Visuais com gatilho | Anexo Importação de Fórmulas Visuais |
Preparação/Carga da Base de Dados | ||
6 | Cadastro de Cliente/Fornecedor | |
6.1 | Abrir tabela de Municípios do Protheus para que a mesma receba carga automática (Acessar o SIGAFIS no Protheus) | |
6.2 | Conferir se o campo A1_COD e A2_COD no Protheus estão sem inicializador padrão (SIGACFG em Dicionário | Banco de Dados) | |
6.3 | Informar o Inic. Padrão para o A1_LOJA e A2_LOJA (Exemplo: '01' e '02') | |
6.4 | Editar o cadastro de um Cliente/Fornecedor manualmente e verificar se é integrado | |
6.5 | Verificar se todos os Clientes possuem endereço cadastrado | |
6.6 | Efetuar a carga de Clientes/Fornecedores | Anexo Execução de Fórmulas Visuais |
7 | Cadastro de Moeda | |
7.1 | Verificar quais as moedas que serão integradas (Lembrando que o Protheus aceita somente 5) | |
7.2 | Editar o cadastro de uma moeda manualmente e verificar se é integrado | |
7.3 | Efetuar a carga de Moedas (Caso necessário alterar a Consulta SQL na FV para buscar somente as moedas desejadas) | Anexo Execução de Fórmulas Visuais |
8 | Cadastro de Unidade de Medida | |
8.1 | Cadastrar os de-para manualmente de algumas unidades conforme cita na especificação (clique aqui) | Anexo DI0001_TOTVS_Gestao_de_Frotas-BackofficeRMxProtheusSigaMNT |
8.2 | Editar o cadastro de uma Unidade de Medida manualmente e verificar se é integrado | |
8.3 | Efetuar a carga de Unidades de medida | Anexo Execução de Fórmulas Visuais |
9 | Cadastro de Produto | |
9.1 | Verificar se as Unidades de Medida associada aos Produtos já estão integradas ou incluído os de-para manualmente | |
9.2 | Editar o cadastro de um Produto manualmente e verificar se é integrado | |
9.3 | Efetuar a carga de Produtos | Anexo Execução de Fórmulas Visuais |
10 | Cadastro de Centro de Custo | |
10.1 | Editar o cadastro de um Centro de Custo manualmente e verificar se é integrado | |
10.2 | Efetuar a carga de Centros de Custos | Anexo Execução de Fórmulas Visuais |
11 | Cadastro de Ativo Fixo | |
11.1 | Cadastrar os valores defaults para Plano de Contas (para cada filial) | Anexo Default para Plano de Contas |
11.2 | Verificar se o campo N1_CHAPA da tabela de Ativos do PROTHEUS está com 30 caracteres | |
11.3 | Verificar se os Fornecedores associados aos Bens já estão integrados | |
11.4 | Verificar se os Centros de Custo associados aos Bens já estão integrados | |
11.5 | Editar o cadastro de um Bem/Ativo manualmente e verificar se é integrado | |
11.6 | Efetuar a carga de Bens/Ativos | Anexo Execução de Fórmulas Visuais |
12 | Cadastro de Cargo | |
12.1 | Editar o cadastro de um Cargo manualmente e verificar se é integrado | |
12.2 | Efetuar a carga de Cargos | Anexo Execução de Fórmulas Visuais |
13 | Cadastro de Função | |
13.1 | Editar o cadastro de um Cargo manualmente e verificar se é integrado | |
13.2 | Efetuar a carga de Funções | Anexo Execução de Fórmulas Visuais |
14 | Cadastro de Turno/Horário | |
14.1 | Editar o cadastro de um Horário manualmente e verificar se é integrado | |
14.2 | Efetuar a carga de Horários | Anexo Execução de Fórmulas Visuais |
15 | Cadastro de Funcionário | |
15.1 | Cadastrar o Banco, agencia e conta default para a integração | Anexo Default para Banco, Agencia e Conta |
15.2 | Verificar se os Turnos, Funções e Horários estão integrados | |
15.3 | Acessar o cadastro de Processos do Protheus (07- Gestão Pessoal) em Atualizações | Definições de Cálculo | Processos | |
15.4 | Verificar dentro da Seção do Funcionário se possui o Centro de Custo informado e se está sincronizado como Global | Anexo Centro de Custo Funcionário |
15.5 | Verificar se os funcionários estão com o Tipo de recebimento como Mensalista ou Semanalista | |
15.6 | Editar o cadastro de um Funcionário manualmente e verificar se é integrado | |
15.7 | Efetuar a carga de Funcionários | Anexo Execução de Fórmulas Visuais |
16 | Cadastro de Projeto (Caso for utilizar na Integração) | |
16.1 | Cadastrar o calendário no Protheus, conforme link: Cadastro de Calendário Protheus | |
16.2 | Informar conteúdo 001 (Calendário cadastrado no passo anterior) no parâmetro MV_INTCAL do Protheus | |
16.3 | Editar o cadastro de um Projeto manualmente e verificar se é integrado | |
16.4 | Efetuar a carga de Projetos | Anexo Execução de Fórmulas Visuais |
17 | Cadastro de Obra (Caso for utilizar na Integração) | |
17.1 | Editar o cadastro de uma Obra manualmente e verificar se é integrado | |
17.2 | Efetuar a carga de Obras | Anexo Execução de Fórmulas Visuais |
18 | Cadastro de Tarefa | |
18.1 | Editar o cadastro de uma Tarefa manualmente e verificar se é integrado | |
18.2 | Efetuar a carga de Tarefas | Anexo Execução de Fórmulas Visuais |
19 | Cadastro de Etapa | |
19.1 | Editar o cadastro de uma Etapa manualmente e verificar se é integrado | |
19.2 | Efetuar a carga de Etapas | Anexo Execução de Fórmulas Visuais |
20 | Cadastro de Local de Estoque | |
20.1 | Acessar a tabela NNR no Protheus, no campo NNR_DESCRI informar o tamanho = 40 | |
20.2 | Editar o cadastro de um Local de Estoque manualmente e verificar se é integrado | |
20.3 | Efetuar a carga de Locais de Estoque | Anexo Execução de Fórmulas Visuais |
Âncora Transações/Entidades/Mensagens Transações/Entidades/Mensagens
Transações/Entidades/Mensagens | |
Transações/Entidades/Mensagens |
Transações/Entidades/Mensagens únicas
Segue abaixo tabela com informações sobre as entidades trafegadas na integração.
...
Obs.: As Fórmulas visuais estão disponíveis na pasta de instalação do RM em (...CORPORERM/Objetos Gerenciais/Fórmulas Visuais)
Cadastros
Para esta integração todos os cadastros possuem sua origem no BackOffice RM, sendo enviados à retaguarda Protheus.
...
- Caso o código do Local de Estoque no RM seja maior que 2 (dois) caracteres, no PROTHEUS o código do local de estoque deverá ser autoincremento.
Processos
Conforme descrito na seção de apresentação do escopo, o escopo da integração se restringe aos processos relacionados a Gestão de Frotas e Manutenção de Ativos que sejam pertinentes de manipulação no BackOffice, como integrações fiscais, financeiras ou controle de estoque.
...
Tipo de Fluxo: RM -> Protheus e Protheus -> RM
Mensagem: MaintenanceOrder
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/25P6E
Checklist de suporte da aplicação
Crie um check-list de verificação de alguns pontos importantes para o funcionamento e atendimento da integração.
...
- Identificar o funcionamento da integração;
- Identificar a ocorrências de problemas;
- Coletar evidências do mau funcionamento relatado pelo cliente;
- Realizar possíveis ajustes na integração quanto à configuração ou negócio.
Anexos
Âncora Configuração da Integração Configuração da Integração
Configuração da integração
Configuração da Integração | |
Configuração da Integração |
Siga os passos abaixo para efetuar a instalação e configuração da integração.
- Acesse o contexto de integração.
- Executar o processo 'Configurar' na aba 'Ferramentas'.
- Selecionar o pacote de integração 'TOTVS Manutenção de Ativos x BackOffice RM" e executar o processo.
- Acessar a rotina "Integrações" (Integração | Mensagem Única | Integrações) e parametrizar o campo 'URL WebService" com o caminho do WebService do Protheus.
- Acessar o anexo "Parâmetros de Integração"
5.1 Configure o parâmetro "CodClassificPais" com o código da tabela de classificação utilizada e associada aos países referente à classificação do IBGE.
5.2 Informe os Códigos dos Tipos de Movimento criado anteriormente para cada um dos processos que será utilizado.
Observação: Este é apenas um exemplo, deve-se informar o Valor com o Código do Tipo de Movimento criado no ambiente do cliente.
Âncora | ||||
---|---|---|---|---|
|
Acesse a rotina de cadastramento de De-para no contexto de Integração
...
Valor Chave Integração: Código do grupo de empresa do Protheus + '|' + Código completo da filial no Protheus (composto por Empresa + Filial)
Âncora | ||||
---|---|---|---|---|
|
A lista de Fórmulas Visuais referente a cada entidade encontra-se na seção Transações/Entidades/Mensagens.
As Fórmulas Visuais informadas na tabela estão disponíveis na pasta "...CORPORERM | Objetos Gerenciais | Fórmulas Visuais" e devem ser importadas conforme apresentado no documento Importação\Exportação de fórmula visual, com atenção à importação dos gatilhos (caso contrário a mesma não será acionada).
Âncora | ||||
---|---|---|---|---|
|
Segue abaixo a lista de passos para efetuar a Carga de Dados entre o BackOffice RM e o Protheus.
...
- Acessar o processo "Executar" no Menu "Gestão -> Fórmula Visual"
- Selecionar a Fórmula Visual de carga desejada e ícone no botão "Executar"
- Após a execução é necessário acessar o arquivo de Log para verificação do status dos envios para o Protheus.
O Log estará disponível na pasta "Carga Inicial / Logs" dentro do diretório de instalação do RM (RM.Net).
Âncora | ||||
---|---|---|---|---|
|
Segue abaixo como cadastrar o de-para das unidades de medida padrão.
Observação: No exemplo foi criado para a unidade de medida UN, é necessário fazer para as demais, conforme a cita nas informações da unidade de medida (clique aqui).
- No RM Acessar o menu Integração | Mensagem Única | De-para
- Incluir um novo Registro de acordo com os dados abaixo
Exemplo:
Observação: O valor da Chave Integração pode alterar de acordo com o código da empresa e níveis de gestão utilizados no Protheus. - Acessar o SIGACFG no Protheus em Ambiente | Schedule | De/Para Mensagem Única
- Incluir um novo Registro de acordo com os dados abaixo
Exemplo:
Observação: Alguns dados podem alterar de acordo com o código da empresa, nível de gestão e etc.
Âncora | ||||
---|---|---|---|---|
|
Para integrar esta entidade, o PROTHEUS exige que sejam cadastrados valores defaults para Plano de Contas em sua base (para cada filial), com os seguintes parâmetros:
...
- Acessar o Protheus no Ambiente 1 - Ativo Fixo
- Acessar Cadastros | Plano de Contas
- Incluir novo registro, conforme exemplo abaixo (É necessário fazer o processo para cada Filial do Protheus).
Âncora | ||||
---|---|---|---|---|
|
Para integrar a entidade Funcionário, o PROTHEUS exige que sejam cadastrados valores defaults para Banco/Agência/Conta. Estes registro devem ser cadastrados com o seguintes códigos abaixo:
...
- Acessar o Protheus no Ambiente 7 - Gestão de Pessoal
- Acessar Cadastros | Bancos/Agencias
- Incluir novo registro, conforme exemplo abaixo.
Âncora | ||||
---|---|---|---|---|
|
A informação de centro de custo é obtida a partir da seção do funcionário. Sendo assim, é necessário atentar ao cadastramento das seções, pois esta entidade ocupa no RM o mesmo nível hierárquico do centro de custo no Protheus.
...