Versões comparadas

Chave

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

...

  • O compartilhamento de tabelas deve ser coerente com a forma como o BackOffice RM trabalha, conforme descrita no documento de configuração.

  • Configurar os adapters utilizados na integração TOTVS Manutenção de Ativos x BackOffice RM, conforme detalhado em Configurações Adapter 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

...

Configurar a utilização do Web Service

...

Manual de Configuração do WS do Host

...

Ativação da Integração

...

Anexo Configuração da Integração

...

Preparação/Carga da Base de Dados

...

Controle de Versão

O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definida pelo Comitê de Integração TOTVS.

Suporte

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos BackOffice RM,  Backoffice Protheus e SigaMNT estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.

Escopo

O escopo deste projeto se restringe aos processos de integração com o SigaMNT Protheus e os cadastros utilizados por estes.

Todos os processamentos de BackOffice se manterão no RM, sendo eles a geração de escrituração, relatórios, emissão de notas fiscais e outros.

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 Mensagem

Cadastros






01Cliente/FornecedorRMProtheusCustomerVendor2.002

02

Moeda

RM

Protheus

Currency

2.001
03Unidade de MedidaRMProtheusUnitOfMeasure2.000
04ProdutoRMProtheusItem

4.005

05

Centro de Custo

RM

Protheus

CostCenter

2.000
06Ativo FixoRMProtheusAssets1.001
07Transferência de Ativo FixoRMProtheusAssets1.001
08Exclusão de Ativo FixoRMProtheusAssets1.001
09ProjetoRMProtheusProject2.000
10ObraRMProtheusSubProject2.000
11TarefaRMProtheusTaskProject2.000
12EtapaRMProtheusStepProject2.000

13

Condição de Pagamento

RM

Protheus

PaymentCondition

2.000
14Local de EstoqueRMProtheusWarehouse1.000

Processos

20

Solicitações (SA e SC)

Protheus

RM

Request

1.010

21Cancelamento de SA/SCProtheusRMCancelRequest1.000

22

Ordem de Serviço

Protheus

RM

MaintenanceOrder

1.002

23Finalizar OSProtheusRMMaintenanceOrder

1.002

24Faturar OSRMProtheusMaintenanceOrder

1.002

25Cancelamento de OSProtheusRMCancelMaintenanceOrder1.000
26Baixa de estoqueProtheusRMStockTurnover

1.006

27Baixa de EstoqueRMProtheusStockTurnover

1.006

28Cancelar Baixa de EstoqueProtheusRMCancelRequest1.000
29Consulta Saldos e CustosProtheusRMStockLevel1.001
30Apropriação de CustosProtheusRMAppointmentCost1.000
31Ampliação PatrimonialProtheusRMAssetsValuation1.000
32Análise técnica de pneusProtheusRMStockTurnover

1.006

33Controle de AbastecimentoProtheusRMStockLevel1.001
34Controle de AbastecimentoProtheusRMStockTurnover

1.006

35Controle de AbastecimentoProtheusRMOrder3.002
36Gestão de DocumentosProtheusRMOrder3.002
37Informação de ParcelasRMProtheusInfoOfParcelValues1.000
38Gestão de MultasProtheusRMOrder3.002
39Honorários de DespachanteProtheusRMOrder3.002
40Ordem de Serviço de PneusProtheusRMMaintenanceOrder

1.002

41Transferência de PneusProtheusRMStockTurnover

1.006

42Ordem de Serviço TerceirosProtheusRMMaintenanceOrder

1.002


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.001
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/VNb0E

Notas

Expandir
titleClique aqui para expandir

As Moedas devem ser cadastrados somente no BackOffice RM e sincronizados automaticamente para o Protheus através de mensagem única Currency. 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.


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/DYcpE

Notas

Expandir
titleClique aqui para expandir

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
Mapeamento de Campos: http://tdn.totvs.com/x/w9b0E

Notas

Expandir
titleClique aqui para expandir

Os Centros de Custo devem ser cadastrados somente no BackOffice RM e sincronizados automaticamente para o Protheus através de mensagem única CosCenter. 

Para manter a compatibilidade entre os sistemas, os campos Centro de Custo e Código Reduzido do Centro de Custo no Protheus deve ser alterado para tamanho de 25 caracteres, uma vez que no RM estes campos permitem até 25 caracteres.


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

Expandir
titleClique aqui para expandir

As Condições de pagamento devem ser cadastradas somente no BackOffice RM e sincronizados automaticamente para o Protheus através de mensagem única PaymentCondition. 

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 auto-incremento.


Cadastro de Produto/Serviço

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

Notas

Expandir
titleClique aqui para expandir

Os Produtos/Serviços devem cadastrados somente no BackOffice RM e sincronizados automaticamente para o Protheus através de mensagem única Item. 

As regras referente à esta entidade pode ser conferida no documento de Integração de Produto/Serviço


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

Expandir
titleClique aqui para expandir

Os Clientes e Fornecedores devem ser cadastrados no BackOffice RM e sincronizados automaticamente para o Protheus através da mensagem única CustomerVendor.

Ao iniciar uma base vazia (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), ao cadastrar um registro do tipo Ambos no RM é gerado no Protheus um registro em cada tabela, SA1 (Clientes) e SA2 (Fornecedor).

Mesmo que a empresa não utilize Cliente/Fornecedor global no RM, deve-se compartilhar a tabela referente no Protheus por empresa.


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

Expandir
titleClique aqui para expandir

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). Esta função considera a Data de Aquisição como Data Início Vigência. Há variações se os parâmetros abaixo estiverem marcado:

             - DTINICIODEPRECPROXANO: Adiciona um ano com base no ano cálculo definido na parametrização e fixa o mês e o dia em 01;

             - DTINICIODEPRECPROXANO e Dia da Data de Aquisição maior que 01: Adiciona um mês na Data Aquisição e fixa o dia em 01;

             - DATASEMPRE1DIAMESAPOSAQUIS: Adiciona um mês na Data Aquisição e fixa o dia em 01.
          * OriginalValueCurrency : IPatrimonio.AQUISICAO
          * CurrencyCode e CurrencyInternalId: Código da moeda padrão do sistema (Definido em Ambientes | Parâmetros Globais | Gerais | Símbolo da Moeda);
          * 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 para o IDCENARIOCALCULO = 1
          * OriginalValueCurrency: ICALCULORAZAO.VALORBASECORRIGIDO (considera apenas o último valor calculado) ou ISALDOCALCULOPATRIMONIOMOEDA. VALORBASECORRIGIDO para o IDCENARIOCALCULO = 1
          * CurrencyCode e CurrencyInternalId: ICALCULORAZAO.MOEDAINDICE ou ISALDOCALCULOPATRIMONIOMOEDA.MOEDAINDICE
          * AnnualRateCurrencyDepreciation: ITAXADEPRECIACAO.VALOR
          * BalanceDepreciation: ICALCULORAZAO. DEPRECIACAOACUMULADACORRIGIDA (considera apenas o último valor calculado) ou ISALDOCALCULOPATRIMONIOMOEDA. DEPRECIACAOACUMULADACORRIGIDA
Exclusão: Serão enviados somente os dados da chave do Ativo, sendo desconsiderados todos os outros campos. Não será possível excluir mais de um registro integrado quando a entidade ASSETS estiver mapeada no cadastro de Rotas e a integração estiver ativa. Caso necessário, a exclusão deverá ser feita por registro.

Para integrar esta entidade, o PROTHEUS exige que seja cadastro um valor default para o Plano de Contas em sua base (para cada filial), com os seguintes parâmetros (No Módulo SigaADV| Cadastros | Planos de Contas):
* 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 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/kkstE

Notas:

Expandir
titleClique aqui para expandir

Caso o código do Local de Estoque no RM seja maior que 6 (seis) caracteres, no Protheus o código do local de estoque deverá ser auto-incremento.

Por padrão, o tamanho máximo da descrição do local de estoque no Protheus é de 20 caracteres.


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:

Expandir
titleClique aqui para expandir

Os Projetos devem ser cadastrados somente no RM e sincronizados automaticamente para o Protheus através da mensagem única Project.

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 Integração de Projeto.

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 se o Protheus deve ser configurado como auto-incremento.


Cadastro de Obra

Identificador da Mensagem: SubProject
Versão: 2

...

Controle de Versão

O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definida pelo Comitê de Integração TOTVS.

Suporte

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos BackOffice RM,  Backoffice Protheus e SigaMNT estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.

Escopo

O escopo deste projeto se restringe aos processos de integração com o SigaMNT Protheus e os cadastros utilizados por estes.

Todos os processamentos de BackOffice se manterão no RM, sendo eles a geração de escrituração, relatórios, emissão de notas fiscais e outros.

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

...

Cadastros

...

02

...

Moeda

...

RM

...

Protheus

...

Currency

...

4.005

...

05

...

Centro de Custo

...

RM

...

Protheus

...

CostCenter

...

13

...

Condição de Pagamento

...

RM

...

Protheus

...

PaymentCondition

...

Processos

...

20

...

Solicitações (SA e SC)

...

Protheus

...

RM

...

Request

...

1.010

...

22

...

Ordem de Serviço

...

Protheus

...

RM

...

MaintenanceOrder

...

1.002

...

1.002

...

1.002

...

1.006

...

1.006

...

1.006

...

1.006

...

1.002

...

1.006

...

1.002

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.001
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/VNb0E

Notas

Expandir
titleClique aqui para expandir

As Moedas devem ser cadastrados somente no BackOffice RM e sincronizados automaticamente para o Protheus através de mensagem única Currency. 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.

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/DYcpE

Notas

Expandir
titleClique aqui para expandir

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
Mapeamento de Campos: http://tdn.totvs.com/x/w9b0E

Notas

Expandir
titleClique aqui para expandir

Os Centros de Custo devem ser cadastrados somente no BackOffice RM e sincronizados automaticamente para o Protheus através de mensagem única CosCenter. 

Para manter a compatibilidade entre os sistemas, os campos Centro de Custo e Código Reduzido do Centro de Custo no Protheus deve ser alterado para tamanho de 25 caracteres, uma vez que no RM estes campos permitem até 25 caracteres.

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

Expandir
titleClique aqui para expandir

As Condições de pagamento devem ser cadastradas somente no BackOffice RM e sincronizados automaticamente para o Protheus através de mensagem única PaymentCondition. 

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 auto-incremento.

Cadastro de Produto/Serviço

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

Notas

Expandir
titleClique aqui para expandir

Os Produtos/Serviços devem cadastrados somente no BackOffice RM e sincronizados automaticamente para o Protheus através de mensagem única Item. 

As regras referente à esta entidade pode ser conferida no documento de Integração de Produto/Serviço

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

Expandir
titleClique aqui para expandir

Os Clientes e Fornecedores devem ser cadastrados no BackOffice RM e sincronizados automaticamente para o Protheus através da mensagem única CustomerVendor.

Ao iniciar uma base vazia (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), ao cadastrar um registro do tipo Ambos no RM é gerado no Protheus um registro em cada tabela, SA1 (Clientes) e SA2 (Fornecedor).

Mesmo que a empresa não utilize Cliente/Fornecedor global no RM, deve-se compartilhar a tabela referente no Protheus por empresa.

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

Expandir
titleClique aqui para expandir

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). Esta função considera a Data de Aquisição como Data Início Vigência. Há variações se os parâmetros abaixo estiverem marcado:

             - DTINICIODEPRECPROXANO: Adiciona um ano com base no ano cálculo definido na parametrização e fixa o mês e o dia em 01;

             - DTINICIODEPRECPROXANO e Dia da Data de Aquisição maior que 01: Adiciona um mês na Data Aquisição e fixa o dia em 01;

             - DATASEMPRE1DIAMESAPOSAQUIS: Adiciona um mês na Data Aquisição e fixa o dia em 01.
          * OriginalValueCurrency : IPatrimonio.AQUISICAO
          * CurrencyCode e CurrencyInternalId: Código da moeda padrão do sistema (Definido em Ambientes | Parâmetros Globais | Gerais | Símbolo da Moeda);
          * 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 para o IDCENARIOCALCULO = 1
          * OriginalValueCurrency: ICALCULORAZAO.VALORBASECORRIGIDO (considera apenas o último valor calculado) ou ISALDOCALCULOPATRIMONIOMOEDA. VALORBASECORRIGIDO para o IDCENARIOCALCULO = 1
          * CurrencyCode e CurrencyInternalId: ICALCULORAZAO.MOEDAINDICE ou ISALDOCALCULOPATRIMONIOMOEDA.MOEDAINDICE
          * AnnualRateCurrencyDepreciation: ITAXADEPRECIACAO.VALOR
          * BalanceDepreciation: ICALCULORAZAO. DEPRECIACAOACUMULADACORRIGIDA (considera apenas o último valor calculado) ou ISALDOCALCULOPATRIMONIOMOEDA. DEPRECIACAOACUMULADACORRIGIDA
Exclusão: Serão enviados somente os dados da chave do Ativo, sendo desconsiderados todos os outros campos. Não será possível excluir mais de um registro integrado quando a entidade ASSETS estiver mapeada no cadastro de Rotas e a integração estiver ativa. Caso necessário, a exclusão deverá ser feita por registro.

Para integrar esta entidade, o PROTHEUS exige que seja cadastro um valor default para o Plano de Contas em sua base (para cada filial), com os seguintes parâmetros (No Módulo SigaADV| Cadastros | Planos de Contas):
* 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 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/kkstEStf0E

Notas:

Expandir
titleClique aqui para expandir

Caso o código do Local de Estoque no RM seja maior que 6 (seis) caracteres, no Protheus o código do local de estoque deverá ser auto-incremento.

Por padrão, o tamanho máximo da descrição do local de estoque no Protheus é de 20 caracteres.

As Obras devem ser cadastradas somente no RM e sincronizados automaticamente para o Protheus através da mensagem única SubProject.

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


Cadastro de TarefaCadastro de Projeto

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

Notas:

Expandir
titleClique aqui para expandir

Os Projetos As Tarefas devem ser cadastrados cadastradas somente no RM e sincronizados automaticamente para o Protheus através da mensagem única Projectúnica TaskProject.

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 Integração de Projeto.

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 se o Protheus deve ser configurado como auto-incremento.

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


Cadastro de EtapaCadastro de Obra

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

Notas:

Expandir
titleClique aqui para expandir

As Obras Etapas do projeto devem ser cadastradas somente no RM e sincronizados automaticamente para o Protheus através da mensagem única SubProjectúnica StepProject.

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

Cadastro de Tarefa

para o tamanho de 60 caracteres, para manter compatibilidade com o RM.

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.010Identificador 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-476E

Notas:

Expandir
titleClique aqui para expandir

As Tarefas devem ser cadastradas somente no RM e sincronizados automaticamente para o Protheus através da mensagem única TaskProject.

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
Mapeamento de Campos: http://tdn.totvs.com/x/udf0E

Notas:

Expandir
titleClique aqui para expandir

As Etapas do projeto devem ser cadastradas somente no RM e sincronizados automaticamente para o Protheus através da mensagem única StepProject.

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

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.

Videos com exemplo dos Processos:

Abertura de O.S. liberada (Clique aqui para acessar o vídeo)
Processo aplicação de Insumo (Clique aqui para acessar o vídeo)
Finalização OS (Clique aqui para acessar o vídeo)
Cancelamento de O.S. (Clique aqui para acessar o vídeo)
Conciliação de Posto Externo (Clique aqui para acessar o vídeo)
Abastecimento Posto Interno (Clique aqui para acessar o vídeo)
Analise Técnica de Pneus (Clique aqui para acessar o vídeo)
Inclusão de O S em Lote Pneus (Clique aqui para acessar o vídeo)
Atendimento S.C. – O.S. Pneus em Lote (Clique aqui para acessar o vídeo)
Movimentação de Pneus (Clique aqui para acessar o vídeo)
Recebimento O.S. em Lote (Clique aqui para acessar o vídeo)
Inclusão de Multas Veículo (Clique aqui para acessar o vídeo)
Pagamento da Multa (Clique aqui para acessar o vídeo)
Inclusão de Documentos Veículos (Clique aqui para acessar o vídeo)
Pagamento do Documento (Faturamento) (Clique aqui para acessar o vídeo)
Inclusão de Honorários Despachantes (Clique aqui para acessar o vídeo)

Manutenção de Ativos

Solicitações de Armazém/Compra

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

Notas:

Expandir
titleClique aqui para expandir

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 Faturamento, 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 Faturamento, 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 não será acionado o gatilho de integração e assim o SigaMNT não será informado da mesma.

Parâmetros de Integração:

Para que os tipos de movimentos de Solicitação de Compra e Solicitação de Armazém sejam recuperados é necessário que o Nome do Parâmetro esteja corretamente informado no cadastro de Parâmetros adapter.

São eles:

  • Solicitação de Compra: TMVSolicitacaoCompra
  • Solicitação de Armazém: TMVSolicitacaoArmazem

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 Faturamento, 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 Faturamento, 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 não será acionado o gatilho de integração e assim o SigaMNT não será informado da mesma.

Parâmetros de Integração:

Para que os tipos de movimentos de Solicitação de Compra e Solicitação de Armazém sejam recuperados é necessário que o Nome do Parâmetro esteja corretamente informado no cadastro de Parâmetros adapter.

São eles:

  • Solicitação de Compra: TMVSolicitacaoCompra
  • Solicitação de Armazém: TMVSolicitacaoArmazem


Consulta Situação da SA/SC

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


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:

Expandir
titleClique aqui para expandir

O processo de Cancelamento de Solicitação de Armazém/Compra no Protheus é realizado ao Cancelar a Ordem de Serviço pela tela de Retorno MOD 2 no SigaMNT. Ao executar esse processo, é enviado a mensagem CancelRequest e logo em seguida a CancelMaintenanceOrder.

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.

A partir da versão 12.1.26.124 se o tipo de movimento de SA estiver parametrizado com a opção "Baixar para Movimento Default" (Etapa Compra/Venda - Outras Características) e a SA for recebida/faturada para um tipo de movimento que não estiver definido no parâmetro "Movimento Gerado (Default)", ao cancelar uma Solicitação de Armazém (a partir do processo de Cancelar Ordem de Serviço no SigaMNT) é consistido a existência de relacionamento entre a SA e o movimento gerado, e não é permitido realizar o cancelamento da SA e da Ordem de Serviço.


Ordem de Serviço

Tipo de Fluxo: RM -> Protheus e Protheus -> RM
Mensagem: MaintenanceOrder
Versão: 1.002
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.

Notas:

Expandir
titleClique aqui para expandir

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çoConsulta Situação da SA/SC

Tipo de Fluxo: Protheus -> RM
Mensagem:  TraceabilityRequestCancelMaintenanceOrder
Versão: 1.001
Especificações BackOffice RM: Consulta situação Solicitação de Armazém/Solicitação de ComprasCancelar Solicitação de Armazém/Compra000
Mapeamento de Campos: http://tdn.totvs.com/x/bpT6E


Baixa de estoque

Tipo de Fluxo: RM -> Protheus e Protheus -> RM
Mensagem: CancelRequestStockTurnover
Versão: 1.000006
Mapeamento de Campos: http://tdn.totvs.com/x/apP6EuJX6E

Notas:

Expandir
titleClique aqui para expandir

O processo de Cancelamento de Solicitação de Armazém/Compra no Protheus é realizado ao Cancelar a Ordem de Serviço pela tela de Retorno MOD 2 no SigaMNT. Ao executar esse processo, é enviado a mensagem CancelRequest e logo em seguida a CancelMaintenanceOrder.

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.

A partir da versão 12.1.26.124 se o tipo de movimento de SA estiver parametrizado com a opção "Baixar para Movimento Default" (Etapa Compra/Venda - Outras Características) e a SA for recebida/faturada para um tipo de movimento que não estiver definido no parâmetro "Movimento Gerado (Default)", ao cancelar uma Solicitação de Armazém (a partir do processo de Cancelar Ordem de Serviço no SigaMNT) é consistido a existência de relacionamento entre a SA e o movimento gerado, e não é permitido realizar o cancelamento da SA e da Ordem de Serviço.

Ordem de Serviço

RM -> Protheus

A 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 (parametrização do tipo de movimento Etapa Manutenção, opção "Integrado com SigaMNT" marcada  e  Etapa Integração Mensagem Única, opção "Mensagem de Integração = Baixa de Estoque").

O Movimento de baixa de estoque pode ser criado através de Copia por Referência da Nota Fiscal vinculada a Solicitação de SA/SC (Utilizando os Motivos de Referência 1, 25 ou 32) 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
Mapeamento de Campos: http://tdn.totvs.com/x/apP6E

Notas:

Expandir
titleClique aqui para expandir

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
Mapeamento de Campos: Tipo de Fluxo: RM -> Protheus e Protheus -> RM
Mensagem: MaintenanceOrder
Versão: 1.002
Mapeamento de Campos: http://tdn.totvs.com/x/25P6EO fluxo completo da ordem de serviço é descrito no anexo: Fluxo da ordem de serviço no SigaMNT.L5r6E

Notas:

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.

Expandir
titleClique aqui para expandir

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

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: AppointmentCost
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/OZv6E

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.Tipo de Fluxo: RM -> Protheus e Protheus -> RM
Mensagem: StockTurnover
Versão: 1.006
Mapeamento de Campos: http://tdn.totvs.com/x/uJX6E

Notas:

RM -> Protheus

A 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 (parametrização do tipo de movimento Etapa Manutenção, opção "Integrado com SigaMNT" marcada  e  Etapa Integração Mensagem Única, opção "Mensagem de Integração = Baixa de Estoque").

O Movimento de baixa de estoque pode ser criado através de Copia por Referência da Nota Fiscal vinculada a Solicitação de SA/SC (Utilizando os Motivos de Referência 1, 25 ou 32) 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.

Expandir
titleClique aqui para expandir

Cancelar Baixa de Estoque

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

Notas:

Expandir
titleClique aqui para expandir

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.

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 PatrimonialConsulta de Saldos e Custos

Tipo de Fluxo: Protheus -> RM
Mensagem: StockLevel AssetsValuation
Versão: 1.001000
Mapeamento de Campos: http://tdn.totvs.com/x/L5r6E

Notas:

Expandir
titleClique aqui para expandir

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.

pZv6E

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: RM -> Protheus e Protheus -> RM
Mensagem:  AppointmentCostStockTurnover
Versão: 1.000006
Mapeamento de Campos:  http://tdn.totvs.com/x/OZv6E

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:

Expandir
titleClique aqui para expandir

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

uJX6E

Boletim Técnico: Processo de Análise Técnica de Pneus

Controle de Abastecimento

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

Tipo de Fluxo: Protheus -> RM
Mensagem: Order
Versão: 3.002
Mapeamento de Campos: http://tdn.totvs.com/x/jJ76E

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

Boletim Técnico: Controle de Abastecimento em Lote
Boletim Técnico: Processo de Abastecimento Manual
Boletim Técnico: Processo de Conciliação de Abastecimentos

Gestão de Documentos

Tipo de Fluxo: Protheus -> RM
Mensagem: Order
Versão: 3.002
Mapeamento de Campos: http://tdn.totvs.com/x/jJ76E

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

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

op76E

Boletim Técnico: Processo de Geração de Documentos

Gestão de Multas

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

Boletim Técnico: Processo de Análise Técnica de Pneus

Controle de AbastecimentojJ76E

Tipo de Fluxo: Protheus RM -> RMProtheus
Mensagem: StockTurnover InfoOfParcelValues
Versão: 1.006000
Mapeamento de Campos: http://tdn.totvs.com/x/uJX6Ecom/x/op76E

Boletim Técnico: Processo de Sinistros e Multas

Honorários de Despachante

Tipo de Fluxo: Protheus -> RM
Mensagem: Order
Versão: 3.002
Mapeamento de Campos: http://tdn.totvs.com/x/jJ76E

Tipo de Fluxo: Protheus RM -> RMProtheus
Mensagem: StockLevel InfoOfParcelValues
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/L5r6Eop76E

Boletim Técnico: Controle de Abastecimento em Lote
Boletim Técnico: Processo de Abastecimento Manual
Boletim Técnico: Processo de Conciliação de Abastecimentos Processo de Geração de Honorários de Despachante

Ordem de Serviço de PneusGestão de Documentos

Tipo de Fluxo: Protheus -> RM
Mensagem:

...

 StockTurnover
Versão:

...

1.

...

006
Mapeamento de Campos: http://tdn.totvs.com/x/

...

uJX6E

Tipo de Fluxo: RM -> Protheus e Protheus -> RM
Mensagem:  InfoOfParcelValuesMaintenanceOrder
Versão: 1.000002
Mapeamento de Campos:  http://tdn.totvs.com/x/op76E

Boletim Técnico: Processo de Geração de Documentos

Gestão de Multas25P6E

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

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

Boletim Técnico: Processo de Sinistros e Multas

Honorários de Despachante

apP6E

Tipo de Fluxo: Protheus -> RM
Mensagem:  OrderCancelMaintenanceOrder
Versão: 31.002000
Mapeamento de Campos:  http://tdn.totvs.com/x/jJ76EbpT6E

Tipo de Fluxo: RM Protheus -> ProtheusRM
Mensagem: InfoOfParcelValues StockLevel
Versão: 1.000001
Mapeamento de Campos: http://tdn.totvs.com/x/op76EL5r6E

Boletim Técnico: Processo de Geração de Honorários de Despachante Ordem de Serviço de Pneus

Transferência de Pneu

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

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

Boletim Técnico: Processo de Transferência de Pneus

Ordem de Serviço Terceiros

Tipo de Fluxo: RM -> Protheus e Protheus -> RM
Mensagem:  RequestMaintenanceOrder
Versão: 1.010002
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
Mapeamento de Campos: http://tdn.totvs.com/x/L5r6E

Boletim Técnico: Processo de Ordem de Serviço de Pneus

Transferência de Pneu

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

Tipo de Fluxo: Protheus -> RM
Mensagem: StockLevel
Versão: 1.001
Mapeamento de Campos: http://tdn.totvs.com/x/L5r6E

Boletim Técnico: Processo de Transferência de Pneus

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

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 AtendimentoOrdem de Serviço Terceiros

Tipo de Fluxo: RM -> Protheus e Protheus -> RM
Mensagem: MaintenanceOrder
Versão: 1.002
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”.

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.

...


Como fazer

Videos com exemplo dos Processos:

Abertura de O.S. liberada (Clique aqui para acessar o vídeo)
Processo aplicação de Insumo (Clique aqui para acessar o vídeo)
Finalização OS (Clique aqui para acessar o vídeo)
Cancelamento de O.S. (Clique aqui para acessar o vídeo)
Conciliação de Posto Externo (Clique aqui para acessar o vídeo)
Abastecimento Posto Interno (Clique aqui para acessar o vídeo)
Analise Técnica de Pneus (Clique aqui para acessar o vídeo)
Inclusão de O S em Lote Pneus (Clique aqui para acessar o vídeo)
Atendimento S.C. – O.S. Pneus em Lote (Clique aqui para acessar o vídeo)
Movimentação de Pneus (Clique aqui para acessar o vídeo)
Recebimento O.S. em Lote (Clique aqui para acessar o vídeo)
Inclusão de Multas Veículo (Clique aqui para acessar o vídeo)
Pagamento da Multa (Clique aqui para acessar o vídeo)
Inclusão de Documentos Veículos (Clique aqui para acessar o vídeo)
Pagamento do Documento (Faturamento) (Clique aqui para acessar o vídeo)
Inclusão de Honorários Despachantes (Clique aqui para acessar o vídeo)

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.002
Mapeamento de Campos: http://tdn.totvs.com/x/25P6E

Restrições e Pontos de Atenção 

...

Expandir
titleGAPs Funcionais e Pontos de Atenção MNT x Officina (Clique aqui)

Ordem de Serviço para Terceiros

        O MNT já fornece recursos para a inclusão e controle de ordens de serviço de terceiros. Entretanto, a funcionalidade deve ser incrementada no MNT para que possa atender o processo da mesma forma que faz o RM Officina.

        O que Falta Implementar:

Inclusão de dois campos na tabela de ordens de serviço: Fornecedor/Loja. Esses campos são utilizados no conceito de prestador de serviços. O campo de “fornecedor” serve para indicar que a OS está sendo executada em um terceiro. Para abrir esse campo, o campo “terceiro” deve estar como “sim”.

O reporte de insumo “terceiro” via NF de entrada deve ser contemplada pelo BackOffice (estoque/compras) para que se apliquem insumos terceiros com custo no MNT. É o mesmo processo de aplicação direta como é feito para produtos.

Incluir no cadastro de manutenção um campo “terceiro” -> sim/não e código/loja do fornecedor para quando esse campo for “sim”. Dessa forma podem ser geradas ordens de serviço preventivas para terceiros através do plano.

No retorno de OS criar regra para impedir o reporte de insumos de mão-de-obra em ordens de serviço de terceiros. O RM não controla mão-de-obra em OS de terceiros.

Para contemplar NF de Remessa, deve ser criada mensagem única de Pedido de Venda para integração com o financeiro do backoffice. O pedido de venda gera uma NF de Remessa. Criar campo NF terceiro para gravar o código do Pedido de Venda gerado.

Contrato de Manutenção de Terceiros

O SIGAMNT possui cadastro de contratos e utiliza desse recurso para contratos de mão-de-obra. O objetivo é manter esta funcionalidade e aprimorá-la de modo a atender também contratos de prestação de serviço. Para isso algumas alterações serão necessárias tanto no Protheus quanto no RM.

         O que Falta Implementar:

Atualizar a descrição da tabela TP3 para “contratos de manutenção” e adicionar os seguintes campos na tabela:
Tipo de contrato (1=mao-de-obra;2=prestador)  - (No caso de contrato de mão-de-obra, abrem-se os campos de fornecedor/loja. Quando for contrato de prestador abrem-se os campos cliente/loja.)
Cliente e Loja (F3 para a tabela de clientes)
Data inclusão (preenchimento automático com a data atual, na inclusão)
Dt. Vigência início
Dt. Vigência fim (Para a versão atual o sistema não deve permitir informar a data de vigência fim em branco.)
Valor Contrato
Valor Consumido
Contrato Compras/Faturamento: na versão atual o campo fica aberto para digitação. Fica pendente a criação de uma mensagem única para contratos e as adaptações necessárias entre o MNT Protheus e o RM.
Criar tabela para listar os equipamentos atendidos pelo contrato. Para isso se sugere os seguintes campos:

Filial
Número do Contrato
Bem (ST9)
Criar tabela para listar os tipos de manutenção a serem atendidas pelo contrato. Para isso se sugere os seguintes campos:

Filial

Número do Contrato
Tipo de Manutenção (STE)

Incluir na tabela de ordens de serviço um campo chamado “contrato” em que seja possível vincular a OS com um contrato de manutenção.

Desenvolver rotina para manutenção do cadastro de contratos baseado no layout sugerido. Esta rotina, no browse, deve conter uma opção de visualizar ordens de serviço do contrato. Ao clicar, o usuário terá uma consulta das ordens de serviço associadas ao contrato selecionado.

Desenvolver opção de impressão de contrato e seus equipamentos, atendimentos, solicitações e ordens de serviço (vinculado ao item de agendamento). Permitir a impressão através da rotina de contratos (para o contrato selecionado) e também através do menu, caso plausível. Esse relatório deve ter um foco maior em custos.
Na abertura de ordens de serviço, seja corretiva ou preventiva, o sistema deve realizar o seguinte procedimento:

a. Verificar se o bem da OS é um bem de prestação de serviço;
b. Procurar um contrato para o cliente/loja do bem e para a data de vigência atual e que atenda o bem e os tipos de serviço do contrato.
     i. Caso encontre mais de um contrato o sistema mostra uma tela e permite a seleção do contrato a ser relacionado.
     ii. Se houver apenas um contrato, o sistema então informa ao usuário e solicita se deseja que a OS seja contabilizada para esse contrato. Não é obrigatório que se utilize o contrato na OS.
c. Na finalização de OS, os custos da ordem de serviço devem ser debitados do contrato, acrescidos no campo “valor consumido”. Um alerta deve indicar caso não haja saldo no contrato, solicitando se o usuário deseja realmente confirmar.

Abertura de Atendimento[SIGAMMNT]

Há alguns gaps relacionados a este item. Abaixo um texto do que teria que ser implementado.

O que Falta Implementar:

Envio de e-mail para o Cliente com dados do atendimento. Este envio de e-mail deve ser enviado somente quando o atendimento for solucionado.

Integração de Atendimento com ECM.

Para contrato de venda:

O MNT já fornece os recursos necessários para atender esse processo. Trata-se do cadastro do equipamento na rotina de bens e abertura de SS/OS informando serviço de instalação. Dependendo do processo da empresa o MNT também permite que se abra um atendimento e a partir dele se gere uma SS e ainda, se necessário, uma OS.

Necessidade de relatório listando atendimentos por equipamento e por cliente/fornecedor, listando também SS’s e OS’s relacionadas.

Agendamento

O que Falta Implementar:

Conforme descrição do processo do RM tem-se que:
Realizar o tratamento referente ao parâmetro de sistema “Agendamento na abertura de OS Obrigatório”. Quando parametrizado desta forma é permitido gerar Ordem de Serviço (normal e terceiros) somente a partir de um agendamento.

Instalação (Alocação) de Objetos[SIGAMNT]

Tendo em vista que o conceito da regra de negócio do Officina consiste em registrar o local em que determinado equipamento foi instalado, seu rastreamento e controle de manutenções, entende-se que o cadastro de bens do MNT atenderia essa necessidade através da inclusão de alguns campos complementares.

O que Falta Implementar:

No cadastro de bens, para identificar um objeto de manutenção alocado devem ser preenchidos os seguintes campos:

Centro de Custo (T9_CCUSTO) com uma formatação específica, de modo a considerar como parte do código o cliente e loja, por exemplo:
XXXXXXYYZ[n]
Sendo:
XXXXXX o código do cliente (T9_CLIENTE)
YY a loja do cliente (T9_LOJACLI)
Z[n] o local de instalação, ou centro de custo.

Cliente (T9_CLIENTE)

Loja Cliente (T9_LOJACLI)

Data Instalação (T9_DTINSTA)

Instalação (T9_INSTALA)* (1=Local;2=Cliente) – informa se a instalação é própria ou se o equipamento é de cliente, considerado para prestação de serviço.

Funcionário responsável (T9_FUNRESP)* – consulta na tabela de funcionários de manutenção. Trata-se de um funcionário próprio que fica responsável pela manutenção do equipamento no cliente.

Os relatórios que já possuem parâmetro de centro de custo não precisarão de alterações, basta pegar uma faixa de centro de custo para visualizar os bens de um mesmo cliente.
Obs: essa funcionalidade deve ser desenvolvida independentemente da utilização do parâmetro da integração por mensagem única.
Foram analisados também os seguintes itens e colocado pela equipe do SIGA-MNT que há equivalências entre os processos:

Abertura de Ordem de Serviço via TOP

Para compatibilizar com funcionalidade semelhante do RM Officina, deve-se disponibilizar no TOP a funcionalidade de abertura de Ordem de Serviço, a ser efetuada através da inclusão de uma Solicitação de Manutenção, onde o operador informa qual o recurso (ativo), projeto, tarefa e descreve quais os sintomas ou observações pertinentes à manutenção solicitada. Esta manutenção deve ser gerenciada pelo módulo de manutenção (MNT).
O custo será apropriado ao TOP no momento da atualização dos itens do movimento (BackOffice) da OS, caso o tipo de movimento esteja parametrizado para apropriar custos.

O processo de finalização da OS no SigaMNT acarretará na atualização do movimento de OS correspondente no BackOffice e , caso parametrizado para tal, gerará apropriação dos custos para seu respectivo projeto/tarefa.
Obs.: Esta implementação deve ser estuda para equipe do TOP, a ser desenvolvida internamente à integração TOP x SigaMNT, visto que não faz parte do escopo do BackOffice.

Liberação de Movimentos

O processo de liberação de movimentos é responsável pela exclusão de movimentos antigos da base de dados, mas não disparará mensagens de exclusão para o SigaMNT.
Deve-se implementar a exclusão dos “DE-PARAs” dos movimentos removidos da base no processo, para evitar problemas futuros.
Quanto à limpeza das solicitações, baixas de estoque e outras entidades que integram movimentos, fica a cargo do cliente efetua-la no SigaMNT com apoio da equipe de suporte ou equipe de consultores.

Check list 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;

, baixas de estoque e outras entidades que integram movimentos, fica a cargo do cliente efetua-la no SigaMNT com apoio da equipe de suporte ou equipe de consultores.

Check list de suporte da aplicação

Executar a ferramenta de Diagnósticos da integraçãoRealizar possíveis ajustes na integração quanto à configuração ou negócio.


...

Âncora
Anexos
Anexos
Anexos

 Configuração da Integração

...