Páginas filhas
  • DI_MANUAL_TOTVS_TCOP X Manutenção_Ativos (SIGAMNT) X Backoffice Protheus

Contexto de negócio (Introdução )

Este documento tem por objetivo reunir as informações relevantes sobre a Integração do Totvs Obras e Projetos com manutenção de Ativos Protheus (SIGAMNT) no EAI 2.0


Sistemas Envolvidos

Descrição dos sistemas envolvidos no contexto de negócio (e que serão envolvidos na integração).

  • TOTVS Obras e Projetos - O TOTVS Obras e Projetos (TOP) visa facilitar ao máximo, com segurança e precisão, as atividades necessárias à realização do orçamento, do planejamento e do acompanhamento da execução do projeto. Isso é feito através de cronogramas, medições, PERT, apropriações e integrações.

  • Manutenção de Ativos PROTHEUS - Ativo Fixo e Manutenção de Ativos.

Integração

A informações para cadastramento dos adapters no PROTHUES estão em TOP x Manutenção de Ativos.


    RM - Patrimônio
    Parâmetro Descrição Valor Padrão
    COLOCARZEROESQPAT Colocar zeros a esquerda para completar o código do Patrimônio 0
    MASCARABEM Máscara do Bem. Obrigatório 2 Níveis. Ex.: ####.#####
    PATRIMONIOUNICO Código do Patrimônio único  0
    Observação: O configurador e conversores da integração são responsáveis por ajustar os parâmetro do RM.
    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) R
    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_NGBEMTR   Código do Status para Bem Transferido  
    MV_NGMBATV Código da Atividade Produtiva

    Integração de Bens MNT (ST9)

    A mensagem de equipamentos é enviada pelo Protheus sempre que o cadastro de um Bem do Manutenção de Ativos for incluído/alterado/inativado (uma vez que a exclusão de bens não é permitida com o processo de mobilidade ativo) e/ou em caso de transferência entre filiais onde o sistema procede da seguinte maneira:

    Premissas para envio:

    • As condições necessárias para funcionamento da integração de Bens são: o Conteúdo do parâmetro MV_NGINTMB deve ser ‘1’; o Campo ‘Sincronismo’ (T6_SINCRON) deve estar como ‘Sim’.

    As seguintes tabelas, devem ter seus compartilhamentos:

    Exclusivas a nível de filial:
    TP9 Bens Padrão Bens Padrão

    Compartilhadas a nível de filial:
    STB Detalhes do Bem Bem
    STC Estrutura Bem
    TPB Detalhes do Bem Padrão Bens Padrão
    TPD Etapas do Bem Padrão Bens Padrão
    SH1 Recursos RecFer
    SH4 Ferramentas RecFer
    STD Área de Manutenção
    STE Tipo de Manutenção

    Informações Integradas

    Descrição Tabela RM Campo RM Tag XML Tabela PROTHEUS Campo PROTHEUS
    Código da Empresa IPATRIMONIO CODCOLIGADA CompanyId
    cEmpAnt
    Código da Categoria Operacional IDGRUPOPATRIMONIO OperationalCategoryCode ST6 T9_CODFAMI
    Tipo de Equipamento.Sempre repassado como ‘1’, indicando o bem como próprio.  TIPOPATRIMONIO PropertyEquipmentType

    Situação do Equipamento ATIVO SituationStatus ST9 T9_SITBEM
    Descrição do Equipamento  DESCRICAO Description ST9 T9_NOME
    Data de Aquisição  DATAAQUISICAO PurchaseDate ST9 T9_DTCOMPR 
    Valor de Compra do Veículo  AQUISICAO PurchaseValue ST9 T9_VALCPA 
    Código do Equipamento  PATRIMONIO Code ST9 T9_CODBEM
    Código de barras do equipament CODIGOBARRA BarCode ST9 T9_BARCODE
    Código da Filial CODFILIAL CompanyInternalId
    cEmpAnt| cFilAnt 
    Cóligada Centro de Custo CODCOLIGADACENTROCUSTO CostCenterInternalId
    cEmpAnt|cFilAn t|T9_CCUSTO 
    Código do Centro de Custo  CODCENTROCUSTO CostCenterCode CTT T9_CCUSTO
    Capacidade Produtiva IPATRIMONIOCOMPL CAPACIDADEPROD CapacityProductive TQR TQR_CPPROD
    Unidade da Capacidade Produtiva CAPACIDADECODUND UnitCapacityProductive TQR TQR_UNPROD

    Integração das Atividades MNT (TV0)

    A mensagem de atividades é enviada pelo PROTHEUS e armazenadas nos motivos de improdutividade do RM. As atividades definidas no PROTHUES com o tipo de hora "1 - Trabalhada" não são enviadas para RM por serem consideradas produtivas.

    Acesso no RM => "módulo PROJETOS | aba CAD. GERAIS | agrupador BÁSICOS | 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 (estrela) MNTA851 Manutenção de Ativos TV1,TV2
    Acerto Parte Diária  (estrela) MNTA852 Manutenção de Ativos TV0,TV1,TV2

    (estrela) 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.


    Informações Integradas

    Descrição Tabela RM  Campo RM TAG Tabela PROTHEUS Campo PROTHEUS



    CompanyInternalId
    cEmpAnt | cFilAnt



    InternalId TV0 cEmpAnt | cFilAnt | TV0_CODATI
    Código da Empresa MMOTIVOPRODIMPROD CODCOLIGADA CompanyId
    cEmpAnt
    Código da Atividade CODMOTIVO Code TV0 TV0_CODATI
    Descrição da Atividade DESCRICAO Description TV0 TV0_NOME

    Integração dos Apontamentos de Equipamentos MNT (TV1 e TV2)

    Envio: A mensagem de Apontamentos é enviada pelo RM ao PROTHEUS com dados referente ao apontamento recebido via Coletor e armazenando as informações do Equipamento. Ao ser enviada ao Protheus o status desse apontamento passa ser Enviado/Apropriado no RM.

    Recebimento: As mensagens enviados do Protheus ao RM referente aos apontamentos, é somente a mensagem de DELETE, que ao ser recebida e processada no RM é atualizado o Status do Apontamento no RM para "Cancelado".

    Acesso no RM => "módulo PROJETOS | aba CONTROLE | agrupador MOBILIDADE | agrupador EQUIPAMENTOS| Apontamentos de Equipamentos".

    Acesso PROTHEUS => Modulo Manutenção de Ativos => Parte Diária => Acerto de Parte Diária.

    Para envio do Apontamento é necessário:

    • Um Equipamento cadastrado e integrado;
    • Equipamento configurado para ser do tipo "Controlador" em sua aba de opções;
    • Equipamento com código de barras;
    • Centro de Custos no 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":

    Informações Integradas:

    Descrição Tabela RM  Campo RM TAG Tabela PROTHEUS Campo PROTHEUS



    CompanyInternalId
    cEmpAnt | cFilAnt



    InternalId TV2 cEmpAnt | cFilAnt | TV0_CODATI
    Código da Empresa MAPONTEQUIPAMENTO CODCOLIGADA CompanyId
    cEmpAnt
    Hora Inicio DATAHORAINICIO StartDateTimeAppointment TV2

    TV2_HRINI

    Hora Fim DATAHORAFIM EndDateTimeAppointment TV2 TV2_HRFIM
    Horímetro HORIMETRO Hourmeter

    Centro de Custos CODCUSTO CostCenter TV2 TV2_CODFRE
    Equipamento IDPATRIMONIO ActivityCode TV2 TV2_CODATI
    Tarefa IDTRF TaskProjectId TV2 TV2_DTSERV

    Integração dos Custos de Equipamentos do SIGAMNT

    Objetivo:

    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 






    • Sem rótulos