Integração BackOffice RM x SigaMNT

Contexto de negócio

O objetivo da integração do SIGAMNT x BackOffice RM é viabilizar que de forma automática os cadastros gerenciados pelo BackOffice sejam replicados no vertical e, de forma similar, que os processos geridos pelo Gestão de Ativos/Gestão de Frotas tenham suas informações levadas ao BackOffice. Desta forma as bases de dados se mantém espelhadas, atualizando estoque, permitindo emissão de notas fiscais e demais processos no BackOffice.

Sistemas Envolvidos

Descrição dos sistemas envolvidos no contexto de negócio (e que serão envolvidos na integração).

Integração

Para atender a demanda de clientes que possuem o BackOffice RM e necessitam de uma solução para Manutenção de Ativos e Controle de Frotas foi desenvolvida esta integração, que possibilita a gestão das movimentações a partir do módulo correspondente do Protheus, sincronizando as informações entre os módulos a partir da integração por Mensagem Única TOTVS.

 

Modelo de Mensagem Única TOTVS.

 

Durante o processo de consolidação de marcas, iniciado pela TOTVS, várias empresas diferentes foram adquiridas e com elas vários produtos passaram a compor o portfólio de ofertas disponível aos clientes. Esta expansão de ofertas permitiu que clientes de uma marca, antes limitados pelas opções com aquela “etiqueta”, pudessem agora compor o seu ambiente de TI utilizando produtos de origens diferentes (Exemplo: BackOffice RM + SigaMNT Protheus).

 

Esta mesma iniciativa já era uma prática comum nos clientes, porém todo o custo envolvido na integração entre estes aplicativos era visto pelo cliente como parte da escolha de utilizar-se de produtos de diferentes fornecedores. Uma vez que estes produtos passam a fazer parte de uma mesma oferta, os clientes TOTVS passam a demandar que estes produtos sejam naturalmente integrados. Isto significa que se antes o cliente arcava com o custo e o risco envolvido em uma integração (como corrupção da base de dados, por exemplo), ele agora entende que a TOTVS deve prover soluções já integradas, independente da origem dos produtos oferecidos.

 

Com o objetivo de padronizar as integrações com os produtos TOTVS, foi definida uma nova diretriz para os projetos de integração: A de que todos os produtos TOTVS devam trabalhar com uma mensagem XML único evitando, desta forma, o processo de transformação de mensagens. Neste cenário, teríamos o seguinte quadro:

Neste cenário, qualquer produto TOTVS trabalhará com o mesmo XML para uma mesma entidade, vamos supor que tenhamos um XML correspondente à mensagem de CLIENTES, ela poderá ser enviada para qualquer um dos produtos que suporte o recebimento desta entidade.
Uma vez que os vários produtos TOTVS terão um "idioma" comum (o XML único), as integrações entre estes produtos não exigirão mais que as mensagens sejam transformadas de um formato para outro. Com isto, será possível conectar diretamente dois produtos, sem a necessidade do TOTVS ESB, como no diagrama abaixo: 

Além de questões referentes ao formato das mensagens, a mensagem única também torna uniforme o tratamento destas mensagens XML pelos aplicativos, principalmente no que diz respeito à capacidade de rastreamento.

 

Pré-requisitos instalação/implantação/utilização

O ambiente de integração necessita, além dos pré-requisitos de cada módulo individualmente, das seguintes características:

BackOffice RM

Protheus

Mensagem ÚnicaRotina ProtheusMensagemDescriçãoEnviaRecebeMétodo ProtheusOperaçãoCanal de EnvioAdapter ProtheusVersão
SimNGMUAmpPat ASSETSVALUATION Ampliação Patrimonial SimNãoSíncronoTodasEAINGMUAmpPat 1.000
SimNGMUAprCst APPOINTMENTCOST Apropriação de Custo SimNãoSíncronoTodasEAINGMUAprCst 1.000
SimATFA010ASSETSAtivo FixoNãoSimSíncronoTodasEAIATFA0101.001
SimNGMUStoTuO STOCKTURNOVER Baixa de EstoqueSimSimSíncronoTodasEAINGMUStoTuO 1.002
SimNGMUCanMnO CANCELMAINTENANCEORDCancelamento de OS SimNãoSíncronoTodasEAINGMUCanMnO 1.000
SimNGMUCanReqCANCELREQUEST Cancelamento de Requisição SimSimSíncronoTodasEAINGMUCanReq1.000
SimGPEA370EMPLOYEEPOSITION CargoNãoSimSíncronoTodasEAIGPEA3701.000
SimCTBA030     COSTCENTERCentro de CustoNãoSimSíncronoTodasEAICTBA030    2.000
SimMATA030CUSTOMERVENDORClienteNãoSimSíncronoTodasEAIMATA0302.002
SimMATA360PAYMENTCONDITIONCondição de PagamentoNãoSimSíncronoTodasEAIMATA3602.000
SimNGMUStoLvl STOCKLEVEL Consulta de Saldo SimNãoSíncronoTodasEAINGMUStoLvl 1.001
Sim*NGMUTRAREQTRANCEABILITYREQUESTConsulta Situação da SolicitaçãoSimNãoSíncronoTodasEAINGMUTRAREQ1.001
SimPMSA201STEPPROJECTEtapa (EDT)NãoSimSíncronoTodasEAIPMSA2012.000
SimMATA020CUSTOMERVENDORForncecedorNãoSimSíncronoTodasEAIMATA0202.002
SimGPEA030ROLE FunçãoNãoSimSíncronoTodasEAIGPEA0301.000
SimGPEA010EMPLOYEEFuncionárioNãoSimSíncronoTodasEAIGPEA0102.001
SimNGMUGETSITGETEMPLOYEESITUATIONSSituação do FuncionárioSimNãoSíncronoTodasEATNGMUGETSIT1.000
SimNGMUInfPar INFOOFPARCELVALUES Informações de Parcelas NãoSimSíncronoTodasEAINGMUInfPar1.000
SimAGRA045WAREHOUSELocal de EstoqueNãoSimSíncronoTodasEAIAGRA0451.000
SimCTBA140CURRENCYMoedaNãoSimSíncronoTodasEAICTBA1402.000
SimPMSA201SUBPROJECTObra (EDT)NãoSimSíncronoTodasEAIObra (EDT)2.000
SimNGMUOrder ORDER OrdemSimSimSíncronoTodasEAINGMUOrder 3.002
SimNGMUMntOrd MAINTENANCEORDER Ordem de ServiçoSimSimSíncronoTodasEAINGMUMntOrd 1.000
SimMATA010ITEMProdutoNãoSimSíncronoTodasEAIMATA0102.000
SimPMSA200PROJECTProjetoNãoSimSíncronoTodasEAIPMSA2002.000
SimNGMUReques REQUEST Solicitação SimSimSíncronoTodasEAINGMUReques 1.000
SimPMSA203TASKPROJECTTarefaNãoSimSíncronoTodasEAIPMSA2032.000
SimGPEA080 SHIFTWORK TurnoNãoSimSíncronoTodasEAIGPEA080 1.000
SimQIEA030UNITOFMEASUREUnidade de medidaNãoSimSíncronoTodasEAIQIEA0302.000

* Disponível a partir da versão 12.1.15.160 do RM. 

 

Instalação/Atualização

Protheus

Visando maior facilidade na implantação da integração está disponível abaixo um CheckList com os passos padrão necessários para implantação e parametrização da integração no Protheus. 

PENDENTE - VERIFICAR COM O PROTHEUS

CheckList de Implantação

Índice

Tarefa

Anexo

Preparação do Ambiente

1Pendente - Verificar com a equipe do Protheus 
   
   
   
   
  

RM

Visando maior facilidade na implantação da integração está disponível abaixo um CheckList com os passos padrão necessários para implantação e parametrização da integração no RM. 

CheckList de Implantação

Índice

Tarefa

Anexo

Preparação do Ambiente

1

Instalação/Atualização da Biblioteca RM

 

1.1     Conferir arquivos *.Config e Alias.dat 
2Instalação e configuração do IIS
Manual de instalação do TBC 
3Instalação e configuração do TBC
3.1     Instalar o TBC na mesma versão da Biblioteca RM 
3.2     Configuração do Web.Config 
3.2.1           Configurar o Web.Config conforme o RM.Host.*.Config e Rm.Exe.Config 
3.2.2           Configurar Tag “DefaultDB” no Web.config com o Alias desejado 
4Atualização da base de dados (Caso ainda não esteja na versão necessária)Manual do RM Atualizador
4.1     Efetuar Backup da base de dados 
4.2     Executar o RM Atualizador na base de dados 
4.3     Conferir se o Dicionário de Dados do Protheus possui compartilhamento por Empresa/Filial igual ao RM para os cadastros integrados. 

Ativação da Integração

5Instalação e parametrização do pacote de integração no RM 
5.1   Parametrizar os Tipos de Movimento utilizados na integraçãoParametrização dos Movimentos
5.2     Executar o configurador da integração

 

Anexo Configuração da Integração

5.3     Parametrizar a URL do WebService Protheus
5.4    Informar os parâmetros da integração
5.5     Cadastrar De-Para de Coligada e FilialAnexo TOTVS_Gestao_de_Frotas-BackofficeRMxProtheusSigaMNT
5.6     Importar as Fórmulas Visuais com gatilhoAnexo Importação de Fórmulas Visuais

Preparação/Carga da Base de Dados

6Cadastro de Cliente/Fornecedor 
6.1     Abrir tabela de Municípios do Protheus para que a mesma receba carga automática (Acessar o SIGAFIS no Protheus) 
6.2     Conferir se o campo A1_COD e A2_COD no Protheus estão sem inicializador padrão (SIGACFG em Dicionário | Banco de Dados) 
6.3Informar o Inic. Padrão para o A1_LOJA e A2_LOJA (Exemplo: '01' e '02') 
6.4Editar o cadastro de um Cliente/Fornecedor manualmente e verificar se é integrado 
6.5     Verificar se todos os Clientes possuem endereço cadastrado 
6.6     Efetuar a carga de Clientes/FornecedoresAnexo Execução de Fórmulas Visuais
7Cadastro de Moeda 
7.1Verificar quais as moedas que serão integradas (Lembrando que o Protheus aceita somente 5) 
7.2Editar o cadastro de uma moeda manualmente e verificar se é integrado 
7.3Efetuar a carga de Moedas (Caso necessário alterar a Consulta SQL na FV para buscar somente as moedas desejadas)Anexo Execução de Fórmulas Visuais
8Cadastro de Unidade de Medida 
8.1Cadastrar os de-para manualmente de algumas unidades conforme cita na especificação (clique aqui)Anexo TOTVS_Gestao_de_Frotas-BackofficeRMxProtheusSigaMNT
8.2 Editar o cadastro de uma Unidade de Medida manualmente e verificar se é integrado 
8.3Efetuar a carga de Unidades de medidaAnexo Execução de Fórmulas Visuais
9Cadastro de Produto 
9.1Verificar se as Unidades de Medida associada aos Produtos já estão integradas ou incluído os de-para manualmente 
9.2Editar o cadastro de um Produto manualmente e verificar se é integrado 
9.3 Efetuar a carga de ProdutosAnexo Execução de Fórmulas Visuais
10Cadastro de Centro de Custo 
10.1Editar o cadastro de um Centro de Custo manualmente e verificar se é integrado 
10.2 Efetuar a carga de Centros de CustosAnexo Execução de Fórmulas Visuais
11Cadastro de Ativo Fixo 
11.1Cadastrar os valores defaults para Plano de Contas (para cada filial)Anexo Default para Plano de Contas
11.2Verificar se o campo N1_CHAPA da tabela de Ativos do PROTHEUS está com 30 caracteres 
11.3Verificar se os Fornecedores associados aos Bens já estão integrados 
11.4Verificar se os Centros de Custo associados aos Bens já estão integrados 
11.5 Editar o cadastro de um Bem/Ativo manualmente e verificar se é integrado 
11.6 Efetuar a carga de Bens/AtivosAnexo Execução de Fórmulas Visuais
12Cadastro de Cargo 
12.1 Editar o cadastro de um Cargo manualmente e verificar se é integrado 
12.2 Efetuar a carga de CargosAnexo Execução de Fórmulas Visuais
13Cadastro de Função 
13.1 Editar o cadastro de um Cargo manualmente e verificar se é integrado 
13.2 Efetuar a carga de FunçõesAnexo Execução de Fórmulas Visuais
14Cadastro de Turno/Horário 
14.1 Editar o cadastro de um Horário manualmente e verificar se é integrado 
14.2 Efetuar a carga de HoráriosAnexo Execução de Fórmulas Visuais
15Cadastro de Funcionário 
15.1Cadastrar o Banco, agencia e conta default para a integraçãoAnexo Default para Banco, Agencia e Conta
15.2Verificar se os Turnos, Funções e Horários estão integrados 
15.3

Acessar o cadastro de Processos do Protheus (07- Gestão Pessoal) em Atualizações | Definições de Cálculo | Processos

 
15.4Verificar dentro da Seção do Funcionário se possui o Centro de Custo informado e se está sincronizado como GlobalAnexo Centro de Custo Funcionário
15.5Verificar se os funcionários estão com o Tipo de recebimento como Mensalista ou Semanalista 
15.6Editar o cadastro de um Funcionário manualmente e verificar se é integrado 
15.7 Efetuar a carga de FuncionáriosAnexo Execução de Fórmulas Visuais
16Cadastro de Projeto (Caso for utilizar na Integração) 
16.1Cadastrar o calendário no Protheus, conforme link: Cadastro de Calendário Protheus 
16.2Informar conteúdo 001 (Calendário cadastrado no passo anterior) no parâmetro MV_INTCAL do Protheus 
16.3 Editar o cadastro de um Projeto manualmente e verificar se é integrado 
16.4Efetuar a carga de ProjetosAnexo Execução de Fórmulas Visuais
17Cadastro de Obra (Caso for utilizar na Integração) 
17.1 Editar o cadastro de uma Obra manualmente e verificar se é integrado 
17.2Efetuar a carga de ObrasAnexo Execução de Fórmulas Visuais
18Cadastro de Tarefa 
18.1Editar o cadastro de uma Tarefa manualmente e verificar se é integrado 
18.2Efetuar a carga de TarefasAnexo Execução de Fórmulas Visuais
19Cadastro de Etapa 
19.1Editar o cadastro de uma Etapa manualmente e verificar se é integrado 
19.2Efetuar a carga de EtapasAnexo Execução de Fórmulas Visuais
20Cadastro de Local de Estoque 
20.1Acessar a tabela NNR no Protheus, no campo NNR_DESCRI informar o tamanho = 40 
20.2Editar o cadastro de um Local de Estoque manualmente e verificar se é integrado 
20.3Efetuar a carga de Locais de EstoqueAnexo Execução de Fórmulas Visuais
 

 

Transações/Entidades/Mensagens únicas

Segue abaixo tabela com informações sobre as entidades trafegadas na integração.

 

Método

ID

Descrição

Origem

Destino

Mensagem Única

Versão da MensagemFórmula Visual de GatilhoFórmula Visual de Carga de Dados

Cadastros

 

 

 

 

 

01Cliente/FornecedorRMProtheusCustomerVendor2.002MOVWKF0007 - CustomerVendorMOVWKF0019 - Sincronizacao_Total_SigaMNT

02

Moeda

RM

Protheus

Currency

2.000MOVWKF0006 - CurrencyMOVWKF0019 - Sincronizacao_Total_SigaMNT
03Unidade de MedidaRMProtheusUnitOfMeasure2.000MOVWKF0017 - UnitOfMeasureMOVWKF0019 - Sincronizacao_Total_SigaMNT
04ProdutoRMProtheusItem2.000MOVWKF0013 - ItemMOVWKF0019 - Sincronizacao_Total_SigaMNT

05

Centro de Custo

RM

Protheus

CostCenter

2.000MOVWKF0005 - CostCenterMOVWKF0019 - Sincronizacao_Total_SigaMNT
06Ativo FixoRMProtheusAssets1.001MOVWKF0002 - Assets_InclusaoAlteracaoMOVWKF0019 - Sincronizacao_Total_SigaMNT
07Transferência de Ativo FixoRMProtheusAssets1.001MOVWKF0003 - Assets_TransferenciaControle-
08Exclusão de Ativo FixoRMProtheusAssets1.001MOVWKF0001 - Assets_Delete-
09CargoRMProtheusEmployeePosition1.000MOVWKF0025 - Sincronização de Cargo, Função e HorárioMOVWKF0025 - Sincronização de Cargo, Função e Horário
10FunçãoRMProtheusRole1.000MOVWKF0025 - Sincronização de Cargo, Função e HorárioMOVWKF0025 - Sincronização de Cargo, Função e Horário
11HorárioRMProtheusShiftwork1.000MOVWKF0025 - Sincronização de Cargo, Função e HorárioMOVWKF0025 - Sincronização de Cargo, Função e Horário
12FuncionárioRMProtheusEmployee2.001MOVWKF0008 - EmployeeMOVWKF0019 - Sincronizacao_Total_SigaMNT
13Exclusão de FuncionárioRMProtheusEmployee2.001MOVWKF0009 - Employee_Delete-
14ProjetoRMProtheusProject2.000MOVWKF0016 - ProjectMOVWKF0019 - Sincronizacao_Total_SigaMNT
15ObraRMProtheusSubProject2.000MOVWKF0014 - Obra Etapa TarefaMOVWKF0019 - Sincronizacao_Total_SigaMNT
16TarefaRMProtheusTaskProject2.000MOVWKF0014 - Obra Etapa TarefaMOVWKF0019 - Sincronizacao_Total_SigaMNT
17EtapaRMProtheusStepProject2.000MOVWKF0014 - Obra Etapa TarefaMOVWKF0019 - Sincronizacao_Total_SigaMNT

18

Condição de Pagamento

RM

Protheus

PaymentCondition

2.000MOVWKF0015 - PaymentConditionMOVWKF0019 - Sincronizacao_Total_SigaMNT
19Local de EstoqueRMProtheusWarehouse1.000MOVWKF0018 - WarehouseMOVWKF0019 - Sincronizacao_Total_SigaMNT

Processos

20

Solicitações (SA e SC)

Protheus

RM

Request

1.000--
21Cancelamento de SA/SCProtheusRMCancelRequest1.000--

22

Ordem de Serviço

Protheus

RM

MaintenanceOrder

1.000--
23Finalizar OSProtheusRMMaintenanceOrder1.000--
24Faturar OSRMProtheusMaintenanceOrder1.000MOVWKF0010 - Faturamento_OS-
25Cancelamento de OSProtheusRMCancelMaintenanceOrder1.000--
26Baixa de estoqueProtheusRMStockTurnover1.002--
27Baixa de EstoqueRMProtheusStockTurnover1.002MOVWKF0004 - Baixa_Estoque-
28Cancelar Baixa de EstoqueProtheusRMCancelRequest1.000--
29Consulta Saldos e CustosProtheusRMStockLevel1.001--
30Apropriação de CustosProtheusRMAppointmentCost1.000--
31Ampliação PatrimonialProtheusRMAssetsValuation1.000--
32Análise técnica de pneusProtheusRMStockTurnover1.001--
33Controle de AbastecimentoProtheusRMStockLevel1.001--
34Controle de AbastecimentoProtheusRMStockTurnover1.001--
35Controle de AbastecimentoProtheusRMOrder3.002--
36Gestão de DocumentosProtheusRMOrder3.002--
37Informação de ParcelasRMProtheusInfoOfParcelValues1.000MOVWKF0012 - InfoOfParcelValues-
38Gestão de MultasProtheusRMOrder3.002--
39Honorários de DespachanteProtheusRMOrder3.002--
40Ordem de Serviço de PneusProtheusRMMaintenanceOrder1.000--
41Transferência de PneusProtheusRMStockTurnover1.002--
42Ordem de Serviço TerceirosProtheusRMMaintenanceOrder1.001--

Obs.: As Fórmulas visuais estão disponíveis na pasta de instalação do RM em (...CORPORERM/Objetos Gerenciais/Fórmulas Visuais)

Cadastros

Para esta integração todos os cadastros possuem sua origem no BackOffice RM, sendo enviados à retaguarda Protheus.

 

Cadastro de Moeda

Identificador da Mensagem: Currency
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/VNb0E

Notas

 

Cadastro de Unidades de Medida

Identificador da Mensagem: UnitOfMeasure
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/h9b0E

Notas

 

Cadastro de Centro de Custo

Identificador da Mensagem: CostCenter
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/w9b0E

Notas

Cadastro de Projeto

Identificador da Mensagem: Project
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/ENf0E

Notas

 

Cadastro de Obra

Identificador da Mensagem: SubProject
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/Stf0E

Notas

Cadastro de Tarefa

Identificador da Mensagem: TaskProject
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/fNf0E

Notas

 

Cadastro de Etapa

Identificador da Mensagem: StepProject
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/udf0E

Notas

 

Cadastro de Condição de Pagamento

Identificador da Mensagem: PaymentCondition
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/Sdj0E

Notas

 

Cadastro de Produto/Serviço

Identificador da Mensagem: Item
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/DYD6E

Notas

 

Cadastro de Cliente/Fornecedor

Identificador da Mensagem: CustomerVendor
Versão: 2.002
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/MYP6E

Notas

 

Cadastro de Ativo Fixo

Identificador da Mensagem: Assets
Versão: 1.001
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/hYP6E

Notas

 

Cadastro de Cargo

Identificador da Mensagem: EmployeePosition
Versão: 1.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/04P6E

 

Cadastro de Função

Identificador da Mensagem: Role
Versão: 1.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/7IP6E

 

Cadastro de Turno

Identificador da Mensagem: ShiftWork
Versão: 1.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/AYT6E

 

Cadastro de Funcionário

Identificador da Mensagem: Employee
Versão: 2.001
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/9Yv6E

Notas:

 

Cadastro de Local de Estoque

Identificador da Mensagem: Warehouse
Versão: 1.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/b4z6E

Notas:

Processos

Conforme descrito na seção de apresentação do escopo, o escopo da integração se restringe aos processos relacionados a Gestão de Frotas e Manutenção de Ativos que sejam pertinentes de manipulação no BackOffice, como integrações fiscais, financeiras ou controle de estoque.

Abaixo são listados os processos integrados.


Manutenção de Ativos

 

Solicitações de Armazém/Compra

Tipo de Fluxo: Protheus -> RM
Mensagem: Request
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/-476E

Notas:

        Ciclo de vida das solicitações:

 

Consulta Situação da SA/SC

Tipo de Fluxo: Protheus -> RM
Mensagem: TranceAbilityRequest
Versão: 1.001
Especificações BackOffice RM: Consulta situação Solicitação de Armazém/Solicitação de Compras

Notas:

 

Cancelar Solicitação de Armazém/Compra

Tipo de Fluxo: Protheus -> RM
Mensagem: CancelRequest
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/apP6E

Notas:

 

Ordem de Serviço

Tipo de Fluxo: RM -> Protheus e Protheus -> RM
Mensagem: MaintenanceOrder
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/25P6E

 

Cancelar Ordem de Serviço

Tipo de Fluxo: Protheus -> RM
Mensagem: CancelMaintenanceOrder
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/bpT6E

 

Baixa de estoque

Tipo de Fluxo: RM -> Protheus e Protheus -> RM
Mensagem: StockTurnover
Versão: 1.002
Mapeamento de Campos: http://tdn.totvs.com/x/uJX6E

  RM -> Protheus

 

Cancelar Baixa de Estoque

Tipo de Fluxo: Protheus -> RM
Mensagem: CancelRequest
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/apP6E

O cancelamento de baixa de estoque ocorre ao excluir ou alterar um insumo realizado no SigaMNT. No caso da alteração de insumos realizados a baixa original deverá ser cancelada e uma nova baixa gerada.

 

Consulta de Saldos e Custos

Tipo de Fluxo: Protheus -> RM
Mensagem: StockLevel
Versão: 1.001
Especificações BackOffice RM:

O serviço de consulta de saldos e custos será utilizado pelo SigaMNT para fazer a validação de disponibilidade e custo de produtos inseridos como realizados

 

Apropriação de Custos

Tipo de Fluxo: Protheus -> RM
Mensagem: StockLevel
Versão: 1.001
Especificações BackOffice RM:

A apropriação de custos no SigaMNT será efetuada em dois pontos distintos, sendo um automático e outro de forma manual, listados abaixo.

Pré-requisitos para a integração de Apropriação de Custos

Notas:

 

Ampliação Patrimonial

Tipo de Fluxo: Protheus -> RM
Mensagem: AssetsValuation
Versão: 1.000
Especificações BackOffice RM:

A mensagem de ampliação patrimonial será enviada pelo SigaMNT para o BackOffice RM caso seja efetuada alguma manutenção que prolongue a vida útil do ativo ou que proporcione qualquer tipo de acréscimo no valor do mesmo.


Manutenção de Frotas

 

Análise técnica de pneus

Tipo de Fluxo: RM -> Protheus e Protheus -> RM
Mensagem: StockTurnover
Versão: 1.002
Mapeamento de Campos: http://tdn.totvs.com/x/uJX6E

 

Controle de Abastecimento

Tipo de Fluxo: Protheus -> RM
Mensagem: StockTurnover
Versão: 1.002
Mapeamento de Campos: http://tdn.totvs.com/x/uJX6E

Tipo de Fluxo: Protheus -> RM
Mensagem: Order
Versão: 3.002
Especificações BackOffice RM:

Tipo de Fluxo: Protheus -> RM
Mensagem: StockLevel
Versão: 1.000
Especificações BackOffice RM:

 

Gestão de Documentos

Tipo de Fluxo: Protheus -> RM
Mensagem: Order
Versão: 3.002
Especificações Backffice RM:

Tipo de Fluxo: RM -> Protheus
Mensagem: InfoOfParcelValues
Versão: 1.000
Especificações BackOffice RM:

 

Gestão de Multas

Tipo de Fluxo: Protheus -> RM
Mensagem: Order
Versão: 3.002
Especificações Backffice RM:

Tipo de Fluxo: RM -> Protheus
Mensagem: InfoOfParcelValues
Versão: 1.000
Especificações BackOffice RM:

 

Honorários de Despachante

Tipo de Fluxo: Protheus -> RM
Mensagem: Order
Versão: 3.002
Especificações Backffice RM:

Tipo de Fluxo: RM -> Protheus
Mensagem: InfoOfParcelValues
Versão: 1.000
Especificações BackOffice RM:

 

Ordem de Serviço de Pneus

Tipo de Fluxo: Protheus -> RM
Mensagem: StockTurnover
Versão: 1.002
Mapeamento de Campos: http://tdn.totvs.com/x/uJX6E

Tipo de Fluxo: RM -> Protheus e Protheus -> RM
Mensagem: MaintenanceOrder
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/25P6E

Tipo de Fluxo: Protheus -> RM
Mensagem: Request
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/-476E

Tipo de Fluxo: Protheus -> RM
Mensagem: CancelRequest
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/apP6E

Tipo de Fluxo: Protheus -> RM
Mensagem: CancelMaintenanceOrder
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/bpT6E

Tipo de Fluxo: Protheus -> RM
Mensagem: StockLevel
Versão: 1.001
Especificações Backffice RM:

 

Transferência de Pneu

Tipo de Fluxo: Protheus -> RM
Mensagem: StockTurnover
Versão: 1.002
Mapeamento de Campos: http://tdn.totvs.com/x/uJX6E

Tipo de Fluxo: Protheus -> RM
Mensagem: StockLevel
Versão: 1.001
Especificações Backffice RM:

 

Ordem de Serviço Terceiros

Tipo de Fluxo: RM -> Protheus e Protheus -> RM
Mensagem: MaintenanceOrder
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/25P6E

O fluxo completo da ordem de serviço é descrito no anexo Fluxo da ordem de serviço no SigaMNT.  

  RM -> Protheus
   A mensagem de ordem de serviço será enviada ao SigaMNT pelo BackOffice RM somente quando o movimento for faturado, para informar a alteração do status da OS para “Faturado”.

 

Manutenção de Ativos / Gestão de Frotas

 

Abertura de Atendimento

Tipo de Fluxo: RM -> Protheus e Protheus -> RM
Mensagem: MaintenanceOrder
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/25P6E


Checklist de suporte da aplicação

 

Crie um check-list de verificação de alguns pontos importantes para o funcionamento e atendimento da integração.

Instalação/Configuração

Relacione itens de verificação para garantir que a integração está corretamente instalada e configurada. Isto não pode ser uma cópia do procedimento de instalação/configuração, mas verificações pontuais que podem remeter aos itens da instalação.

Checklist de Verificações:

Relacione itens de verificações para que o atendente possa:

Anexos

 Configuração da integração

Siga os passos abaixo para efetuar a instalação e configuração da integração.

  1. Acesse o contexto de integração.


  2. Executar o processo 'Configurar' na aba 'Ferramentas'.


  3. Selecionar o pacote de integração 'TOTVS Manutenção de Ativos x BackOffice RM" e executar o processo.



  4. Acessar a rotina "Integrações" (Integração | Mensagem Única | Integrações) e parametrizar o campo 'URL WebService" com o caminho do WebService do Protheus.


  5. Acessar o anexo "Parâmetros de Integração"


    5.1 Configure o parâmetro "CodClassificPais" com o código da tabela de classificação utilizada e associada aos países referente à classificação do IBGE.


    5.2 Informe os Códigos dos Tipos de Movimento criado anteriormente para cada um dos processos que será utilizado.

    Observação: Este é apenas um exemplo, deve-se informar o Valor com o Código do Tipo de Movimento criado no ambiente do cliente.

 

 Cadastrar De-Para de Empresas e Filiais

Acesse a rotina de cadastramento de De-para no contexto de Integração

Os passos a seguir devem se repetir para todas as coligadas e filiais.

Efetue o cadastramento do De-Para de Coligadas conforme imagem abaixo, substituindo os valores entre chaves com o valor correspondente pelo código da coligada.

Tabela RM: Fixo valor 'GCOLIGADA'

Chave Primária RM: Fixo valor 'CODCOLIGADA'

Valor Chave Primária RM: Código da coligada referente

Sistema Integrado: Fixo valor 'PROTHEUS'

Valor Chave Integração: Código da coligada referente (mesma do campo Valor Chave Primária RM)

Efetue o cadastramento do De-Para de Filiais conforme imagem abaixo, substituindo os valores entre chaves com o valor correspondente ao descrito internamente a ele.

 Tabela RM: Fixo valor 'GFILIAL'

 Chave Primária RM: Fixo valor 'CODCOLIGADA|CODFILIAL'

 Valor Chave Primária RM: Código da coligada + '|' + Código da filial

 Sistema Integrado: Fixo valor 'PROTHEUS'

 Valor Chave Integração: Código do grupo de empresa do Protheus + '|' + Código completo da filial no Protheus (composto por Empresa + Filial)


Importação de Fórmulas Visuais

A lista de Fórmulas Visuais referente a cada entidade encontra-se na seção Transações/Entidades/Mensagens.

As Fórmulas Visuais informadas na tabela estão disponíveis na pasta "...CORPORERM | Objetos Gerenciais | Fórmulas Visuais" e devem ser importadas conforme apresentado no documento Importação\Exportação de fórmula visual, com atenção à importação dos gatilhos (caso contrário a mesma não será acionada).

 

Execução de Fórmulas Visuais de Carga de Dados

Segue abaixo a lista de passos para efetuar a Carga de Dados entre o BackOffice RM e o Protheus.


  1. Acessar o processo "Executar" no Menu "Gestão -> Fórmula Visual"


  2. Selecionar a Fórmula Visual de carga desejada e ícone no botão "Executar"


  3. Após a execução é necessário acessar o arquivo de Log para verificação do status dos envios para o Protheus.
    O Log estará disponível na pasta "Carga Inicial / Logs" dentro do diretório de instalação do RM (RM.Net).
     

 

Cadastrar De-para das Unidades de Medida padrão

Segue abaixo como cadastrar o de-para das unidades de medida padrão.
Observação: No exemplo foi criado para a unidade de medida UN, é necessário fazer para as demais, conforme a cita nas informações da unidade de medida (clique aqui).

  1. No RM Acessar o menu Integração | Mensagem Única | De-para


  2. Incluir um novo Registro de acordo com os dados abaixo

    Exemplo:

    Observação: O valor da Chave Integração pode alterar de acordo com o código da empresa e níveis de gestão utilizados no Protheus. 
  3. Acessar o SIGACFG no Protheus em Ambiente | Schedule | De/Para Mensagem Única


  4. Incluir um novo Registro de acordo com os dados abaixo

    Exemplo:

    Observação: Alguns dados podem alterar de acordo com o código da empresa, nível de gestão e etc.

 

Cadastrar os valores defaults para Plano de Contas

Para integrar esta entidade, o PROTHEUS exige que sejam cadastrados valores defaults para Plano de Contas em sua base (para cada filial), com os seguintes parâmetros:

  1. Acessar o Protheus no Ambiente 1 - Ativo Fixo
  2. Acessar Cadastros | Plano de Contas
  3. Incluir novo registro, conforme exemplo abaixo (É necessário fazer o processo para cada Filial do Protheus).

 

Cadastrar os valores defaults para Banco, Agência e Conta

Para integrar a entidade Funcionário, o PROTHEUS exige que sejam cadastrados valores defaults para Banco/Agência/Conta. Estes registro devem ser cadastrados com o seguintes códigos abaixo:

 

  1. Acessar o Protheus no Ambiente 7 - Gestão de Pessoal
  2. Acessar Cadastros | Bancos/Agencias
  3. Incluir novo registro, conforme exemplo abaixo.

 

 

Verificar Centro de Custo associado ao Funcionário

A informação de centro de custo é obtida a partir da seção do funcionário. Sendo assim, é necessário atentar ao cadastramento das seções, pois esta entidade ocupa no RM o mesmo nível hierárquico do centro de custo no Protheus.

  1. Acessar o cadastro de Funcionário no RM
  2. Na aba Seção, Editar a Seção do Funcionário
  3. Dentro da Seção, na aba Dados Contábeis, verificar se possui centro de custo no Funcionário e se este centro de custo está integrado


  4. Para sincronizar os Centros de Custos do RH como Global, deve-se acessar o sistema Folha de Pagamento
  5. Aba Administração Pessoal | Centros de Custos
  6. Acessar Processos | Sincronização Centro de Custo Global


Tipo de Fluxo: RM -> Protheus e Protheus -> RMMensagem: StockTurnoverVersão: 1.002Mapeamento de Campos: http://tdn.totvs.com/x/uJX6E