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.

Manual da Integração

...

Manutenção de Ativos/Gestão de Frotas x BackOffice RM - Mensagem Única EAI 1.0

Contexto de negócio

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

Âncora
Sistemas Envolvidos
Sistemas Envolvidos
Sistemas Envolvidos

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

  • Microsiga Protheus através dos seguintes módulos:
    • Protheus Framework (SIGACFG): Módulo responsável pelos WebServices e Framework de Integração.

    • Protheus Padrão NG (SIGAMNT): Módulo utilizado pelo cliente, sendo responsável pela manutenção do cadastro (Frotas, Pneus, Bens, Manutenção, Funcionário da Manutenção(mão de obra), Solicitações de Serviço, Ordens de Serviço, Retorno de OS, Movimentação), Controle de Pneus, Controle de Abastecimentos, Controle de Documentos, Controle de Riscos e demais processos da empresa.

    • Protheus Manufatura (SIGAPCP): Módulo utilizado pelo cliente, sendo responsável pela manutenção do cadastro (Calendário, Ordem de Produção, Recursos, Ferramentas) e demais processos da empresa. 

    • Protheus Logística (SIGAOMS, SIGATMS): Módulo utilizado pelo cliente, sendo responsável pela manutenção do cadastro (Motorista, VeiculosVeículos) e demais processos da empresa.

  • BackOffice RM através RM através dos seguintes módulos:
    • TOTVS Gestão de Estoque, Compras e Faturamento (RM Nucleus): Módulo utilizado pelo cliente, sendo responsável pela manutenção dos cadastros (Unidade de medida, produto, Local de estoque, Condição de pagamento, Moeda, Movimentação), gestão de estoque, integrações Fiscaisfiscais, integrações financeiras e demais processos da empresa.
    • TOTVS Gestão Financeira (RM Fluxus): Módulo utilizado pelo cliente, sendo responsável pela manutenção dos cadastros (Cliente/Fornecedor), integrações financeiras e demais processos da empresa. 
    • TOTVS Gestão Contábil (RM Saldus): Módulo utilizado pelo cliente, sendo responsável pela manutenção dos cadastros (Centro de custo) e demais processos da empresa. 
    • TOTVS Gestão Patrimonial (RM Bonum): Módulo utilizado pelo cliente, sendo responsável pela manutenção dos cadastros (Bem/Ativo) e demais processos da empresa.
    • TOTVS Construção e Projetos (RM Solum): Módulo utilizado pelo cliente, sendo responsável pela manutenção dos cadastros (Obra, Projeto, Tarefa) e demais processos da empresa.
    • TOTVS Folha de Pagamento (RM Labore): Módulo utilizado pelo cliente, sendo responsável pela manutenção dos cadastros (Funcionário, Cargo, Função, Horário) e demais processos da empresa.
    • TOTVS Business Connect: Módulo responsável pelos WebServices e Framework de Integração.

...

ParâmetroConteúdoObservação
MV_NGINTERML=Logix; R=RM; M=Mensagem única.
MV_NGGERSAS/NIndica se deve gerar Solicitação de Armazém ao invés de Solicitação de Compras

MV_ESTNEG

N

Não permite estoque negativo. O estoque é consultado no RM, independente das movimentações na SD3 e da SB2.
Porém há funções Microsiga que não relevam essa consulta no âmbito do MNT.
Por isso a funcionalidade deveria ser desenvolvida pelo módulo de Estoque (função SaldoSB2).
Em todo caso, o SB2 está sendo alterado conforme o resultado da consulta da integração.

 MV_NGMNTES  S Integração com Estoque.
MV_NGMNTPCSIntegração com PCP.
MV_PRODFER<produto>Item de estoque que indica ferramentas no SIGAMNT.
MV_PRODTER<produto>Item de estoque que indica terceiros no SIGAMNT

MV_NGMNTCP

N

Indica se a numeração dos itens da solicitação de compras será a mesma.
Este parâmetro sobrepõe o processo padrão de geração do Compras.

MV_NGCORPR

SPermite gerar empenho e SC’s para OS Corretiva.

MV_NGMNTAT

3

Integração Manutenção (MNT) c/ Ativo (ATF).
Informar “” ou “N” não integra;
1= alterações no ATF replicarão no MNT;
2= MNT p/ ATF;
3= MNT p/ ATF e ATF p/ MNT.

MV_NGSALHOSDefine se o campo salário do funcionário da manutenção é integrado com o GPE.
MV_NGMNTRHSIntegração Manutenção (MNT) com Recursos Humanos (RH).
MV_RASTRONDetermina a utilização ou não da rastreabilidade dos lotes de produção (S para ‘sim’ ou N para ‘não’).
MV_NGMNTCMSIntegração do Manutenção de Ativos (MNT) com Compras (COM). Informar S para sim e N para não.
MV_NGMNTFISIntegração do Manutenção de Ativos (MNT) com Financeiro (FIN). Informar S para sim e N para não.
MV_PRODTRX<produto>Item de estoque que indica multas no MNT.
MV_PRODTS2<produto>Item de estoque que indica documentos no MNT.
MV_PRODTS8<produto>Item de estoque que indica honorários no MNT.
MV_NGPRSB2SBusca preço médio da tabela SB2.
MV_NGLOCPAD <Almoxarifado>Indica o Almoxarifado padrão para gerar os produto utilizado pelo SIGAMNT (Manutencao/Terceiros)
Outras configurações recomendadas:
MV_NGMULOSSPermite a abertura de mais de uma OS por SS.
MV_NGMNTFRSIndica que a empresa utiliza o sistema Gestão de Frotas.
MV_NGPNEUSSIndica se utiliza complemento de pneus.
MV_NGPNEST SIndica se a empresa utiliza identificação do bem no controle de estoque.
MV_NGOSNFE 2Indica se consiste integração do Documento de Entrada no recebimento da O.S. em Lote pela Nota Fiscal. (1=Sim;2=Nao)
MV_NGMNTSC 1Indica o modo de aglutinar os itens da solicitacao de compra dos produtos 1 - Normal, 2 - Por OP, 3 - Por Necessidade 
MV_ESTHOME S/C Indica o momento que o estoque sera debitado. S = Abastecimento, C = Conciliação, N = Não baixa estoque
MV_NGMNTAS 1Define se aglutina as Solicita coes de Armazém para a mesma Ordem de Serviço (1=Sim,2=Não)
Abaixo as configurações necessárias ao Gestão de Frotas (MV_NGMNTFR = ‘S’) para utilização do Controle de Pneus. Os parâmetros devem estar configurados
conforme o cadastro de status do MNT.
MV_NGSTAPL<codigo>Código do Status para Aplicado
MV_NGSTAGR<codigo>Código do Status para Aguardando Reforma
MV_NGSTAEU<codigo>Código do status para Estoque Usado.
MV_NGSTAER<codigo>Código do Status para Estoque Reformado
MV_NGSTAAT <codigo>Código do Status para Aguardando Análise Técnica
MV_NGSTARS<codigo>Código do Status para Removido de Serviço
MV_NGSTAEN<codigo>Código do Status para Estoque Novo
Pneu
MV_NG1ANAT <codigo>

Indica quais serão os destinos que sofrerão entradas/baixas no estoque.

MV_NGSECON <codigo>Código de serviço para conserto de pneus.
MV_NGSEREF <codigo>Código do serviço para Reforma de Pneus
MV_NGSERPN <codigo>Indica o código do serviço que sera utilizado para movimentação de pneus. 
MV_NGRODIZ <codigo>Código de serviço que será utilizado para o.s. de rodízio de pneus.
MV_NGSERCA <codigo>Indica o código do serviço para CANIBALISMO (Desmontagem da estrutura de rodados).
MV_NGSINSP <codigo>Indica o código do serviço de inspeção de pneus.
MV_NGSTACA <codigo>Indica o código do status para Canibalismo.
MV_NGSTAGC <codigo>Código do status para Aguardando Conserto.
MV_NGSTEST <codigo>Indica o status para o pneu no estoque da filial.
MV_NGBEMTR<codigo>Código do Status para Bem Transferido.
MV_NGSTEP <codigo>Indica se pode movimentar o pneu de STEP no processo do rodizio.
MV_NGMOROD <codigo>Código do motivo padrão para o rodizio de pneus.
MV_NGMODEF <codigo>Código dos motivos de defeito nos pneus.
Configurações necessárias ao EAI:
MV_EAIURL2<URL TBC>

Nome do canal configurado no EAI para envio a outro EAI. Case sensitive.
No caso do RM, indica o endereço do TBC. Verificar com a equipe de infraestrutura qual o endereço a ser utilizado.
Exemplo: http://localhost/TOTVSBusinessConnect/WsEAIService.asmx

MV_EAIUSER<Usuário>Usuário para autenticação do EAI para uso no envio de mensagens.
Informar o código do usuário que tenha acesso RM.
MV_EAIPASS<Senha>

Senha para autenticação do EAI para uso no envio de mensagens.
Informar a senha para acesso ao RM do usuário informado no parametro anterior.


Âncora
CheckList Protheus
CheckList Protheus
Protheus

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

CheckList de Implantação

Índice

Tarefa

Anexo

Preparação do Ambiente

1Instalação/Atualização do Protheus
1.1Protheus 11Guia de instalação e atualização do Protheus 11
1.2Protheus 12Guia de instalação e atualização do Protheus 12
2Configuração do WebserviceComo efetuar a configuração para habilitar Webservices
Ativação da Integração
3Parametrização do pacote de integração no Protheus
3.1Protheus 11 - Necessário executar update UPDMNT42Boletim Técnico UPDMNT42
3.2Parâmetros da Integração Protheus 11 e 12Anexo DI0001_TOTVS_Gestao_de_Frotas-BackofficeRMxProtheusSigaMNT Configurar os Parametros Protheus
3.3Cadastro De/Para Empresas Mensagem ÚnicaAnexo DI0001_TOTVS_Gestao_de_Frotas-BackofficeRMxProtheusSigaMNT Cadastrar De-Para Protheus
3.4Cadastro De/Para do funcionário da manutenção (Utilizado para a Mão de Obra do Funcionário)Configuração de Mão de Obra

Âncora
CheckList RM
CheckList RM
RM

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

CheckList de Implantação

Índice

Tarefa

Anexo

Preparação do Ambiente

1

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


1.1Configurar o Alias para acessar a base do RM que irá realizar a integração
2

Definir a utilização do Web Service (TBC ou Host)

2Web Service via Host

Manual de Configuração do WS do Host

3Web Service via TOTVS Business Connect
Instalação e configuração do IIS



Manual de instalação do TBC 

3.1Instalação e configuração do IIS + Instalação e configuração do TBC
3.1Instalar o TBC
na mesma versão da Biblioteca RM
3.2Configuração do Web.Config (importante)
3.2.1Configurar o Web.Config conforme o RM.Host.*.Config e Rm.Exe.Config
3.2.2Configurar Tag “DBAlias” no Web.config com o Alias desejado (Nome do Alias criado no passo 1.1)
4Atualização da base de dados (Caso ainda não esteja na versão necessária)


Manual do RM Atualizador

4.1Efetuar Backup da base de dados
4.2Executar o RM Atualizador na base de dados
4.3Conferir 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.1Parametrizar os Tipos de Movimento utilizados na integraçãoParametrização dos Movimentos
5.2Executar o configurador da integração


Anexo Configuração da Integração

5.3Parametrizar a URL do WebService Protheus
5.4Informar os parâmetros da integração
5.5Cadastrar De-Para de Coligada e FilialAnexo
DI0001_TOTVS_Gestao_de_Frotas-BackofficeRMxProtheusSigaMNT
Cadastrar De-Para RM
5.6Importar as Fórmulas Visuais com gatilhoAnexo Importação de Fórmulas Visuais
5.7Marcar o parâmetro "Utilizar Fórmula Visual em Integração (SIGAMNT)"  em: Parametrizador: Folha de Pagamento > Integrações > Outros BackOffice

Preparação/Carga da Base de Dados

6Cadastro de Cliente/Fornecedor
6.1Abrir tabela de Municípios do Protheus para que a mesma receba carga automática (Acessar o SIGAFIS no Protheus)
6.2Conferir se o campo A1_COD e A2_COD no Protheus estão sem inicializador padrão (SIGACFG em Dicionário | Base de Dados tabela SA1 e SA2)
6.3Informar o Inic. Padrão para o A1_LOJA e A2_LOJA (Exemplo: '01' e '02') - (SIGACFG em Dicionário | Base de Dados tabela SA1 e SA2)
6.4Editar o cadastro de um Cliente/Fornecedor manualmente e verificar se é integrado
6.5Verificar se todos os Clientes possuem endereço cadastrado
6.6Efetuar a carga de Clientes/Fornecedores (Fórmula Visual: 07 - Sincronização de Cliente/Fornecedor)Anexo 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
DI0001_TOTVS_Gestao_de_Frotas-BackofficeRMxProtheusSigaMNT
De-para das Unidades de Medida
8.2Editar o cadastro de uma Unidade de Medida manualmente e verificar se é integrado
8.3Efetuar a carga de Unidades de medidaAnexo Execução de Fórmulas Visuais
9Cadastro de Produto
9.1Verificar se as Unidades de Medida associada aos Produtos já estão integradas ou incluído os de-para manualmente
9.2Editar o cadastro de um Produto manualmente e verificar se é integrado
9.3Efetuar a carga de ProdutosAnexo Execução de Fórmulas Visuais
10Cadastro de Centro de Custo
10.1Editar o cadastro de um Centro de Custo manualmente e verificar se é integrado
10.2Efetuar a carga de Centros de CustosAnexo Execução de Fórmulas Visuais
11Cadastro de Ativo Fixo
11.1Cadastrar os valores defaults para Plano de Contas (para cada filial)Anexo Default para Plano de Contas
11.2Verificar se o campo N1_CHAPA da tabela de Ativos do PROTHEUS está com 30 caracteres (SIGACFG em Dicionário | Base de Dados tabela SN1)
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.5Editar o cadastro de um Bem/Ativo manualmente e verificar se é integrado
11.6Efetuar a carga de Bens/AtivosAnexo Execução de Fórmulas Visuais
12Cadastro de Cargo
12.1Editar o cadastro de um Cargo manualmente e verificar se é integrado
12.2Efetuar a carga de CargosAnexo Execução de Fórmulas Visuais
13Cadastro de Função
13.1Editar o cadastro de um Função manualmente e verificar se é integrado
13.2Efetuar a carga de FunçõesAnexo Execução de Fórmulas Visuais
14Cadastro de Turno/Horário
14.1Editar o cadastro de um Horário manualmente e verificar se é integrado
14.2Efetuar a carga de HoráriosAnexo Execução de Fórmulas Visuais
15Cadastro de Funcionário
15.1Cadastrar o Banco, agencia e conta default para a integraçãoAnexo Default para Banco, Agencia e Conta
15.2Verificar se os Turnos, Funções e Horários estão integrados
15.3

Acessar o Protheus (07- Gestão Pessoal) em Atualizações | Definições de Cálculo | Processos para que o sistema faça a carga automaticamente


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

Âncora
Controle de Versão / Suporte / Escopo
Controle de Versão / Suporte / Escopo
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 definidas 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.

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

...

  • As Fórmulas visuais estão disponíveis na pasta de instalação do RM em (...CORPORERM/Objetos Gerenciais/Fórmulas Visuais)
  • A partir da versão RM 12.1.19, a integração passa a utilizar novas versões de mensagens para as entidades Ordem de Serviço (MaintenaceOrder 1.002), Solicitação de Armazém/Compra (Request 1.010) e Baixa de Estoque (StockTurnOver 1.006). Para maiores informações de como atualizar a sua integração consulte o documento técnico 1146369 MATESTCNTFTOF01-517 DT Código do Bem no Item de Movimento.
  • A partir da versão RM 12.1.20, a integração passa a utilizar nova versão de mensagem para entidade Produto (Item 4.005). Para maiores informações de como atualizar sua integração consulte o documento técnico 1331649 MATESTCNTFTOF01-1147 DT Campo tributação do CF no Cadastro de Produto por filial


Âncora
Cadastros
Cadastros
Cadastros

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

...

Expandir
titleClique aqui para expandir

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.

* A partir do release 12.1.8 da linha RM, na alteração do Produto Global o RM irá replicar os produtos globais para cada filial no PROTHEUS, somente quando for alterado os campos da tabela Produtos Globais (TPRODUTO) que são sincronizados na mensagem única. São eles: Código do Produto; Descrição do Produto; Nome Fantasia; Inativo; Tipo; Peso Bruto; Peso Líquido; Usa Número de Série; Controlado por Lote; Referência; Número da Nomenclatura Comum do Mercosul (NCM).

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.

A partir da versão RM 12.1.20 será utilizado o adapter versão 4.005. Mais informações consulte o documento 1331649 MATESTCNTFTOF01-1147 DT Campo tributação do CF no Cadastro de Produto por filial

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

Para melhoria na performance do cadastro de produtos, apenas a alteração dos campos integrados farão um novo envio de mensagem ao Protheus:

Expandir
titleLista de campos

TPRODUTO.CODIGOPRD
TPRODUTO.DESCRICAO
TPRODUTO.NOMEFANTASIA
TPRODUTO.INATIVO
TPRODUTO.DTCADASTRAMENTO
TPRODUTO.CONTROLADOPORLOTE
TPRODUTO.USANUMSERIE
TPRODUTO.PESOLIQUIDO
TPRODUTO.PESOBRUTO
TPRODUTO.REFERENCIACP
TPRODUTO.TIPO
TPRODUTO.NUMEROCCF
TPRODUTODEF.CODUNDCONTROLE
TPRODUTODEF.CODUNDCOMPRA
TPRODUTODEF.CUSTOMEDIO
TPRODUTODEF.CUSTOUNITARIO
TPRODUTODEF.CODMOEPRECO1
TPRODUTODEF.DATABASEPRECO1
TPRODUTODEF.PRECO1
TPRODUTODEF.CODMOEPRECO2
TPRODUTODEF.DATABASEPRECO2
TPRODUTODEF.PRECO2
TPRODUTODEF.CODMOEPRECO3
TPRODUTODEF.DATABASEPRECO3
TPRODUTODEF.PRECO3
TPRODUTODEF.CODMOEPRECO4
TPRODUTODEF.DATABASEPRECO4
TPRODUTODEF.PRECO4
TPRODUTODEF.CODMOEPRECO5
TPRODUTODEF.DATABASEPRECO5
TPRODUTODEF.PRECO5
TPRODUTODEF.TRIBUTACAOECF
TPRODUTODEF.NUMNOFABRIC


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

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

Expandir
titleClique aqui para expandir

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

O disparo da mensagem (CustomerVendor) via Fórmula Visual será enviado somente na versão 1.000. A partir desta versão o disparo será feito automaticamente.


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

...

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

    na tela de inclusão.
          * DepreciationStartDate : Valor calculado pela função PatPatrimonioService. RetornaDataInicioVigencia(CodColigada, DataAquisicao)- 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: ICALCULOPATRIMONIO ICALCULORAZAO.VALORBASECORRIGIDO (considera apenas o último valor calculado) ou ISALDOCALCULOPATRIMONIOMOEDA. VALORBASECORRIGIDO para o IDCENARIOCALCULO = 1
          * CurrencyCode e CurrencyInternalId: ICALCULOPATRIMONIO ICALCULORAZAO.MOEDAINDICE ou ISALDOCALCULOPATRIMONIOMOEDA.MOEDAINDICE
          * AnnualRateCurrencyDepreciation: ITAXADEPRECIACAO.VALOR
          * BalanceDepreciation: ICALCULOPATRIMONIO. DEPRECIACAOACUMULADACORRIGIDA  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.

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.

...

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


Âncora
Processos
Processos
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.

...

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

...

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

...

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


Âncora
Restrições e Pontos de Atenção
Restrições e Pontos de Atenção
Restrições e Pontos de Atenção 

Expandir
titleRestrições e Pontos de Atenção (Clique aqui)


Carga Inicial de dados e migração de bases RM Officina para SigaMNT
Não faz parte do escopo da integração efetuar carga Inicial de dados ou migração de bases RM Officina para SigaMNT, ficando a cargo da implantação efetuar este serviço.

Manutenção da sincronia das bases BackOffice RM e SigaMNT
Caso sejam efetuadas alterações por meios diferentes dos objetos de negócio apresentados na seção de cadastros como gatilhos de integração, as mesmas não serão encaminhadas ao SigaMNT, gerando incoerência entre as bases de dados. Um exemplo de alterações que gerariam esta incoerência é sistemas terceiros que efetuem alteração diretamente na base de dados, sem passar pelos objetos de negócio da linha RM.

Visando facilitar a manutenção da sincronia das bases de dados, está disponível na pasta de objetos de negócio (“../CorporeRM/Objetos Gerenciais/Formulas Visuais”) arquivo “MOVWKF0019 - Sincronizacao_Total_SigaMNT.TotvsWF” com fórmulas visuais responsáveis por manter a base SigaMNT atualizada, que podem ser agendadas com a recorrência demandada pelo cliente.
Estas fórmulas visuais vêm com configuração padrão, mas podem ser customizadas da forma que melhor atender ao cliente. Um exemplo de customização seria a alteração das mesmas para sincronizar somente os registros da coligada corrente no momento do agendamento, ou somente enviar os registros que possuam um campo específico com um valor específico.

Criação de novos tipos de relacionamento (TMOVRELAC-TIPORELAC)
Caso seja criado algum tipo de cópia por referência que não seja de relacionamento invertido, a constante “TiposRelacNaoInvertida” existente dentro da Extension da mensagem “StockTurnover” e da atividade de fórmula visual “MovInfoParcelaSigaMNT” deve ser alterada, adicionando o novo valor.

Configuração do comportamento do tipos de movimento
Fica a cargo da equipe de implantação fazer a configuração dos tipos de movimento, devendo somente se ater aos requisitos mínimos descritos da sessão Parâmetros de Tipo de Movimento.
Algumas configurações, como série do movimento e controle de estoque, são críticas para o perfeito funcionamento do gerenciamento de estoque.

O configurador da integração não faz atualizações
Devido a restrições no configurador das integrações o mesmo funcionará somente para a primeira instalação ou para inserção de novas entidades, visto que o mesmo não faz atualização de registros, somente inserção.

Apropriação de custos não relacionados a OS
Não faz parte do escopo inicial o envio da apropriação de custos externos a OS ou ao custo de utilização de material, como pagamento de IPVA, seguro, depreciação e outros, mesmo que a mensagem “AppointmentCost” contemple estes.

Mapa de Alocação de Equipamentos
Não faz parte do escopo inicial o envio do planejamento do Solum quanto a alocação de Equipamentos.

Informações referentes aos cadastros de Municipio, Estado e País
Não faz parte do escopo da integração efetuar carga de dados referentes ao Municipio, Estado e País, ficando a cargo da implantação sincronizar estes dados e seu respectivo De-Para.

Integração com TOP
Pelo entendimento de que não era utilizada e pela nova estrutura do SigaMNT foi descontinuada a integração do TOP com o Officina.

Caracteres especiais na mensagem única
O EAI de mensagem única utiliza o EncodeUTF8 no envio das mensagens. O Protheus não considera os seguintes códigos da tabela ASCII que são: ASCII 129, ASCII 141, ASCII 143 , ASCII 144 e ASCII 157. Maiores informações podem ser obtidas através do link: http://tdn.totvs.com.br/display/tec/EncodeUTF8

Cadastro de Cliente/Fornecedor (CustomerVendor)
Uma vez que já foi feito consenso que Cliente e Fornecedor são tratados na mesma mensagem (CustomerVendor), é responsabilidade do destinatário processar a mensagem da melhor forma possível para garantir a consistência dos dados na origem e no destino. Se o destino implementa uma única tabela, terá que manipular apenas um registro. Se implementa mais de uma tabela, tem que manipular até 2 registros.
Exemplo1: <TOTVSMessage ... CustomerVendor...>…<Event>upsert</Event>…<Type>Customer<Type>…
   Como não dá para saber se este Cliente (<Type>Customer) é uma inclusão ou uma alteração (<Event>upsert), tem que verificar no de/para.
       Se o EAI destino é capaz de cadastrar um único registro como ambos: deve verificar se já existe um registro com este ID, caso afirmativo fazer alteração deste registro para Cliente e alterar os demais campos, senão fazer inclusão.
       Se o EAI destino NÃO é capaz de cadastrar um único registro como ambos: primeiro deve verificar se já existe um Fornecedor com este ID, caso afirmativo deve tentar excluir este Fornecedor (não conseguindo gerar uma exceção semelhante a “o código xx já é          um fornecedor não pode ser excluído/alterado para tipo cliente.”). Segundo, deve verificar se já existe um registro de Cliente com este ID, caso afirmativo fazer alteração dos demais campos, senão fazer inclusão.
Exemplo 2: <TOTVSMessage ... CustomerVendor...>…<Event>upsert</Event>…<Type>Both<Type>…
       Se o EAI destino é capaz de cadastrar um único registro como ambos, deve verificar se o ID já existe para definir se faz alteração ou inclusão.
       Se o EAI destino tem 2 tabelas distintas, deve incluir/alterar um Cliente. E ainda incluir/alterar um fornecedor.

Âncora
GAPs Funcionais e Pontos de Atenção MNT x Officina
GAPs Funcionais e Pontos de Atenção MNT x Officina
GAPs Funcionais e Pontos de Atenção MNT x Officina

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.


Âncora
Checklist de suporte da aplicação
Checklist de suporte da aplicação
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.

...

Realizar possíveis ajustes na integração quanto à configuração ou negócio.

...


Âncora
Anexos
Anexos
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.

...

URL WebService: http://[IP PROTHEUS]:[PORTA PROTHEUS]/ws/EaiService.apw?WSDL

Image AddedImage Removed

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


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


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

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


...


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

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

...

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


 

...


 

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


Acessar o Configurador > Ambiente > Schedule > Emp Filial Mensagem Unica


...

Preencher os campos conforme exemplo abaixo:

Observação: O código da Empresa e Filial podem alterar de acordo com a estrutura utilizada

 

...


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

...

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


...


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

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


...

Incluir um novo Registro de acordo com os dados abaixo

Exemplo:

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

 

 

...


Â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:

...

Incluir novo registro, conforme exemplo abaixo (É necessário fazer o processo para cada Filial do Protheus).


...


Â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:

...

Incluir novo registro, conforme exemplo abaixo.


...

 

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

...

Acessar Processos | Sincronização Centro de Custo Global


...


Âncora
Fluxo da ordem de serviço
Fluxo da ordem de serviço
Fluxo da ordem de serviço no SigaMNT (status e pontos de integração)


Pendente

Etapa responsável por orçamento, análise, aprovação, liberação, etc.

...

Ao efetuar baixa de estoque (direta ou por baixa de solicitações) diretamente pelo BackOffice será enviada mensagem de integração ao SigaMNT, fazendo com que os insumos baixados sejam inseridos nos insumos realizados da OS.A partir de então o mesmo não deverá sofrer alterações no SigaMNT.

Alteração de Insumos

A alteração de insumos previstos ou realizados, quando possível, implica no cancelamento na solicitação anterior e a geração de novas solicitaçõesde novas solicitações.

Ao alterar a quantidade ou incluir insumos no SigaMNT, o mesmo deve consultar o saldo em estoque do produto e verificar se será possível atender a nova quantidade solicitada, decidindo assim entre solicitação de armazém ou de compra.
Ao confirmar a alteração, submetendo o formulário, deve-se sinalizar ao BackOffice para cancelar/estornar a solicitação anterior e efetuar uma nova baixa.

Quando o Manutenção de Ativos estiver configurado para aglutinar as Solicitações de Armazém para a mesma Ordem de Serviço (MV_NGMNTAS  = 1), ao realizar alteração de insumos previstos ele irá aplicar esta alteração na mesma solicitação, ou seja, não irá excluir a solicitação e gerar uma nova.

Ao alterar a quantidade do insumo previsto, será enviado ao BackOffice uma mensagem apagando o item alterado e outra mensagem contendo um novo item com a quantidade alterada. Caso seja incluído um novo insumo previsto ele enviará ao RM uma mensagem contendo todos os dados da Solicitação mais o item inserido.

Observação: o Manutenção de Ativos deve consultar o BackOffice para verificar se será permitido a alteração do movimento. Quando não for permitido alterar o movimento, será criado um novo movimento de solicitação contendo as alterações realizadas na OS ou incluir insumos no SigaMNT, o mesmo deve consultar o saldo em estoque do produto e verificar se será possível atender a nova quantidade solicitada, decidindo assim entre solicitação de armazém ou de compra.
Ao confirmar a alteração, submetendo o formulário, deve-se sinalizar ao BackOffice para cancelar/estornar a solicitação anterior e efetuar uma nova baixa.


Insumos de serviços de terceiros serão inseridos no BackOffice como solicitações e devem sofrer alterações somente no BackOffice. Quando a solicitação for baixada o SigaMNT deve ser informado para que o insumo seja inserido como realizado na OS.

...