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

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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 Projetos -  O O TOTVS Obras e Projetos (TOPTCOP) 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 TCOP x Manutenção de Ativos.


Deck of Cards
idMensagens
Card
id0
labelParâmetros
titleParâmetros Utilizados.
RM - Patrimônio
ParâmetroDescriçãoValor Padrão
COLOCARZEROESQPATColocar zeros a esquerda para completar o código do Patrimônio0
MASCARABEMMáscara do Bem. Obrigatório 2 Níveis. Ex.: ####.#####
PATRIMONIOUNICOCó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âmetroDescriçãoValor 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_NGMBATVCódigo da Atividade Produtiva
Card
id1
labelEquipamentos
titleA Integração de Bens MNT (ST9) via Mensagem Única TOTVS.

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 filialFilial:

TP9 Bens Padrão Bens PadrãoPadrão 

Exclusivas a nível de Empresa e Compartilhadas a nível de filialUnidade de Negócio e Filial:

ST9 Bem
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çãoTabela RMCampo RMTag XMLTabela PROTHEUSCampo PROTHEUS
Código da EmpresaIPATRIMONIOCODCOLIGADACompanyId
cEmpAnt
Código da Categoria OperacionalIDGRUPOPATRIMONIOOperationalCategoryCodeST6T9_CODFAMI
Tipo de Equipamento. Sempre repassado como ‘1’, indicando o bem como próprio. TIPOPATRIMONIOPropertyEquipmentType

Situação do EquipamentoATIVOSituationStatusST9T9_SITBEM
Descrição do Equipamento DESCRICAODescriptionST9T9_NOME
Data de Aquisição DATAAQUISICAOPurchaseDateST9T9_DTCOMPR 
Valor de Compra do Veículo AQUISICAOPurchaseValueST9T9_VALCPA 
Código do Equipamento PATRIMONIOCodeST9T9_CODBEM
Código de barras do equipamentCODIGOBARRABarCodeST9T9_BARCODE
Código da FilialCODFILIALCompanyInternalId
cEmpAnt| cFilAnt 
Cóligada Centro de CustoCODCOLIGADACENTROCUSTOCostCenterInternalId
cEmpAnt|cFilAn t|T9_CCUSTO 
Código do Centro de Custo CODCENTROCUSTOCostCenterCodeCTTT9_CCUSTO
Capacidade ProdutivaIPATRIMONIOCOMPLCAPACIDADEPRODCapacityProductiveTQRTQR_CPPROD
Unidade da Capacidade ProdutivaCAPACIDADECODUNDUnitCapacityProductiveTQRTQR_UNPROD
Card
id2
labelAtividades - Motivos de Improdutividade
titleAtividades (TV0)

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çãoProgramaMóduloTabelas
Atividades MNTA850Manutenção de AtivosTV0
Parte Diária (estrela)MNTA851Manutenção de AtivosTV1,TV2
Acerto Parte Diária  (estrela)MNTA852Manutenção de AtivosTV0,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çãoTabela RM Campo RMTAGTabela PROTHEUSCampo PROTHEUS



CompanyInternalId
cEmpAnt | cFilAnt



InternalIdTV0cEmpAnt | cFilAnt | TV0_CODATI
Código da EmpresaMMOTIVOPRODIMPRODCODCOLIGADACompanyId
cEmpAnt
Código da AtividadeCODMOTIVOCodeTV0TV0_CODATI
Descrição da AtividadeDESCRICAODescriptionTV0TV0_NOME
Card
labelApontamentos de Equipamentos

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 MINHA OBRA | 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:

Obs.: O apontamento sera registrado com Horímetro ou Quilometragem.

DescriçãoTabela RM Campo RMTAGTabela PROTHEUSCampo PROTHEUS



CompanyInternalId
cEmpAnt | cFilAnt



InternalIdTV2cEmpAnt | cFilAnt | TV0_CODATI
Código da EmpresaMAPONTEQUIPAMENTOCODCOLIGADACompanyId
cEmpAnt
Hora InicioDATAHORAINICIOStartDateTimeAppointmentTV2

TV2_HRINI

Hora FimDATAHORAFIMEndDateTimeAppointmentTV2TV2_HRFIM
HorímetroHORIMETROHourmeter


HORIMETROFIMHourmeterEnd


QUILOMETRAGEMKilometers


QUILOMETRAGEMFIMKilometersEnd

Centro de CustosCODCUSTOCostCenterTV2TV2_CODFRE
EquipamentoIDPATRIMONIOActivityCodeTV2TV2_CODATI
TarefaIDTRFTaskProjectIdTV2TV2_DTSERV
Card
id3
labelCusto de Equipamentos
titleAdapter de Custos de Equipamentos

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.

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;
  • 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:

    MNTA494B: Mensagem Única de Custos Diretos Mensais do bem.

    O caminho da rotina no menu deverá ser configurado como: 

      • Miscelanea/Custos/Custo Mensal 

    Acesso PROTHEUS => Adicionar ao menu as rotinas conforme abaixo:

    DescriçãoProgramaMóduloTabelas
    Miscelania/Custos/Custo MensalMNTA494Manutenção de AtivosSTJ, 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".

    Image Added

    Para que o processo calcule os custos indiretos é necessário definir nos parâmetros de projetos os custos serão apropriados.

    Image Added


    Custos Indiretos

    DescriçãoCustoTabelaObservaçãoComo Cadastrar
    Custo Mão de ObraLaborCostSTLCusto 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 STLCusto 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 STLCusto 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 STLCusto 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 multasPenaltyCost 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 DocumentosPaperCost TS2Custo com documentos realizados  no mês
    Custo com AcidentesIncidentCost TRH,TRK, TRO, TRL, TRV, TRMCusto 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 EquipamentoRentCost 
    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 EquipamentoHourRentCost 
    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 FaturadoBilledRentCost 
    Valor faturado pela locação do equipamento 


    Informações no XML de Custos Indiretos

    DescriçãoTabela RM Campo RMTAGTabela PROTHEUSCampo PROTHEUS
    BusinessContent
    Código da empresa/coligada MCUSTOINDIRETOEQUIPAMENTO    CODCOLIGADACompanyId

    Internal ID da chave completa da empresa 
    CompanyInternalId

    Código da Filial 
    BranchId

    Internal id do Código do BemIDPATRIMONIOAssetInternalId

    Ano mês de ocorrência dos custos MESANOMonthYear

    ListOfIndirectCost 
    Internal ID da entidade  MCUSTOINDIRETOEQUIPAMENTO              
    InternalId   

    Código do Centro de Custo. Utilizado para identificar o projeto.CODCCUSTOBEMCostCenterCode   

    Custo da Mão de Obra aplicado na O.S. CUSTOMAODEOBRALaborCost   STL
    Custo de peças, produtos, lubrificantes, aplicados na OS CUSTOMATERIAIS InputCost   STL
    Custo com serviços de terceiros que trabalharam na OS CUSTOTERCEIROSThirdPartCost   STL
    Custo com ferramentas aplicadas na OS CUSTOFERRAMENTASToolCost   STL
    Custo de Locação do Equipamento (Fixo), calculado pelo sistema de manutenção de ativos CUSTOFXLOCACAOCUSTOCOMBUSTIVEISRentCost   

    Custo com multas pagas no mês, podemos considerar somente multas por culpa da empresa CUSTOMULTASPenaltyCost   TRX
    Custo com acidentes ocorridos no mês CUSTOACIDENTESIncidentCost   TRH, TRK, TRO, TRL, TRV, TRM
    Custo com documentos realizados no mês CUSTODOCUMENTOSPaperCost   TS2
    Custo com os abastecimentos realizados no Mês CUSTOCOMBUSTIVEISFuelCost   

    Custo total de locação do Equipamento, calculado pelo sistema de manutenção de ativos mensalmente CUSTOTTLOCACAOTotalRentCost   

    Custo Hora de Locação do Equipamento, calculado pelo sistema de manutenção de ativos CUSTOHRLOCACAOHourRentCost   

    Custo Hora Real de locação do Equipamento, calculado pelo sistema de manutenção de ativos mensalmente CUSTORELOCACAORealHourRentCost   

    Valor Faturado pela locação do Equipamento VALORFTLOCACAOBilledRentCost   



    Custos Diretos

    DescriçãoCustoTabelaObservação
    Horas Improdutivas UnproductiveHoursAmount 
    Quantidade de horas improdutivas apontadas no mês na frente de trabalho
    Valor Horas ImprodutivasUnproductiveHoursCost 
    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 ProdutivasProductiveHoursCost
    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çãoTabela RM Campo RMTAGTabela PROTHEUSCampo PROTHEUS



    CompanyInternalId
    cEmpAnt | cFilAnt



    BranchId 
    cFilAnt
    Código da coligada/empresa MCUSTODIRETOEQUIPAMENTO MCUSTOEQUIPAMENTOAPONTCODCOLIGADACompanyId
    cEmpAnt 
    Código do PatrimônioIDPATRIMONIOAssetInternalIdST9cEmpAnt| cFilAnt| T9_CODBEM 
    Mês e AnoMESANO

    Ano mês da ocorrência dos custos
    Codigo do centro de custoCODCCUSTOCostCenterCode    
    Código do Centro de Custo/Frente de Trabalho
    CostCenterInternalId
    Internal ID do Centro de Custos
    ListOfDirectCost 
    Codigo do centro de custoMCUSTODIRETOEQUIPAMENTOCODCCUSTOCostCenterCode    
    Código do Centro de Custo/Frente de Trabalho
    CostCenterInternalId
    Internal ID do Centro de Custos


    InternalId   
    Internal ID da entidade 
    Quantidade horas improdutivasQTDHRIMPRODUTIVAUnproductiveHoursAmount   
    Quantidade de Horas Improdutivas apontadas no mês para a Frente de Trabalho/Centro de Custo 
    Valor horas improdutivasVLRHRIMPRODUTIVAUnproductiveHoursCost   
    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 produtivasQTDHRPRODUTIVAProductiveHoursAmount   
    Quantidade de Horas Produtivas apontadas no mês para a Frente de Trabalho/Centro de Custo 
    Valor horas produtivasVLRHRPRODUTIVAProductiveHoursCost   
    Valor das Horas Produtivas 
    Valor hora apos rateioVLRHRApportionmentProductiveHoursCost
    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 TarefaIDTRFTaskProjectInternalId  
    Internal id do ID da tarefa 
    TaskProjectId  
    ID Tarefa 
    Data e hora inicio do apontamentoDATAHORAINICIOStartDateTimeAppointment  
    Data/Hora Inicial do apontamento 
    Data e hora fim do apontamentoDATAHORAFIMEndDateTimeAppointment  
    Data/Hora Final do apontamento 
    Identificador do MotivoIDMOTIVOActivityCode   
    Código da Atividade 
    ActivityInternalId   
    Internal ID da Atividade 




    ...