Histórico da Página

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

id	Mensagens

Card

id	0
label	Parâmetros
title	Parâmetros Utilizados.

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.

Parâmetro	Descrição	Valor Padrão
Protheus
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

Card

id	1
label	Equipamentos
title	A 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:

Envia mensagem para integração com o bem inativado (SituationStatus = 2) para a filial atual e envia nova mensagem para a filial de destino, ativando o bem (SituationStatus = 1) ;
Detalhes do processo de transferência em Transferência de Bens-mnta550_dados_para_tranferencia_de_bens.htm.

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çã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	IPATRIMONIOCOMPL	CAPACIDADECODUND	UnitCapacityProductive	TQR	TQR_UNPROD

Card

id	2
label	Atividades - Motivos de Improdutividade
title	Atividades (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:

Descrição	Programa	Módulo	Tabelas
Agrupador:	Parte Diária
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.

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

Card

label	Apontamentos 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çã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
		HORIMETROFIM	HourmeterEnd
		QUILOMETRAGEM	Kilometers
		QUILOMETRAGEMFIM	KilometersEnd
Centro de Custos		CODCUSTO	CostCenter	TV2	TV2_CODFRE
Equipamento		IDPATRIMONIO	ActivityCode	TV2	TV2_CODATI
Tarefa		IDTRF	TaskProjectId	TV2	TV2_DTSERV

Card

id	3
label	Custo de Equipamentos
title	Adapter 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çã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:

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

ListOfDirectCost
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
Codigo do centro de custo		CODCCUSTO	CostCenterInternalId		Internal ID do Centro de Custos
Codigo do centro de custo	MCUSTODIRETOEQUIPAMENTO	CODCCUSTO	CostCenterCode		Código do Centro de Custo/Frente de Trabalho
Codigo do centro de custo		CODCCUSTO	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
Identificador da Tarefa		IDTRF	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
Identificador do Motivo		IDMOTIVO	ActivityInternalId		Internal ID da Atividade

Páginas filhas

Versões comparadas

Versão antiga 19

Nova versão Atual

Chave

Contexto de negócio (Introdução )

Sistemas Envolvidos

Integração