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.

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çã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