Páginas filhas
  • TOTVS Gestão de Ativos - BackofficeRM x ProtheusSigaMNT - EAI 1.0

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

em sua base

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.45     Verificar se todos os Clientes possuem endereço cadastrado 
6.56     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 medida.Anexo Execução de Fórmulas Visuais
9Cadastro de Produto 
9.1Verificar se a Unidade as Unidades de Medida associada ao Produto já foi integrada aos Produtos já estão integradas ou incluído o os de-para manualmente 
9.2Editar o cadastro de um Produto manualmente e verificar se é integrado 
9.3 Efetuar a carga de Produtos.Anexo 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 Custos.Anexo Execução de Fórmulas Visuais
11Cadastro de Ativo Fixo 
11.1Cadastrar os valores defaults para Plano de Contas (para cada filial)Anexo Defaults 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.3Verificar 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.4Verificar se os funcionários estão com o Tipo de recebimento como Mensalista ou Semanalista 
15.5Editar o cadastro de um Funcionário manualmente e verificar se é integrado 
15.6 Efetuar a carga de FuncionáriosAnexo Execução de Fórmulas Visuais
   
   
 

 

Âncora
Transações/Entidades/Mensagens
Transações/Entidades/Mensagens

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 - Item

...

Transações/Entidades/Mensagens únicas

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

 

Exclusão FuncionárioEmployeeCondição de PagamentoPaymentCondition222Ordem ServiçoRM10002327Baixa EstoqueStockTurnover1002MOVWKF0004 Baixa_Estoque28Consulta Saldos e CustosStockLevelAmpliação PatrimonialAssetsValuation37 InfoOfParcelValues

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_SigaMNT13

05

Centro de

Custo

RM

Protheus

CostCenter

2.001MOVWKF0009 - Employee_Delete-14ProjetoRMProtheusProject2.000MOVWKF0016 MOVWKF0005 - ProjectCostCenterMOVWKF0019 - Sincronizacao_Total_SigaMNT
1506ObraAtivo FixoRMProtheusSubProjectAssets21.000001MOVWKF0014 - Obra Etapa TarefaMOVWKF0002 - Assets_InclusaoAlteracaoMOVWKF0019 - Sincronizacao_Total_SigaMNT16
07Transferência de Ativo FixoTarefaRMProtheusTaskProjectAssets21.000001MOVWKF0014 - Obra Etapa TarefaMOVWKF0019 - Sincronizacao_Total_SigaMNT17MOVWKF0003 - Assets_TransferenciaControle-
08Exclusão de Ativo FixoEtapaRMProtheusStepProjectAssets21.000001MOVWKF0014 - Obra Etapa TarefaMOVWKF0019 - Sincronizacao_Total_SigaMNT

18

MOVWKF0001 - Assets_Delete-
09CargoRMProtheusEmployeePosition1.000MOVWKF0015 - PaymentConditionMOVWKF0019 - Sincronizacao_Total_SigaMNT19MOVWKF0025 - Sincronização de Cargo, Função e HorárioMOVWKF0025 - Sincronização de Cargo, Função e Horário
10FunçãoLocal de EstoqueRMProtheusWarehouseRole1.000MOVWKF0018 - WarehouseMOVWKF0019 - Sincronizacao_Total_SigaMNTMOVWKF0025 - Sincronização de Cargo, Função e HorárioMOVWKF0025 - Sincronização de Cargo, Função e Horário
11HorárioRMProtheusShiftwork

Processos

20

Solicitações (SA e SC)

Protheus

RM

Request

1.000MOVWKF0025 - Sincronização de Cargo, Função e HorárioMOVWKF0025 - Sincronização de Cargo, Função e Horário
12FuncionárioRM21Cancelamento de SA/SCProtheusRMEmployeeCancelRequest12.000001MOVWKF0008 - EmployeeMOVWKF0019 - Sincronizacao_Total_SigaMNT
13Exclusão de FuncionárioRMProtheusEmployee

MaintenanceOrder

2.001MOVWKF0009 - Employee_Delete-
14ProjetoFinalizar OSRMProtheusRMProjectMaintenanceOrder12.000MOVWKF0016 - ProjectMOVWKF0019 - Sincronizacao_Total_SigaMNT
2415Faturar OSObraRMProtheusMaintenanceOrderSubProject12.000MOVWKF0010 - Faturamento_OS-MOVWKF0014 - Obra Etapa TarefaMOVWKF0019 - Sincronizacao_Total_SigaMNT
16TarefaRM25Cancelamento de OSProtheusRMTaskProjectCancelMaintenanceOrder12.000MOVWKF0014 - Obra Etapa TarefaMOVWKF0019 - Sincronizacao_Total_SigaMNT
17EtapaRM26Baixa de estoqueProtheusRMStepProjectStockTurnover12.002000MOVWKF0014 - Obra Etapa TarefaMOVWKF0019 - Sincronizacao_Total_SigaMNT

18

Condição de

Pagamento

RM

Protheus

PaymentCondition

2.000MOVWKF0015 - PaymentConditionMOVWKF0019 - Sincronizacao_Total_SigaMNT
19Cancelar Baixa Local de EstoqueRMProtheusRMCancelRequestWarehouse1.000MOVWKF0018 - WarehouseMOVWKF0019 - 29Sincronizacao_Total_SigaMNT

Processos

20

Solicitações (SA e SC)

Protheus

RM

Request

1.001000--
3021Apropriação Cancelamento de CustosSA/SCProtheusRMAppointmentCostCancelRequest1.000--31

22

Ordem de Serviço

Protheus

RM

MaintenanceOrder

1.000--
23Finalizar OS32Análise técnica de pneusProtheusRMStockTurnoverMaintenanceOrder1.001000--
2433Faturar OSRMControle de AbastecimentoProtheusRMStockLevelMaintenanceOrder1.001000MOVWKF0010 - Faturamento_OS-
3425Controle Cancelamento de AbastecimentoOSProtheusRMStockTurnoverCancelMaintenanceOrder1.001000--
3526Controle Baixa de AbastecimentoestoqueProtheusRMOrderStockTurnover31.002--36
27Gestão Baixa de DocumentosEstoqueRMProtheusRMStockTurnoverOrder31.002MOVWKF0004 - Baixa_Estoque-
28Cancelar Baixa de EstoqueProtheusInformação de ParcelasRMProtheusCancelRequestInfoOfParcelValues1.000MOVWKF0012 --
29Consulta Saldos e Custos38Gestão de MultasProtheusRMOrderStockLevel31.002001--
3930Honorários Apropriação de DespachanteCustosProtheusRMOrderAppointmentCost31.002000--
31Ampliação Patrimonial40Ordem de Serviço de PneusProtheusRMMaintenanceOrderAssetsValuation1.000--
4132Transferência Análise técnica de PneuspneusProtheusRMStockTurnover1.002001--
4233Ordem Controle de Serviço TerceirosAbastecimentoProtheusRMMaintenanceOrderStockLevel1.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

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

Notas

  • Serão integrados somente os dados dos registros do tipo Moeda, desconsiderando registros do tipo Índices.
  • O Protheus, por default, aceita no máximo 5 tipos de Moedas.
  • O campo “Código da Moeda” é gerado pelo Adapter Protheus, uma vez que não existe o campo código no RM.

 

...

Identificador da Mensagem: UnitOfMeasure
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono

Notas

  • Visto que a base Protheus possui carga de unidades de medida padrões, que obrigatoriamente constam na base de dados, deve-se efetuar manualmente o cadastramento da relação “DE-PARA” nas tabelas referentes no RM e Protheus para viabilizar a integração de registros que utilizem estas como parâmetro.
  • As unidades de medida referentes à Hora (H), Quilometragem (KM), Unidade (UN) e Litro (L) devem possuir o mesmo código tanto no RM quanto no PROTHEUS.
  • O campo Código da Unidade de Medida no PROTHEUS será gerado pelo Adapter, uma vez que este campo no RM tem tamanho de 5 caracteres, no PROTHEUS 2 caracteres e na mensagem única 6 caracteres.

 

Cadastro de Centro de Custo

Identificador da Mensagem: CostCenter
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono

Notas

...

Cadastro de Projeto

Identificador da Mensagem: Project
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono

Notas

  • O código da filial do projeto será sempre obrigatório caso a integração esteja instalada. Caso ele não seja informado será exibida uma mensagem ao usuário e a mensagem não será enviada ao Protheus.
  • Algumas parametrizações são obrigatórias no Protheus para que a integração de projetos seja efetuada com sucesso. Para maiores detalhes acesse o link abaixo.
    http://fwrm-wiki:21598/WikiHelp/CON3/INT.cadastrosProjetoBackOfficeRMxProtheusSigaMNT.aspx - VERIFICAR !!!

  • O campo “Código do Projeto” no Protheus está limitado a 10 caracteres. Caso o RM possua Código do Projeto com mais de 10 caracteres deve-se analisar o Protheus deve ser configurado como autoincremento.

 

Cadastro de Obra

  • Serão integrados somente os dados dos registros do tipo Moeda, desconsiderando registros do tipo Índices.
  • O Protheus, por default, aceita no máximo 5 tipos de Moedas.
  • O campo “Código da Moeda” é gerado pelo Adapter Protheus, uma vez que não existe o campo código no RM.

 

Âncora
Unidade de Medida
Unidade de Medida
Cadastro de Unidades de Medida

Identificador da Mensagem: UnitOfMeasureIdentificador da Mensagem: SubProject
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono

Notas

...

  • Visto que a base Protheus possui carga de unidades de medida padrões, que obrigatoriamente constam na base de dados, deve-se efetuar manualmente o cadastramento da relação “DE-PARA” nas tabelas referentes no RM e Protheus para viabilizar a integração de registros que utilizem estas como parâmetro.
  • As unidades de medida referentes à Hora (H), Quilometragem (KM), Unidade (UN) e Litro (L) devem possuir o mesmo código tanto no RM quanto no PROTHEUS.
  • O campo Código da Unidade de Medida no PROTHEUS será gerado pelo Adapter, uma vez que este campo no RM tem tamanho de 5 caracteres, no PROTHEUS 2 caracteres e na mensagem única 6 caracteres.

 

Cadastro de Centro de Custo

Identificador da Mensagem: CostCenter

Cadastro de Tarefa

Identificador da Mensagem: TaskProject
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono

Notas

  • O campo “Código da Tarefa” no Protheus deve ser alterado para o tamanho de 60 caracteres, para manter compatibilidade com o RM.

 

Cadastro de Etapa

Identificador da Mensagem: StepProject
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono

Notas

  • O campo “Código da Etapa” no Protheus deve ser alterado para o tamanho de 60 caracteres, para manter compatibilidade com o RM.

 

Cadastro de Condição de Pagamento

Identificador da Mensagem: PaymentCondition
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono

Notas

  • O cadastro de condições de pagamento deve ser compatibilizado com as limitações do Protheus quanto aos tipos de período, que são mais bem especificadas na seção de mapeamento da mensagem.

  • Caso o “Código da Condição de Pagamento” no RM seja maior que 3 caracteres, o código da condição de pagamento no Protheus deve ser configurado como autoincremento.

 

  • Os campos “Centro de Custo” e “Código Reduzido do Centro de Custo” no PROTHEUS deve ser alterado para tamanho de 20 caracteres, uma vez que no RM estes campos permitem até 25 caracteres.


Cadastro de ProjetoCadastro de Produto/Serviço

Identificador da Mensagem:  ItemProject
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono

Notas

  • O código da filial do projeto será sempre obrigatório caso a integração esteja instalada. Caso ele não seja informado será exibida uma mensagem ao usuário e a mensagem não será enviada ao Protheus.
  • Algumas parametrizações são obrigatórias no Protheus para que a integração de projetos seja efetuada com sucesso. Para maiores detalhes acesse o link abaixo.
    http://fwrm-wiki:21598/WikiHelp/CON3/INT.cadastrosProjetoBackOfficeRMxProtheusSigaMNT.aspx - VERIFICAR !!!

  • O campo “Código do Projeto” no Protheus está limitado a 10 caracteres. Caso o RM possua Código do Projeto com mais de 10 caracteres deve-se analisar o Protheus deve ser configurado como autoincremento.

 

Cadastro de Obra

Identificador da Mensagem: SubProject
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono

Notas

  • O campo “Código da Obra” no Protheus deve ser alterado para o tamanho de 60 caracteres,

  • Serão enviados para o PROTHEUS somente os Produtos/Serviços de Último Nível (Caso o controle de nível de máscara esteja habilitado nos parâmetros de Tabelas | Produtos no RM).

  • Caso a integração esteja ativa, não será permitido o cadastramento de produtos controlados por lote e série, devendo ser selecionada somente uma das opções.
  • Produtos globais no BackOffice RM não serão considerados globais no sistema de destino, sendo enviada uma mensagem de inclusão para cada empresa a qual o produto faz parte.
    * Caso haja ao menos uma mensagem enviada com sucesso ao SigaMNT, mesmo havendo erro nas mensagens referentes ao produto para as outras coligadas, não será apresentada mensagem de erro e a alteração/inclusão não será desfeita.

  • Não serão enviadas informações de Cliente/Fornecedor do Produto.
  • O campo B1_CODITE no cadastro de Produtos do PROTHEUS deve ser alterado, via apsdu, para não obrigatório e também deve-se retirar sua validação.
  • O campo “Código do Produto” no PROTHEUS deve ser alterado para tamanho 30 caracteres

    para manter compatibilidade com o RM.

...




Cadastro de Cliente/Fornecedorde Tarefa

Identificador da Mensagem:  CustomerVendorTaskProject
Versão: 2.002000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono

Notas

  • Ao iniciar uma base zerada do Protheus, para incluir a tabela de Municípios no Protheus é necessário acessar o Protheus no sistema 09 - Livros Fiscais. Se não acessar o sistema Fiscal do Protheus antes de enviar o cadastro do RM irá apresentar mensagem de inconsistência informando que é valor inválido para o campo Município.

  • Uma vez que o Cliente e Fornecedor são tratados na mesma mensagem (CustomerVendor), é responsabilidade do destinatário ao processar a mensagem garantir a consistência dos dados na origem e no destino da melhor forma possível.Ou seja, se o destino implementa uma única tabela, terá que manipular apenas um registro e se implementa mais de uma tabela, terá que manipular quantos registros forem necessários.

  • Para regras de negócio desta mensagem atenção ao seguinte ponto de atenção.
  • Mesmo que a empresa não utilize Cliente/Fornecedor global no RM, deve-se compartilhar a tabela referente no Protheus por empresa.
  • No Protheus o código do cliente/fornecedor será composto pelo código do cliente/fornecedor e da coligada, conforme a mascara “[CODCOLIGADA]|[CODCFO]”.

 

Cadastro de Ativo Fixo

  • O campo “Código da Tarefa” no Protheus deve ser alterado para o tamanho de 60 caracteres, para manter compatibilidade com o RM.

 

Cadastro de Etapa

Identificador da Mensagem: StepProject
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono

Notas

  • O campo “Código da Etapa” no Protheus deve ser alterado para o tamanho de 60 caracteres, para manter compatibilidade com o RM.

 

Cadastro de Condição de Pagamento

Identificador da Mensagem: PaymentCondition
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono

Notas

  • O cadastro de condições de pagamento deve ser compatibilizado com as limitações do Protheus quanto aos tipos de período, que são mais bem especificadas na seção de mapeamento da mensagem.

  • Caso o “Código da Condição de Pagamento” no RM seja maior que 3 caracteres, o código da condição de pagamento no Protheus deve ser configurado como autoincremento.

 

Cadastro de Produto/Serviço

Identificador da Mensagem: Item
Versão: 2.000Identificador da Mensagem: Assets
Versão: 1.001
Mandatário: BackOffice RM
Tipo de Envio: Síncrono

Notas

  • Serão integrados somente ativos do tipo “Patrimônio”. Assim sendo, qualquer ativo dos tipos “Título” ou “Terceiros” será desconsiderado e não disparará o gatilho de integração.

  • Não será integrado o histórico de valores do ativo fixo na seção “ListOfSalesAndValuesAssets” da mensagem, sendo o código de integração enviado sempre com o sufixo “1”. Estes dados do patrimônio serão enviados respeitando a seguinte regra:
    * Inclusão: Serão enviados os dados informados na tela de inclusão.
              * DepreciationStartDate : Valor calculado pela função PatPatrimonioService. RetornaDataInicioVigencia(CodColigada, DataAquisicao)
              * OriginalValueCurrency : IPatrimonio . AQUISICAO
              * CurrencyCode e CurrencyInternalId : Código da moeda padrão do sistema
              * AnnualRateCurrencyDepreciation : IPatrimonio .VRTAXADEPRECIACAO
              * BalanceDepreciation: Fixo 0.
    * Alteração: Serão enviados os dados atuais do ativo em uma única linha, desconsiderando as movimentações anteriores não integradas.
              * DepreciationStartDate : ICALCULOPATRIMONIO.DATAINICIOVIGENCIA
              * OriginalValueCurrency : ICALCULOPATRIMONIO.VALORBASECORRIGIDO ou ISALDOCALCULOPATRIMONIOMOEDA. VALORBASECORRIGIDO
              * CurrencyCode e CurrencyInternalId : ICALCULOPATRIMONIO.MOEDAINDICE ou ISALDOCALCULOPATRIMONIOMOEDA.MOEDAINDICE
              * AnnualRateCurrencyDepreciation : ITAXADEPRECIACAO.VALOR
              * BalanceDepreciation: ICALCULOPATRIMONIO. DEPRECIACAOACUMULADACORRIGIDA ou ISALDOCALCULOPATRIMONIOMOEDA. DEPRECIACAOACUMULADACORRIGIDA
    * Exclusão: Serão enviados somente os dados da chave do Ativo, sendo desconsiderados todos os outros campos.

  • A alteração e a exclusão de ativos são executadas via processo, assim sendo, caso haja algum erro na integração a operação executada não será desfeita, sendo necessário seguir o seguinte processo:
    * Analisar a mensagem de erro obtida
    * Corrigir a origem do problema
    * Reencaminhar a mensagem de integração
    * Caso o erro não seja sanado deve-se fazer os ajustes de forma manual

  • 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:
    * Código: 001
    * Descrição: “Default Integração”
    * Classe de conta: Analítica
    * Condição normal: Credora

  • No processo de Transferência de Controle (filial e centro de custo) é necessário cadastrar no PROTHEUS cotação de moeda para a moeda utilizada na data de transferência. Caso não exista cotação de moeda na data de transferência, podem ser apresentadas as seguintes mensagens de erro: “HELP: AF010JABAI” ou “HELP: AF060NOTXA”.
  • O campo “N1_CHAPA” da tabela de Ativos do PROTHEUS deve ter seu tamanho alterado para 30 caracteres para ficar compatível com o RM.

Cadastro de Turno

Identificador da Mensagem: ShiftWork
Versão: 1.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono

 

Cadastro de Cargo

  • enviados para o PROTHEUS somente os Produtos/Serviços de Último Nível (Caso o controle de nível de máscara esteja habilitado nos parâmetros de Tabelas | Produtos no RM).

  • Caso a integração esteja ativa, não será permitido o cadastramento de produtos controlados por lote e série, devendo ser selecionada somente uma das opções.
  • Produtos globais no BackOffice RM não serão considerados globais no sistema de destino, sendo enviada uma mensagem de inclusão para cada empresa a qual o produto faz parte.
    * Caso haja ao menos uma mensagem enviada com sucesso ao SigaMNT, mesmo havendo erro nas mensagens referentes ao produto para as outras coligadas, não será apresentada mensagem de erro e a alteração/inclusão não será desfeita.

  • Não serão enviadas informações de Cliente/Fornecedor do Produto.
  • O campo B1_CODITE no cadastro de Produtos do PROTHEUS deve ser alterado, via apsdu, para não obrigatório e também deve-se retirar sua validação.
  • O campo “Código do Produto” no PROTHEUS deve ser alterado para tamanho 30 caracteres para manter compatibilidade com o RM.

 

Cadastro de Cliente/Fornecedor

Identificador da Mensagem: CustomerVendor
Versão: 2.002
Mandatário: BackOffice RM
Tipo de Envio: Síncrono

Notas

  • Ao iniciar uma base zerada do Protheus, para incluir a tabela de Municípios no Protheus é necessário acessar o Protheus no sistema 09 - Livros Fiscais. Se não acessar o sistema Fiscal do Protheus antes de enviar o cadastro do RM irá apresentar mensagem de inconsistência informando que é valor inválido para o campo Município.

  • Uma vez que o Cliente e Fornecedor são tratados na mesma mensagem (CustomerVendor), é responsabilidade do destinatário ao processar a mensagem garantir a consistência dos dados na origem e no destino da melhor forma possível.Ou seja, se o destino implementa uma única tabela, terá que manipular apenas um registro e se implementa mais de uma tabela, terá que manipular quantos registros forem necessários.

  • Para regras de negócio desta mensagem atenção ao seguinte ponto de atenção.
  • Mesmo que a empresa não utilize Cliente/Fornecedor global no RM, deve-se compartilhar a tabela referente no Protheus por empresa.
  • No Protheus o código do cliente/fornecedor será composto pelo código do cliente/fornecedor e da coligada, conforme a mascara “[CODCOLIGADA]|[CODCFO]”.

 

Cadastro de Ativo Fixo

Identificador da Mensagem: Assets
Versão: 1.001Identificador da Mensagem: EmployeePosition
Versão: 1.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono

 

Cadastro de Função

Identificador da Mensagem: Role
Versão: 1.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono

 

Cadastro de Funcionário

Identificador da Mensagem: Employee
Versão: 2.001
Mandatário: BackOffice RM
Tipo de Envio: Síncrono

Notas:

  • 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.
  • O cadastro de centros de custo do Labore (tabela PCCUSTO) deve trabalhar conforme o processo “Sincronização Centro de Custo Global”, que mantém o cadastro da tabela PCCUSTO espelhada com a tabela de centro de custo global (“GCCUSTO”).
  • 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:
    * Banco / Agência / Conta com códigos: 001 / 00000 / 0000000000
  • A exclusão de funcionário é executada via processo, assim sendo, caso haja algum erro na integração a exclusão não será desfeita, sendo necessário seguir o seguinte processo:
    * Analisar a mensagem de erro obtida
    * Corrigir a origem do problema
    * Reencaminhar a mensagem de integração
    * Caso o erro não seja sanado deve-se fazer a exclusão de forma manual

  • Para que a exclusão seja efetuada com sucesso no Protheus é necessário executar o update “RHUPDMOD” no mesmo para normalizar a base de dados para integração.
  • Serão integrados somente funcionários cujo Tipo de Recebimento for igual à Mensalista ou Semanalista.
  • O rateio de funcionário por centro de custos não será integrado, pois o mesmo não é utilizado pelo sistema SigaMNT.
  • Caso a chapa do funcionário no RM seja maior que 6 caracteres, este campo no PROTHEUS deve ser configurado como autoincremento.

 

Cadastro de Local de Estoque

Identificador da Mensagem: Warehouse
Versão: 1.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono

Notas:

...

Notas

  • Serão integrados somente ativos do tipo “Patrimônio”. Assim sendo, qualquer ativo dos tipos “Título” ou “Terceiros” será desconsiderado e não disparará o gatilho de integração.

  • Não será integrado o histórico de valores do ativo fixo na seção “ListOfSalesAndValuesAssets” da mensagem, sendo o código de integração enviado sempre com o sufixo “1”. Estes dados do patrimônio serão enviados respeitando a seguinte regra:
    * Inclusão: Serão enviados os dados informados na tela de inclusão.
              * DepreciationStartDate : Valor calculado pela função PatPatrimonioService. RetornaDataInicioVigencia(CodColigada, DataAquisicao)
              * OriginalValueCurrency : IPatrimonio . AQUISICAO
              * CurrencyCode e CurrencyInternalId : Código da moeda padrão do sistema
              * AnnualRateCurrencyDepreciation : IPatrimonio .VRTAXADEPRECIACAO
              * BalanceDepreciation: Fixo 0.
    * Alteração: Serão enviados os dados atuais do ativo em uma única linha, desconsiderando as movimentações anteriores não integradas.
              * DepreciationStartDate : ICALCULOPATRIMONIO.DATAINICIOVIGENCIA
              * OriginalValueCurrency : ICALCULOPATRIMONIO.VALORBASECORRIGIDO ou ISALDOCALCULOPATRIMONIOMOEDA. VALORBASECORRIGIDO
              * CurrencyCode e CurrencyInternalId : ICALCULOPATRIMONIO.MOEDAINDICE ou ISALDOCALCULOPATRIMONIOMOEDA.MOEDAINDICE
              * AnnualRateCurrencyDepreciation : ITAXADEPRECIACAO.VALOR
              * BalanceDepreciation: ICALCULOPATRIMONIO. DEPRECIACAOACUMULADACORRIGIDA ou ISALDOCALCULOPATRIMONIOMOEDA. DEPRECIACAOACUMULADACORRIGIDA
    * Exclusão: Serão enviados somente os dados da chave do Ativo, sendo desconsiderados todos os outros campos.

  • A alteração e a exclusão de ativos são executadas via processo, assim sendo, caso haja algum erro na integração a operação executada não será desfeita, sendo necessário seguir o seguinte processo:
    * Analisar a mensagem de erro obtida
    * Corrigir a origem do problema
    * Reencaminhar a mensagem de integração
    * Caso o erro não seja sanado deve-se fazer os ajustes de forma manual

  • 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:
    * Código: 001
    * Descrição: “Default Integração”
    * Classe de conta: Analítica
    * Condição normal: Credora

  • No processo de Transferência de Controle (filial e centro de custo) é necessário cadastrar no PROTHEUS cotação de moeda para a moeda utilizada na data de transferência. Caso não exista cotação de moeda na data de transferência, podem ser apresentadas as seguintes mensagens de erro: “HELP: AF010JABAI” ou “HELP: AF060NOTXA”.
  • O campo “N1_CHAPA” da tabela de Ativos do PROTHEUS deve ter seu tamanho alterado para 30 caracteres para ficar compatível com o RM.


Cadastro de Turno

Identificador da Mensagem: ShiftWork
Versão: 1.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono

 

Cadastro de Cargo

Identificador da Mensagem: EmployeePosition
Versão: 1.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono

 

Cadastro de Função

Identificador da Mensagem: Role
Versão: 1.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono

 

Cadastro de Funcionário

Identificador da Mensagem: Employee
Versão: 2.001
Mandatário: BackOffice RM
Tipo de Envio: Síncrono

Notas:

  • 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.
  • O cadastro de centros de custo do Labore (tabela PCCUSTO) deve trabalhar conforme o processo “Sincronização Centro de Custo Global”, que mantém o cadastro da tabela PCCUSTO espelhada com a tabela de centro de custo global (“GCCUSTO”).
  • 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:
    * Banco / Agência / Conta com códigos: 001 / 00000 / 0000000000
  • A exclusão de funcionário é executada via processo, assim sendo, caso haja algum erro na integração a exclusão não será desfeita, sendo necessário seguir o seguinte processo:
    * Analisar a mensagem de erro obtida
    * Corrigir a origem do problema
    * Reencaminhar a mensagem de integração
    * Caso o erro não seja sanado deve-se fazer a exclusão de forma manual

  • Para que a exclusão seja efetuada com sucesso no Protheus é necessário executar o update “RHUPDMOD” no mesmo para normalizar a base de dados para integração.
  • Serão integrados somente funcionários cujo Tipo de Recebimento for igual à Mensalista ou Semanalista.
  • O rateio de funcionário por centro de custos não será integrado, pois o mesmo não é utilizado pelo sistema SigaMNT.
  • Caso a chapa do funcionário no RM seja maior que 6 caracteres, este campo no PROTHEUS deve ser configurado como autoincremento.

 

Cadastro de Local de Estoque

Identificador da Mensagem: Warehouse
Versão: 1.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono

Notas:

  • Caso o código do Local de Estoque no RM seja maior que 2 (dois) caracteres, no PROTHEUS o código do local de estoque deverá ser autoincremento.

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
Especificações BackOffice RM:

Notas:

  • As mensagens de solicitação de compra ou armazém enviadas ao BackOffice RM serão originadas no SigaMNT ao se cadastrar insumos como previstos, respeitando as devidas regras de negócio implementadas no SigaMNT. O fluxo das ordens de serviço, que inicia o fluxo das solicitações, é descrito no anexo Fluxo da ordem de serviço no SigaMNT.

        Ciclo de vida das solicitações:

  • Solicitação de compra:
    A solicitação de compra segue o processo padrão definido pelo TOTVS Gestão de Estoque, Compras e Fatuarmento, podendo passar pelo processo de cotação ou não, sendo que a baixa de estoque referente aos produtos comprados deve ser inserida no BackOffice via cópia por referência para o movimento de OS com o tipo de relacionamento “Cópia Simples com Relacionamento somente de movimento”.
  • Solicitação de armazém (estoque):
    A solicitação de armazém segue o processo padrão definido pelo TOTVS Gestão de Estoque, Compras e Fatuarmento, sendo que a baixa de estoque destas solicitações devem ser efetuadas através do processo de faturamento disponibilizado em tela e com o tipo de movimento parametrizado como sendo de Baixa de Estoque para o SigaMNT.
    Caso o faturamento não seja feito por tela ou não utilize o tipo de movimento parametrizado como sendo de Baixa de Estoque para o SigaMNT a Fórmula Visual NÃO será disparada, assim o SigaMNT não será informado da mesma.

 

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:

  • Disponível a partir da versão da biblioteca 12.1.15.160.

 

Cancelar Solicitação

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 CancelRequest
Versão: 1.000
Especificações BackOffice RM:

Notas:

  • As mensagens No caso de solicitação de compra ou armazém enviadas ao BackOffice RM serão originadas no SigaMNT ao se cadastrar insumos como previstos, respeitando as devidas regras de negócio implementadas no SigaMNT. O fluxo das ordens de serviço, que inicia o fluxo das solicitações, é descrito no anexo Fluxo da ordem de serviço no SigaMNT.

        Ciclo de vida das solicitações:

  • Solicitação de compra:
    A solicitação de compra segue o processo padrão definido pelo TOTVS Gestão de Estoque, Compras e Fatuarmento, podendo passar pelo processo de cotação ou não, sendo que a baixa de estoque referente aos produtos comprados deve ser inserida no BackOffice via cópia por referência para o movimento de OS com o tipo de relacionamento “Cópia Simples com Relacionamento somente de movimento”.
  • Solicitação de armazém (estoque):
    A solicitação de armazém segue o processo padrão definido pelo TOTVS Gestão de Estoque, Compras e Fatuarmento, sendo que a baixa de estoque destas solicitações devem ser efetuadas através do processo de faturamento disponibilizado em tela e com o tipo de movimento parametrizado como sendo de Baixa de Estoque para o SigaMNT.
    Caso o faturamento não seja feito por tela ou não utilize o tipo de movimento parametrizado como sendo de Baixa de Estoque para o SigaMNT a Fórmula Visual NÃO será disparada, assim o SigaMNT não será informado da mesma.

 

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:

  • Disponível a partir da versão da biblioteca 12.1.15.160.

 

Cancelar Solicitação de Armazém/Compra

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

Notas:

  • No caso de alteração de insumos, logo após este fluxo deve ser executado o de inclusão da nova solicitação no BackOffice, conforme definido no item Solicitações de Armazém/Compra.
  • A partir da versão da biblioteca 12.1.15.160 existe a mensagem TRANCEABILITYREQUEST onde o Protheus consulta o STATUS da SC/SA no RM, caso a mesma esteja em um Status que não é possível excluir o RM retorna ao Protheus a informação que não pode excluir esta SC/SA e caso seja apenas a inclusão de um novo item o ERP cria um novo movimento de SC/SA sem alterar o movimento antigo.

 

  • alteração de insumos, logo após este fluxo deve ser executado o de inclusão da nova solicitação no BackOffice, conforme definido no item Solicitações de Armazém/Compra.
  • A partir da versão da biblioteca 12.1.15.160 existe a mensagem TRANCEABILITYREQUEST onde o Protheus consulta o STATUS da SC/SA no RM, caso a mesma esteja em um Status que não é possível excluir o RM retorna ao Protheus a informação que não pode excluir esta SC/SA e caso seja apenas a inclusão de um novo item o ERP cria um novo movimento de SC/SA sem alterar o movimento antigo.

 

Ordem de Serviço

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

  • 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”.

  • A mensagem de envio NÃO deve ser considerada como de inclusão ou alteração de dados da OS além do status, pois desta forma seria requerido algumas informações que não são da alçada do BackOffice e o mesmo não detém.
  • Na mensagem enviada consta somente os dados necessários para identificação da OS e o novo Status, não devendo assim alterar nenhuma outra informação, como custos ou insumos.

    Protheus -> RM
    A mensagem de ordem de serviço será enviada ao BackOffice RM pelo SigaMNT nas seguintes circunstâncias:

  • Ao cadastrar uma ordem de serviço com status “Liberada”.
  • Ao efetuar a liberação de uma ordem de serviço.
  • Ao finalizar uma ordem de serviço.
  • Na reabertura da ordem de serviço.

 

Cancelar Ordem de Serviço

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

 

Baixa de estoqueOrdem de Serviço

Tipo de Fluxo: RM -> Protheus e Protheus -> RM
Mensagem: MaintenanceOrder StockTurnover
Versão: 1.001002
Especificações BackOffice RM:

...

  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”.
  • A mensagem de envio NÃO deve ser considerada como de inclusão ou alteração de dados da OS além do status, pois desta forma seria requerido algumas informações que não são da alçada do BackOffice e o mesmo não detém.
  • Na mensagem enviada consta somente os dados necessários para identificação da OS e o novo Status, não devendo assim alterar nenhuma outra informação, como custos ou insumos.
    Protheus -> RM
    A mensagem de ordem de serviço será enviada ao BackOffice RM pelo SigaMNT nas seguintes circunstâncias:
  • Ao cadastrar uma ordem de serviço com status “Liberada”.
  • Ao efetuar a liberação de uma ordem de serviço.
  • Ao finalizar uma ordem de serviço.
  • Na reabertura da ordem de serviço.

 

  • integração da baixa de estoque para o SigaMNT ocorre ao efetuar a baixa de estoque no BackOffice informando a OS da mesma, utilizando tipo de movimento configurado para gerar integração com sistema de manutenção.
    O Movimento de baixa de estoque pode ser criado através de Copia por Referência ou Faturamento. É necessário selecionar algum dos movimentos que esteja relacionado com a OS.

    Protheus -> RM
  • A integração da baixa de estoque para o BackOffice ocorre na inserção de insumos realizados em uma OS no SigaMNT, tanto para a inclusão de insumos novos como na realização de insumos previstos.

 

Cancelar Baixa de Estoque

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

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 CustosCancelar Ordem de Serviço

Tipo de Fluxo: Protheus -> RM
Mensagem: CancelMaintenanceOrder StockLevel
Versão: 1.000001
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

 

Baixa Apropriação de estoqueCustos

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

  RM -> Protheus

...

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

  • Ao finalizar uma ordem de serviço (manutenção), caso esteja parametrizado para tal, o SigaMNT enviará ao BackOffice a mensagem de apropriação com todos os custos da mesma, fazendo com que este movimento aproprie automaticamente os custos da OS aos respectivos projeto e tarefa.
  • Será disponibilizado no SigaMNT o serviço de apropriação de custo de utilização de equipamento no BackOffice RM, para que os custos possam ser apropriados ao projeto e tarefa em que o equipamento está alocado.

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

  • Parametrização do cronograma no TOP.
  • Parametrização da integração TOP x TOTVS Gestão de Estoque, Compras e Faturamento.

Notas:

  • No caso de alteração de insumos, logo após este fluxo deve ser executado o de inclusão da nova baixa no BackOffice, conforme definido no item Baixa de Estoque.
  • O parâmetro “TMVApropriacao” deverá te seu valor atualizado com o código do tipo de movimento de Apropriação de Custos específico da integração.
    * Quando as integrações TOP com NG e BackOffice RM com NG estiverem habilitadas, o movimento inserido pela integração “BackOffice RM x NG” não deverá apropriar custos no TOTVS Obras e Projetos, pois para não existir duplicação de informações a apropriação deverá ser gerada pela integração TOP com NG. Sendo assim o tipo de movimento de Apropriação de Custos deve ser configurado para Não Gerar Apropriação, ou seja, o parâmetro Gera Apropriação da etapa Projeto do Tipo de Movimento deve estar desmarcado.

 

Ampliação Patrimonial

  • A integração da baixa de estoque para o BackOffice ocorre na inserção de insumos realizados em uma OS no SigaMNT, tanto para a inclusão de insumos novos como na realização de insumos previstos.

 

Cancelar Baixa de Estoque

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

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 AssetsValuation
Versão: 1.001000
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

 

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

  • Ao finalizar uma ordem de serviço (manutenção), caso esteja parametrizado para tal, o SigaMNT enviará ao BackOffice a mensagem de apropriação com todos os custos da mesma, fazendo com que este movimento aproprie automaticamente os custos da OS aos respectivos projeto e tarefa.
  • Será disponibilizado no SigaMNT o serviço de apropriação de custo de utilização de equipamento no BackOffice RM, para que os custos possam ser apropriados ao projeto e tarefa em que o equipamento está alocado.

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

  • Parametrização do cronograma no TOP.
  • Parametrização da integração TOP x TOTVS Gestão de Estoque, Compras e Faturamento.

Notas:

  • No caso de alteração de insumos, logo após este fluxo deve ser executado o de inclusão da nova baixa no BackOffice, conforme definido no item Baixa de Estoque.
  • O parâmetro “TMVApropriacao” deverá te seu valor atualizado com o código do tipo de movimento de Apropriação de Custos específico da integração.
    * Quando as integrações TOP com NG e BackOffice RM com NG estiverem habilitadas, o movimento inserido pela integração “BackOffice RM x NG” não deverá apropriar custos no TOTVS Obras e Projetos, pois para não existir duplicação de informações a apropriação deverá ser gerada pela integração TOP com NG. Sendo assim o tipo de movimento de Apropriação de Custos deve ser configurado para Não Gerar Apropriação, ou seja, o parâmetro Gera Apropriação da etapa Projeto do Tipo de Movimento deve estar desmarcado.

 

 StockTurnover
Versão: 1.000
Especificações BackOffice RM:

 

Controle de Abastecimento

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

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 PneusAmpliação Patrimonial

Tipo de Fluxo: Protheus -> RM
Mensagem:

...

 StockTurnover
Versão: 1.

...

002
Especificações

...

Backffice 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 pneusTipo de Fluxo: RM -> Protheus e Protheus -> RM
Mensagem: MaintenanceOrder
Versão: 1.000
Especificações Backffice RM:

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

 

Controle de Abastecimento

Tipo de Fluxo: Protheus -> RM
Mensagem: StockTurnover CancelRequest
Versão: 1.002000
Especificações BackOffice Backffice RM:

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

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

 Gestão de Documentos

Transferência de Pneu

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

Tipo de Fluxo: RM Protheus -> ProtheusRM
Mensagem: InfoOfParcelValues StockLevel
Versão: 1.000001
Especificações BackOffice Backffice RM:

 

Gestão Ordem de MultasServiço Terceiros

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

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

  RM -> Protheus

...

 

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

...

   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”.

  • A mensagem de envio NÃO deve ser considerada como de inclusão ou alteração de dados da OS além do status, pois desta forma seria requerido algumas informações que não são da alçada do BackOffice e o mesmo não detém.
  • Na mensagem enviada consta somente os dados necessários para identificação da OS e o novo Status, não devendo assim alterar nenhuma outra informação, como custos ou insumos.

    Protheus -> RM
    A mensagem de ordem de serviço será enviada ao BackOffice RM pelo SigaMNT nas seguintes circunstâncias:
  • Ao cadastrar uma ordem de serviço corretiva com status “Liberada”.
  • Ao efetuar a liberação de uma ordem de serviço corretiva.
  • Ao finalizar uma ordem de serviço.
  • Na reabertura da ordem de serviço.

 

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
Especificações Backffice RM:

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

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

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

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
Especificações Backffice RM:

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
Especificações Backffice RM:

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”.

...

  • Ao cadastrar uma ordem de serviço corretiva com status “Liberada”.
  • Ao efetuar a liberação de uma ordem de serviço corretiva.
  • Ao finalizar uma ordem de serviço.
  • Na reabertura da ordem de serviço.

 

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
Especificações Backffice RM:

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:

  • Identificar o funcionamento da integração;
  • Identificar a ocorrências de problemas;
  • Coletar evidências do mau funcionamento relatado pelo cliente;
  • Realizar possíveis ajustes na integração quanto à configuração ou negócio.

Anexos

...

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

...

 

...

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

Image Removed

Image Removed

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)

Image Removed

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)

Image Removed

...

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).

 

...

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

...


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:

  • Identificar o funcionamento da integração;
  • Identificar a ocorrências de problemas;
  • Coletar evidências do mau funcionamento relatado pelo cliente;
  • Realizar possíveis ajustes na integração quanto à configuração ou negócio.

Anexos

 
Âncora
Configuração da Integração
Configuração da Integração
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.
    Image Added

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

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

  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.
    Image AddedImage Added

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

    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.
    Image Added

    5.2 Informe os Códigos dos Tipos de Movimento criado anteriormente para cada um dos processos que será utilizado.
    Image Added
    Observação: Este é apenas um exemplo, deve-se informar o Valor com o Código do Tipo de Movimento criado no ambiente do cliente.

 

Âncora
Cadastrar De-Para
Cadastrar De-Para
 Cadastrar De-Para de Empresas e Filiais

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

Image Added

Image Added

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)

Image Added

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)

Image Added


Âncora
Importação de Fórmulas Visuais
Importação de Fórmulas Visuais
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).

 

Âncora
Execução de Fórmulas Visuais
Execução de Fórmulas Visuais
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"
    Image Added

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

  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).
    Image Added 
    Image Added

 

Âncora
De-para das Unidades de Medida
De-para das Unidades de Medida
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
    Image Added

  2. Incluir um novo Registro de acordo com os dados abaixo
    Image Added
    Exemplo:
    Image Added
    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
    Image Added

  4. Incluir um novo Registro de acordo com os dados abaixo
    Image Added
    Exemplo:
    Image Added
    Observação: Alguns dados podem alterar de acordo com o código da empresa, nível de gestão e etc.

 

Âncora
Cadastrar os valores defaults para Plano de Contas
Cadastrar os valores defaults para Plano de Contas
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:

  •  Código: 001
  • Descrição: “Default Integração”
  • Classe de conta: Analítica
  • Condição normal: Credora

  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).
    Image Added

 

Âncora
Cadastrar os valores defaults para Banco, Agência e Conta
Cadastrar os valores defaults para Banco, Agência e Conta
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:

  • Banco: 001
  • Agência: 00000
  • Conta com códigos: 0000000000

 

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

 

 

Âncora
Verificar Centro de Custo associado ao Funcionário
Verificar Centro de Custo associado ao Funcionário
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
    Image Added

  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
    Image Added

 

...

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).

...

 

...

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).
    Image Removed

...