Integração Protheus MNT x BackOffice RM

Protheus MNT x BackOffice RM
Integrao
Pgina 1 de 84
Integrao
INTEGRAO
Protheus MNT x Backoffice RM
(Mensagem nica)
DOCUMENTAO
TCNICA
AMBIENTE:
Manuteno de Ativos
02/08/13
Verso 4
Pgina 2 de 84
Integrao
SUMRIO
1. OBJETIVO ...................................................................................................................................................... 5
2. PROGRAMAS ................................................................................................................................................ 6
3. TABELAS........................................................................................................................................................ 8
3.1. NOVOS CAMPOS E TABELAS ................................................................................................................................ 8
3.2. TABELAS ENVOLVIDAS ....................................................................................................................................... 9
4. CONFIGURAO DO AMBIENTE .................................................................................................................. 11
4.1. SERVIDOR HTTP ............................................................................................................................................ 11
4.2. UPDATES ...................................................................................................................................................... 14
4.3. PARMETROS ................................................................................................................................................ 15
4.4. MENU .......................................................................................................................................................... 17
4.5. CONFIGURAES DE CADASTRO ........................................................................................................................ 19
A) CADASTRO DE BENS ............................................................................................................................................ 19
B) CADASTRO DE PRODUTOS DE CDIGO FIXO.............................................................................................................. 19
C) CADASTRO DAS ENTIDADES DE-PARA E CARGA INICIAL............................................................................................... 21
D) OUTRAS CONFIGURAES..................................................................................................................................... 22
4.6. UTILIZAO DE OUTROS MDULOS .................................................................................................................... 22
5. CONFIGURAO DOS ADAPTERS ................................................................................................................ 23
6. DESCRIO DOS PROCESSOS/MENSAGENS ................................................................................................ 28
6.1. BAIXA DE ESTOQUE ......................................................................................................................................... 29
6.2. BAIXA DE ESTOQUE (RECEBIMENTO)................................................................................................................... 31
6.3. ESTORNO DE BAIXA DE ESTOQUE ....................................................................................................................... 32
6.4. ESTORNO DE BAIXA DE ESTOQUE (RECEBIMENTO) ................................................................................................. 34
6.5. SOLICITAO DE COMPRA ................................................................................................................................ 35
6.6. SOLICITAO AO ARMAZM ............................................................................................................................. 37
6.7. CANCELAMENTO DE SOLICITAO DE COMPRA ..................................................................................................... 38
6.8. CANCELAMENTO DE SOLICITAO AO ARMAZM .................................................................................................. 39
6.9. AMPLIAO PATRIMONIAL ............................................................................................................................... 40
6.10. APROPRIAO DE CUSTO ................................................................................................................................. 42
6.11. CONSULTA DE SALDO ...................................................................................................................................... 45
6.12. ORDEM DE SERVIO ........................................................................................................................................ 48
6.13. ATUALIZAO DE CUSTO .................................................................................................................................. 53
6.14. SOLICITAO DE SERVIO [NO DISPONVEL] ....................................................................................................... 54
6.15. PEDIDO DE COMPRA ....................................................................................................................................... 55
6.16. PROCESSOS ESPECFICOS DO FROTAS .................................................................................................................. 56
7. COMPOSIO DAS MENSAGENS ................................................................................................................. 62
7.1. STOCKTURNOVER ........................................................................................................................................... 62
7.2. REQUEST ...................................................................................................................................................... 63
7.3. MAINTENANCEORDER ..................................................................................................................................... 66
7.4. MAINTENANCEREQUEST NO CONTEMPLADO ..................................................................................................... 68
7.5. CANCELREQUEST ............................................................................................................................................ 68
7.6. CANCELMAINTENANCEORDER .......................................................................................................................... 70
7.7. STOCKLEVEL .................................................................................................................................................. 70
7.8. APPOINTMENTCOST........................................................................................................................................ 71
7.9. ASSETSVALUATION ......................................................................................................................................... 72
7.10. ORDER ......................................................................................................................................................... 73
7.11. INFOOFPARCELVALUES ................................................................................................................................... 75
Pgina 3 de 84
Integrao
8. OBSERVAES GERAIS ................................................................................................................................ 76

8.1. CONSULTA DE OS ........................................................................................................................................... 76
8.2. DUPLICAO DE MENSAGENS............................................................................................................................ 77
8.3. HISTRICO DE OS (STS) .................................................................................................................................. 78
8.4. CUSTO DAS ORDENS DE SERVIO ....................................................................................................................... 78
9. GAPS DE PROCESSO .................................................................................................................................... 80
10. FAQ FREQUENTED ASKED QUESTIONS ..................................................................................................... 81
11. ANEXOS .................................................................................................... ERRO! INDICADOR NO DEFINIDO.
11.1. FUNCIONALIDADE DE APROPRIAO DE CUSTOS NO MNT ............................................ ERRO! INDICADOR NO DEFINIDO.
Pgina 4 de 84
Integrao
1. OBJETIVO
O objetivo deste documento descrever os processos que envolvem a

integrao do mdulo Manuteno de Ativos com o Backoffice do ERP, e servir
como base para a configurao do sistema e para utilizao dos adapters de
integrao via mensagem nica. Os processos descritos nesse documento foram
elaborados tendo em vista a utilizao do Backoffice RM.
O presente documento tem como foco apenas a configurao do mdulo
Manuteno de Ativos e seus processos em integrao com o Backoffice, no
sendo responsabilidade do mesmo descrever as parametrizaes referentes ao EAI
Protheus ou RM. Para os demais processos e configuraes recomenda-se as
documentaes e especificao desenvolvidas para o projeto e documentaes
especficas do EAI. Em alguns momentos, de forma complementar, so citadas
tambm configuraes referentes ao Protheus e outras documentaes.
Recomenda-se, para auxiliar no processo, utilizar as evidncias de testes
desenvolvidas durante a etapa de testes integrados para visualizar o funcionamento
prtico da integrao.
Pgina 5 de 84
Integrao
2. PROGRAMAS
o Rotinas padro (fase 1)

MNTUTIL MNTA080 MNTA430
NGUTIL01 MNTA245 MNTA435
NGMNT00 MNTA280* MNTA550
NGGERAOS MNTA295 MNTA600
NGMUUtil MNTA330 MNTA655
MNTA340 MNTA690
MNTA360 MNTA720
MNTA365 MNTA860
MNTA370 MNTA875
MNTA380 MNTA880
MNTA385 MNTA985
MNTA400 MNTA990
MNTA401 MNTA998
MNTA410 MNTC755
MNTA415 GerXnuFrt
MNTA420
o Rotinas padro (fase 2)

MNTUTIL MNTA080 MNTA600
NGMUUtil MNTA245 MNTA650
NGMNT00 MNTA340 MNTA666
NGGERAOS MNTA385 MNTA680
GERXNUFRT MNTA386 MNTA690
NGIntFin MNTA400 MNTA720
NGFWError MNTA401 MNTA765
NGFWStruct MNTA402 MNTA805
NGGenerico MNTA415 MNTA815
MNTA435 MNTA825
Pgina 6 de 84
Integrao
MNTA450 MNTA880
MNTA480 MNTA901
MNTA510 MNTA990
o Update
UPDMNT42
o Adapters de integrao (fase 1)

NGMUStoTuO
NGMUCanReq
NGMUReques
NGMUAmpPat
NGMUAprCst
NGMUStoLvl
NGMUMntOrd
NGMUMntReq*
NGMUCanMnO
o Adapters de integrao (fase 2)

NGMUStoTuO
NGMUCanReq
NGMUReques
NGMUAmpPat
NGMUAprCst
NGMUStoLvl
NGMUMntOrd
NGMUMntReq*
NGMUCanMnO
NGMUOrder
NGMUInfPar
* no disponvel
Pgina 7 de 84
Integrao
3. TABELAS
3.1. Novos campos e tabelas
Foram criadas novas tabelas para atender o escopo da integrao:

Tabela Descrio
TUT Indicador de Uso de Objetos de Manuteno
Tambm foram criados os seguintes campos:

Tabela Campo Descrio
TUT TUT_FILIAL Filial do Sistema
TUT_CODBEM Cdigo do Bem
TUT_TPCONT Tipo Contador
TUT_CLSPRE Classificao do Preo
TUT_VALOR Valor
TUT_CUSTHO Custo Hora
TUT_CODPRO Cdigo do Produto
TUT_LOCAL Local do Produto
TUT_CUSTD Custo Standard
TUT_CUSTM Custo Mdio
TQB TQB_INTPRJ Cdigo do Projeto TOP
TQB_INTTSK Cdigo da Tarefa TOP
STJ TJ_INTPRJ Cdigo do Projeto TOP
TJ_INTTSK Cdigo da Tarefa TOP
TJ_FATURA Faturado - Integrao
TJ_APROPRI Apropriado - Integrao
STS TS_INTPRJ Cdigo do Projeto TOP
TS_INTTSK Cdigo da Tarefa TOP
TS_FATURA Faturado - Integrao
TS_APROPRI Apropriado - Integrao
Pgina 8 de 84
Integrao
STP TP_APROPRI Apropriado - Integrao

TPP TPP_APROPR Apropriado - Integrao
3.2. Tabelas Envolvidas
Entre as principais tabelas envolvidas no processo esto:

Tabela Descrio
TUT Indicador de Uso de Objetos de Manuteno
TQB Solicitao Servio
STJ Ordens de Servio de Manuteno
STS Histrico de Manuteno
STP Ordens de Servio de Acompanhamento (Contador)
TPP OS Acompanhamento (Contador 2)
SN1 Ativo Imobilizado
ST9 Bem
TPE Segundo Contador do Bem
STL Detalhes da Ordem de Servio
SB1 Descrio Genrica do Produto
ST1 Funcionrios
SD3 Movimentaes Internas
SC1 Solicitaes de Compra
SCP Solicitaes ao Armazm
SB2 Saldos Fsico e Financeiro
SN4 Movimentaes do Ativo Fixo
SC7 Pedidos de Compra
SE2 Contas a Pagar
TRX Cadastro de Multas
TS2 Documentos a Pagar
TS8 Honorrios de Despachante
Pgina 9 de 84
Integrao
O compartilhamento das tabelas no Protheus entre compartilhada/exclusiva

deve seguir a regra definida pelo Backoffice RM entre global/por filial, seguindo
tambm as regras de integrao entre tabelas do Protheus para que se mantenha a
integridade relacional. Na implantao importante avaliar o compartilhamento das
tabelas de maior impacto SB1, SB2, CTT, NNR, SE4, SN1 e SRA, entre outras.
Pgina 10 de 84
Integrao
4. CONFIGURAO DO AMBIENTE
Dentre as configuraes necessrias para o correto funcionamento da

integrao entre o Protheus MNT e o Backoffice RM esto as configuraes de
webservice, parmetros, menu, update, entre outros. Nesse captulo sero
abordadas, de forma geral, as principais configuraes necessrias. De forma
complementar o documento disponvel no link abaixo contempla o escopo do projeto
de forma mais detalhada, abordando tambm as configuraes do RM:
http://tdn.totvs.com.br/download/attachments/51251322/LinhaRM+x+Protheus+SigaMNT.docx?versio
n=1&modificationDate=1369062022000
4.1. Servidor HTTP
Pode ser configurado atravs do wizard.exe. Como pr-requisito, o cliente

deve ter licena Protheus do Tipo I. Abaixo um exemplo das configuraes da seo
HTTP:
[HTTP]
ENABLE=1
PORT=86
PATH=\web\EAI
ENVIRONMENT=Environment
RESPONSEJOB=JOB_EAI_0101
[localhost:86]
ENABLE=1
PATH=M:\Protheus11\web\EAI
ENVIRONMENT=Oracle
INSTANCENAME=EAI
RESPONSEJOB=JOB_EAI_0101
DEFAULTPAGE=wsindex.apw
[JOB_EAI_0101]
TYPE=WEBEX
ENVIRONMENT=Environment
INSTANCES=1,1
SIGAWEB=WS
INSTANCENAME=EAI
ONSTART=__WSSTART
ONCONNECT=__WSCONNECT
PREPAREIN=01,01
Pgina 11 de 84
Integrao
Da forma exemplificada acima, o webservice ser localizado quando na

mquina local. recomendado duplicar a seo [localhost:86] tambm para o
endereo IP e para o hostname da mquina.
Para acessar o WSDL, utilizar o endereo configurado como exemplo:
localhost:86/wsindex.apw e localizar o servio EAISERVICE.
Recomenda-se aplicar patch com atualizao do EAI e da ferramenta

FSENVEAI desenvolvida por Ernani Forastieri como recurso para realizar
simulaes no ambiente, caso necessrio. Ferramenta disponvel no link:
http://www.ernaniforastieri.com/products/fsenveai1/
Pode-se utilizar tambm algum aplicativo terceiro como o soapUI para realizar
um teste no WSDL do Protheus. Abaixo um exemplo de utilizao da ferramenta
FSENVEAI:
Pgina 12 de 84
Integrao
Exemplo de XML enviado:
<?xml version="1.0" encoding="utf-8"?>

<TOTVSMessage>
<MessageInformation version="1.000">
<UUID>3d4b45b3-8443-67d1-f16f-6107d3162c02</UUID>
<Type>BusinessMessage</Type>
<Transaction>WhoIs</Transaction>
<StandardVersion>1.000</StandardVersion>
<SourceApplication>TESTE</SourceApplication>
<CompanyId>99</CompanyId>
<BranchId>01</BranchId>
<Product name="PROTHEUS" version="11"></Product>
<GeneratedOn>2010-12-10T14:41:56</GeneratedOn>
<DeliveryType>Sync</DeliveryType>
</MessageInformation>
<BusinessMessage>
<BusinessRequest>
<Operation>WhoIs</Operation>
</BusinessRequest>
</BusinessMessage>
</TOTVSMessage>
Pgina 13 de 84
Integrao
Ao enviar a mensagem WHOIS para o EAI Protheus, a resposta um XML

com os adapters cadastrados no Protheus e suas verses:
Configuraes complementares em:
http://tdn.totvs.com.br/pages/viewpage.action?pageId=6064937
4.2. Updates
A integrao exige a execuo do update UPDMNT42. Para execut-lo

necessrio ter configurado a integrao via mensagem nica atravs do parmetro
MV_NGINTER, citado no captulo configurao de ambiente / parmetros.
Pgina 14 de 84
Integrao
Na verso atual, para utilizao da integrao com TOP e utilizar os adapters

de projeto e tarefa, necessrio aplicar o update UPDPMS para correes no
Protheus. Tambm necessrio incluir manualmente um calendrio padro.
4.3. Parmetros
necessrio configurar alguns parmetros para que a integrao com o

Backoffice RM funcione corretamente, o que pode ser feito atravs do configurador:
Parmetro Contedo Observao
MV_NGINTER M L=Logix;R=RM;M=Mensagem nica.

Indica se deve gerar Solicitao de Armazm ao invs de
MV_NGGERSA S/N
Solicitao de Compras.
No permite estoque negativo. O estoque consultado no
RM, independente das movimentaes na SD3 e da SB2.
Porm h funes Microsiga que no relevam essa consulta
MV_ESTNEG N no mbito do MNT. Por isso a funcionalidade deveria ser
desenvolvida pelo mdulo de Estoque (funo SaldoSB2).
Em todo caso, o SB2 est sendo alterado conforme o
resultado da consulta da integrao.
Pgina 15 de 84
Integrao
MV_NGMNTES S Integrao com Estoque.

MV_NGMNTPC S integrao com PCP.
MV_PRODFER <produto> Item de estoque que indica ferramentas no SIGAMNT.
MV_PRODTER <produto> Item de estoque que indica terceiros no SIGAMNT.
Indica se a numerao dos itens da solicitao de compras
MV_NGMNTCP N ser a mesma. Este parmetro sobrepe o processo padro
de gerao do Compras.
MV_NGCORPR S Permite gerar empenho e SCs para OS Corretiva.
Integrao Manuteno (MNT) c/ Ativo (ATF). Informar ou
MV_NGMNTAT 3 N no integra; 1= alteraes no ATF replicaro no MNT; 2=
MNT p/ ATF; 3= MNT p/ ATF e ATF p/ MNT.
MV_NGSALHO Define se o campo salrio do funcionrio da manuteno
S
integrado com o GPE.
MV_NGMNTRH Integrao Manuteno (MNT) com Recursos Humanos
S
(RH).
MV_RASTRO Determina a utilizao ou no da rastreabilidade dos lotes de
N
produo (S para sim ou N para no).
MV_NGMNTCM Integrao do Manuteno de Ativos (MNT) com Compras
S
(COM). Informar S para sim e N para no.
MV_NGMNTFI Integrao do Manuteno de Ativos (MNT) com Financeiro
S
(FIN). Informar S para sim e N para no.
MV_PRODTRX <produto> Item de estoque que indica multas no MNT.
MV_PRODTS2 <produto> Item de estoque que indica documentos no MNT.
MV_PRODTS8 <produto> Item de estoque que indica honorrios no MNT.
MV_NGPRSB2 S Busca preo mdio da tabela SB2.
Outras configuraes recomendadas:

MV_NGMULOS S Permite a abertura de mais de uma OS por SS.
MV_NGMNTFR S Indica que a empresa utiliza o sistema Gesto de Frotas.
MV_NGPNEUS S Indica se utiliza complemento de pneus.
Abaixo as configuraes necessrias ao Gesto de Frotas (MV_NGMNTFR =

S) para utilizao do Controle de Pneus. Os parmetros devem estar configurados
conforme o cadastro de status do MNT:
Parmetro Descrio
MV_NGSTAPL Aplicado
MV_NGSTAGR Aguardando Reforma
MV_NGSTAGC Aguardando Conserto
Pgina 16 de 84
Integrao
MV_NGSTAEU Estoque Usado

MV_NGSTAER Estoque Reformado
MV_NGSTAAT Aguardando Anlise Tcnica
MV_NGSTARS Removido de Servio
MV_NGSTAEN Estoque Novo
Segue tambm as configuraes necessrias ao EAI:

Senha para autenticao do EAI para uso no envio de
MV_EAIPASS mensagens. No necessariamente o que est sendo
totvs
apresentado nessa documentao confirmar com a
equipe de infraestrutura.
http://rm0005291.bh01. Nome do canal configurado no EAI para envio a outro
MV_EAIURL2 EAI. Case sensitive. No caso do RM, indica o endereo
local/TBC1180/
do TBC. Verificar com a equipe de infraestrutura qual o
WsEAIService.asmx endereo a ser utilizado.
MV_EAIUSER Usurio para autenticao do EAI para uso no envio de
mestre
mensagens. Verificar com a equipe de infraestrutura.
Importante:
- alguns parmetros do EAI j vm configurados por padro.
- ateno para parmetros case sensitive.
- para melhor entendimento do funcionamento do EAI Protheus com
mensagem nica, consultar:
http://tdn.totvs.com.br/display/public/dts/Conceitos+-+113343+EAI+2+-+Console
4.4. Menu
Configurar o menu com as rotinas:

Indicadores de Uso (MNTA370) [STJ, STP, TUT]
Apropriao de Custos (MNTA385) [TUT]
Atualizao de Custos (MNTA386) [STJ, STL]
A sugesto que fique conforme a imagem abaixo:
Pgina 17 de 84
Integrao
importante tambm que as rotinas de cadastros bsicos que so realizados

atravs do Backoffice RM sejam retiradas do menu do MNT (ou ao menos
desabilitadas as opes de incluir, alterar e excluir), visto que a manuteno do
cadastro deve ser feito atravs do Backoffice. Para isso deve-se verificar quais
cadastros do Backoffice foram integrados e devem ser removidos. Um exemplo o
cadastro de produtos e centros de custo.
Pode ser que haja a necessidade de incluir tambm as rotinas para cadastro
de de-para no configurador do Protheus:
APCFG050 De/Para Empresa
APCFG070 De/Para Entidade
Pgina 18 de 84
Integrao
Considerando o relacionamento das configuraes do arquivo de empresas

sigamat.emp com as tabelas de empresas GColigada e filiais GFilial no RM: o
campo referncia indica o produto de onde vem a informao do de-para, nesse
caso RM; company e branch indicam a empresa e filial do RM; e emp. Protheus
pode fazer referncia ao grupo de empresas no Protheus quando fil. Protheus
referencia a empresa e filial. As informaes dos cadastros de de-para podem ser
visualizadas no arquivo XX4010.dbf.
4.5. Configuraes de Cadastro
a) Cadastro de Bens
Para utilizar o mdulo SigaMNT, uma das principais entidades envolvidas em

qualquer processo o cadastro de bens (ST9). Considerando o processo de
integrao, entende-se que invivel solicitar ao cliente que inclua no MNT todos os
cadastros de bens j existentes no Officina. Para isso o MNT deve fornecer um
facilitador que permite um cadastro automtico desses bens.
A soluo adotada a utilizao de um programa de carga inicial, o qual
ficar a cargo da equipe de implantao.
A soluo inicial envolvia a utilizao da integrao da entidade de ativo fixo,
a partir da qual seria gerado um bem por meio da rotina Miscelnea / Gera Bens / A
partir do ATF. Entretanto, a rotina exige ajustes manuais posteriores. Segue link do
boletim para integrao do cadastro de ativos:
http://tdn.totvs.com.br/download/attachments/45224822/Boletim+T%C3%A9cnico+Ativos+NGI+.docx?
version=1&modificationDate=1370459267000
b) Cadastro de Produtos de Cdigo Fixo
A integrao do cadastro de produtos funciona normalmente conforme

desenvolvido pelo mdulo responsvel pela entidade. Entretanto, tanto o
Manuteno de Ativos quanto outros mdulos do Protheus utilizam como artifcio a
incluso de produtos de cdigo fixo em algumas situaes. Quando integrado com o
Backoffice, insumos so convertidos para produtos e enviados com um cdigo fixo.
Pgina 19 de 84
Integrao
No caso de insumos do tipo mo-de-obra, por exemplo, gerado um cdigo de

produto pela concatenao de MOD com o centro de custo do funcionrio.
Para o bom funcionamento da integrao imprescindvel que os produtos de
cdigo fixo estejam cadastrados no Backoffice RM e tenham um de-para com o
Protheus. Isso feito de forma automtica via mensagem nica. Entretanto, h
casos em que no possvel ao Backoffice cadastrar um produto seguindo o
mesmo padro do Protheus. Dessa forma, a soluo adequada para essa limitao
utilizar uma tag do XML da mensagem nica e criar uma regra para que o adapter
de produtos (desenvolvido pela Totvs) identifique produtos de cdigo fixo e os
cadastre no Protheus. Exemplificando, se o RM cadastrar um produto 01 e marcar
uma flag como mo-de-obra, o adapter de produtos geraria um cdigo seguindo a
regra de cdigo fixo em questo, seja MOD+CC ou qualquer outra regra utilizada.
O cadastro do de-para associaria, ento, o cdigo 01 com MOD01, por exemplo.
Porm, como tal tratamento no fez parte do escopo, o MNT usa um artifcio
que permite associar um produto MOD+CC com outro cdigo a ser enviado ao RM.
Para isso necessrio incluir, via configurador, um registro na tabela de-para,
seguindo os seguintes parmetros:
- Referncia: PROTHEUS
- Alias: ST1
- Campo: T1_CCUSTO
- Valor Externo: cdigo do produto (interno) a ser enviado na integrao
- Valor Interno: MOD+CC
Sempre que houver a necessidade de se enviar um produto de cdigo fixo ao
Backoffice, o adapter ir pesquisar pelo cdigo fixo na tabela de-para do Protheus
pelo alias ST1 e campo T1_CCUSTO. Encontrando, envia o valor externo, e se no
encontrar envia o prprio cdigo fixo do produto (supondo que o cadastro est
totalmente integrado). Exemplificando, quando o MNT enviar o produto MOD01, ir
procurar por esse cdigo na tabela de de-para considerando o alias ST1. Se
encontrar um suposto produto 09.01 associado, o MNT o envia esse 09.01, caso
contrrio envia MOD01.
No caso da utilizao de um produto TERCEIROS, possvel apenas
realizar um ajuste no parmetro MV_PRODTER, informando o cdigo de um produto
Pgina 20 de 84
Integrao
que esteja integrado. Nesse caso no h necessidade de contorno atravs de um

cadastro de-para.
c) Cadastro das Entidades De-Para e Carga Inicial
As entidades de-para so fundamentais para qualquer integrao, pois

vinculam os cdigos dos registros do sistema base com registros de um sistema
integrado, representando uma nica entidade em sistemas diferentes. O quadro
abaixo mostra quais adapters realizam o de-para automtico e quais precisam de
interveno por parte dos consultores no status atual do projeto:
Adapter De-Para Carga inicial
Cliente/Fornecedor Automtico (Adapter) Manual (Adapter)
Moeda Automtico (Adapter) Manual (Adapter)
Produto Automtico (Adapter) Manual (Adapter)
Centro de Custo Automtico (Adapter) Manual (Adapter)
Ativos Automtico (Adapter) Manual (Adapter)
Funcionrios Automtico (Adapter) Manual (Adapter)
Projeto Automtico (Adapter) Manual (Consultor)
Obra Automtico (Adapter) Manual (Consultor)
Tarefa Automtico (Adapter) Manual (Consultor)
Etapa Automtico (Adapter) Manual (Consultor)
Condies de Automtico (Adapter)

pagamento
Coligada Manual (Configurador) Manual (Consultor)
Filial Manual (Configurador) Manual (Consultor)
Local de Estoque Manual Manual (Adapter)
Pgina 21 de 84
Integrao
d) Outras configuraes
A unidade de medida que representa hora no Protheus a unidade H. Essa

unidade ser integrada entre os ambientes. O mesmo vale para as unidades UN
(unidade) e KM (quilometragem). O ideal que essas informaes sejam apagadas
no ambiente do Protheus e sincronizadas a partir do RM para manter a integridade
fsica da base.
4.6. Utilizao de outros mdulos
O sistema Manuteno de Ativos do ERP Protheus se integra

operacionalmente com as funcionalidades de Backoffice de um outro ERP, no
sendo possvel ativar mdulos selecionados e mescl-los devido aos processos
distintos que compem a regra de negcio de cada sistema em particular. Por
exemplo, no projeto atual no possvel utilizar o SIGAMNT e SIGAEST/SIGACOM
(Estoque/Compras) do Protheus enquanto se utiliza o Ativo Fixo e Obras e Projetos
de outro ERP.
Essa regra, entretanto vale apenas para os mdulos que tem suas operaes
integradas, como o caso do Backoffice. Caso o cliente tenha a necessidade de
utilizao de um mdulo para gesto de transportes, como o caso do SIGATMS, o
mesmo integra suas funcionalidades com o SIGAMNT, mas no as integrar com o
Backoffice. Recomenda-se, entretanto, que seja feito uma anlise detalhada
conforme as necessidades de integrao.
Pgina 22 de 84
Integrao
5. CONFIGURAO DOS ADAPTERS
A configurao dos adapters no Protheus se d atravs da interface do

configurador, acessando o smartclient pelo programa inicial SIGACFG.
Atravs da rotina de Adapter EAI (em Ambiente / Schedule / Adapter EAI), j

possvel visualizar o adapter WHOIS, criado automaticamente pelo sistema. Os
demais adapters devem ser includos no sistema atravs dessa interface.
STOCKTURNOVER
Mensagem nica Sim
Rotina NGMUStoTuO
Mensagem StockTurnover
Descrio Baixa de Estoque
Envia Sim
Recebe Sim
Pgina 23 de 84
Integrao
Mtodo Sncrono
Operao Todas
Canal Envio EAI
Verso 1.002
CANCELREQUEST
Mensagem nica Sim
Rotina NGMUCanReq
Mensagem CancelRequest
Descrio Cancelamento de Requisio
Envia Sim
Recebe Sim
Mtodo Sncrono
Operao Todas
Canal Envio EAI
Verso 1.000
APPOINTMENTCOST
Mensagem nica Sim
Rotina NGMUAprCst
Mensagem AppointmentCost
Descrio Apropriao de Custo
Envia Sim
Recebe No
Mtodo Sncrono
Operao Todas
Canal Envio EAI
Verso 1.000
REQUEST
Mensagem nica Sim
Rotina NGMUReques
Mensagem Request
Descrio Solicitao
Envia Sim
Recebe Sim
Mtodo Sncrono
Operao Todas
Pgina 24 de 84
Integrao
Canal Envio EAI

Verso 1.000
ASSETSVALUATION
Mensagem nica Sim
Rotina NGMUAmpPat
Mensagem AssetsValuation
Descrio Ampliao Patrimonial
Envia Sim
Recebe No
Mtodo Sncrono
Operao Todas
Canal Envio EAI
Verso 1.000
STOCKLEVEL
Mensagem nica Sim
Rotina NGMUStoLvl
Mensagem StockLevel
Descrio Consulta de Saldo
Envia Sim
Recebe No
Mtodo Sncrono
Operao Todas
Canal Envio EAI
Verso 1.001
MAINTENANCEORDER
Mensagem nica Sim
Rotina NGMUMntOrd
Mensagem MaintenanceOrder
Descrio Ordem de Servio
Envia Sim
Recebe Sim
Mtodo Sncrono
Operao Todas
Canal Envio EAI
Verso 1.000
Pgina 25 de 84
Integrao
MAITENANCEREQUEST [no disponvel]

Mensagem nica Sim
Rotina NGMUMntReq
Mensagem MaintenanceRequest
Descrio Solicita
Envia No
Recebe Sim
Mtodo Sncrono
o de Servio
Operao Todas
Canal Envio EAI
Verso 1.000
CANCELREQUEST
Mensagem nica Sim
Rotina NGMUCanMnO
Mensagem CancelMaintenanceOrder
Descrio Cancelamento de OS
Envia Sim
Recebe No
Mtodo Sncrono
Operao Todas
Canal Envio EAI
Verso 1.000
ORDER
Mensagem nica Sim
Rotina NGMUOrder
Mensagem Order
Descrio Ordem
Envia Sim
Recebe Sim
Mtodo Sncrono
Operao Todas
Canal Envio EAI
Verso 3.002
Pgina 26 de 84
Integrao
INFOOFPARCELVALUES
Mensagem nica Sim
Rotina NGMUInfPar
Mensagem InfoOfParcelValues
Descrio Informaes de Parcelas
Envia No
Recebe Sim
Mtodo Sncrono
Operao Todas
Canal Envio EAI
Verso 1.000
Para o correto funcionamento do fluxo da integrao necessrio tambm a

incluso de adapters do Protheus, conforme documentao disponibilizada no link
abaixo:
http://tdn.totvs.com.br/download/attachments/45224822/BT+-
+Cadastro+das+Rotinas+dos+Adapters+Protheus.doc?version=1&modificationDate=1365606651000
Pgina 27 de 84
Integrao
6. DESCRIO DOS PROCESSOS/MENSAGENS
Nessa seo esto descritos detalhes a respeito da construo de cada

adapter projetado para a integrao. O mapeamento busca dar uma viso mais
ampla para os desenvolvedores e a descrio do processo busca facilitar os testes
integrados. Para desenvolver os diagramas foi utilizada a ferramenta astah
community 6.4.1 (model version: 34).
Logo abaixo esto representados os processos separados por mensagem, e
em seguida os processos integrados referentes a cada mdulo, com uma indicao
do sentido da mensagem (entrada/sada).
Pgina 28 de 84
Integrao
6.1. Baixa de Estoque
Mensagem: StockTurnover
Sentido: Protheus -> RM
Mapeamento:
Pgina 29 de 84
Integrao
A mensagem de baixa de estoque sentido Protheus -> RM gerada a partir

da gerao de movimentao de estoque no Protheus, tabela SD3. Como referncia
enviado o cdigo da Ordem de Servio gerada no Protheus.
Um ponto importante a ressaltar que no Protheus no existe um cabealho
da requisio. Toda a informao gravada na tabela SD3 e cada item recebe um
nmero sequencial (NUMSEQ). O nmero DOC at pode agrupar a requisio de
vrios itens, mas o MNT sempre gera requisies individuais, com DOC e SEQ
nicos. Somente pelo Estoque do Protheus possvel gerar vrios SEQs para um
mesmo DOC.
O InternalId dessa mensagem composto por:
cEmpAnt+|+SD3->D3_FILIAL+'|'+SD3->D3_DOC + | + STO
Ex:
99|12|123456789|STO
Testes pontuais:
Pgina 30 de 84
Integrao
- [NGMovEstoque] faz referncia s rotinas de Frota, no utilizado no MNT.

No est no escopo da integrao, mas j foi contemplado. Bastaria fazer um
abastecimento em posto interno, com tanque/bomba associado a um produto.
- [MntGeraD3] incluso de um insumo realizado na rotina de retorno de OS
(Atualizaes / Controle de Oficina / Retorno O.S.)
- [MntMovEst] faz referncia s rotinas de Frota, no utilizado no MNT. No
est no escopo da integrao, mas j foi contemplado. Bastaria fazer uma sada de
combustvel atravs da rotina de abastecimento em lote.
- [MNT400MovEst] Usa o campo TL_NUMSEQ2 e no est liberado no
padro. Em todo caso, foi implementado.
- [NGMovEst] Chamado na anlise tcnica e rotina de recebimento de pneus,
ou seja, faz referncia somente ao Frota, no ao MNT. Entretanto, tambm foi
implementado.
- [NGPnGeraD3] Chamado na solicitao e remessa de pneus. No est no
escopo da integrao, pois faz referncia ao Frota, mas tambm foi implementado.
Fontes relacionados:
- NGMUStoTuO
- MNTA400
- MNTUTIL
- MNTA690
- MNTA600
6.2. Baixa de Estoque (recebimento)
Mensagem: StockTurnover
Sentido: RM -> Protheus
Mapeamento:
Pgina 31 de 84
Integrao
A mensagem de baixa no sentido RM -> Protheus gerada a partir do RM,

atravs de processos internos, e enviada ao Protheus de modo informativo para que
possa realizar a incluso dos insumos na ordem de servio relacionada.
Ao receber a mensagem, o MNT carrega a lista de produto e identifica a
ordem de servio relacionada a OS do XML. Com base nessa informao so
reportados insumos realizados para a ordem de servio. O retorno a lista de IDs
de movimentao de estoque correspondentes no MNT.
Testes pontuais:
- O teste s pode ser realizado atravs de uma ferramenta de simulao ou
de forma integrada a um sistema que trabalhe nos moldes de mensagem nica.
- NGMUStoTuO
- MNTUTIL
6.3. Estorno de Baixa de Estoque
Mensagem: CancelRequest
Mapeamento:
Pgina 32 de 84
Integrao
A mensagem estorno de baixa de estoque no sentido Protheus -> RM

tambm gerada a partir da gerao de movimentao de estoque no Protheus,
tabela SD3. No sistema Manuteno de Ativos o funcionamento do estorno se d
pela gerao de uma movimentao de operao contrria baixa, ou seja, o
estorno uma operao complementar que neutraliza a baixa. J para a
integrao o estorno passa a ser uma requisio de cancelamento de baixa,
semelhante a uma operao de excluso de movimentao. Dessa forma foi
necessrio desenvolver a mensagem de estorno com o mesmo layout da mensagem
de cancelamento (CancelRequest) ao invs de usar o layout de movimentao de
estoque (StockTurnOver).
Os testes pontuais podem ser realizados, de forma geral, nos mesmos
lugares em que h a mensagem de baixa de estoque, mas normalmente utilizando-
se da operao contrria. Por exemplo: se a incluso de um insumo gera baixa de
estoque, a excluso desse insumo ou alterao de sua quantidade gera uma
mensagem de cancelamento e, posteriormente, uma nova baixa.
Pgina 33 de 84
Integrao
A mensagem de cancelamento pode ser aplicada a outros processos

tambm. O cancelamento de movimentao de estoque identificado por uma tag
<Type>, a qual tem o valor 002.
Testes pontuais:
- [NGMovEstoque] faz referncia s rotinas de Frota, no utilizado no MNT.
No est no escopo da integrao, mas j foi contemplado. Para verificar o
funcionamento basta alterar um abastecimento feito em posto interno (com
tanque/bomba associado a um produto).
- [MntGeraD3] alterao ou excluso de um insumo realizado na rotina de
retorno de OS (Atualizaes / Controle de Oficina / Retorno O.S.).
- [MntMovEst] faz referncia s rotinas de Frota, no utilizado no MNT. No
est no escopo da integrao. Verificar na rotina de abastecimento em lote a
alterao de uma movimentao SD3 deve gerar estorno, o que no ocorre.
Necessita verificao quando o Gesto de Frota for contemplado.
- [MNT400MovEst] usa o campo TL_NUMSEQ2 e no est liberado no
padro. Necessita verificao quando o Gesto de Frota for contemplado.
- [NGMovEst] chamado na anlise tcnica e rotina de recebimento de pneus,
ou seja, faz referncia somente ao Frota, no ao MNT. Entretanto, tambm foi
implementado.
- NGMUCanReq
- MNTUTIL
- MNTA400
- MNTA690
- MNTA600
6.4. Estorno de Baixa de Estoque (recebimento)
Mensagem: CancelRequest
Pgina 34 de 84
Integrao

Mapeamento:
A mensagem de estorno de baixa no sentido RM -> Protheus gerada a partir

do RM, atravs de processos internos, e enviada ao Protheus de modo informativo
para que possa realizar a excluso da movimentao relacionada aos insumos na
ordem de servio relacionada.
Ao receber a mensagem identificada pela tag 002, o MNT se encarrega de
excluir o insumo da OS e seu vnculo com demais tabelas do sistema, tal como o
movimento de estoque (SD3).
Testes pontuais:
- O teste s pode ser realizado atravs de uma ferramenta de simulao ou
de forma integrada a um sistema que trabalhe nos moldes de mensagem nica.
- NGMUCanReq
6.5. Solicitao de Compra
Mensagem: Request
Pgina 35 de 84
Integrao
Mapeamento:
A mensagem de solicitao de compras gerada atravs de uma funo

centralizadora NGAtuERP, conforme pode ser visto no mapeamento. Ela
responsvel por gerar um registro na tabela SC1 do Protheus e envi-lo atravs da
mensagem nica. Apesar de a solicitao ser gerada no Protheus, o registro
gerado apenas como referncia, para que as integridades do MNT se mantenham,
tal como pesquisa por NUMSEQ e associao de insumo x item da solicitao.
Uma premissa que o parmetro MV_NGGERSA esteja como N, indicando
que no ser gerada Solicitao ao Armazm, e sim de Compra.
cEmpAnt+'|'SC1->C1_FILIAL + '|' + SC1->C1_NUM + | + SC
Ex:
99|12|123456|SC
Testes pontuais:
Pgina 36 de 84
Integrao
- Incluso de insumos previstos na rotina de ordem de servio

manual/corretiva. Incluir insumo do tipo produto para uma OS liberada
[NGGERASC1]
- NGMUReques
- NGUTIL04
6.6. Solicitao ao Armazm
Mensagem: Request
Mapeamento:
A mensagem de solicitao ao armazm uma alternativa de solicitao de

compras. Tem o mesmo formato, mas o contedo de uma das tags identifica a
Pgina 37 de 84
Integrao
diferena. necessrio que o parmetro MV_NGGERSA esteja habilitado para que

sejam geradas solicitaes ao armazm.
cEmpAnt+'|'SCP->CP_FILIAL + '|' + SCP->CP_NUM + | + SA
Ex:
99|12|123456|SA
Testes pontuais:
- Incluso de insumos previstos na rotina de ordem de servio manual. Incluir
insumo do tipo produto para uma OS liberada [NGGERASA-NGINTCOMPEST]
- NGMUReques
- NGUTIL02
6.7. Cancelamento de Solicitao de Compra
Mensagem: Request
Mapeamento:
Cancelamento de solicitao de compras o processo que visa excluir a

solicitao da base de dados. Tal processo feito atravs da mensagem nica
solicitao, informado a operao de excluso.
Pgina 38 de 84
Integrao
Testes pontuais:
- Excluso de um insumo previsto do tipo produto na rotina de ordem de
servio manual, o qual tenha gerado solicitao de compra
[NGDELETAREG(SC1)]
- Excluso de um plano de manuteno que tenha Ordens de Servio
liberadas com insumos previstos do tipo produto e que tenham gerado solicitao de
compra [NGDELETAREG(SC1)]
- Finalizar uma ordem de servio que tenha insumo previsto que tenha gerado
solicitao de compra. Ao finalizar, alterar o cdigo do produto. A solicitao de
compra do insumo previsto (que no foi realizado) ser cancelada [NGFINAL]
- Configurar os parmetros MV_NGGERPR=S, MV_NGVEROS=V,
MV_NGOSAES=S e MV_NGIOSAU=S. Incluir manutenes para um bem com
diferentes incrementos (100, 200 e 300, por exemplo) e que j estejam atrasadas.
importante que na manuteno esteja cadastrado ao menos um insumo do tipo
produto para um produto que no tenha saldo em estoque. Utilizar tambm o campo
de substituio informando que a 3 substitui 2 e a 2 substitui a 1. Utilizar a rotina de
informa contador com uma diferena para que gere uma OS para a primeira
manuteno (de menor incremento). Ser gerada uma solicitao de compras.
Informar contador para que gere OS para a segunda manuteno. A OS ir
substituir a OS gerada anteriormente e cancelar a solicitao de compras. Repetir o
processo para a terceira manuteno.
- NGMUCanReq
- NGUTIL02
- NGUTIL04
- MNTA330
6.8. Cancelamento de Solicitao ao Armazm
Mensagem: Request
Pgina 39 de 84
Integrao

Mapeamento:
Cancelamento de solicitao de armazm o processo que visa excluir a

solicitao da base de dados. Tal processo feito atravs da mensagem nica de
solicitao, informando a opo de excluir. Para utilizar esse processo necessrio
ter o parmetro MV_NGGERSA configurado como S.
Testes pontuais:
- Alterao de um insumo previsto do tipo produto na rotina de ordem de
servio corretiva, o qual tenha gerado uma solicitao de compra
[NGDELETAREG(SCP)]
- MNTA420
- NGUTIL02
- MNTA265
- MNTA330
6.9. Ampliao Patrimonial
Mensagem: AssetsValuation
Mapeamento:
Pgina 40 de 84
Integrao
Ampliao patrimonial trata-se de uma rotina, executada via menu, atravs da

qual possvel selecionar Ordens de Servio e ampliar seu custo no mdulo de
Ativo Fixo, tratando-se do Backoffice Protheus. O mesmo funcionamento se espera
para o Backoffice de outro produto que esteja integrado atravs da utilizao de
mensagem nica. A mensagem consiste em enviar basicamente o ativo e o valor
que ampliado (custo da OS).
O processo no MNT consiste em gravar as tabelas do mdulo Ativo Fixo
(SN(?)) e basear-se no registro gerado na tabela de movimentaes do Ativo Fixo
(SN4) para gerar a mensagem. Essa tabela contm os campos necessrios, tal
como ID de movimentao, cdigo do ativo e do servio.
A forma de clculo utilizada no MNT valor nominal multiplicado pela
quantidade, sendo a quantidade 1. O custo da OS j representa o valor nominal,
visto que o rateio de insumos e custo feito antes da finalizao, caso haja.
Testes pontuais:
- valores ATF (Miscelnea / Atualizao / Valores ATF) [MNTA860]
- NGMUAmpPat
- MNTA860
Pgina 41 de 84
Integrao
6.10. Apropriao de Custo
Mensagem: AppointmentCost
Mapeamento:
A mensagem de apropriao de custo abrange duas abordagens: uma sobre

ordens de servio e outra em relao ao indicador de uso (contador) do
equipamento. Devido complexidade no processo de elaborao dessas
mensagens, as mesmas foram conceituadas em um documento anexo, o qual est
sendo referenciado no anexo Funcionalidade de apropriao de custos no MNT no
final deste documento.
Resumidamente, o funcionamento se d atravs de duas rotinas:
- Indicador de custo (MNTA370): uma rotina em que se configura o
indicador de uso de cada equipamento (contador 1 ou 2) a um custo, seja ele
associado a um produto, ao prprio cadastro do equipamento ou a um valor manual.
Nesta rotina pode se escolher o bem e seu contador 1 ou 2 para associar a
um produto e a uma classificao de preo entre as opes: manual, custo hora,
custo standard e custo mdio.
Pgina 42 de 84
Integrao
- Apropriao (MNTA385): permite que se selecione entre ordens de servio

ou contador (1 ou 2) para enviar o custo ao Backoffice via mensagem nica. A rotina
tambm solicita um projeto e tarefa para enviar junto ao custo.

STJ+cEmpAnt+'|'+'|'+STJ->TJ_FILIAL+'|'+STJ->TJ_ORDEM+'|'+STJ-
>TJ_PLANO
Ex: STJ|99|12|123456|123456
STP+cEmpAnt+'|'+'|'+STP->TP_FILIAL+'|'+STP->TP_ORDEM+'|'+STP-
>TP_PLANO+'|'+STP->TP_CODBEM+'|'+DTOS(STP->TP_DTORIGI)
Ex: STP|99|12|123456|123456|1234567890123456|20120101
Pgina 43 de 84
Integrao
TPP+cEmpAnt+'|'+'|'+TPP->TPP_FILIAL+'|'+TPP-
>TPP_ORDEM+'|'+TPP->TPP_PLANO+'|'+TPP-
>TPP_CODBEM+'|'+DTOS(TPP->TPP_DTORIG)
Ex: TPP|99|12|123456|123456|1234567890123456|20120101
Testes pontuais:
- apropriar uma ordem de servio finalizada e faturada atravs da rotina de
apropriao. Logo em seguida tentar a reabertura desta ordem de servio, o que
no permitido (Atualizaes / Controle de Oficina / Retorno OS / Reabertura OS).
- a aplicao direta de insumos atravs da mensagem nica de
movimentao de estoque tambm no permitida.
- cadastrar um indicador de uso de cada tipo para os contadores 1 e 2 de um
determinado veculo.
- apropriar registros de contador 1 e 2.
- alterar um registro de abastecimento que esteja associado a um contador
que j tenha sido apropriado (Atualizaes / Controle de Combustveis /
Abastecimento / Abast. Manual). A rotina no deve permitir.
- tentar a reabertura de uma OS que j tenha sido apropriada ou cujo
contador j tenha sido apropriado (Atualizaes / Controle de Oficina / Retorno OS /
Reabertura OS). O sistema no deve permitir.
- tentar a alterao/excluso de um contador pela rotina de acerto
(Atualizaes / Controle de Oficina / Contador / Acerto) para um contador que j
tenha sido apropriado. O sistema no ir permitir. O sistema tambm no permite
alterar ou excluir um contador que seja anterior a algum registro cujo custo foi
apropriado.
- tentar incluir/excluir um registro de reporte de produo para data/hora
anterior a um registro de contador j apropriado (Atualizaes / Controle de Oficina /
Contador / Retorno Produo). O sistema no permite.
- incluir um novo registro de contador (o que pode ser feito na rotina em
Atualizaes / Controle de Oficina / Contador / Informa). Se o registro imediatamente
posterior estiver apropriado, o novo tambm ser marcado como apropriado. Caso
contrrio ser marcado como no apropriado.
Pgina 44 de 84
Integrao
- utilizar a rotina de histrico de OS para jogar as ordens de servio mais

antigas em histrico.
- NGMUAprCst
- MNTA880
- MNTA245*
- MNTA480*
- NGMNT00
- NGUTIL03*
- MNTA655
- MNTA875
- NGUTIL04
- MNTA380
- MNTA370
- MNTA385
- MNTA998
- MNTA550
*adaptaes no liberadas
6.11. Consulta de Saldo
Mensagem: StockLevel
Mapeamento:
Pgina 45 de 84
Integrao
A mensagem de consulta de saldo teoricamente de responsabilidade

do mdulo de Estoque, e deveria ser ativada via chamada de funo a partir do
mdulo MNT. Porm, em decorrncia dessa integrao foi tomada uma soluo
alternativa, visando o menor impacto no sistema e maior agilidade no processo.
Soluo Ideal: a soluo ideal seria a alterao da funo SaldoSB2

do estoque, chamada a partir do MNT e de outros mdulos, de forma a fazer a
consulta de forma online utilizando mensagem nica.
Soluo Adotada (pendente de adequao futura): a soluo
encontrada, entretanto, consiste em manter o processo do Protheus de consultar o
saldo na tabela SB2. Para isso, a rotina de integrao, sempre que feita uma
consulta de saldo atravs da funo NGSALSB2, atualiza os valores da tabela SB2
com os valores de B2_QEMPN como a quantidade empenhada e B2_QATU para o
saldo atual. Processos que se baseiam nessas tabelas podem continuar a ser
executados sem alteraes at que o Estoque desenvolva uma tratativa para essa
rotina, quando tal atualizao feita no MNT pode ser anulada e substituda.
Pgina 46 de 84
Integrao
Testes pontuais:
- incluso de um insumo em uma ordem de servio (Atualizaes / Controle
de Oficina / Retorno O.S.) [NGSALSB2 NGUTIL03]
- incluso de um insumo do tipo produto para uma OS atravs da rotina de
retorno simplificado. Para visualizar a mensagem informar quantidade maior do que
o saldo em estoque [MNTA415]
- na rotina de retorno OS modelo 2, selecionar uma OS e transferir insumos
do tipo produto do lado de previsto para realizado. No caso de no haver saldo em
estoque uma mensagem informar [MNTA435]
- na rotina de programao de OS em Atualizaes / Controle de Oficina /
Plano de Manuteno, informar os parmetros e selecionar ordens de servio. A
rotina carrega o estoque dos produtos utilizados como insumo [MNTA990]
- na rotina de consulta de OS em Consultas / Controle de Oficina / Planos /
Consulta de OS, selecionar uma OS aberta com insumo previsto do tipo produto e
com quantidade realizada inferior para esse mesmo insumo. O grid de
disponibilidade ser montado considerando o saldo disponvel, porm a informao
no visvel em tela [MNTC755]
- parmetro MV_NGGERSA = N e MV_NGMNTCP = S para esse teste
especfico. Incluir uma ordem de servio corretiva liberada com insumo previsto do
tipo produto. A rotina ir consultar o saldo em estoque antes de abrir uma solicitao
de compras[NGUTIL01]
- parmetro MV_NGGERSA = N e MV_NGMNTCP = N para esse teste.
Incluir uma ordem de servio corretiva liberada com insumo previsto do tipo produto
[NGUTIL02]
*O teste fica pendente para testes integrados, visto necessidade de retorno.
- NGMUStoLvl
- MNTA415
- MNTA435
- MNTC755
Pgina 47 de 84
Integrao
- MNTA990
- NGUTIL01
- NGUTIL02
- NGUTIL03
6.12. Ordem de Servio
Mensagem: MaintenanceOrder
Sentido: Protheus -> RM / RM -> Protheus
Mapeamento:
A mensagem de ordem de servio tem sua maior ocorrncia no fluxo

Protheus -> RM, mas tambm enviada no sentido oposto. O processo para
integrao de ordens de servio tem destaque nos seguintes pontos:
- na liberao de uma ordem de servio do MNT ser enviada a mensagem
de OS para o Backoffice. A ordem de servio ser enviada sem insumos, pois no
Pgina 48 de 84
Integrao
MNT os mesmos tratam-se de previstos. O status nesse momento em

andamento.
- ao finalizar a OS no MNT enviada a mensagem ao Backoffice. Nesse
momento sero enviados os insumos e as informaes atualizadas. O status poderia
ser finalizada, mas para o Backoffice ser tratado como a faturar.
- na reabertura de uma OS no MNT enviada uma mensagem de
incluso/atualizao de OS, assim como na liberao, com o status em
andamento.
- o cancelamento ser tratado em uma mensagem parte, enviando uma
requisio de cancelamento de OS (NGMUCanMnO).
Ser desenvolvida tambm uma nova mensagem no sentido RM -> Protheus.
Essa mensagem serve para atualizar a OS no MNT, indicando que a mesma j foi
faturada. Para isso h um campo novo (TJ_FATURA). Ordens de servio j
faturadas no Backoffice no podero ser reabertas no MNT.
cEmpAnt+|+STJ->TJ_FILIAL + '|' + STJ->TJ_ORDEM + | + OS
Ex:
99|12|123456|OS
Testes pontuais:
Abertura/liberao:
- abertura de uma OS preventiva com situao liberada atravs da rotina de
OS manual [MNTA410]
- abertura e alterao de uma ordem de servio corretiva, liberada, pela rotina
de OS corretiva [MNTA420]
- incluso de um plano de manuteno e confirmao de algumas das ordens
de servio geradas. No momento da confirmao as OSs so liberadas [MNTA340]
- gerao de ordens de servio atravs da rotina de distribuio de solicitao
de servio [MNTA295]
Pgina 49 de 84
Integrao
- configurar o parmetro MV_NGCOPOS com o valor 2. Incluir uma ordem

de servio corretiva e na tela de cpia, informar ao menos uma cpia
[NGGERAOSTJ (NGUTIL03) em NGCOPIAOS]
- no controle de portaria tambm foi implementado, mas no faz parte do
escopo, pois Frota. O teste s pode ser realizado em um ambiente com mais de
uma empresa/filial, sendo que o veculo tenha uma OS preventiva em outra filial e a
OS seja transferida para a filial onde se encontra [M985GERAOS (MNTA985)]
- retorno de ordem de servio com etapas que tenham opo de resposta e
gerao de OS automtica. A rotina permite a gerao de OS liberadas
considerando o parmetro MV_NGGEROS[NGGERAOS em MNTA400]
- importao BANDAG gera uma ordem de servio liberada e terminada, no
foi implementado, pois se trata apenas de Frota [MNTA245]
- incluir uma OS pendente atravs da rotina de OS Corretiva, por exemplo.
Em Controle de Oficina / Status da OS / Alterar Status OS, colocar a OS em
execuo e na rotina Confirm. OS Execuo, selecionar a OS e confirmar sua
execuo [MNTA275]
- realizar o retorno em lote para um bem, uma ordem de servio ser gravada
no sistema [MNTA401]
- em Controle de Oficina / Ordem de Servio / Histrico, incluir uma nova OS
de histrico [MNTA430]
- na liberao de ordens de servio pendentes na rotina em Atualizaes /
Controle de Oficina / Plano Manuteno / Liberao de OS, selecionar uma ordem
de servio pendente e liber-la [MNTA490]
Finalizao:
- importao BANDAG gera uma ordem de servio liberada e terminada, no
foi implementado, pois se trata apenas de Frota [MNTA245]
- finalizar uma ordem de servio (sem insumo realizado) pelo retorno de OS
[MNTA400]
- retorno de uma OS por etapas (Atualizaes / Retorno OS / Por Etapas)
[MNTA480]
Pgina 50 de 84
Integrao
- finalizar uma ordem de servio (que j tenha insumo realizado) pelo retorno
[NGFINAL]
Reabertura:
- selecionar uma ordem de servio finalizada e no faturada para reabertura.
Sero enviadas duas mensagens: uma solicitando a excluso e outra a incluso de
uma nova OS com as mesmas caractersticas [MNTA880]
Cancelamento:
- incluir uma manuteno de perodo nico e um servio que permita
acompanhamento por follow-up. Na rotina de Ordem de servio manual incluir duas
OSs para essa manuteno, e em seguida na rotina de retorno finalizar uma delas.
Na tela de confirmao de OS em execuo (no menu Controle de Oficina / Status
da OS) selecionar a OS restante e confirmar a liberao. A OS ser cancelada
[MNTA275]
- para um plano de manuteno gerado com OSs no liberadas, selecionar a
opo finalizar. O plano ser finalizado e as ordens canceladas[MNTA330]
- para uma manuteno do tipo nica, gerar um plano de manuteno.
Posteriormente, incluir uma ordem de servio manual para o mesmo bem e liberar.
Na confirmao do plano, ao confirmar a OS gerada pelo plano a mesma ser
cancelada, pois o sistema encontrou a OS manual para a manuteno
nica[MNTA340]
- cancelar uma ordem de servio de lubrificao [MNTA360]
- cancelar uma ordem de servio na rotina de retorno de OS [MNTA400]
- cancelar uma ordem de servio de reforma [MNTA450]
- cancelar uma ordem de servio atravs da tela de planejamento*
[MNTA990]
- cancelar uma ordem de servio pela rotina de OS Corretiva [NGDELETOS]
Faturamento:
- mensagem enviada no sentido RM -> Protheus. A simulao pode ser feita
atravs de teste integrado ou usando uma ferramenta de simulao. Como resultado
Pgina 51 de 84
Integrao
a Ordem de Servio enviada deve alterar seu campo TJ_FATURA para 1 indicando
que a mesma foi faturada. Isso, desde que a mesma esteja finalizada, visto que a
condio necessria para que seja enviada para faturamento. A partir de ento no
deve ser possvel reabrir essa OS.
A mensagem de ordem de servio, por ser sncrona, trata o retorno:

- sendo negativo indica a impossibilidade de incluir uma OS no Backoffice.
Nesse caso a OS aberta automaticamente cancelada e o erro do Backoffice
apresentado ao usurio.
- sendo positivo, recebe o nmero da ordem gravada no Backoffice e grava
na tabela de/para do Protheus.
- NGMUMntOrd
- MNTA245
- MNTA275
- MNTA295
- MNTA330
- MNTA340
- MNTA360
- MNTA400
- MNTA401
- MNTA410
- MNTA420
- MNTA430
- MNTA450
- MNTA480
- MNTA490
- MNTA880
- MNTA985
- MNTA990
- NGUTIL02
Pgina 52 de 84
Integrao
- NGUTIL03
- NGGERAOS
6.13. Atualizao de Custo
Mensagem: StockLevel
Mapeamento: MNTA386
O processo de atualizao de custos tem por finalidade permitir que os custos

das ordens de servio do MNT sejam atualizados corretamente conforme os valores
dos itens de estoque no Backoffice. Essa funcionalidade visa atender o processo de
reclculo de custo mdio, que impacta diretamente nos custos dos insumos
utilizados em ordens de servio. O processo se d atravs da rotina MNTA386, a
qual lista as ordens de servio que foram faturadas pelo Backoffice porm ainda no
apropriadas. Atravs da opo atualizao de custos possvel selecionar ordens
de servio para que tenham seus custos atualizados.
Pgina 53 de 84
Integrao
6.14. Solicitao de Servio [no disponvel]
Mensagem: MaintenanceRequest
Mapeamento:
A mensagem de solicitao de servio enviada a partir do Backoffice do RM

quando integrado ao TOP. O MNT est preparado para receber esta mensagem e
incluir uma nova solicitao no Protheus. Inicialmente o fluxo dessa mensagem
apenas RM -> Protheus. A SS includa no MNT com o status aguardando
anlise, independente do status recebido na mensagem, visto que para que
controlar os outros status, outras informaes so necessrias.
Na mensagem so trafegados os campos projeto e tarefa, que sero
armazenados na tabela de solicitaes de servio do MNT apenas como informativo.
Essa informao ser repassada s Ordens de Servio geradas a partir da SS.
Para a mensagem de solicitao de servio, no caso de ocorrer algum erro

durante a incluso no MNT, est preparada para retornar o erro ao sistema que
solicitou a incluso atravs do uso de mensagem nica sncrona.
Pgina 54 de 84
Integrao
Testes pontuais:
- o teste s pode ser executado de forma integrada, pelo recebimento de uma
mensagem de incluso de solicitao de servio no sentido RM ->Protheus, ou
atravs de uma simulao com a ferramenta FSEnvEAI.
- a distribuio e abertura de OS a partir da SS deve replicar o cdigo de
projeto e tarefa da SS.
- NGMUMntReq*
- MNTA280
- MNTA295
6.15. Pedido de Compra
Mensagem: Order
A mensagem de pedido de compra gerada nos processos de gerao de

pedido de compra e tambm em substituio ao processo de gerao de ttulos a
pagar, por permitir uma maior abertura ao processo do Backoffice. A mensagem
gerada em dois momentos: um atravs das funcionalidades de conciliao manual
de NFs de abastecimentos externos (baseado na tabela SC7 pedidos de compra)
e outro atravs da gerao de ttulos pagar, sejam eles atravs de multas,
documentos ou honorrios (baseado na tabela SE2 contas a pagar).
Uma diferena significativa na utilizao dessas mensagens que no
processo de pedido de compra a mensagem utiliza a tag <PaymentTermCode> para
informar uma condio de pagamento integrada. J no processo de gerao de
ttulos a pagar a mensagem no se utiliza dessa tag e j envia todas as informaes
de parcelamento definidas na tag <PaymentPlan>.
cEmpAnt+'|'+SC7->C7_FILIAL + '|' + SC7->C7_NUM +'|'+'PC' ou
cEmpAnt+'|'+SE2->E2_FILIAL + '|' + SE2->E2_NUM +'|'+'PP'
Pgina 55 de 84
Integrao
6.16. Processos especficos do Frotas
a. Anlise Tcnica de Pneus
Pneus cadastrados no MNT podem estar associados a produtos do mdulo

de Estoque. O processo de anlise tcnica permite a alterao de status dos pneus
e dessa forma tambm o estoque a eles relacionados. Dessa forma, o processo se
utiliza da mensagem de movimentao de estoque e envia tanto a baixa quando
acrscimo ao Backoffice pela mensagem StockTurnover.
b. Transferncia de Pneus
O processo de transferncia de pneus consiste na transferncia fsica de

pneus entre filiais. Considerando a possibilidade de um pneu estar diretamente
associado a um produto de estoque, o processo tambm atualiza o saldo dos
produtos relacionados.
Para iniciar o processo, uma filial precisa gerar uma solicitao ao armazm
de um produto (que esteja relacionado a um pneu) e informar algumas
caractersticas como medida, sulco e tipo de modelo do pneu. Em seguida, outra
filial atende essa solicitao gerando uma remessa de pneus. Os pneus da remessa
devem atender aos parmetros informados na solicitao e devem tambm estar
associados ao produto requisitado e com status que indique sua disponibilidade no
estoque. Ento, a filial requisitante realiza o recebimento dos pneus.
O processo automaticamente realiza a baixa de estoque na filial que gera a
remessa e seu acrscimo na filial requisitante, quando feito o recebimento, atravs
da mensagem StockTurnover.
c. Abastecimento Manual (posto interno)
Para o correto funcionamento do processo conforme indicado nesse item, o

parmetro MV_ESTHOME deve estar configurado como S, o que indica que a
Pgina 56 de 84
Integrao
baixa de estoque se dar no momento do abastecimento. Caso seu contedo seja

C a baixa ser realizada no processo de conciliao.
O processo de abastecimento manual para posto interno consiste em realizar
um abastecimento com um combustvel que esteja relacionado a um local de
estoque da empresa, dessa forma a incluso do abastecimento remete na consulta
de saldo e na baixa de estoque (StockLevel e StockTurnover). Operaes de
alterao e excluso do registro de abastecimento envolvem tambm o
cancelamento da movimentao de baixa, o que se d pela mensagem
CancelRequest.
d. Abastecimento em Lote
O abastecimento em lote uma variao do abastecimento manual. A rotina

de abastecimento em lote permite a realizao de um lote de abastecimentos para
os veculos da frota da empresa com combustveis utilizados em postos internos e
relacionados a produtos integrados ao Backoffice. A rotina tambm permite a
incluso de sadas de combustvel do tanque.
O processo semelhante ao de abastecimento manual, havendo consulta de
saldo (StockLevel) e baixa de estoque para o combustvel (StockTurnOver). Da
mesma forma operaes de alterao e excluso envolvem o cancelamento da
baixa (CancelRequest).
e. Conciliao de Abastecimentos
Conciliao de posto interno
O processo considera o parmetro MV_ESTHOME configurado como C, o

que indica que a baixa de estoque se dar no momento da conciliao e no no
abastecimento. Assim como no abastecimento manual de posto interno, ao realizar
a conciliao de um abastecimento cadastrado, realizada a baixa de estoque
(StockTurnOver) do produto associado ao combustvel utilizado.
Pgina 57 de 84
Integrao
Conciliao manual
A conciliao manual realizada para abastecimentos de postos externos,

conveniados ou no conveniados. Atravs da rotina de conciliao manual
possvel selecionar um conjunto de abastecimentos realizados em um posto
(fornecedor) para conciliao. Quando realizado esse processo gerado um pedido
de compra (mensagem Order) para um produto relacionado na conciliao e
enviado ao Backoffice.
Conciliao automtica
A conciliao automtica realiza o mesmo processo da conciliao manual. A

diferena na origem dos abastecimentos que, ao invs de serem gerados atravs
da rotina de abastecimentos, so gerados de maneira automtica via rotina de
importao utilizada pelos convnios.
f. OS de Pneus
O processo de OS de pneus consiste na gerao de um lote de pneus, os

quais so enviados para realizao de servios de conserto e reforma em um
terceiro. Aps a realizao do servio a OS em lote pode ser recebida e o MNT
atualizado.
Alguns parmetros influenciam de maneira direta o processo: MV_NGSECON
e MV_NGSEREF definem, respectivamente, quais os servios de conserto e
reforma cadastrados no MNT; MV_NGGERSA indica a utilizao de SA ao invs de
SC; e MV_NGOSNFE indica se consiste a integrao do documento de entrada no
recebimento de OS em lote pela NF.
O primeiro ponto do processo incluir uma OS de pneus para os pneus que
estejam aguardando reforma/conserto. Para cada pneu gerada uma OS e para
cada OS gerada uma SA ou SC para realizao de servio de terceiros. Quando
h o controle por NF necessrio que o Backoffice realize a aplicao do insumo na
OS, atendendo a SA/SC gerada no caso em que no h esse controle, no h
Pgina 58 de 84
Integrao
essa dependncia. Em seguida pode ser realizado o recebimento da OS em lote,

indicando a realizao ou no do servio para cada pneu, havendo a finalizao ou
cancelamento da OS associada.
g. Multas
Atravs da incluso de um registro de multa ou notificao (a partir da qual se

gera uma multa) so definidas, no folder pagamento, as parcelas a serem
integradas com o mdulo financeiro. Cada parcela gerada para o ttulo corresponde
a um registro na tabela SE2 no MNT, porm para a integrao enviado apenas
uma mensagem do tipo pedido de pagamento atravs do modelo de mensagem
Order, detalhando as informaes das parcelas a serem geradas. No Backoffice as
parcelas seguem o fluxo normal de pagamento.
Quando, atravs do Backoffice, se realiza uma baixa parcial ou total de uma
parcela, automaticamente o Protheus atualizado e consequentemente o cadastro
da multa que gerou essa parcela. Tal integrao se d atravs da mensagem
InfoOfParcelValues. Ao realizar a baixa total de todas as parcelas, a multa
marcada como paga.
Para utilizao dessa funcionalidade deve ser configurado o parmetro
MV_PRODTRX que indica um item de estoque do Backoffice a ser integrado como
multa.
h. Documentos
A integrao de documentos dos veculos atravs do SIGAMNT se d atravs

das rotinas de documentos obrigatrios e gerao de documentos a vencer. O
processo padro permite o cadastro de documentos padro que podem ser
utilizados para um processo mais rpido em substituio ao cadastramento manual.
Da mesma forma a rotina de gerao de documentos a vencer permite a gerao de
documentos de uma forma simplificada.
Ao cadastrar um documento qualquer, as informaes de pagamento e
parcelamento so integradas com o mdulo financeiro. Cada parcela gerada para o
Pgina 59 de 84
Integrao
ttulo corresponde a um registro na tabela SE2 no MNT e, da mesma forma que se

d a integrao de multas, enviada apenas uma mensagem do tipo pedido de
pagamento atravs do modelo de mensagem Order, detalhando as informaes das
parcelas a serem geradas. No Backoffice as parcelas seguem o fluxo normal de
pagamento.
da documentos que gerou essa parcela. Tal integrao se d atravs da mensagem
InfoOfParcelValues.
MV_PRODTS2 que indica um item de estoque do Backoffice a ser integrado como
documento.
i. Honorrios Despachante
A gerao de honorrios para servios realizados por despachantes

realizada no MNT a partir da gerao e pagamento de documentos dos veculos
com base em cadastros de servios, documentos e fornecedores no sistema.
O cadastro de servios por despachante permite incluir um cdigo de servio
e relacionar a ele documentos (taxas) que sero pagas pelo despachante, indicando
tambm se os honorrios correspondem ao incio do processo de pagamento ou
apenas quando todas as parcelas estiverem pagas. necessrio tambm realizar o
cadastro de servios por fornecedor, relacionando os servios cadastrados
anteriormente a um fornecedor e o valor para realizao desse servio em relao
ao ano de pagamento.
A partir do momento em que se cadastra e se realiza o pagamento dos
documentos relacionados ao servio, a rotina de honorrios despachante permite a
gerao de honorrios referentes execuo do servio de pagamento. As
informaes de parcelamento dos honorrios so integradas com o mdulo
financeiro. Cada parcela gerada corresponde a um registro na tabela SE2 no MNT e,
da mesma forma que se d a integrao de multas e de documentos, enviada
apenas uma mensagem do tipo pedido de pagamento atravs do modelo de
Pgina 60 de 84
Integrao
mensagem Order, detalhando as informaes das parcelas a serem geradas. No

Backoffice as parcelas seguem o fluxo normal de pagamento.
da honorrios que gerou essa parcela. Tal integrao se d atravs da mensagem
InfoOfParcelValues.
MV_PRODTS8 que indica um item de estoque do Backoffice a ser integrado como
honorrios.
Pgina 61 de 84
Integrao
7. COMPOSIO DAS MENSAGENS
7.1. StockTurnover
Mensagem nica MNT

Elemento Descrio Tabela Coluna Observao
BusinessContent
Utilizado para selecionar o Tipo de Movimento.
Type Tipo da Movimentao Fixo "000 Baixa de Estoque
cEmpAnt |
D3_FILIAL |
D3_DOC |
InternalId InternalId da Movimentao SD3 STO
Code Id da Movimentao SD3 D3_DOC
Number Numero da Movimentao SD3 D3_DOC
CompanyId Empresa cEmpAnt
BranchId Filial cFilAnt
CEmpAnt |
CompanyInternalId Empresa e Filial cFilAnt
Series Srie
D3_EMISSAO +
RegisterDateTime Data de Emisso SD3 0:00:00
TL_DTINICI + Utiliza informao da OS quando h OS
DeliveryDateTime Data de Entrega STL Time() relacionada.
AbatementDateTime Data de Abatimento
ProjectInternalId ID do Projeto
MainOrderCode Codigo da Ordem (OS) SD3 D3_ORDEM No obrigatrio.
cEmpAnt |
TJ_FILIAL |
STJ / D3_ORDEM |
MainOrderInternalId InternalId da Ordem (OS) SD3 OS No obrigatrio.
Observation Observao
ListOfStockTurnoverItem . StockTurnoverItem
cEmpAnt |
D3_FILIAL |
D3_NUMSEQ |
D3_CHAVE |
InternalId InternalID SD3 D3_COD
Code Id do Item
D3_COD composto conforme regras e
parametrizaes de integrao: Produto = cdigo
do produto; Terceiro = MV_PRODTER; Ferramenta
IntProExt() -> = MV_PRODFER, Mao-de-Obra = MOD+T1_CCUSTO
B1_FILIAL | (caso haja de-para para produto definido para MDO
ItemInternalId Produto SB1 / SD3 *D3_COD ele substitudo).
ItemReferenceCode Codigo de Ref. do Produto
ItemReserveInternalId Cdigo da reserva
D3_CUSTO1 / Preo unitrio composto pela diviso do custo
UnitPrice Preo Unitrio SD3 D3_QUANT pela quantidade.
TotalPrice Valor total do item SD3 D3_CUSTO1
Pgina 62 de 84
Integrao
TL_DTINICI +
TL_HOINICI +
DeliveryDateTime Data de Entrega STL :00
Quantity Quantidade SD3 D3_QUANT
IntUndExt() ->
SAH / AH_FILIAL |
UnitofMeasureInternalId Unidade de Medida SD3 D3_UM
IntLocExt() ->
NNR / NNR_FILIAL |
WarehouseInternalId Local de Estoque SD3 D3_LOCAL
IntCusExt() ->
CostCenterInternalId Centro de Custo SD3 D3_CC
AccountantAcountIntern
alId Conta Contbil
MainOrderCode Codigo da Ordem (OS) SD3 D3_ORDEM
cEmpAnt |
TJ_FILIAL |
D3_ORDEM |
MainOrderInternalId InternalId da Ordem (OS) STJ / SD3 OS
TaskInternalId ID da Tarefa
ListOfApportionStockTurnover.ApportionStockTurnover no enviado pelo MNT
7.2. Request
a) Solicitao de Compra
Mensagem nica MNT
BusinessContent
Type Tipo da requisio 000 para Solicitao de Compra
C1_FILIAL |
C1_NUM |
InternalId InternalId da Solicitao SC1 SC
Code Id da Solicitao SC1 C1_NUM
Number Numero da Solicitao SC1 C1_NUM
CEmpAnt |
Series Srie
UserRequesterCode Cdigo do Usurio Solicitante SC1 C1_SOLICIT
Composto por: empresa + | + cdigo (6
UserRequesterInternalId IntenalID do Usurio Solicitante caracteres) + | + nome do usurio
C1_EMISSAO +
RegisterDateTime Data de Emisso SC1 00:00:00
DeliveryDateTime Data de Entrega
Pgina 63 de 84
Integrao
IntConExt() ->
PaymentConditionIntern E4_FILIAL |
alId Condio de Pagamento SE4 / SC1 C1_CONDPAG
O cdigo da OP usado para extrair e enviar o
MainOrderCode Codigo da Ordem (OS) SC1 C1_OP nmero da OS.
cEmpAnt |
TJ_FILIAL |
STJ / *C1_OP | O cdigo da OP usado para extrair e enviar o
MainOrderInternalId Codigo da Ordem (OS) SC1 OS nmero da OS.
Observation Observao SC1 C1_OBS

ListOfRequestItem .RequestItem
cEmpAnt |
C1_FILIAL |
C1_NUM |
C1_ITEM |
InternalId InternalID SC1 C1_ITEMGRD
Code Id do Item SC1 C1_ITEM
IntProExt() ->
SB1 / B1_FILIAL |
ItemInternalId Produto SC1 C1_PRODUTO
UnitPrice Preo Unitario SC1 C1_PRECO
TotalPrice Valor total do item SC1 C1_TOTAL
C1_DATPRF +
DeliveryDateTime Data de Entrega SC1 hora atual
Quantity Quantidade SC1 C1_QUANT
IntUndExt() ->
SAH / AH_FILIAL |
UnitofMeasureInternalId Unidade de Medida SC1 C1_UM
IntLocExt() ->
NNR / NNR_FILIAL |
WarehouseInternalId Local de Estoque SC1 C1_LOCAL
IntCusExt() ->
CTT / CTT_FILIAL |
CostCenterInternalId Centro de Custo SC1 C1_CC
alId Conta Contbil
MainOrderCode Codigo da Ordem (OS) SC1 *C1_OP nmero da OS.
cEmpAnt |
TJ_FILIAL |
STJ / *C1_OP | O cdigo da OP usado para extrair e enviar o
MainOrderInternalId Codigo da Ordem (OS) SC1 OS nmero da OS.
C1_OBS
ListOfApportionRequest.ApportionRequest no enviado pelo MNT
Pgina 64 de 84
Integrao
b) Solicitao ao Armazm
Mensagem nica MNT
BusinessContent
Type Tipo da requisio 001 para Solicitao ao Armazm
cEmpAnt |
CP_FILIAL |
CP_NUM |
InternalId InternalId da Solicitao SCP SA
Code Id da Solicitao SCP CP_NUM
Number Numero da Solicitao SCP CP_NUM
CEmpAnt |
Series Srie
UserRequesterCode Cdigo do Usurio Solicitante SCP CP_SOLICIT
Composto por: cdigo (6 caracteres) + | + nome
UserRequesterInternalId IntenalID do Usurio Solicitante do usurio
CP_EMISSAO +
RegisterDateTime Data de Emisso SCP 00:00:00
DeliveryDateTime Data de Entrega
PaymentConditionIntern
alId Condio de Pagamento
MainOrderCode Codigo da Ordem (OS) SCP CP_OP nmero da OS.
cEmpAnt |
TJ_FILIAL |
STJ / *CP_OP | O cdigo da OP usado para extrair e enviar o
MainOrderInternalId Codigo da Ordem (OS) SCP OS nmero da OS.
Observation Observao SCP CP_OBS

ListOfRequestItem .RequestItem
cEmpAnt |
CP_FILIAL |
CP_NUM |
CP_ITEM |
InternalId InternalID SCP CP_LOCAL
Code Id do Item SCP CP_ITEM
IntLocExt() ->
SB1 / B1_FILIAL |
ItemInternalId Produto SCP CP_PRODUTO
UnitPrice Preo Unitario
TotalPrice Valor total do item
CP_DATPRF +
DeliveryDateTime Data de Entrega SCP hora atual
Quantity Quantidade SCP CP_QUANT
UnitofMeasureInternalId Unidade de Medida SAH / IntUndExt() ->
Pgina 65 de 84
Integrao
SCP AH_FILIAL |
CP_UM
IntProExt() ->
NNR / NNR_FILIAL |
WarehouseInternalId Local de Estoque SCP CP_LOCAL
IntCusExt() ->
CTT / CTT_FILIAL |
CostCenterInternalId Centro de Custo SCP CP_CC
alId Conta Contbil
MainOrderCode Codigo da Ordem (OS) SCP *CP_OP nmero da OS.
cEmpAnt |
TJ_FILIAL |
STJ / *CP_OP | O cdigo da OP usado para extrair e enviar o
MainOrderInternalId Codigo da Ordem (OS) SCP OS nmero da OS.
Observation Observao SCP

CP_OPS
ListOfApportionRequest.ApportionRequest no enviado pelo MNT
7.3. MaintenanceOrder
Mensagem nica MNT

BusinessContent
cEmpAnt |
TJ_FILIAL |
TJ_ORDEM |
InternalId InternalId da Solicitao STJ OS
Code Id da Solicitao STJ TJ_ORDEM
Number Numero da Solicitao STJ TJ_ORDEM
CEmpAnt |
Utiliza a combinao de campos para montar um
status fixo para a OS:
Fixo "000 - No iniciada - Y
Fixo "001 - Em andamento E (liberada e no
terminada)
Fixo "002 - Finalizada - Z
Fixo 003 - A faturar A (liberada e terminada)
TJ_SITUACA e Fixo 004 - Faturada - F
Status Situao da OS STJ TJ_TERMINO Fixo 999 - Cancelada- C
cEmpAnt |
N1_FILIAL |
N1_CBASE |
AssetInternalId Ativo fixo da OS SN1 N1_ITEM
UserRequesterCode Cdigo do Usurio Solicitante STJ TJ_USUARIO
AccountableUserInternalI Composto por: empresa + '| + cdigo (6
D Usurio Responsvel caracteres) + | + nome do usurio
Pgina 66 de 84
Integrao
TJ_DTORIGI +
RegisterDateTime Data de Emisso STJ 00:00:00
MaintenanceServiceCode Servio da manuteno STJ TJ_SERVICO
Utiliza TJ_POSCONT, mas por no ser obrigatrio
STJ ou TJ_POSCONT ou em tela envia T9_POSCONT quando no
FirstCounter Contador de utilizao 1 ST9 T9_POSCONT informado.
STJ ou TJ_POSCON2 ou
SecondCounter Contador de utilizao 2 TPE TPE_POSCON
IntPrjExt() ->
ProjectInternalId Projeto da OS STJ TJ_INTPRJ
IntTrfExt() ->
TaskInternalId Tarefa da OS STJ TJ_INTTSK
Observation Observao STJ TJ_OBSERVA

ListOfMaintenanceOrderItem .MaintenanceOrderItem
Event Evento UPSERT ou DELETE
cEmpAnt |
TL_FILIAL |
TL_ORDEM |
TL_PLANO |
TL_TAREFA |
TL_TIPOREG |
TL_CODIGO |
TL_SEQRELA |
InternalId InternalID STL TL_SEQTARE
Code Id do Item
TL_CODIGO composto conforme regras e
parametrizaes de integrao: Produto = cdigo
do produto; Terceiro = MV_PRODTER; Ferramenta
= MV_PRODFER, Mao-de-Obra = MOD+T1_CCUSTO
IntProExt() -> (caso haja de-para para produto definido para
ItemInternalId Produto SB1 / STL *TL_CODIGO MDO ele substitudo)
ItemReferenceCode Codigo de Ref. do Produto 1
TL_CUSTO /
UnitPrice Preo Unitario STL TL_QUANTID Diviso do custo pela quantidade.
TotalPrice Valor total do item STL TL_CUSTO
Quantity Quantidade STL TL_QUANTID
TL_DTINICI +
InitialDateTime Incio da utilizao STL TL_HOINICI
TL_DTFIM +
FinalDateTime Final da utilizao STL TL_HOFIM
IntUndExt() ->
AH_FILIAL |
UnitofMeasureInternalId Unidade de Medida SAH / STL TL_UNIDADE
IntLocExt() ->
NNR / NNR_FILIAL |
WarehouseInternalId Local de Estoque STL TL_LOCAL
ListOfApportionRequest.ApportionRequest - no enviado pelo MNT
Pgina 67 de 84
Integrao
7.4. MaintenanceRequest No contemplado

Mensagem nica MNT
BusinessContent
Code Cdigo da solicitao
InternalId InternalId da solicitao
CompanyId Coligada
BranchId Filial
CompanyInternalId Coligada|Filial
Status Status da solicitao
AssetInternalId Ativo fixo
RegisterDateTime Data da Solicitao
MaintenanceServiceDesc Descrio dos servio a ser
ription solicitado.
UserRequesterCode Usurio requisitante
AccountableUserInternal
ID Usurio que planejou a solicitao
ProjectInternalId Projeto
TaskInternalId Tarefa
ListOfMaintenanceOrderCode.MaintenanceOrderCode
Ordem de manuteno gerada
MaintenanceOrderCode pela solicitao
7.5. CancelRequest
a) Baixa de Estoque
Mensagem nica MNT Observao
Elemento Descrio Tabela Coluna
BusinessContent
Code Cdigo SD3 D3_DOC
SD3 cEmpAnt |
D3_FILIAL |
D3_DOC |
InternalId InternalId do cancelamento STO
SD3 cEmpAnt |
D3_FILIAL |
D3_DOC |
RequestInternalId Id da Solicitao STO
Type Tipo da entidade a cancelar Fixo 002
data atual +
CancelDateTime Data de Cancelamento hora atual
CancelReason Motivo de Cancelamento
CancelRelatedRequests Indica cancelamento em Cascata Fixo true
Pgina 68 de 84
Integrao
b) Solicitao de Compra
BusinessContent
Code Cdigo SC1 C1_NUM
SC1 cEmpAnt |
C1_FILIAL |
C1_NUM |
InternalId InternalId do cancelamento SC
SC1 cEmpAnt |
C1_FILIAL |
C1_NUM |
RequestInternalId Id da Solicitao SC
data atual +
c) Solicitao ao Armazm
BusinessContent
Code Cdigo SCP CP_NUM
SCP cEmpAnt |
CP_FILIAL |
CP_NUM |
InternalId InternalId do cancelamento SA
SCP cEmpAnt |
CP_FILIAL |
CP_NUM |
RequestInternalId Id da Solicitao SA
data atual +
d) Ordem de Servio
BusinessContent
Code Cdigo STJ TJ_ORDEM
STJ TJ_FILIAL |
TJ_ORDEM |
InternalId InternalId do cancelamento OS
Pgina 69 de 84
Integrao
STJ TJ_FILIAL |
TJ_ORDEM |
RequestInternalId Id da Solicitao OS
data atual +
7.6. CancelMaintenanceOrder

BusinessContent
Code Cdigo STJ TJ_ORDEM
cEmpAnt |
TJ_FILIAL |
TJ_ORDEM |
InternalId InternalId do cancelamento STJ OS
cEmpAnt |
TJ_FILIAL |
MaintenanceOrderIntern TJ_ORDEM |
alId Id da OS STJ OS
data atual +
7.7. StockLevel
BusinessContent.RequestItem
SB1 / IntProExt() ->
SB2 B1_FILIAL |
ItemInternalId Produto B2_COD
NNR / IntLocExt() ->
SB2 NNR_FILIAL |
WarehouseInternalId Local de estoque B2_LOCAL
Mensagem nica MNT
ReturnContent.ReturnItem
Pgina 70 de 84
Integrao
CompanyId Coligada
BranchId Filial
CompanyInternalId Coligada|Filial
SB2 IntProInt () ->
ItemInternalId Produto B2_COD
SB2 IntLocInt() ->
WarehouseInternalId Local de Estoque B2_LOCAL
UnitItemCost Custo unitrio
AverageUnitItemCost Custo unitrio mdio
CurrentStockAmount Saldo em estoque
AvailableStockAmount Saldo disponvel SB2 B2_QATU
BookedStockAmount Saldo reservado SB2 B2_QEMP

ValueOfCurrentStockAmo
unt Valor do estoque atual
7.8. AppointmentCost
Mensagem nica MNT

BusinessContent
STJ |
cEmpAnt |
TJ_FILIAL |
TJ_ORDEM |
InternalId InternalId da Solicitao STJ TJ_PLANO
Code Id da Solicitao STJ STJ + TJ_ORDEM
Number Nmero STJ STJ + TJ_ORDEM
BranchId Filial Filial
CEmpAnt |
TJ_DTMRFIM +
RegisterDateTime Data de Emisso STJ TJ_HOMRFIM + :00
IntPrjExt() ->
ProjectInternalId ID do Projeto STJ TJ_INTPRJ
MainOrderCode Codigo da Ordem (OS) STJ TJ_ORDEM
cEmpAnt |
TJ_FILIAL |
TJ_ORDEM |
MainOrderInternalId InternalId da Ordem STJ OS
Observation Observao TMOV OBSERVACAO

ListOf AppointmentCostItem . AppointmentCostItem
cEmpAnt |
TL_FILIAL |
TL_ORDEM |
TL_PLANO |
TL_TAREFA |
TL_TIPOREG |
InternalId InternalID STL TL_CODIGO |
Pgina 71 de 84
Integrao
TL_SEQRELA |
TL_SEQTARE
Code Id do Item STL TL_SEQRELA Tamanho 3, completado com 0s.
TL_CODIGO composto conforme regras e
parametrizaes de integrao: Produto =
cdigo do produto; Terceiro = MV_PRODTER;
Ferramenta = MV_PRODFER, Mao-de-Obra =
IntProExt () -> MOD+T1_CCUSTO (caso haja de-para para
B1_FILIAL | produto definido para MDO ele
ItemInternalId Produto SB1 / STL TL_CODIGO substitudo)
TL_CUSTO /
UnitPrice Preo Unitario STL TL_QUANTID Diviso do custo pela quantidade.
TotalPrice Valor total do item STL TL_CUSTO
TJ_DTMRFIM +
RegisterDateTime Data de apropriao STJ TJ_HOMRFIM + :00
Quantity Quantidade STL TL_QUANTID
IntUndExt() ->
AH_FILIAL |
UnitofMeasureInternalId Unidade de Medida SAH / STL TL_UNIDADE
IntLocExt() ->
NNR_FILIAL |
WarehouseInternalId Local de Estoque NNR / STL TL_LOCAL
IntCusExt() ->
CTT_FILIAL |
CostCenterInternalId Centro de Custo CTT / ST9 T9_CCUSTO
alId Conta Contbil
MainOrderCode Codigo da Ordem (OS) STJ TJ_ORDEM
TJ_FILIAL |
TJ_ORDEM |
MainOrderInternalId InternalId da Ordem STJ OS
IntPrjExt () ->
ProjectInternalId ID do Projeto STJ TJ_INTPRJ
IntTrfExt () ->
TaskInternalId ID da Tarefa STJ TJ_INTTSK
7.9. AssetsValuation

BusinessContent
Code Cdigo da ampliao SN4 N4_IDMOV
cEmpAnt |
N4_FILIAL |
InternalId InternalId SN4 N4_IDMOV
CompanyInternalId Coligada|Filial cEmpAnt | cFilAnt
cEmpAnt |
AssetInternalId Ativo Fixo SN1 / SN4 N1_FILIAL |
Pgina 72 de 84
Integrao
N4_CBASE |
N4_ITEM
N4_DATA +
RegisterDateTime Data de ampliao SN4 00:00:00
Fixo 001.
001 - utilizado valor nominal a ser
multiplicado pela quantidade, caso seja
maior que 1
002 - utilizado valor nominal a ser rateado
pela quantidade, caso seja maior que 1
003 - utilizado valor percentual a ser
rateado pela quantidade, caso seja maior
CalculationType Forma de clculo que 1
AssetAccounting Contabiliza ampliao
Value Valor SN4 N4_VLROC1
Percentual Valor percentual
Quantity Quantidade Fixo 1.
7.10. Order
a) Pedido de Compra (SC7)

BusinessContent
OrderId Nmero do pedido SC7 C7_NUM
cEmpAnt |
C7_FILIAL |
C7_NUM |
InternalId InternalId do pedido SC7 'PC'
RegisterDate Data de emisso da parcela SC7 C7_EMISSAO
Envia valor fixo 001 para pedido de
Ordertypecode Tipo do pedido compra.
RegisterHour Horrio de emisso Envia hora corrente.
CustomerCode Cdigo do fornecedor SC7 C7_FORNECE
IntForExt () ->
C7_FORNECE |
CustomerInternalId InternalId do fornecedor SC7 C7_LOJA
PaymentTermCode Condio de pagamento SC7 C7_COND
PaymentConditionInter InternalId da condio de IntConExt () ->
nalId pagamento SC7 C7_COND
SalesOrderItens.Item
OrderItem Id do Item SC7 C7_ITEM
Pgina 73 de 84
Integrao
cEmpAnt |
cFilAnt |
InternalId InternalId do item do pedido SC7 C7_ITEM
IntProExt() ->
ItemInternalId InternalId do produto SC7 C7_PRODUTO
UnitOfMeasureInternal IntUndExt() ->
Id Unidade de medida do item SC7 C7_UM
Quantity Quantidade SC7 C7_QUANT
UnityPrice Preo unitrio SC7 C7_PRECO
C7_QUANT *
TotalPrice Valor total SC7 C7_PRECO
CostCenterCode Centro de custo SC7 C7_CC
IntCusExt() ->
CostCenterInternalId InternalId do centro de custo SC7 C7_CC
b) Pedido de Pagamento (SE2): multas, documentos e honor. despachante

BusinessContent
OrderId Nmero do pedido SE2 E2_NUM
cEmpAnt |
E2_FILIAL |
E2_NUM |
InternalId InternalId do pedido SE2 'PP'
RegisterDate Data de emisso da parcela SE2 E2_EMISSAO
Envia valor fixo 000 para pedido de
ordertypecode Tipo do pedido pagamento.
RegisterHour Horrio de emisso Envia hora corrente.
CustomerCode Cdigo do fornecedor SE2 E2_FORNECE
IntForExt () ->
E2_FORNECE |
CustomerInternalId InternalId do fornecedor SE2 E2_LOJA
SalesOrderItens.Item
OrderItem Id do Item Envia fixo 001.
cEmpAnt |
E2_FILIAL |
E2_NUM |
'PP' |
InternalId InternalId do item do pedido SE2 001
Utiliza como produto o contedo dos
parmetros MV_PRODTRX, MV_PRODTS2
ItemInternalId InternalId do produto IntProExt() ou MV_PRODTS8.
UnitOfMeasureInternal IntUndExt() -> Envia unidade de medida relacionada ao
Id Unidade de medida do item SB1 B1_UM produto do parmetro utilizado.
Pgina 74 de 84
Integrao
Quantity Quantidade Valor fixo 1.

UnityPrice Preo unitrio Valor da parcela.
TotalPrice Valor total SE2 Envia fixo valor da parcela x 1.
CostCenterCode Centro de custo SE2 E2_CCD
IntCusExt() ->
CostCenterInternalId InternalId do centro de custo SE2 E2_CCD
7.11. InfoOfParcelValues

BusinessContent
InternalId InternalId da mensagem No utilizado.
cEmpAnt |
E2_FILIAL | Na mensagem de pagamento no
InternalId do pedido relacionado E2_NUM | obrigatrio, sendo utilizado apenas como
OrderInternalId parcela SE2 'PP' informativo.
cEmpAnt |
E2_FILIAL |
E2_PREFIXO |
E2_NUM |
E2_PARCELA |
E2_TIPO|
E2_FORNECE|
ParcelInternalId InternalId da parcela SE2 E2_LOJA Chave da tabela SE2.
DocumentInternalId Documento financeiro da parcela No utilizado.
Tipo de documento financeiro
DocumentType (pagar/receber) No utilizado.
DateReference Data de emisso da parcela SE2 E2_EMISSAO
ParcelDueDate Data de vencimento da parcela SE2 E2_VENCTO
Data do ltimo pagamento da
LastPaymentDate parcela SE2 E2_BAIXA Faz referncia a TRX_DTPGTO.
ParcelAmount Valor da parcela SE2 E2_VALOR Faz referncia ao campo TRX_VALOR.
DiscountAmount Valor do desconto SE2 E2_DESCONT Faz referncia ao campo TRX_DESCON.
AmountPaid Valor pago SE2 E2_VALLIQ Debitado de E2_SALDO e TRX_VALPAG.
Campo calculado para identificao da
operao: 00 cancela, 01 baixa parcial e 02
Status Situao de pagamento da parcela baixa total.
Observation Observao SE2 E2_HIST
Pgina 75 de 84
Integrao
8. OBSERVAES GERAIS
8.1. Consulta de OS
Sugesto/necessidade para ordens de servio finalizadas:

- cancelar solicitaes em aberto (as que forem possveis) que foram geradas
no processo de liberao da OS (pendente -> liberado) para que as mesmas no
fiquem em aberto pendente indefinidamente.
- listar os itens realizados cuja baixa foi direto pelo Backoffice para que seja
possvel informar as quantidades no utilizadas dessa baixa. Pode ocorrer de no se
utilizar a quantidade baixada.
Com base nessas informaes gerar mensagens para efetuar o fechamento,
cancelamento, estornos, devolues das solicitaes e tambm a entrada de
estoque (de itens no utilizados e que j foram baixados).
Sugesto/necessidade para ordens de servio canceladas:

- Cancelar solicitaes em aberto (as que sejam possveis), geradas no
processo de liberao da OS (pendente -> liberado) ou na insero de insumos
previstos com a OS liberada, para que as mesmas no fiquem em aberto pendente
indefinidamente. As solicitaes pendentes sero excludas caso no estejam
amarradas a um pedido ou a uma cotao.
Anlise dos itens apontados:

As solicitaes de compras ou armazm so geradas apenas na incluso de
insumos previstos para as ordens de servio, portanto no achamos adequado
incluir solicitaes ao armazm pelo MNT sem ser atravs dos insumos previstos.
Pgina 76 de 84
Integrao
8.2. Duplicao de mensagens
A respeito da integrao do mdulo MNT com o Backoffice do RM, foi

desenvolvido pela NG a integrao dos processos que o MNT integra com o
Backoffice Protheus para que fosse substitudo pelo Backoffice do RM.
Considerando essa documentao, pode-se notar que algumas funes, tal
como gerar solicitao ao armazm, so na verdade chamadas pelo MNT (via
MSExecAuto por exemplo), mas a gravao das tabelas e a ativao de rotinas
relacionadas est localizada na rotina do mdulo responsvel.
A imagem abaixo demonstra como funciona a integrao entre o MNT e o
Backoffice do RM:
Na situao atual, considerando que no Protheus o nico mdulo ativo o

MNT, a integrao funcionaria sem problemas com o Backoffice do RM. A
preocupao a seguinte: caso o mdulo MNT e outro mdulo (como no caso da
imagem, o Estoque) estejam ativos MNT integrando com EST e o Backoffice
sendo RM poderia haver duplicidade. O MNT geraria uma S.A. direto ao
Backoffice do RM e outra ao mdulo de Estoque do Protheus, que
consequentemente geraria outra S.A. ao Backoffice RM. A situao ocorreria
mesmo que o MNT fosse o nico mdulo em uso do Protheus, pois para integrar
com os mdulos do Backoffice o MNT considera os parmetros de integrao dos
mdulos do Protheus, de forma a gerar ou no mensagens de integrao com
outros mdulos.
Nesse caso, talvez fosse mais adequado centralizar as solicitaes ao
armazm no mdulo responsvel, assim para os demais processos. Mas, a
princpio, a chamada est sendo desenvolvida no MNT. A inteno nesse momento
apontar essa situao que pode gerar duplicidades ou problemas futuramente.
Pgina 77 de 84
Integrao
Como premissa para o funcionamento dessa integrao est sendo

considerado que o mdulo MNT funcionar isolado no Protheus e o restante do
Backoffice ser do RM. Como o MNT mantm algumas integraes ativas com o
Backoffice Protheus, medida que as mensagens de integrao forem
desenvolvidas nos outros mdulos do produto, a integrao do MNT deve ser revista
e as responsabilidades pela gerao de mensagens atribudas aos mdulos
responsveis, tal como Estoque e Compras.
Em situaes em que porventura ocorra duplicidade no envio das
mensagens, a sugesto rever os adapters responsveis pelo envio da mensagem
nica e manter apenas o principal adapter como ativo.
8.3. Histrico de OS (STS)
Constatou-se que no so necessrias alteraes na rotina de histrico de

OS, a qual transfere os dados da tabela STJ para a STS, apesar dos novos campos
criados nessas tabelas, pois o processo j considera todo e qualquer campo novo
por padro.
8.4. Custo das Ordens de Servio
No Manuteno de Ativos os custos das ordens de servio so essenciais

para a gesto das manutenes. Quando ordens de servio utilizam insumos do tipo
produto/terceiros e os mesmos esto integrados com o mdulo de Estoque, existem
processos que atualizam esses valores nos dois mdulos. Tais processos sero
descritos em seguida.
No que se refere aos custos de produtos, h dois custos utilizados no MNT, o
mdio e o standard. O custo standard utilizado no cadastro de produtos (SB1) e o
custo mdio atualizado no cadastro de saldos em estoque (SB2).
Ao incluir um produto como insumo realizado na ordem de servio, o campo
TL_CUSTO, que representa o custo do insumo (e consequentemente o custo total
da OS), atualizado conforme o custo mdio do produto.
Pgina 78 de 84
Integrao
No sentido inverso, o Estoque realiza a funo de reclculo de custo mdio

dos produtos. Nesse contexto so atualizadas as movimentaes de entrada e sada
de estoque que esto relacionadas aos insumos utilizados nas ordens de servio.
Dessa forma tanto o custo dos insumos quanto o valor da OS atualizado quando o
feito o processo de reclculo de custo mdio. Importante ressaltar que apenas as
ordens de servio includas no intervalo definido pelo parmetro MV_ULMES (que
indica a data do ltimo fechamento do estoque) so atualizadas.
Para a integrao, ao se realizar uma consulta de saldo de qualquer produto,
o MNT atualiza as quantidades em saldo e os custos do produto conforme
informaes do Backoffice. A integrao conta com a atualizao dos custos das
ordens de servio ao liberar uma OS e aps sua finalizao quando o MNT recebe a
informao de seu faturamento. Tambm existe uma rotina independente atravs da
qual o usurio consegue atualizar no MNT o custo de produtos e ordens de servio
especficas (MNTA386). Tambm est contemplada a integrao do parmetro
MV_ULMES para limitar o intervalo de atualizao dos custos conforme o
fechamento do estoque.
Pgina 79 de 84
Integrao
9. GAPS DE PROCESSO
Durante o estudo, desenvolvimento e homologao dos cadastros e

processos a serem integrados identificaram-se alguns gaps no escopo do projeto
que devem ser atendidos nas prximas fases conforme roadmaps. Os principais
gaps encontram-se detalhados na especificao desenvolvida pela Totvs, sendo que
alguns deles cujo impacto no MNT mais significativo, seguem abaixo:
1. Desenvolvimento do cadastro de ativos para integrar o Backoffice RM com o

Backoffice Protheus, permitindo o relacionamento de um bem do MNT com
um ativo do Backoffice.
2. A alterao do cadastro de ativo no RM deve refletir a alterao do cadastro

do ativo no Protheus. O cadastro de bens no MNT sofre reflexos das
alteraes realizadas em campos como o cdigo do centro de custo.
3. Desenvolvimento do adapter de funcionrios (RH) para facilitar o cadastro de

funcionrios da manuteno.
4. Carga inicial/importao do cadastro de bens (objetos de manuteno do RM)

para o Protheus MNT de clientes que j utilizam o Officina. Tambm o estudo
de carga inicial para outras entidades bsicas.
5. Criao de um cadastro de-para de postos para o convnio CTF. A utilizao

da importao de abastecimentos por convnio CTF tem a limitao de 5
caracteres para o cdigo do posto. Entretanto, quando integrado, o cdigo
auto incremental de tamanho mnimo 6. Dessa forma surge a necessidade de
melhoria.
Pgina 80 de 84
Integrao
10. FAQ FREQUENTED ASKED QUESTIONS
1. Como se d a integrao entre Protheus MNT e o Backoffice RM?

um processo de convergncia que visa a substituio do produto RM Officina
pelo Protheus MNT, sendo que esse passa a trabalhar com o Backoffice RM.
2. Como funciona a integrao no aspecto tecnolgico?

A integrao utiliza o conceito de mensagem nica, um arquivo XML
padronizado para os produtos Totvs, o qual enviado atravs de uma camada de
comunicao (EAI) e processado pelos programas responsveis nos sistemas
integrados (adapters).
3. Como ser a troca de informaes e o relacionamento das entidades

entre os dois sistemas?
A integrao utiliza o conceito de mensagem nica, o envio de um arquivo XML
de um sistema a outro sempre que ocorre uma incluso, atualizao ou excluso de
registro. O relacionamento das entidades entre os dois sistemas feito atravs de
uma tabela de-para, a qual automaticamente alimentada durante as integraes
(no que se refere aos cadastros integrados, pois nem todos os cadastros bsicos
tem adapters desenvolvidos). Os cadastros sero mantidos e devem ser
consultados atravs do Backoffice.
4. Qual verso do Protheus e RM necessria para integrao?

Como requisito est a utilizao da verso 11 release 11.5 do Protheus com
build superior a 7.00.120420A. Para o RM a verso 11.80 com patch 11.81.10 ou
superior.
5. Quais os requisitos obrigatrios que o cliente deve cumprir para

viabilizar o processo de integrao?
Como requisitos gerais para verso atual esto: utilizao do ambiente MNT
Protheus com Manuteno Padro ou Gesto de Frotas e Backoffice RM;
verses atualizadas dos produtos e que suportem a integrao; configurao e
Pgina 81 de 84
Integrao
instalao corretas do EAI e das parametrizaes dos sistemas; carga inicial de

dados. Demais requisitos tcnicos podem ser encontrados nas documentaes e
especificaes de integrao da Totvs e NG.
6. Quais configuraes so necessrias ao MNT para o correto

funcionamento da integrao?
H um update disponvel para utilizao da integrao e alguns parmetros que
devem ser ajustados. Tambm necessrio cadastrar os adapters desenvolvidos
para integrao atravs do configurador e realizar alguns ajustes de menu. Todas as
configuraes necessrias esto descritas na documentao de integrao
desenvolvida pela NG e na documentao da Totvs
7. Aps as configuraes necessrio realizar carga inicial da base?

Sim, porm no h um processo nico definido para isso ficando a cargo da
equipe de implantao analisar as melhores alternativas conforme a necessidade do
cliente. A carga inicial pode ser facilitada pela utilizao do TBC em alguns
cadastros, pela execuo de scripts no banco de dados, pelo recurso de alterao
global de cadastros no RM, pela ferramenta MILE ou desenvolvimentos especficos.
8. A integrao contempla o produto Gesto de Frotas?

Na primeira fase a integrao foi disponibilizada apenas para o ambiente
Manuteno de Ativos, entretanto o Gesto de Frotas no foi bloqueado para
utilizao. A integrao com o Gesto de Frotas foi contemplada na segunda fase
do projeto e est disponvel em patchs atualizados.
9. Quais integraes foram entregues na primeira fase do projeto?

O escopo da primeira entrega contempla o sistema Manuteno de Ativos e as
seguintes integraes: baixa de estoque (sentido RM-Protheus e Protheus-RM) e
seu estorno, solicitao de compra (SC), solicitao ao armazm (SA),
cancelamento de SC e SA, ampliao patrimonial, apropriao de custo, consulta de
saldo e ordem de servio. Todos os processos integrados do MNT esto detalhados
na documentao.
Pgina 82 de 84
Integrao
10. Quais integraes foram entregues na segunda fase do projeto?

Na segunda entrega foram integradas as funcionalidades referentes ao Gesto
de Frotas: anlise tcnica de pneus, transferncia de pneus, abastecimento manual,
abastecimento em lote, conciliao de abastecimentos, OS de pneus, sinistros e
multas, documentos e gerao de documentos e honorrios despachante. Todos os
processos integrados do MNT esto detalhados na documentao.
11. Qual o perfil de integrao com os mdulos de Ativo Fixo (Bonum),

Compras/Estoque (Ncleos) e RH/Financeiro (Labore)?
No que envolve a NG a integrao dos processos contempla:
- baixa de estoque e estorno, solicitao ao armazm e cancelamento, consulta
de saldo e atualizao de custos de produtos no mdulo Estoque;
- solicitao de compras e cancelamento, pedido de compra e pedido de
pagamento, e pagamento de parcelas no mdulo de Compras;
- ampliao patrimonial para o mdulo Ativo Fixo;
- apropriao de custos para o mdulo de Obras e Projetos;
- e ordem de servio.
No que envolve a Totvs a integrao de cadastros envolve: cliente/fornecedor,
moeda, unidade de medida, produto, centro de custo, ativos, funcionrios, projetos,
obra, tarefa, etapa e etc. Mais detalhes da abrangncia da integrao com outros
mdulos se encontra na documentao desenvolvida pela Totvs.
12. possvel utilizar o MNT e mais algum mdulo do Backoffice Protheus

nessa integrao?
A integrao foi projetada para operar apenas com o mdulo MNT do Protheus e
o restante do Backoffice sendo RM, pelo menos quanto aos mdulos que integram
com o MNT. Mdulos complementares ao Backoffice, como o caso do TMS,
podem ser utilizados no Protheus, mas sua interao se dar apenas com o MNT e
no com o Backoffice de outros produtos.
13. Como sero tratadas as configuraes de empresas, filiais e unidades

de negcio, tendo em vista que o conceito entre os sistemas diferente?
Pgina 83 de 84
Integrao
Atravs do configurador possvel acessar o cadastro de-para de empresas e

filiais. No caso, cada empresa/grupo do Protheus corresponde a uma coligada do
RM e uma filial do Protheus a uma filial do RM. O mesmo deve ser verificado no RM.
14. Como sero configurados os compartilhamentos de tabelas visto que

os compartilhamentos entre os sistemas so diferentes?
O compartilhamento das tabelas no Protheus entre compartilhada/exclusiva
deve seguir a regra definida pelo Backoffice RM entre global/por filial, seguindo
tambm as regras de integrao entre tabelas do Protheus para que se mantenha a
integridade relacional.
15. Em qual sistema deve ser realizada a atualizao dos cadastros? Os

mesmos sero replicados?
Cadastros do Backoffice sero mantidos no Backoffice e replicados ao Protheus
para que o MNT tenha acesso. Esse o caso de cadastros como produtos, clientes,
fornecedores e etc. As atualizaes sero realizadas apenas no RM e repassadas
ao Protheus a cada atualizao. J cadastros prprios do MNT, como cadastro de
famlias e ordens de servio, sero mantidos e devem ser atualizados no MNT.
16. Como fica o processo bsico de incluso de OS, gerao de SC e SA e

retorno de insumos considerando a integrao?
O MNT continua a operar da mesma forma. As ordens de servio e insumos so
reportados no MNT e so enviados ao RM de forma transparente. As integraes
que antes eram realizadas com o Backoffice Protheus, tal como movimentos de SC,
SA, baixa de estoque e etc. passam a ser enviadas ao Backoffice RM.
17. Como se d o processo de atualizao de custos de produtos e de OS?

A atualizao dos custos dos produtos ocorre sempre que realizada uma
consulta de saldo. A atualizao dos custos dos insumos das ordens de servio
realizada ao liberar uma OS e quando a mesma enviada como faturada do
Backoffice ao MNT. Existe, ainda, uma rotina que permite a atualizao manual dos
custos de ordens de servio.
Pgina 84 de 84

Integração Protheus MNT x BackOffice RM

Uploaded by

Document Information

Original Description:

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Integração Protheus MNT x BackOffice RM

Uploaded by

Copyright:

Available Formats

Protheus MNT x BackOffice RM

8. OBSERVAES GERAIS ................................................................................................................................ 76

O objetivo deste documento descrever os processos que envolvem a

o Rotinas padro (fase 1)

o Rotinas padro (fase 2)

o Adapters de integrao (fase 1)

o Adapters de integrao (fase 2)

3.1. Novos campos e tabelas

Foram criadas novas tabelas para atender o escopo da integrao:

Tambm foram criados os seguintes campos:

STP TP_APROPRI Apropriado - Integrao

3.2. Tabelas Envolvidas

Entre as principais tabelas envolvidas no processo esto:

O compartilhamento das tabelas no Protheus entre compartilhada/exclusiva

Dentre as configuraes necessrias para o correto funcionamento da

4.1. Servidor HTTP

Pode ser configurado atravs do wizard.exe. Como pr-requisito, o cliente

Da forma exemplificada acima, o webservice ser localizado quando na

Recomenda-se aplicar patch com atualizao do EAI e da ferramenta

Exemplo de XML enviado:

<?xml version="1.0" encoding="utf-8"?>

Ao enviar a mensagem WHOIS para o EAI Protheus, a resposta um XML

Configuraes complementares em:

A integrao exige a execuo do update UPDMNT42. Para execut-lo

Na verso atual, para utilizao da integrao com TOP e utilizar os adapters

necessrio configurar alguns parmetros para que a integrao com o

MV_NGINTER M L=Logix;R=RM;M=Mensagem nica.

MV_NGMNTES S Integrao com Estoque.

Outras configuraes recomendadas:

Abaixo as configuraes necessrias ao Gesto de Frotas (MV_NGMNTFR =

MV_NGSTAEU Estoque Usado

Segue tambm as configuraes necessrias ao EAI:

Configurar o menu com as rotinas:

A sugesto que fique conforme a imagem abaixo:

importante tambm que as rotinas de cadastros bsicos que so realizados

Considerando o relacionamento das configuraes do arquivo de empresas

4.5. Configuraes de Cadastro

Para utilizar o mdulo SigaMNT, uma das principais entidades envolvidas em

b) Cadastro de Produtos de Cdigo Fixo

A integrao do cadastro de produtos funciona normalmente conforme

No caso de insumos do tipo mo-de-obra, por exemplo, gerado um cdigo de

que esteja integrado. Nesse caso no h necessidade de contorno atravs de um

c) Cadastro das Entidades De-Para e Carga Inicial

As entidades de-para so fundamentais para qualquer integrao, pois

Adapter De-Para Carga inicial

Cliente/Fornecedor Automtico (Adapter) Manual (Adapter)

Moeda Automtico (Adapter) Manual (Adapter)

Produto Automtico (Adapter) Manual (Adapter)

Centro de Custo Automtico (Adapter) Manual (Adapter)

Ativos Automtico (Adapter) Manual (Adapter)

Funcionrios Automtico (Adapter) Manual (Adapter)

Projeto Automtico (Adapter) Manual (Consultor)

Obra Automtico (Adapter) Manual (Consultor)

Tarefa Automtico (Adapter) Manual (Consultor)

Etapa Automtico (Adapter) Manual (Consultor)

Condies de Automtico (Adapter)

Coligada Manual (Configurador) Manual (Consultor)

Filial Manual (Configurador) Manual (Consultor)

Local de Estoque Manual Manual (Adapter)

A unidade de medida que representa hora no Protheus a unidade H. Essa

4.6. Utilizao de outros mdulos

O sistema Manuteno de Ativos do ERP Protheus se integra