Documentacao MNTxBackOfficeRM 020813

Protheus MNT x BackOffice RM
Integrao
Pgina 1 de 88

Integrao
INTEGRAO Protheus MNT x Backoffice RM (Mensagem nica)
DOCUMENTAO TCNICA
AMBIENTE: Manuteno de Ativos
02/08/13 Verso 4
Pgina 2 de 88

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

Integrao
8.
OBSERVAES GERAIS ................................................................................................................................ 76 8.1. 8.2. 8.3. 8.4. CONSULTA DE OS ........................................................................................................................................... 76 DUPLICAO DE MENSAGENS............................................................................................................................ 77 HISTRICO DE OS (STS) .................................................................................................................................. 78 CUSTO DAS ORDENS DE SERVIO ....................................................................................................................... 78
9. 10. 11.
GAPS DE PROCESSO .................................................................................................................................... 80 FAQ FREQUENTED ASKED QUESTIONS ..................................................................................................... 81 ANEXOS ...................................................................................................................................................... 85 FUNCIONALIDADE DE APROPRIAO DE CUSTOS NO MNT ...................................................................................... 85
11.1.
Pgina 4 de 88

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 88

Integrao
2.
PROGRAMAS o
Rotinas padro (fase 1)

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

MNTUTIL NGMUUtil NGUTIL02 NGUTIL05 NGMNT00 NGGERAOS GERXNUFRT NGIntFin NGFWError NGFWStruct NGGenerico MNTA080 MNTA245 MNTA275 MNTA330 MNTA340 MNTA385 MNTA386 MNTA400 MNTA401 MNTA402 MNTA415 MNTA435 MNTA600 MNTA650 MNTA656 MNTA657 MNTA666 MNTA680 MNTA690 MNTA720 MNTA765 MNTA805 MNTA815 MNTA825
Pgina 6 de 88

Integrao
MNTA450 MNTA480 MNTA510
MNTA880 MNTA901 MNTA990
Update
UPDMNT42
Adapters de integrao (fase 1)

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

NGMUStoTuO NGMUCanReq NGMUReques NGMUAmpPat NGMUAprCst NGMUStoLvl NGMUMntOrd NGMUMntReq* NGMUCanMnO NGMUOrder NGMUInfPar
* no disponvel
Pgina 7 de 88

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

Integrao
STP TPP
TP_APROPRI TPP_APROPR
Apropriado - Integrao Apropriado - Integrao
3.2.
Tabelas Envolvidas Entre as principais tabelas envolvidas no processo esto: Tabela Descrio TUT TQB STJ STS STP TPP SN1 ST9 TPE STL SB1 ST1 SD3 SC1 SCP SB2 SN4 SC7 SE2 TRX TS2 TS8 Indicador de Uso de Objetos de Manuteno Solicitao Servio Ordens de Servio de Manuteno Histrico de Manuteno Ordens de Servio de Acompanhamento (Contador) OS Acompanhamento (Contador 2) Ativo Imobilizado Bem Segundo Contador do Bem Detalhes da Ordem de Servio Descrio Genrica do Produto Funcionrios Movimentaes Internas Solicitaes de Compra Solicitaes ao Armazm Saldos Fsico e Financeiro Movimentaes do Ativo Fixo Pedidos de Compra Contas a Pagar Cadastro de Multas Documentos a Pagar Honorrios de Despachante
Pgina 9 de 88

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 88

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 88

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 88

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 88

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 88

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
MV_NGINTER MV_NGGERSA
Contedo
M S/N
Observao
L=Logix;R=RM;M=Mensagem nica. Indica se deve gerar Solicitao de Armazm ao invs de 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
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 88

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

MV_NGMULOS MV_NGMNTFR MV_NGPNEUS
Contedo
S S S
Observao
Permite a abertura de mais de uma OS por SS. Indica que a empresa utiliza o sistema Gesto de Frotas. 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
MV_NGSTAPL MV_NGSTAGR MV_NGSTAGC
Descrio
Aplicado Aguardando Reforma Aguardando Conserto
Pgina 16 de 88

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

MV_EAIPASS
Contedo
totvs
Observao
Senha para autenticao do EAI para uso no envio de mensagens. No necessariamente o que est sendo apresentado nessa documentao confirmar com a equipe de infraestrutura. Nome do canal configurado no EAI para envio a outro EAI. Case sensitive. No caso do RM, indica o endereo do TBC. Verificar com a equipe de infraestrutura qual o endereo a ser utilizado. Usurio para autenticao do EAI para uso no envio de mensagens. Verificar com a equipe de infraestrutura.
MV_EAIURL2
http://rm0005291.bh01. local/TBC1180/ WsEAIService.asmx mestre
MV_EAIUSER
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 88

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 88

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 88

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 88

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 Cliente/Fornecedor Moeda Produto Centro de Custo Ativos Funcionrios Projeto Obra Tarefa Etapa Condies de pagamento Coligada Filial Local de Estoque
De-Para Automtico (Adapter) Automtico (Adapter) Automtico (Adapter) Automtico (Adapter) Automtico (Adapter) Automtico (Adapter) Automtico (Adapter) Automtico (Adapter) Automtico (Adapter) Automtico (Adapter) Automtico (Adapter) Manual (Configurador) Manual (Configurador) Manual
Carga inicial Manual (Adapter) Manual (Adapter) Manual (Adapter) Manual (Adapter) Manual (Adapter) Manual (Adapter) Manual (Consultor) Manual (Consultor) Manual (Consultor) Manual (Consultor)
Manual (Consultor) Manual (Consultor) Manual (Adapter)
Pgina 21 de 88

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
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 m escl-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 88

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 Rotina Mensagem Descrio Envia Recebe Sim NGMUStoTuO StockTurnover Baixa de Estoque Sim Sim
Pgina 23 de 88

Integrao
Mtodo Operao Canal Envio Verso
Sncrono Todas EAI 1.002
CANCELREQUEST
Mensagem nica Rotina Mensagem Descrio Envia Recebe Mtodo Operao Canal Envio Verso Sim NGMUCanReq CancelRequest Cancelamento de Requisio Sim Sim Sncrono Todas EAI 1.000
APPOINTMENTCOST
Mensagem nica Rotina Mensagem Descrio Envia Recebe Mtodo Operao Canal Envio Verso Sim NGMUAprCst AppointmentCost Apropriao de Custo Sim No Sncrono Todas EAI 1.000
REQUEST
Mensagem nica Rotina Mensagem Descrio Envia Recebe Mtodo Operao Sim NGMUReques Request Solicitao Sim Sim Sncrono Todas
Pgina 24 de 88

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

Integrao
MAITENANCEREQUEST [no disponvel]

Mensagem nica Rotina Mensagem Descrio Envia Recebe Mtodo Operao Canal Envio Verso Sim NGMUMntReq MaintenanceRequest Solicita No Sim Sncrono o de Servio Todas EAI 1.000
CANCELREQUEST
Mensagem nica Rotina Mensagem Descrio Envia Recebe Mtodo Operao Canal Envio Verso Sim NGMUCanMnO CancelMaintenanceOrder Cancelamento de OS Sim No Sncrono Todas EAI 1.000
ORDER
Mensagem nica Rotina Mensagem Descrio Envia Recebe Mtodo Operao Canal Envio Verso Sim NGMUOrder Order Ordem Sim Sim Sncrono Todas EAI 3.002
Pgina 26 de 88

Integrao
INFOOFPARCELVALUES
Mensagem nica Rotina Mensagem Descrio Envia Recebe Mtodo Operao Canal Envio Verso Sim NGMUInfPar InfoOfParcelValues Informaes de Parcelas No Sim Sncrono Todas EAI 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 88

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 88

Integrao
Pgina 29 de 88

Integrao
6.1.
Baixa de Estoque
Mensagem: StockTurnover Sentido: Protheus -> RM Mapeamento:
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
Pgina 30 de 88

Integrao
Ex: 99|12|123456789|STO
Testes pontuais: - [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
Pgina 31 de 88

Integrao
Mapeamento:
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.
Fontes relacionados: - NGMUStoTuO - MNTUTIL
6.3.
Estorno de Baixa de Estoque
Mensagem: CancelRequest Sentido: Protheus -> RM
Pgina 32 de 88

Integrao
Mapeamento:
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 utilizandose 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 88

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.
Fontes relacionados: - NGMUCanReq - MNTUTIL - MNTA400 - MNTA690 - MNTA600
6.4.
Estorno de Baixa de Estoque (recebimento)
Mensagem: CancelRequest
Pgina 34 de 88

Integrao
Sentido: RM -> Protheus 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.
Fontes relacionados: - NGMUCanReq
6.5.
Solicitao de Compra Mensagem: Request Sentido: Protheus -> RM
Pgina 35 de 88

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. O InternalId dessa mensagem composto por: cEmpAnt+'|'SC1->C1_FILIAL + '|' + SC1->C1_NUM + | + SC Ex: 99|12|123456|SC
Testes pontuais:
Pgina 36 de 88

Integrao
- Incluso manual/corretiva. [NGGERASC1]
de
insumos previstos na insumo do tipo
rotina
de para
ordem uma
de OS
servio liberada
Incluir
produto
Fontes relacionados: - NGMUReques - NGUTIL04
6.6.
Solicitao ao Armazm
Mensagem: Request Sentido: Protheus -> RM 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 88

Integrao
diferena. necessrio que o parmetro MV_NGGERSA esteja habilitado para que sejam geradas solicitaes ao armazm. O InternalId dessa mensagem composto por: 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]
Fontes relacionados: - NGMUReques - NGUTIL02
6.7.
Cancelamento de Solicitao de Compra
Mensagem: Request Sentido: Protheus -> RM 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 88

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.
Fontes relacionados: - NGMUCanReq - NGUTIL02 - NGUTIL04 - MNTA330
6.8.
Cancelamento de Solicitao ao Armazm
Mensagem: Request
Pgina 39 de 88

Integrao
Sentido: Protheus -> RM 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)]
Fontes relacionados: - MNTA420 - NGUTIL02 - MNTA265 - MNTA330
6.9.
Ampliao Patrimonial
Mensagem: AssetsValuation Sentido: Protheus -> RM Mapeamento:
Pgina 40 de 88

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]
Fontes relacionados: - NGMUAmpPat - MNTA860
Pgina 41 de 88

Integrao
6.10. Apropriao de Custo
Mensagem: AppointmentCost Sentido: Protheus -> RM 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 88

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.
O InternalId dessa mensagem composto por: 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 88

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 88

Integrao
- utilizar a rotina de histrico de OS para jogar as ordens de servio mais antigas em histrico.
Fontes relacionados: - NGMUAprCst - MNTA880 - MNTA245* - MNTA480* - NGMNT00 - NGUTIL03* - MNTA655 - MNTA875 - NGUTIL04 - MNTA380 - MNTA370 - MNTA385 - MNTA998 - MNTA550
*adaptaes no liberadas
6.11. Consulta de Saldo
Mensagem: StockLevel Sentido: Protheus -> RM Mapeamento:
Pgina 45 de 88

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 88

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.
Fontes relacionados: - NGMUStoLvl - MNTA415 - MNTA435 - MNTC755
Pgina 47 de 88

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 88

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. O InternalId dessa mensagem composto por: 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 88

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 88

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 88

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.
Fontes relacionados: - NGMUMntOrd - MNTA245 - MNTA275 - MNTA295 - MNTA330 - MNTA340 - MNTA360 - MNTA400 - MNTA401 - MNTA410 - MNTA420 - MNTA430 - MNTA450 - MNTA480 - MNTA490 - MNTA880 - MNTA985 - MNTA990 - NGUTIL02
Pgina 52 de 88

Integrao
- NGUTIL03 - NGGERAOS
6.13. Atualizao de Custo Mensagem: StockLevel Sentido: Protheus -> RM 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 88

Integrao
6.14. Solicitao de Servio [no disponvel] Mensagem: MaintenanceRequest Sentido: RM -> Protheus 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 88

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. Fontes relacionados: - NGMUMntReq* - MNTA280 - MNTA295
6.15. Pedido de Compra
Mensagem: Order Sentido: Protheus -> RM
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>. O InternalId dessa mensagem composto por: cEmpAnt+'|'+SC7->C7_FILIAL + '|' + SC7->C7_NUM +'|'+'PC' ou cEmpAnt+'|'+SE2->E2_FILIAL + '|' + SE2->E2_NUM +'|'+'PP'
Pgina 55 de 88

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 88

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 88

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 88

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 88

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. Quando, atravs do Backoffice, se realiza uma baixa parcial ou total de uma parcela, automaticamente o Protheus atualizado e consequentemente o cadastro da documentos que gerou essa parcela. Tal integrao se d atravs da mensagem InfoOfParcelValues. Para utilizao dessa funcionalidade deve ser configurado o parmetro 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 88

Integrao
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 honorrios que gerou essa parcela. Tal integrao se d atravs da mensagem InfoOfParcelValues. Para utilizao dessa funcionalidade deve ser configurado o parmetro MV_PRODTS8 que indica um item de estoque do Backoffice a ser integrado como honorrios.
Pgina 61 de 88

Integrao
7.
COMPOSIO DAS MENSAGENS
7.1.
StockTurnover
MNT Coluna
Elemento BusinessContent Type
Mensagem nica Descrio
Tabela
Observao Utilizado para selecionar o Tipo de Movimento. Fixo "000 Baixa de Estoque
Tipo da Movimentao cEmpAnt | D3_FILIAL | D3_DOC | STO D3_DOC D3_DOC cEmpAnt cFilAnt CEmpAnt | cFilAnt
InternalId Code Number CompanyId BranchId CompanyInternalId Series RegisterDateTime DeliveryDateTime AbatementDateTime ProjectInternalId MainOrderCode
InternalId da Movimentao Id da Movimentao Numero da Movimentao Empresa Filial Empresa e Filial Srie Data de Emisso Data de Entrega Data de Abatimento ID do Projeto Codigo da Ordem (OS)
SD3 SD3 SD3
SD3 STL
D3_EMISSAO + 0:00:00 TL_DTINICI + Utiliza informao da OS quando h OS Time() relacionada.
SD3
MainOrderInternalId
InternalId da Ordem (OS)
STJ / SD3
D3_ORDEM cEmpAnt | TJ_FILIAL | D3_ORDEM | OS
No obrigatrio.
No obrigatrio.
Observation Observao ListOfStockTurnoverItem . StockTurnoverItem cEmpAnt | D3_FILIAL | D3_NUMSEQ | D3_CHAVE | D3_COD D3_COD composto conforme regras e parametrizaes de integrao: Produto = cdigo do produto; Terceiro = MV_PRODTER; Ferramenta = MV_PRODFER, Mao-de-Obra = MOD+T1_CCUSTO (caso haja de-para para produto definido para MDO ele substitudo).
InternalId Code
InternalID Id do Item
SD3
ItemInternalId ItemReferenceCode ItemReserveInternalId UnitPrice TotalPrice
Produto Codigo de Ref. do Produto Cdigo da reserva Preo Unitrio Valor total do item
IntProExt() -> B1_FILIAL | SB1 / SD3 *D3_COD
SD3 SD3
D3_CUSTO1 / D3_QUANT D3_CUSTO1
Preo unitrio composto pela diviso do custo pela quantidade.
Pgina 62 de 88

Integrao
DeliveryDateTime Quantity
Data de Entrega Quantidade
STL SD3 SAH / SD3 NNR / SD3 SD3
TL_DTINICI + TL_HOINICI + :00 D3_QUANT IntUndExt() -> AH_FILIAL | D3_UM IntLocExt() -> NNR_FILIAL | D3_LOCAL IntCusExt() -> D3_CC
UnitofMeasureInternalId
Unidade de Medida
WarehouseInternalId CostCenterInternalId AccountantAcountIntern alId MainOrderCode
Local de Estoque Centro de Custo Conta Contbil Codigo da Ordem (OS)
SD3
MainOrderInternalId ProjectInternalId TaskInternalId Observation
InternalId da Ordem (OS) ID do Projeto ID da Tarefa Observao
STJ / SD3
D3_ORDEM cEmpAnt | TJ_FILIAL | D3_ORDEM | OS
ListOfApportionStockTurnover.ApportionStockTurnover no enviado pelo MNT
7.2.
Request
a) Solicitao de Compra
Elemento BusinessContent Type Mensagem nica Descrio Tipo da requisio C1_FILIAL | C1_NUM | SC C1_NUM C1_NUM cEmpAnt cFilAnt CEmpAnt | cFilAnt SC1 C1_SOLICIT Composto por: empresa + | + cdigo (6 caracteres) + | + nome do usurio SC1 C1_EMISSAO + 00:00:00 Tabela MNT Coluna Observao 000 para Solicitao de Compra
InternalId Code Number CompanyId BranchId CompanyInternalId Series UserRequesterCode UserRequesterInternalId RegisterDateTime DeliveryDateTime AbatementDateTime
InternalId da Solicitao Id da Solicitao Numero da Solicitao Empresa Filial Empresa e Filial Srie Cdigo do Usurio Solicitante IntenalID do Usurio Solicitante Data de Emisso Data de Entrega Data de Abatimento
SC1 SC1 SC1
Pgina 63 de 88

Integrao
PaymentConditionIntern alId ProjectInternalId MainOrderCode
Condio de Pagamento ID do Projeto Codigo da Ordem (OS)
IntConExt() -> E4_FILIAL | SE4 / SC1 C1_CONDPAG O cdigo da OP usado para extrair e enviar o nmero da OS.
SC1
MainOrderInternalId
Codigo da Ordem (OS)
STJ / SC1 SC1
C1_OP cEmpAnt | TJ_FILIAL | *C1_OP | OS C1_OBS cEmpAnt | C1_FILIAL | C1_NUM | C1_ITEM | C1_ITEMGRD C1_ITEM IntProExt() -> B1_FILIAL | C1_PRODUTO C1_PRECO C1_TOTAL C1_DATPRF + hora atual C1_QUANT IntUndExt() -> AH_FILIAL | C1_UM IntLocExt() -> NNR_FILIAL | C1_LOCAL IntCusExt() -> CTT_FILIAL | C1_CC
O cdigo da OP usado para extrair e enviar o nmero da OS.
Observation Observao ListOfRequestItem .RequestItem
InternalId Code
SC1 SC1 SB1 / SC1 SC1 SC1 SC1 SC1 SAH / SC1 NNR / SC1 CTT / SC1
ItemInternalId ItemReferenceCode UnitPrice TotalPrice DeliveryDateTime Quantity
Produto Codigo de Ref. do Produto Preo Unitario Valor total do item Data de Entrega Quantidade
Unidade de Medida
WarehouseInternalId
Local de Estoque
CostCenterInternalId AccountantAcountIntern alId MainOrderCode
Centro de Custo Conta Contbil Codigo da Ordem (OS)
SC1
Codigo da Ordem (OS) ID do Projeto ID da Tarefa Observao
STJ / SC1
*C1_OP cEmpAnt | TJ_FILIAL | *C1_OP | OS
C1_OBS ListOfApportionRequest.ApportionRequest no enviado pelo MNT
Pgina 64 de 88

Integrao
b) Solicitao ao Armazm
Elemento BusinessContent Type Mensagem nica Descrio Tipo da requisio cEmpAnt | CP_FILIAL | CP_NUM | SA CP_NUM CP_NUM cEmpAnt cFilAnt CEmpAnt | cFilAnt SCP CP_SOLICIT Composto por: cdigo (6 caracteres) + | + nome do usurio SCP CP_EMISSAO + 00:00:00 Tabela MNT Coluna Observao 001 para Solicitao ao Armazm
InternalId Code Number CompanyId BranchId CompanyInternalId Series UserRequesterCode UserRequesterInternalId RegisterDateTime DeliveryDateTime AbatementDateTime PaymentConditionIntern alId ProjectInternalId MainOrderCode
InternalId da Solicitao Id da Solicitao Numero da Solicitao Empresa Filial Empresa e Filial Srie Cdigo do Usurio Solicitante IntenalID do Usurio Solicitante Data de Emisso Data de Entrega Data de Abatimento Condio de Pagamento ID do Projeto Codigo da Ordem (OS)
SCP SCP SCP
SCP
MainOrderInternalId
Codigo da Ordem (OS)
STJ / SCP SCP
CP_OP cEmpAnt | TJ_FILIAL | *CP_OP | OS CP_OBS cEmpAnt | CP_FILIAL | CP_NUM | CP_ITEM | CP_LOCAL CP_ITEM IntLocExt() -> B1_FILIAL | CP_PRODUTO
Observation Observao ListOfRequestItem .RequestItem
InternalId Code
SCP SCP SB1 / SCP
ItemInternalId ItemReferenceCode UnitPrice TotalPrice DeliveryDateTime Quantity UnitofMeasureInternalId
Produto Codigo de Ref. do Produto Preo Unitario Valor total do item Data de Entrega Quantidade Unidade de Medida
SCP SCP SAH /
CP_DATPRF + hora atual CP_QUANT IntUndExt() ->
Pgina 65 de 88

Integrao
SCP
WarehouseInternalId
Local de Estoque
NNR / SCP CTT / SCP
AH_FILIAL | CP_UM IntProExt() -> NNR_FILIAL | CP_LOCAL IntCusExt() -> CTT_FILIAL | CP_CC
SCP
Codigo da Ordem (OS) ID do Projeto ID da Tarefa Observao
STJ / SCP
*CP_OP cEmpAnt | TJ_FILIAL | *CP_OP | OS
SCP CP_OPS
ListOfApportionRequest.ApportionRequest no enviado pelo MNT
7.3.
MaintenanceOrder
MNT Coluna cEmpAnt | TJ_FILIAL | TJ_ORDEM | OS TJ_ORDEM TJ_ORDEM cEmpAnt cFilAnt CEmpAnt | cFilAnt 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) Fixo 004 - Faturada - F Fixo 999 - Cancelada- C
Elemento BusinessContent
Tabela
Observao
InternalId Code Number CompanyId BranchId CompanyInternalId
InternalId da Solicitao Id da Solicitao Numero da Solicitao Empresa Filial Empresa e Filial
STJ STJ STJ
Status
Situao da OS
STJ
AssetInternalId
Ativo fixo da OS
SN1 STJ
TJ_SITUACA e TJ_TERMINO cEmpAnt | N1_FILIAL | N1_CBASE | N1_ITEM TJ_USUARIO
UserRequesterCode Cdigo do Usurio Solicitante AccountableUserInternalI D Usurio Responsvel
Composto por: empresa + '| + cdigo (6 caracteres) + | + nome do usurio
Pgina 66 de 88

Integrao
RegisterDateTime
Data de Emisso
STJ STJ STJ ou ST9 STJ ou TPE STJ STJ STJ
TJ_DTORIGI + 00:00:00 TJ_SERVICO Utiliza TJ_POSCONT, mas por no ser obrigatrio TJ_POSCONT ou em tela envia T9_POSCONT quando no T9_POSCONT informado. TJ_POSCON2 ou TPE_POSCON IntPrjExt() -> TJ_INTPRJ IntTrfExt() -> TJ_INTTSK TJ_OBSERVA UPSERT ou DELETE cEmpAnt | TL_FILIAL | TL_ORDEM | TL_PLANO | TL_TAREFA | TL_TIPOREG | TL_CODIGO | TL_SEQRELA | TL_SEQTARE 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 (caso haja de-para para produto definido para MDO ele substitudo) 1
MaintenanceServiceCode Servio da manuteno
FirstCounter SecondCounter ProjectInternalId TaskInternalId
Contador de utilizao 1 Contador de utilizao 2 Projeto da OS Tarefa da OS
Observation Observao ListOfMaintenanceOrderItem .MaintenanceOrderItem Event Evento
InternalId Code
STL
ItemInternalId ItemReferenceCode UnitPrice TotalPrice Quantity InitialDateTime FinalDateTime
Produto Codigo de Ref. do Produto Preo Unitario Valor total do item Quantidade Incio da utilizao Final da utilizao
SB1 / STL
IntProExt() -> *TL_CODIGO TL_CUSTO / TL_QUANTID TL_CUSTO
STL STL STL
Diviso do custo pela quantidade.
Unidade de Medida
WarehouseInternalId ProjectInternalId TaskInternalId Observation
Local de Estoque ID do Projeto ID da Tarefa Observao
TL_QUANTID TL_DTINICI + STL TL_HOINICI TL_DTFIM + STL TL_HOFIM IntUndExt() -> AH_FILIAL | SAH / STL TL_UNIDADE IntLocExt() -> NNR / NNR_FILIAL | STL TL_LOCAL
ListOfApportionRequest.ApportionRequest - no enviado pelo MNT
Pgina 67 de 88

Integrao
7.4.
MaintenanceRequest No contemplado
Tabela MNT Coluna Observao
Elemento BusinessContent Code InternalId CompanyId BranchId CompanyInternalId Status AssetInternalId
Mensagem nica Descrio Cdigo da solicitao InternalId da solicitao Coligada Filial Coligada|Filial Status da solicitao 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 TaskInternalId Projeto Tarefa
Observation Observao ListOfMaintenanceOrderCode.MaintenanceOrderCode Ordem de manuteno gerada MaintenanceOrderCode pela solicitao
7.5.
CancelRequest
a) Baixa de Estoque
Mensagem nica Elemento BusinessContent Code Cdigo SD3 SD3 D3_DOC cEmpAnt | D3_FILIAL | D3_DOC | STO cEmpAnt | D3_FILIAL | D3_DOC | STO Fixo 002 data atual + hora atual Fixo true Descrio Tabela MNT Coluna Observao
InternalId
InternalId do cancelamento SD3
RequestInternalId Type CancelDateTime CancelReason CancelRelatedRequests
Id da Solicitao Tipo da entidade a cancelar Data de Cancelamento Motivo de Cancelamento Indica cancelamento em Cascata
Pgina 68 de 88

Integrao
b) Solicitao de Compra
Mensagem nica Elemento BusinessContent Code Cdigo SC1 SC1 C1_NUM cEmpAnt | C1_FILIAL | C1_NUM | SC cEmpAnt | C1_FILIAL | C1_NUM | SC Fixo 000 data atual + hora atual Fixo true Descrio Tabela MNT Coluna Observao
InternalId
InternalId do cancelamento SC1
c) Solicitao ao Armazm
Mensagem nica Elemento BusinessContent Code Cdigo SCP SCP CP_NUM cEmpAnt | CP_FILIAL | CP_NUM | SA cEmpAnt | CP_FILIAL | CP_NUM | SA Fixo 001 data atual + hora atual Fixo true Descrio Tabela MNT Coluna Observao
InternalId
InternalId do cancelamento SCP
d) Ordem de Servio
Mensagem nica Elemento BusinessContent Code Cdigo STJ STJ InternalId InternalId do cancelamento TJ_ORDEM TJ_FILIAL | TJ_ORDEM | OS Descrio Tabela MNT Coluna Observao
Pgina 69 de 88

Integrao
STJ RequestInternalId Type CancelDateTime CancelReason CancelRelatedRequests Id da Solicitao Tipo da entidade a cancelar Data de Cancelamento Motivo de Cancelamento Indica cancelamento em Cascata
TJ_FILIAL | TJ_ORDEM | OS Fixo 003 data atual + hora atual Fixo true
7.6.
CancelMaintenanceOrder
MNT Coluna TJ_ORDEM cEmpAnt | TJ_FILIAL | TJ_ORDEM | OS cEmpAnt | TJ_FILIAL | TJ_ORDEM | OS Fixo 003 data atual + hora atual Fixo true Observao
Elemento BusinessContent Code
Mensagem nica Descrio Cdigo
Tabela STJ
InternalId
InternalId do cancelamento
STJ
MaintenanceOrderIntern alId Type CancelDateTime CancelReason CancelRelatedRequests
Id da OS Tipo da entidade a cancelar Data de Cancelamento Motivo de Cancelamento Indica cancelamento em Cascata
STJ
7.7.
StockLevel
MNT Tabela SB1 / SB2 Coluna IntProExt() -> B1_FILIAL | B2_COD IntLocExt() -> NNR_FILIAL | B2_LOCAL MNT Coluna Observao Observao
Mensagem nica Elemento Descrio BusinessContent.RequestItem
ItemInternalId
Produto NNR / SB2
WarehouseInternalId
Local de estoque Tabela
Mensagem nica Elemento Descrio ReturnContent.ReturnItem
Pgina 70 de 88

Integrao
CompanyId BranchId CompanyInternalId ItemInternalId WarehouseInternalId UnitItemCost AverageUnitItemCost CurrentStockAmount AvailableStockAmount BookedStockAmount ValueOfCurrentStockAmo unt
Coligada Filial Coligada|Filial SB2 Produto SB2 Local de Estoque Custo unitrio Custo unitrio mdio Saldo em estoque Saldo disponvel Saldo reservado Valor do estoque atual SB2 SB2 B2_QATU B2_QEMP IntProInt () -> B2_COD IntLocInt() -> B2_LOCAL
7.8.
AppointmentCost
MNT Coluna STJ | cEmpAnt | TJ_FILIAL | TJ_ORDEM | TJ_PLANO STJ + TJ_ORDEM STJ + TJ_ORDEM cEmpAnt Filial CEmpAnt | cFilAnt TJ_DTMRFIM + TJ_HOMRFIM + :00 IntPrjExt() -> TJ_INTPRJ TJ_ORDEM cEmpAnt | TJ_FILIAL | TJ_ORDEM | OS OBSERVACAO cEmpAnt | TL_FILIAL | TL_ORDEM | TL_PLANO | TL_TAREFA | TL_TIPOREG | TL_CODIGO |
Elemento BusinessContent
Tabela
Observao
InternalId Code Number CompanyId BranchId CompanyInternalId RegisterDateTime AbatementDateTime ProjectInternalId MainOrderCode
InternalId da Solicitao Id da Solicitao Nmero Empresa Filial Empresa e Filial Data de Emisso Data de Abatimento ID do Projeto Codigo da Ordem (OS)
STJ STJ STJ
STJ
STJ STJ
MainOrderInternalId
InternalId da Ordem
STJ TMOV
Observation Observao ListOf AppointmentCostItem . AppointmentCostItem
InternalId
InternalID
STL
Pgina 71 de 88

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 = MOD+T1_CCUSTO (caso haja de-para para produto definido para MDO ele substitudo)
ItemInternalId ItemReferenceCode UnitPrice TotalPrice RegisterDateTime Quantity
Produto Codigo de Ref. do Produto Preo Unitario Valor total do item Data de apropriao Quantidade
SB1 / STL
IntProExt () -> B1_FILIAL | TL_CODIGO TL_CUSTO / TL_QUANTID TL_CUSTO TJ_DTMRFIM + TJ_HOMRFIM + :00 TL_QUANTID IntUndExt() -> AH_FILIAL | TL_UNIDADE IntLocExt() -> NNR_FILIAL | TL_LOCAL IntCusExt() -> CTT_FILIAL | T9_CCUSTO
STL STL STJ STL
Diviso do custo pela quantidade.
Unidade de Medida
SAH / STL
WarehouseInternalId
Local de Estoque
NNR / STL
CTT / ST9
STJ
InternalId da Ordem ID do Projeto ID da Tarefa Observao
STJ STJ STJ
TJ_ORDEM TJ_FILIAL | TJ_ORDEM | OS IntPrjExt () -> TJ_INTPRJ IntTrfExt () -> TJ_INTTSK
7.9.
AssetsValuation
MNT Coluna N4_IDMOV cEmpAnt | N4_FILIAL | N4_IDMOV cEmpAnt cFilAnt cEmpAnt | cFilAnt cEmpAnt | N1_FILIAL | Observao
Elemento BusinessContent Code
Mensagem nica Descrio Cdigo da ampliao
Tabela SN4
InternalId CompanyId BranchId CompanyInternalId AssetInternalId
InternalId Empresa Filial Coligada|Filial Ativo Fixo
SN4
SN1 / SN4
Pgina 72 de 88

Integrao
RegisterDateTime
Data de ampliao
SN4
N4_CBASE | N4_ITEM N4_DATA + 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 que 1
CalculationType AssetAccounting Value Percentual Quantity Observation
Forma de clculo Contabiliza ampliao Valor Valor percentual Quantidade Observao SN4 N4_VLROC1
Fixo 1.
7.10. Order a) Pedido de Compra (SC7)
Elemento BusinessContent OrderId
Mensagem nica Descrio Nmero do pedido
MNT Tabela SC7
Observao Coluna C7_NUM cEmpAnt | C7_FILIAL | C7_NUM | 'PC' cEmpAnt cFilAnt cEmpAnt | cFilAnt
InternalId CompanyId BranchId CompanyInternalId RegisterDate Ordertypecode RegisterHour CustomerCode
InternalId do pedido Empresa Filial Coligada|Filial Data de emisso da parcela Tipo do pedido Horrio de emisso Cdigo do fornecedor
SC7
SC7
C7_EMISSAO Envia valor fixo 001 para pedido de compra. Envia hora corrente.
SC7
CustomerInternalId
InternalId do fornecedor
SC7 SC7 SC7
C7_FORNECE IntForExt () -> C7_FORNECE | C7_LOJA C7_COND IntConExt () -> C7_COND cEmpAnt cFilAnt
PaymentTermCode Condio de pagamento PaymentConditionInter InternalId da condio de nalId pagamento SalesOrderItens.Item CompanyId BranchId OrderItem Empresa Filial Id do Item
SC7
C7_ITEM
Pgina 73 de 88

Integrao
InternalId
InternalId do item do pedido
SC7 SC7 SC7 SC7 SC7 SC7 SC7 SC7
ItemInternalId InternalId do produto UnitOfMeasureInternal Id Unidade de medida do item Quantity UnityPrice TotalPrice CostCenterCode CostCenterInternalId Quantidade Preo unitrio Valor total Centro de custo InternalId do centro de custo
cEmpAnt | cFilAnt | C7_ITEM IntProExt() -> C7_PRODUTO IntUndExt() -> C7_UM C7_QUANT C7_PRECO C7_QUANT * C7_PRECO C7_CC IntCusExt() -> C7_CC
b) Pedido de Pagamento (SE2): multas, documentos e honor. despachante
Elemento BusinessContent OrderId
Mensagem nica Descrio Nmero do pedido
MNT Tabela SE2
Observao Coluna E2_NUM cEmpAnt | E2_FILIAL | E2_NUM | 'PP' cEmpAnt cFilAnt cEmpAnt | cFilAnt
InternalId CompanyId BranchId CompanyInternalId RegisterDate ordertypecode RegisterHour CustomerCode
InternalId do pedido Empresa Filial Coligada|Filial Data de emisso da parcela Tipo do pedido Horrio de emisso Cdigo do fornecedor
SE2
SE2
E2_EMISSAO Envia valor fixo 000 para pedido de pagamento. Envia hora corrente.
SE2
CustomerInternalId SalesOrderItens.Item CompanyId BranchId OrderItem
InternalId do fornecedor Empresa Filial Id do Item
SE2
E2_FORNECE IntForExt () -> E2_FORNECE | E2_LOJA cEmpAnt cFilAnt Envia fixo 001. cEmpAnt | E2_FILIAL | E2_NUM | 'PP' | 001 Utiliza como produto o contedo dos parmetros MV_PRODTRX, MV_PRODTS2 ou MV_PRODTS8. Envia unidade de medida relacionada ao produto do parmetro utilizado.
InternalId
InternalId do item do pedido
SE2
ItemInternalId InternalId do produto UnitOfMeasureInternal Id Unidade de medida do item
SB1
IntProExt() IntUndExt() -> B1_UM
Pgina 74 de 88

Integrao
Quantity UnityPrice TotalPrice CostCenterCode CostCenterInternalId
Quantidade Preo unitrio Valor total Centro de custo InternalId do centro de custo SE2 SE2 SE2 E2_CCD IntCusExt() -> E2_CCD
Valor fixo 1. Valor da parcela. Envia fixo valor da parcela x 1.
7.11. InfoOfParcelValues
Mensagem nica Descrio InternalId da mensagem cEmpAnt | E2_FILIAL | E2_NUM | 'PP' cEmpAnt | E2_FILIAL | E2_PREFIXO | E2_NUM | E2_PARCELA | E2_TIPO| E2_FORNECE| E2_LOJA MNT Tabela Observao Coluna No utilizado. Na mensagem de pagamento no obrigatrio, sendo utilizado apenas como informativo.
Elemento BusinessContent InternalId
OrderInternalId
InternalId do pedido relacionado parcela SE2
ParcelInternalId DocumentInternalId DocumentType DateReference ParcelDueDate LastPaymentDate ParcelAmount DiscountAmount AmountPaid
InternalId da parcela Documento financeiro da parcela Tipo de documento financeiro (pagar/receber) Data de emisso da parcela Data de vencimento da parcela Data do ltimo pagamento da parcela Valor da parcela Valor do desconto Valor pago
SE2
Chave da tabela SE2. No utilizado. No utilizado.
SE2 SE2 SE2 SE2 SE2 SE2
E2_EMISSAO E2_VENCTO E2_BAIXA E2_VALOR E2_DESCONT E2_VALLIQ Faz referncia a TRX_DTPGTO. Faz referncia ao campo TRX_VALOR. Faz referncia ao campo TRX_DESCON. Debitado de E2_SALDO e TRX_VALPAG. Campo calculado para identificao da operao: 00 cancela, 01 baixa parcial e 02 baixa total.
Status Observation
Situao de pagamento da parcela Observao SE2 E2_HIST
Pgina 75 de 88

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 88

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 88

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 88

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 88

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 88

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 88

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 88

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 88

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 88

Integrao
11.
ANEXOS
11.1. Funcionalidade de apropriao de custos no MNT
Abordagem 1 Ordens de servio Se resume em enviar uma mensagem de apropriao de custos nos padres de mensagem nica no momento em que uma ordem de servio finalizada. Outro momento quando a OS reaberta, nesse caso, o evento da mensagem de excluso (delete). Ela composta, de uma forma geral, pelo cdigo da OS e os insumos realizados. O MNT calcula os custos dos insumos realizados (produto, terceiro, mo-de-obra e ferramenta) e os envia ao RM da seguinte maneira: - Produto: cdigo do produto - Terceiro: produto associado ao terceiro conforme parmetro MV_PRODTER - Mo-de-Obra: um produto cujo cdigo composto por MOD mais o centro de custo do funcionrio. - Ferramenta: produto associado s ferramentas conforme o parmetro MV_PRODFER. Os produtos de mesmo cdigo so agrupados, como por exemplo, dois funcionrios de um mesmo centro de custo. O valor unitrio calculado como o valor total sobre a quantidade. Se, por ventura, um insumo acrescer o valor total de horas extras, seu valor unitrio calculado j contemplara esse valor. Lendo o documento e analisando o fluxo de informaes formulamos as seguintes consideraes: A apropriao NO dever ser um processo automtico no momento da finalizao da OS, pois talvez nem todas OSs devero ser apropriadas e a apropriao acarretar em outras regras (vide prxima considerao). Caso uma ordem de servio seja apropriada a mesma dever ser travada, ou seja, a mesma no poder mais ser alterada, cancelada ou excluda. Regra necessria para evitar apropriao em duplicidade ou desatualizada [Lucas] Observao do comit de produto MNT: Quando uma OS estiver terminada, a incluso de insumos feita atravs da aplicao direta do estoque (via mensagem nica) deve retornar um erro e no permitir que a incluso seja realizada. No haver incluso pelo mdulo EST do Protheus, apenas via movimentao de estoque (mensagem nica). Esta mensagem deve ser tratada para no permitir a incluso do insumo em uma OS apropriada. Abordagem 2 Indicador de uso Consiste no desenvolvimento de uma funcionalidade prpria para tratar da apropriao de custo a partir dos indicadores de uso do bem, ou seja, de seus contadores. Necessidade da incluso de alguns campos associados ao contador 1 e 2. Esses campos podem ser adicionados na tabela ST9/TPE ou em uma tabela nova: - Classificao do preo: indica o tipo de classificao do preo a ser apropriado, pode ser de quatro diferentes tipos: - 1=Manual: valor informado pelo usurio; - 2=Custo Hora: utiliza o valor de custo hora do bem;
Pgina 85 de 88

Integrao
- 3=Custo standard do produto; - 4=Custo mdio do produto. * Qual o objetivo principal da apropriao? Apenas contabilizar ou gerar cobranas tambm? Considerando essa pergunta, seria interessante utilizar o preo de venda do produto ao invs do custo mdio ou standard? Ou ainda usar o custo mdio no lugar do preo mdio ou standard? [Felipe/Hamilton] O objetivo principal da apropriao informar ao TOP os gastos de seu projeto/tarefa. Este dado tem importncia somente informativa, no gerando contabilizao, cobrana ou qualquer outro tipo de integrao fiscal/financeira.[Lucas] - Um campo numrico para informar o valor manual, quando for do tipo 1. - Campo de produto/local para quando for do tipo 3 ou 4. Definio do comit de produto MNT: Criar uma nova tabela no MNT para associar o indicador de uso (contador) com o tipo de objeto de manuteno. Essa tabela ter os campos: Filial, Bem, Classificao do Preo (com as opes definida anteriormente), tipo de contador (1 ou 2), Custo Hora do Bem (campo virtual), Produto, Local, Custo Mdio (campo virtual) e custo standard (virtual). Desenvolver uma nova rotina para permitir indicar a apropriao de custo, semelhante rotina de tipos de objetos de manuteno do RM. Tendo definido a origem do valor para apropriao acima, h agora a necessidade de gerar a apropriao. O processo ser manual, atravs de uma nova rotina da rotina de acerto de contador. Essa rotina permite selecionar o equipamento e contador e um perodo sobre o qual apresentado o histrico de utilizao do bem.
<imagem ilustrativa> Partindo dessa tela de parmetros o usurio visualiza o histrico de utilizao do contador selecionado. A tela abaixo seria modificada para aceitar uma coluna de marcao e um boto de apropriar custo. Tais modificaes teriam efeito apenas quando o sistema estivesse configurado para trabalhar integrado com mensagem nica.
Pgina 86 de 88

Integrao
Definio do comit de produto MNT: Desenvolver uma nova rotina, ao invs de utilizar a rotina de acerto de contador. Criar um Subitem no menu (Integrao RM), com os itens sugeridos: Configurao Indicador de Uso (para configurar os tipos de objetos de manuteno) e Apropriao (para realizar a apropriao). Ao selecionar os registros a apropriar e clicar em apropriar. O usurio preenche tambm os campos visualizaria uma tela para informar projeto e tarefa para os itens que selecionou. Ao confirmar ser gerada uma mensagem de apropriao individual para cada linha. Haveria a necessidade de um novo campo na tabela de histrico de contador (STP e TPP, assim como foi criado na STJ) para marcar se o registro foi ou no apropriado. Dessa forma se evita a apropriao de um item repetidas vezes. Observaes gerais: - na mensagem de apropriao, os campos referentes a produtos estariam sendo usados apenas no caso de a classificao de custo ser dos tipos 3 ou 4 (onde h um produto relacionado).SEMPRE dever ter um produto associado. No caso do tipo 3 e 4 o que no ser necessrio enviar o valor unitrio do item. [Lucas] Definio do comit de produto MNT: Quando for enviado o tipo 1 ou 2, dever ser criado um parmetro para indicar qual produto ser considerado. Uma alternativa solicitar um produto para o indicador mesmo quando o custo no utilizar o produto como base. - o campo de ordem de servio no seria enviado em todas as apropriaes, visto que o MNT permite o reporte de uso do equipamento em diversos pontos do sistema, alm das ordens de servio. Questionamentos: O MNT permite alterar a utilizao do indicador de uso, ou seja, permite que se faa um reporte de contador e depois se altere ou exclua o registro. No caso de registros apropriados, haveria a necessidade inicial de desapropriao tambm? Tal necessidade geraria um enorme trabalho no MNT com a inteno de preparar o sistema para gerar mensagens de desapropriao (quando excluso) ou desapropriao + apropriao (quando alterao). Se houver a necessidade para a verso atual, sugerem alguma alternativa? Existe real necessidade de que o contador seja
Pgina 87 de 88

Integrao
alterado? No caso do contador de Km dificilmente aconteceria. Creio que a melhor abordagem bloquear a excluso e alterao de reportes de contador j apropriados. [Lucas] Definio do comit de produto MNT: Deve se bloquear qualquer alterao de abastecimento, reabertura de OS, alterao ou excluso de contador (pelo acerto de contador) para quando encontrar algum registro no histrico que esteja apropriado com data superior ao que se est manipulando. Ex.: foi feita apropriao dia 09/08 para o registro de STP com o valor de 1000 para uso. Se o usurio tentar alterar um abastecimento anterior a esse registro, como do dia 08/08, o sistema no deve permitir. Tambm no possvel fazer reporte de produo tendo registros apropriados posteriormente. Outra considerao que sempre que for inserido um registro retroativo, que no seja o ltimo STP, deve verificar se o prximo registro j est apropriado. Se estiver, o registro que est sendo includo tambm pode ser considerado apropriado, pois seu valor est embutido no registro posterior a ele. - Haveria a necessidade de rastrear a apropriao no BackOffice, sabendo a sua origem? O campo observao poderia usar um descritivo nesse sentido, caso necessrio? O campo observao poderia ser utilizado para integrarmos algum descritivo especfico, mas o rastreamento no ser feito a partir deste campo. Apropriaes vindas do SigaMNT sero cadastradas em um tipo de movimento especfico, assim, saberemos que a mesma foi originada pelo SigaMNT (independente de qual tela a originou). [Lucas] ANEXOS
Anexo 1. Tela de configurao dos indicadores de uso dos equipamentos no RM
Pgina 88 de 88

Documentacao MNTxBackOfficeRM 020813

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

Documentacao MNTxBackOfficeRM 020813

Uploaded by

Copyright:

Available Formats

Protheus MNT x BackOffice RM

Protheus MNT x BackOffice RM

INTEGRAO Protheus MNT x Backoffice RM (Mensagem nica)

Protheus MNT x BackOffice RM

Protheus MNT x BackOffice RM

Protheus MNT x BackOffice RM

Protheus MNT x BackOffice RM

Rotinas padro (fase 1)

Rotinas padro (fase 2)

Protheus MNT x BackOffice RM

MNTA450 MNTA480 MNTA510

MNTA880 MNTA901 MNTA990

Adapters de integrao (fase 1)

Adapters de integrao (fase 2)

Protheus MNT x BackOffice RM

Protheus MNT x BackOffice RM

Apropriado - Integrao Apropriado - Integrao

Protheus MNT x BackOffice RM

Protheus MNT x BackOffice RM

CONFIGURAO DO AMBIENTE Dentre as configuraes necessrias para o correto funcionamento da

Protheus MNT x BackOffice RM

Protheus MNT x BackOffice RM

Exemplo de XML enviado:

Protheus MNT x BackOffice RM

Configuraes complementares em:

Protheus MNT x BackOffice RM

Parmetros necessrio configurar alguns parmetros para que a integrao com o

Protheus MNT x BackOffice RM

S S <produto> <produto> N S 3 S S N S S <produto> <produto> <produto> S

Outras configuraes recomendadas: Parmetro

Protheus MNT x BackOffice RM

MV_NGSTAEU MV_NGSTAER MV_NGSTAAT MV_NGSTARS MV_NGSTAEN

Segue tambm as configuraes necessrias ao EAI: Parmetro

http://rm0005291.bh01. local/TBC1180/ WsEAIService.asmx mestre

A sugesto que fique conforme a imagem abaixo:

Protheus MNT x BackOffice RM

Protheus MNT x BackOffice RM

Protheus MNT x BackOffice RM

Protheus MNT x BackOffice RM

Manual (Consultor) Manual (Consultor) Manual (Adapter)

Protheus MNT x BackOffice RM

Utilizao de outros mdulos

Protheus MNT x BackOffice RM

CONFIGURAO DOS ADAPTERS

Protheus MNT x BackOffice RM

Mtodo Operao Canal Envio Verso

Sncrono Todas EAI 1.002

Protheus MNT x BackOffice RM

Canal Envio Verso

Protheus MNT x BackOffice RM

MAITENANCEREQUEST [no disponvel]

Protheus MNT x BackOffice RM

Protheus MNT x BackOffice RM

DESCRIO DOS PROCESSOS/MENSAGENS

Protheus MNT x BackOffice RM

Protheus MNT x BackOffice RM

Mensagem: StockTurnover Sentido: Protheus -> RM Mapeamento:

Protheus MNT x BackOffice RM

Fontes relacionados: - NGMUStoTuO - MNTA400 - MNTUTIL - MNTA690 - MNTA600

Baixa de Estoque (recebimento)

Mensagem: StockTurnover Sentido: RM -> Protheus

Protheus MNT x BackOffice RM