Este documento tem como por objetivo reunir as informações relevantes sobre a integração do TCOP X Manutenção de Ativos (SIGAMNT) X
BackofficeRM
SISTEMAS ENVOLVIDOS
- TCOP
- Manutenção de Ativos PROTHEUS - Ativo Fixo e Manutenção de Ativos.
- Backoffice RM
INTEGRAÇÃO BACKOFFICE RM X SIGAMNT X TCOP
FLUXOGRAMA
PASSOS:
1- CONFIGURAR A INTEGRAÇÃO
2 - REALIZAR CADASTROS BÁSICOS
3 - ENVIAR APONTAMENTOS
5 -CONSULTAR CUSTOS (DIRETOS E INDIRETOS)
POR ONDE COMEÇAR?
EXECUTAR CONFIGURADOR
Para ativar a integração basta executar o configurador selecionando o pacote correspondente "Manutenção de Ativos X Backoffice RM .Veja os detalhes : Executando configurador de integração.
ADAPTERS DESTA INTEGRAÇÃO
Após a execução do configurador estes adapters serão criados.
M. Única | Rotina | Mensagem | Descrição | Envia | Recebe | Método | Operação | Canal | Versão | Alias | Condição |
Sim | MNTI494A | ASSETMONTHLYUNDIRECTCOSTS | Custos Indiretos | sim | não | Síncrono | Todas | EAI | 1.000 | ||
Sim | MNTI494B | ASSETMONTHLYDIRECTCOSTS | Custos Diretos | sim | não | Síncrono | Todas | EAI | 1.000 | ||
| Sim | MNTA851 | APPOINTMENT | Apontamentos de Equipamentos | sim | sim | Síncrono | Todas | EAI | 1.000 | ||
| Sim | MNTA850 | ACTIVITY | Motivos de Improdutividade | sim | não | Síncrono | Todas | EAI | 1.000 | MNT851VLAM() | |
| Sim | ATFA012 | ASSETS (Backoffice RM) | Ativos | sim | não | Síncrono | Todas | EAI | 1.001 | ||
| Sim | PMSA200 | PROJECT | Projeto | não | sim | Sincrono | Todas | EAI | 2.000 | ||
| Sim | PMSA201 | SUBPROJECT | Obra | não | sim | Sincrono | Todas | EAI | 2.000 | ||
| Sim | PMSA201A | STEPPROJECT | Etapa | não | sim | Sincrono | Todas | EAI | 2.000 | ||
| Sim | PMSA203 | TASKPROJECT | Tarefa | não | sim | Sincrono | Todas | EAI | 2.000 | ||
| Sim | MATA020 | CUSTOMERVENDOR | Fornecedor | sim | sim | Sincrono | Todas | EAI | 2.002 | ||
| Sim | MATA030 | CUSTOMERVENDOR | Cliente | sim | sim | Sincrono | Todas | EAI | 2.002 | ||
| Sim | QIEA030 | UNITOFMEASURE | Unidade de medida | sim | não | Sincrono | Todas | EAI | 2.000 | ||
| Sim | CTBA030 | COSTCENTER | Centros de custo | sim | não | Sincrono | Todas | EAI | 2.000 |
Depois de aivar a integração pelo configurador verifique os parâmetros
PARÂMETROS RM
| RM | ||
| Parâmetro | Descrição | Valor Padrão |
| CODLOJADEFAULT | Informar um codgo de loja default | 01 |
| MASCARABEM | Máscara do Bem. Obrigatório 2 Níveis. | ####.##### |
| CODCLASSIFICPAIS | Código de um pais cadastrado | 05 |
PARÂMETROS PROTHEUS
| Protheus | ||
| Parâmetro | Descrição | Valor Padrão |
|---|---|---|
| MV_NGINTMB | Indica integração do processo de mobilidade: sincronismo de equipamentos, parte diária e custos/apontamentos. Informe 1=Sim;2=Não. | 1 |
| MV_NGINTER | - Indica se esta integrado a outro ERP (L=Logix, R=RM, M=Mensagem Unica, N=Nao) | M |
| MV_ESTNEG | Identifica se o sistema permitira que os saldos em estoque dos produtos fique negativo atraves de movimentacao. Conteudo deve ser (S)im ou (N)ao. | N |
| MV_INTCAL | Calendário padrão a ser utilizado na criação do projeto.Informe o código do calendário cadastrado 001. (Lembrando que deve ter cadastrado um calendario no módulo (SIGAPMS) conforme orientado na documentação de cadastros de integração) : https://tdn.totvs.com/display/INT/DI_MANUAL_TOTVS_TOP_BackOffice_Protheus_EAI2.0 | 001 |
| MV_PRJINIC | Define a fase do projeto a ser considerada. Informe o código da fase cadastrada no módulo SIGAPMS: Fase do projeto Protheus | 06 |
| EDT/Tarefa | Configure o campo EDT tarefa conforme orientado na documentação:EDT/Tarefa Protheus | |
MV_NGMNTAT | Habilita integração com o e Manutenção | 3 |
O próximo passo é realizar os cadastros básicos .
CADASTROS BASICOS SIGAMNT :
ATIVIDADES - MOTIVO DE IMPRODUTIVIDADE (ACTIVITY)
Cadastrar as atividades definidas no PROTHUES com o tipo de hora "1 - Trabalhada".
Acesso no RM => módulo Projetos | aba Cadastros gerais | agrupador Basicos | Motivo de Improdutividade
Acesso PROTHEUS => Adicionar ao menu as rotinas conforme abaixo:
| Agrupador: | Parte Diária | ||
| Descrição | Programa | Módulo | Tabelas |
|---|---|---|---|
| Atividades | MNTA850 | Manutenção de Ativos | TV0 |
Parte Diária  | MNTA851 | Manutenção de Ativos | TV1,TV2 |
| Acerto Parte Diária | MNTA852 | Manutenção de Ativos | TV0,TV1,TV2 |
Utilizado em processo por isso não serão detalhados neste cadastro.
Observações:
- Detalhes para adição em menus do PROTHEUS estão em Personalização de menus;
- As tabelas TV0, TV1, TV2 devem esta compartilhadas em todos os níveis;
- O parâmetro do PROTHEUS "MV_NGMBATV" indica o código da atividade produtiva, utilizada para o processo de apropriação diária (Appointment) via Mensagem Única.
CADASTROS BASICOS RM
Unidade de medida
centros de custo
Projetos
Obra , etapa e tarefa
CLIENTE/FORNECEDOR (CUSTOMERVENDOR)
Os Clientes e Fornecedores devem ser cadastrados no BackOffice RM e sincronizados automaticamente para o Protheus através da mensagem única CustomerVendor.
Ao iniciar uma base vazia (zerada) do Protheus, para incluir a tabela de Municípios no Protheus é necessário acessar o Protheus no sistema 09 - Livros Fiscais. Se não acessar o sistema Fiscal do Protheus antes de enviar o cadastro do RM irá apresentar mensagem de inconsistência informando que é valor inválido para o campo Município.
Uma vez que o Cliente e Fornecedor são tratados na mesma mensagem (CustomerVendor), ao cadastrar um registro do tipo Ambos no RM é gerado no Protheus um registro em cada tabela, SA1 (Clientes) e SA2 (Fornecedor).
Mesmo que a empresa não utilize Cliente/Fornecedor global no RM, deve-se compartilhar a tabela referente no Protheus por empresa.
Ao cadastrar Cliente/Fornecedor é importante verificar se o campo loja esta informado como inic padrão
Acesse SIGACFG / Base de dados/ Tabela SA1 e SA2 (campo A1_LOJA, A2_LOJA) na aba opções informar o codigo de uma loja default.
ATIVOS (ASSETS)
E importante cadastrar o ativo (patrimônio) informando o código de barras e a quantidade igual a 1.
Após o cadastro de ativos e imprescindivel o cadastro do Bem e o vinculo do mesmo.
BEM (SIGAMNT MODULO 95)
É necessário cadastrar um Bem e vincular o mesmo a um Ativo.
O vinculo ocorre aravés do campo imobilizado no cadastro Bem.Bastando informar o ativo no campo imobilizado.
É possivel também ativar um gatilho que quando informado no cadastro do bem o vinculo de ativos preenche automaticamente o código de barras. Para ativar esse gatilho acesse:
SIGACFG | Base de Dados | Gatilhos
Campo: T9_CODIMOB
Cnt. Dominio: T9_BARCODE
Tipo: 1 - Primário
Regra: SN1->N1_CODBAR
Posiciona: 1 - sim
Alias: SN1
Ordem: 1
Chave: xFilial("SN1")+M→T9_CODIMOB
APONTAMENTO
Para envio do Apontamento é necessário:
- Um Bem/Equipamento cadastrado ;
- Bem/Equipamento configurado para ser do tipo "Controlador" em sua aba de opções;
- BemEquipamento com código de barras;
- Centro de Custos no Bem/Equipamento;
- Motivo de Improdutividade cadastrado no Protheus sendo do tipo "Trabalhada";
Para enviar esse apontamento para o Protheus, deve executar o processo no RM "Enviar Apontamentos para o Manutenção de Ativos":
CUSTOS DIRETOS E INDIRETOS
No módulo de Manutenção de Ativos, são registrados os custos de manutenção corretiva, preventiva, abastecimentos, despesas com multas e sinistros, parte diária, entre outros. Todas estas informações de custos estão disponíveis no sistema MNT e podem ser divididas conceitualmente entre custos diretos e indiretos. Custos diretos evolvem custos relacionados à parte diária e os indiretos são os custos dos demais processos controlados pelo sistema.
O processo integrado visa enviar para o sistema TOTVS Obras e Projetos as informações referentes a esses custos. Os parâmetros de entrada para esa rotina serão o código do equipamento e o mês de referência. Dessa forma, a exportação considerará custos mensais referentes a um equipamento. Para cada equipamento também será transferido, as informações relativas à parte diária (horas produtivas e improdutivas no mês), apuradas com base nas informações de apontamento da parte diária, seja manualmente ou por coletores de dados.
Caso os sistema identifique alguma divergência nos dados integrados, será enviado um e-mail para um responsável pela avaliação conforme parametrizações de emails no RM.
Como realizar:
No Protheus:
O caminho da rotina no menu deverá ser configurado como:
- Miscelanea/Custos/Custo Mensal
Acesso PROTHEUS => Adicionar ao menu as rotinas conforme abaixo:
| Descrição | Programa | Módulo | Tabelas |
| Miscelania/Custos/Custo Mensal | MNTA494 | Manutenção de Ativos | STJ, STL, SB1, ST9, TRH, TRT, STS, STT, TRK, TRO, TRL, TRV, TRM, TQN, TQI, TRX, SBM |
Detalhes Técnicos:
O processo de exportação de custos é baseado nas seguintes rotinas:
- MNTA494: Chamada e cálculo de custos diretos e indiretos;
- MNTA494A: Mensagem Única de Custos Indiretos Mensais do bem;
- MNTA494B: Mensagem Única de Custos Diretos Mensais do bem.
No RM:
Acesso RM => modulo PROJETOS | CONTROLE | agrupador BÁSICO | MOBILIDADE | EQUIPAMENTOS | CUSTOS DO PERÍODO
Após ajustes nos custos quando necessário, deve apropriar os custos no projetos deve acessando no menu acima a funcionalidade de custos indiretos e executar o processo de "Apropriar custos de equipamentos".
Para que o processo calcule os custos indiretos é necessário definir nos parâmetros de projetos os custos serão apropriados.
Custos Indiretos
| Descrição | Custo | Tabela | Observação | Como Cadastrar |
| Custo Mão de Obra | LaborCost | STL | Custo de mão de obra aplicado nas O.S. Aplicará à essa tag o custo gerado nos insumos de tipo Mão de Obra, de uma ordem de serviço já finalizada. | |
| Custo Materiais aplicados | InputCost | STL | Custo de peças, produtos, lubrificantes, aplicados na O.S Aplicará à essa tag o custo gerado nos insumos de tipo Produto, de uma ordem de serviço já finalizada. | |
| Custo com Terceiros | ThirdPartCost | STL | Custo com serviços de terceiros que trabalharam na O.S. Aplicará à essa tag o custo gerado nos insumos de tipo Produto, de uma ordem de serviço já finalizada. | |
| Custo de Ferramentas | ToolCost | STL | Custo com Ferramentas aplicadas na O.S. Aplicará à essa tag o custo gerado nos insumos de tipo Ferramenta, de uma ordem de serviço já finalizada. | |
| Custo com multas | PenaltyCost | TRX | Custo com multas pagas no mês. Dica: Para cadastrar uma Multa é necessário um Ben do Tipo Veiculo, para realizar este cadastro deste Ben é necessário ativar este parâmetro MV_NGMNTFR e adicionar ao Menu a Rotina MNTA084 ao Menu. Para cadastrar a Multa, cadastrar a Rotina MNTA765 no Menu. | Link Youtube |
| Custo com Documentos | PaperCost | TS2 | Custo com documentos realizados no mês | |
| Custo com Acidentes | IncidentCost | TRH,TRK, TRO, TRL, TRV, TRM | Custo com acidentes ocorridos no mês | |
| Custo do consumo de combustível | FuelCost | Custo com abastecimento realizado no mês | ||
| Custo Fixo de locação do Equipamento | RentCost | Custo de locação do equipamento (fixo), calculado pelo sistema de Manutenção de Ativos. | ||
| Custo total de locação do equipamento | TotalRentCost | Custo total de locação do equipamento, calculado pelo sistema de Manutenção de Ativos mensalmente. | ||
| Custo Hora de locação do Equipamento | HourRentCost | Custo hora de locação do equipamento, calculado pelo sistema de Manutenção de Ativos | ||
| Custo Hora Real de locação do equipamento | RealHourRentCost | Custo hora real de locação do equipamento, calculado pelo sistema de Manutenção de Ativos mensalmente | ||
| Valor Faturado | BilledRentCost | Valor faturado pela locação do equipamento |
Informações no XML de Custos Indiretos
| Descrição | Tabela RM | Campo RM | TAG | Tabela PROTHEUS | Campo PROTHEUS |
|---|---|---|---|---|---|
| BusinessContent | |||||
| Código da empresa/coligada | MCUSTOINDIRETOEQUIPAMENTO | CODCOLIGADA | CompanyId | ||
| Internal ID da chave completa da empresa | CompanyInternalId | ||||
| Código da Filial | BranchId | ||||
| Internal id do Código do Bem | IDPATRIMONIO | AssetInternalId | |||
| Ano mês de ocorrência dos custos | MESANO | MonthYear | |||
| ListOfIndirectCost | |||||
| Internal ID da entidade | MCUSTOINDIRETOEQUIPAMENTO | InternalId | |||
| Código do Centro de Custo. Utilizado para identificar o projeto. | CODCCUSTOBEM | CostCenterCode | |||
| Custo da Mão de Obra aplicado na O.S. | CUSTOMAODEOBRA | LaborCost | STL | ||
| Custo de peças, produtos, lubrificantes, aplicados na OS | CUSTOMATERIAIS | InputCost | STL | ||
| Custo com serviços de terceiros que trabalharam na OS | CUSTOTERCEIROS | ThirdPartCost | STL | ||
| Custo com ferramentas aplicadas na OS | CUSTOFERRAMENTAS | ToolCost | STL | ||
| Custo de Locação do Equipamento (Fixo), calculado pelo sistema de manutenção de ativos | CUSTOFXLOCACAOCUSTOCOMBUSTIVEIS | RentCost | |||
| Custo com multas pagas no mês, podemos considerar somente multas por culpa da empresa | CUSTOMULTAS | PenaltyCost | TRX | ||
| Custo com acidentes ocorridos no mês | CUSTOACIDENTES | IncidentCost | TRH, TRK, TRO, TRL, TRV, TRM | ||
| Custo com documentos realizados no mês | CUSTODOCUMENTOS | PaperCost | TS2 | ||
| Custo com os abastecimentos realizados no Mês | CUSTOCOMBUSTIVEIS | FuelCost | |||
| Custo total de locação do Equipamento, calculado pelo sistema de manutenção de ativos mensalmente | CUSTOTTLOCACAO | TotalRentCost | |||
| Custo Hora de Locação do Equipamento, calculado pelo sistema de manutenção de ativos | CUSTOHRLOCACAO | HourRentCost | |||
| Custo Hora Real de locação do Equipamento, calculado pelo sistema de manutenção de ativos mensalmente | CUSTORELOCACAO | RealHourRentCost | |||
| Valor Faturado pela locação do Equipamento | VALORFTLOCACAO | BilledRentCost | |||
Custos Diretos
| Descrição | Custo | Tabela | Observação |
| Horas Improdutivas | UnproductiveHoursAmount | Quantidade de horas improdutivas apontadas no mês na frente de trabalho | |
| Valor Horas Improdutivas | UnproductiveHoursCost | Valor das horas improdutivas no mês. Calculado da seguinte forma: valor improdutivo = (custo hora da máquina parada * quantidade de horas paradas). O somatório das horas paradas é apurado com base nas horas lançadas nas atividades improdutivas | |
| Horas Produtivas | ProductiveHoursAmount | Quantidade de horas produtivas apontadas no mês na frente de trabalho | |
| Valor Horas Produtivas | ProductiveHoursCost | Valor de horas produtivas | |
| Valor das horas produtivas recalculada após rateio das horas improdutivas. | ApportionmentProductiveHoursCost | Valor das horas produtivas recalculada após rateio das horas improdutivas. Processo de rateio distribui as horas improdutivas com base na quantidade de horas produtivas por frente de trabalho. Então a quantidade de horas produtivas vai aumentar, e consequentemente o valor também vai aumentar, após o rateio. Este campo representa este novo valor. |
Informações no XML de Custos Diretos
| Descrição | Tabela RM | Campo RM | TAG | Tabela PROTHEUS | Campo PROTHEUS |
| CompanyInternalId | cEmpAnt | cFilAnt | ||||
| BranchId | cFilAnt | ||||
| Código da coligada/empresa | MCUSTODIRETOEQUIPAMENTO MCUSTOEQUIPAMENTOAPONT | CODCOLIGADA | CompanyId | cEmpAnt | |
| Código do Patrimônio | IDPATRIMONIO | AssetInternalId | ST9 | cEmpAnt| cFilAnt| T9_CODBEM | |
| Mês e Ano | MESANO | Ano mês da ocorrência dos custos | |||
| Codigo do centro de custo | CODCCUSTO | CostCenterCode | Código do Centro de Custo/Frente de Trabalho | ||
| CostCenterInternalId | Internal ID do Centro de Custos | ||||
| ListOfDirectCost | |||||
|---|---|---|---|---|---|
| Codigo do centro de custo | MCUSTODIRETOEQUIPAMENTO | CODCCUSTO | CostCenterCode | Código do Centro de Custo/Frente de Trabalho | |
| CostCenterInternalId | Internal ID do Centro de Custos | ||||
| InternalId | Internal ID da entidade | ||||
| Quantidade horas improdutivas | QTDHRIMPRODUTIVA | UnproductiveHoursAmount | Quantidade de Horas Improdutivas apontadas no mês para a Frente de Trabalho/Centro de Custo | ||
| Valor horas improdutivas | VLRHRIMPRODUTIVA | UnproductiveHoursCost | Valor das horas improdutivas no mês. Calculado da seguinte forma. Valor Improdutivo = (custo hora da maquina parada * quantidade de horas paradas). O somatório das horas paradas será apurado com base nas horas lançadas nas atividades improdutivas | ||
| Quantidade horas produtivas | QTDHRPRODUTIVA | ProductiveHoursAmount | Quantidade de Horas Produtivas apontadas no mês para a Frente de Trabalho/Centro de Custo | ||
| Valor horas produtivas | VLRHRPRODUTIVA | ProductiveHoursCost | Valor das Horas Produtivas | ||
| Valor hora apos rateio | VLRHR | ApportionmentProductiveHoursCost | Valor das horas produtivas recalculada após rateio das horas improdutivas. Processo de rateio distribui as horas improdutivas com base na quantidade de horas produtivas por frente de trabalho. Então a quantidade de horas produtivas vai aumentar, e consequentemente o valor também vai aumentar, após o rateio. Este campo representa este novo valor. | ||
| ListOfAppointment | |||||
| MCUSTOEQUIPAMENTOAPONT | InternalId | Internal ID do apontamento | |||
| Identificador da Tarefa | IDTRF | TaskProjectInternalId | Internal id do ID da tarefa | ||
| TaskProjectId | ID Tarefa | ||||
| Data e hora inicio do apontamento | DATAHORAINICIO | StartDateTimeAppointment | Data/Hora Inicial do apontamento | ||
| Data e hora fim do apontamento | DATAHORAFIM | EndDateTimeAppointment | Data/Hora Final do apontamento | ||
| Identificador do Motivo | IDMOTIVO | ActivityCode | Código da Atividade | ||
| ActivityInternalId | Internal ID da Atividade | ||||
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas