Contexto de negócio
O objetivo da integração do SIGAMNT x BackOffice RM é viabilizar que de forma automática os cadastros gerenciados pelo BackOffice sejam replicados no vertical e, de forma similar, que os processos geridos pelo Gestão de Ativos/Gestão de Frotas tenham suas informações levadas ao BackOffice. Desta forma as bases de dados se mantém espelhadas, atualizando estoque, permitindo emissão de notas fiscais e demais processos no BackOffice.
Descrição dos sistemas envolvidos no contexto de negócio (e que serão envolvidos na integração).
Integração
Para atender a demanda de clientes que possuem o BackOffice RM e necessitam de uma solução para Manutenção de Ativos e Controle de Frotas foi desenvolvida esta integração, que possibilita a gestão das movimentações a partir do módulo correspondente do Protheus, sincronizando as informações entre os módulos a partir da integração por Mensagem Única TOTVS.
Modelo de Mensagem Única TOTVS.
Durante o processo de consolidação de marcas, iniciado pela TOTVS, várias empresas diferentes foram adquiridas e com elas vários produtos passaram a compor o portfólio de ofertas disponível aos clientes. Esta expansão de ofertas permitiu que clientes de uma marca, antes limitados pelas opções com aquela “etiqueta”, pudessem agora compor o seu ambiente de TI utilizando produtos de origens diferentes (Exemplo: BackOffice RM + SigaMNT Protheus).
Esta mesma iniciativa já era uma prática comum nos clientes, porém todo o custo envolvido na integração entre estes aplicativos era visto pelo cliente como parte da escolha de utilizar-se de produtos de diferentes fornecedores. Uma vez que estes produtos passam a fazer parte de uma mesma oferta, os clientes TOTVS passam a demandar que estes produtos sejam naturalmente integrados. Isto significa que se antes o cliente arcava com o custo e o risco envolvido em uma integração (como corrupção da base de dados, por exemplo), ele agora entende que a TOTVS deve prover soluções já integradas, independente da origem dos produtos oferecidos.
Com o objetivo de padronizar as integrações com os produtos TOTVS, foi definida uma nova diretriz para os projetos de integração: A de que todos os produtos TOTVS devam trabalhar com uma mensagem XML único evitando, desta forma, o processo de transformação de mensagens. Neste cenário, teríamos o seguinte quadro:
Neste cenário, qualquer produto TOTVS trabalhará com o mesmo XML para uma mesma entidade, vamos supor que tenhamos um XML correspondente à mensagem de CLIENTES, ela poderá ser enviada para qualquer um dos produtos que suporte o recebimento desta entidade.
Uma vez que os vários produtos TOTVS terão um "idioma" comum (o XML único), as integrações entre estes produtos não exigirão mais que as mensagens sejam transformadas de um formato para outro. Com isto, será possível conectar diretamente dois produtos, sem a necessidade do TOTVS ESB, como no diagrama abaixo:
Além de questões referentes ao formato das mensagens, a mensagem única também torna uniforme o tratamento destas mensagens XML pelos aplicativos, principalmente no que diz respeito à capacidade de rastreamento.
Pré-requisitos instalação/implantação/utilização
O ambiente de integração necessita, além dos pré-requisitos de cada módulo individualmente, das seguintes características:
BackOffice RM
Protheus
O Protheus deve utilizar grupo de empresas para refletir a hierarquia de empresas configurada no BackOffice RM, contendo somente um grupo e a divisão de empresas sendo representada pelo respectivo conjunto “empresa” +” unidade”.
Exemplo:
O compartilhamento de tabelas deve ser coerente com a forma como o BackOffice RM trabalha, conforme descrita tabela abaixo.
Cadastro | Empresa | Filial | Tabela RM | Tabela Protheus |
---|---|---|---|---|
Moeda | Compartilhado | Compartilhado | GMOEDA | CTO |
Unidade de Medida | Compartilhado | Compartilhado | TUND | SAH |
Centro de Custo | Exclusivo | Compartilhado | GCCUSTO | CTT |
Projeto | Exclusivo | Exclusivo | MPRJ | AF8 |
Obra | Exclusivo | Exclusivo | MTAREFA | AFC |
Tarefa | Exclusivo | Exclusivo | MTAREFA | AF9 |
Etapa | Exclusivo | Exclusivo | MTAREFA | AFC |
Condição de Pagamento | Exclusivo | Compartilhado | TCPG | SE4 |
Produto | Exclusivo * | Compartilhado | TPRODUTO | SB1 |
Cliente/Fornecedor | Compartilhado ** | Compartilhado | FCFO | SA1 (Cliente) e SA2 (Fornecedor) |
Patrimônio | Exclusivo | Exclusivo | IPATRIMONIO | SN1 |
Funcionário | Exclusivo | Compartilhado | PFUNC | SRA | SRF | SR3 | SR7 |
Local de Estoque | Exclusivo | Exclusivo | TLOC | NNR |
* Independentemente se for utilizado produto global no RM, a tabela referente no Protheus deve ser exclusiva por empresa, ficando a cargo do RM replicar os produtos globais para cada filial no Protheus.
** Mesmo que a empresa não utilize Cliente/Fornecedor global no RM, deve-se compartilhar a tabela referente no Protheus por empresa. Será enviado concatenado ao código do cliente/fornecedor o código da coligada, conforme a mascara “[CODCOLIGADA]|[CODCFO]”.
Mensagem Única | Rotina Protheus | Mensagem | Descrição | Envia | Recebe | Método Protheus | Operação | Canal de Envio | Adapter Protheus | Versão |
Sim | NGMUAmpPat | ASSETSVALUATION | Ampliação Patrimonial | Sim | Não | Síncrono | Todas | EAI | NGMUAmpPat | 1.000 |
Sim | NGMUAprCst | APPOINTMENTCOST | Apropriação de Custo | Sim | Não | Síncrono | Todas | EAI | NGMUAprCst | 1.000 |
Sim | ATFA010 | ASSETS | Ativo Fixo | Não | Sim | Síncrono | Todas | EAI | ATFA010 | 1.001 |
Sim | NGMUStoTuO | STOCKTURNOVER | Baixa de Estoque | Sim | Sim | Síncrono | Todas | EAI | NGMUStoTuO | 1.002 |
Sim | NGMUCanMnO | CANCELMAINTENANCEORD | Cancelamento de OS | Sim | Não | Síncrono | Todas | EAI | NGMUCanMnO | 1.000 |
Sim | NGMUCanReq | CANCELREQUEST | Cancelamento de Requisição | Sim | Sim | Síncrono | Todas | EAI | NGMUCanReq | 1.000 |
Sim | GPEA370 | EMPLOYEEPOSITION | Cargo | Não | Sim | Síncrono | Todas | EAI | GPEA370 | 1.000 |
Sim | CTBA030 | COSTCENTER | Centro de Custo | Não | Sim | Síncrono | Todas | EAI | CTBA030 | 2.000 |
Sim | MATA030 | CUSTOMERVENDOR | Cliente | Não | Sim | Síncrono | Todas | EAI | MATA030 | 2.002 |
Sim | MATA360 | PAYMENTCONDITION | Condição de Pagamento | Não | Sim | Síncrono | Todas | EAI | MATA360 | 2.000 |
Sim | NGMUStoLvl | STOCKLEVEL | Consulta de Saldo | Sim | Não | Síncrono | Todas | EAI | NGMUStoLvl | 1.001 |
Sim* | NGMUTRAREQ | TRANCEABILITYREQUEST | Consulta Situação da Solicitação | Sim | Não | Síncrono | Todas | EAI | NGMUTRAREQ | 1.001 |
Sim | PMSA201 | STEPPROJECT | Etapa (EDT) | Não | Sim | Síncrono | Todas | EAI | PMSA201 | 2.000 |
Sim | MATA020 | CUSTOMERVENDOR | Forncecedor | Não | Sim | Síncrono | Todas | EAI | MATA020 | 2.002 |
Sim | GPEA030 | ROLE | Função | Não | Sim | Síncrono | Todas | EAI | GPEA030 | 1.000 |
Sim | GPEA010 | EMPLOYEE | Funcionário | Não | Sim | Síncrono | Todas | EAI | GPEA010 | 2.001 |
Sim | NGMUGETSIT | GETEMPLOYEESITUATIONS | Situação do Funcionário | Sim | Não | Síncrono | Todas | EAT | NGMUGETSIT | 1.000 |
Sim | NGMUInfPar | INFOOFPARCELVALUES | Informações de Parcelas | Não | Sim | Síncrono | Todas | EAI | NGMUInfPar | 1.000 |
Sim | AGRA045 | WAREHOUSE | Local de Estoque | Não | Sim | Síncrono | Todas | EAI | AGRA045 | 1.000 |
Sim | CTBA140 | CURRENCY | Moeda | Não | Sim | Síncrono | Todas | EAI | CTBA140 | 2.000 |
Sim | PMSA201 | SUBPROJECT | Obra (EDT) | Não | Sim | Síncrono | Todas | EAI | Obra (EDT) | 2.000 |
Sim | NGMUOrder | ORDER | Ordem | Sim | Sim | Síncrono | Todas | EAI | NGMUOrder | 3.002 |
Sim | NGMUMntOrd | MAINTENANCEORDER | Ordem de Serviço | Sim | Sim | Síncrono | Todas | EAI | NGMUMntOrd | 1.000 |
Sim | MATA010 | ITEM | Produto | Não | Sim | Síncrono | Todas | EAI | MATA010 | 2.000 |
Sim | PMSA200 | PROJECT | Projeto | Não | Sim | Síncrono | Todas | EAI | PMSA200 | 2.000 |
Sim | NGMUReques | REQUEST | Solicitação | Sim | Sim | Síncrono | Todas | EAI | NGMUReques | 1.000 |
Sim | PMSA203 | TASKPROJECT | Tarefa | Não | Sim | Síncrono | Todas | EAI | PMSA203 | 2.000 |
Sim | GPEA080 | SHIFTWORK | Turno | Não | Sim | Síncrono | Todas | EAI | GPEA080 | 1.000 |
Sim | QIEA030 | UNITOFMEASURE | Unidade de medida | Não | Sim | Síncrono | Todas | EAI | QIEA030 | 2.000 |
* Disponível a partir da versão 12.1.15.160 do 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 Protheus.
PENDENTE - VERIFICAR COM O PROTHEUS
CheckList de Implantação | ||
---|---|---|
Índice | Tarefa | Anexo |
Preparação do Ambiente | ||
1 | Pendente - Verificar com a equipe do 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 RM.
CheckList de Implantação | ||
Índice | Tarefa | Anexo |
Preparação do Ambiente | ||
1 | Instalação/Atualização da Biblioteca RM |
|
1.1 | Conferir arquivos *.Config e Alias.dat | |
2 | Instalação e configuração do IIS | Manual de instalação do TBC |
3 | Instalação e configuração do TBC | |
3.1 | Instalar o TBC na mesma versão da Biblioteca RM | |
3.2 | Configuração do Web.Config | |
3.2.1 | Configurar o Web.Config conforme o RM.Host.*.Config e Rm.Exe.Config | |
3.2.2 | Configurar Tag “DefaultDB” no Web.config com o Alias desejado | |
4 | Atualização da base de dados (Caso ainda não esteja na versão necessária) | Manual do RM Atualizador |
4.1 | Efetuar Backup da base de dados | |
4.2 | Executar o RM Atualizador na base de dados | |
4.3 | Conferir se o Dicionário de Dados do Protheus possui compartilhamento por Empresa/Filial igual ao RM para os cadastros integrados. | |
Ativação da Integração | ||
5 | Instalação e parametrização do pacote de integração no RM | |
5.1 | Parametrizar os Tipos de Movimento utilizados na integração | Parametrização dos Movimentos |
5.2 | Executar o configurador da integração |
|
5.3 | Parametrizar a URL do WebService Protheus | |
5.4 | Informar os parâmetros da integração | |
5.5 | Cadastrar De-Para de Coligada e Filial | Anexo DI0001_TOTVS_Gestao_de_Frotas-BackofficeRMxProtheusSigaMNT |
5.6 | Importar as Fórmulas Visuais com gatilho | Anexo Importação de Fórmulas Visuais |
Preparação/Carga da Base de Dados | ||
6 | Cadastro de Cliente/Fornecedor | |
6.1 | Abrir tabela de Municípios do Protheus para que a mesma receba carga automática (Acessar o SIGAFIS no Protheus) | |
6.2 | Conferir se o campo A1_COD e A2_COD no Protheus estão sem inicializador padrão (SIGACFG em Dicionário | Banco de Dados) | |
6.3 | Informar o Inic. Padrão para o A1_LOJA e A2_LOJA (Exemplo: '01' e '02') | |
6.4 | Editar o cadastro de um Cliente/Fornecedor manualmente e verificar se é integrado | |
6.5 | Verificar se todos os Clientes possuem endereço cadastrado | |
6.6 | Efetuar a carga de Clientes/Fornecedores | Anexo Execução de Fórmulas Visuais |
7 | Cadastro de Moeda | |
7.1 | Verificar quais as moedas que serão integradas (Lembrando que o Protheus aceita somente 5) | |
7.2 | Editar o cadastro de uma moeda manualmente e verificar se é integrado | |
7.3 | Efetuar 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 |
8 | Cadastro de Unidade de Medida | |
8.1 | Cadastrar os de-para manualmente de algumas unidades conforme cita na especificação (clique aqui) | Anexo DI0001_TOTVS_Gestao_de_Frotas-BackofficeRMxProtheusSigaMNT |
8.2 | Editar o cadastro de uma Unidade de Medida manualmente e verificar se é integrado | |
8.3 | Efetuar a carga de Unidades de medida | Anexo Execução de Fórmulas Visuais |
9 | Cadastro de Produto | |
9.1 | Verificar se as Unidades de Medida associada aos Produtos já estão integradas ou incluído os de-para manualmente | |
9.2 | Editar o cadastro de um Produto manualmente e verificar se é integrado | |
9.3 | Efetuar a carga de Produtos | Anexo Execução de Fórmulas Visuais |
10 | Cadastro de Centro de Custo | |
10.1 | Editar o cadastro de um Centro de Custo manualmente e verificar se é integrado | |
10.2 | Efetuar a carga de Centros de Custos | Anexo Execução de Fórmulas Visuais |
11 | Cadastro de Ativo Fixo | |
11.1 | Cadastrar os valores defaults para Plano de Contas (para cada filial) | Anexo Default para Plano de Contas |
11.2 | Verificar se o campo N1_CHAPA da tabela de Ativos do PROTHEUS está com 30 caracteres | |
11.3 | Verificar se os Fornecedores associados aos Bens já estão integrados | |
11.4 | Verificar se os Centros de Custo associados aos Bens já estão integrados | |
11.5 | Editar o cadastro de um Bem/Ativo manualmente e verificar se é integrado | |
11.6 | Efetuar a carga de Bens/Ativos | Anexo Execução de Fórmulas Visuais |
12 | Cadastro de Cargo | |
12.1 | Editar o cadastro de um Cargo manualmente e verificar se é integrado | |
12.2 | Efetuar a carga de Cargos | Anexo Execução de Fórmulas Visuais |
13 | Cadastro de Função | |
13.1 | Editar o cadastro de um Cargo manualmente e verificar se é integrado | |
13.2 | Efetuar a carga de Funções | Anexo Execução de Fórmulas Visuais |
14 | Cadastro de Turno/Horário | |
14.1 | Editar o cadastro de um Horário manualmente e verificar se é integrado | |
14.2 | Efetuar a carga de Horários | Anexo Execução de Fórmulas Visuais |
15 | Cadastro de Funcionário | |
15.1 | Cadastrar o Banco, agencia e conta default para a integração | Anexo Default para Banco, Agencia e Conta |
15.2 | Verificar se os Turnos, Funções e Horários estão integrados | |
15.3 | Acessar o cadastro de Processos do Protheus (07- Gestão Pessoal) em Atualizações | Definições de Cálculo | Processos | |
15.4 | Verificar dentro da Seção do Funcionário se possui o Centro de Custo informado e se está sincronizado como Global | Anexo Centro de Custo Funcionário |
15.5 | Verificar se os funcionários estão com o Tipo de recebimento como Mensalista ou Semanalista | |
15.6 | Editar o cadastro de um Funcionário manualmente e verificar se é integrado | |
15.7 | Efetuar a carga de Funcionários | Anexo Execução de Fórmulas Visuais |
16 | Cadastro de Projeto (Caso for utilizar na Integração) | |
16.1 | Cadastrar o calendário no Protheus, conforme link: Cadastro de Calendário Protheus | |
16.2 | Informar conteúdo 001 (Calendário cadastrado no passo anterior) no parâmetro MV_INTCAL do Protheus | |
16.3 | Editar o cadastro de um Projeto manualmente e verificar se é integrado | |
16.4 | Efetuar a carga de Projetos | Anexo Execução de Fórmulas Visuais |
17 | Cadastro de Obra (Caso for utilizar na Integração) | |
17.1 | Editar o cadastro de uma Obra manualmente e verificar se é integrado | |
17.2 | Efetuar a carga de Obras | Anexo Execução de Fórmulas Visuais |
18 | Cadastro de Tarefa | |
18.1 | Editar o cadastro de uma Tarefa manualmente e verificar se é integrado | |
18.2 | Efetuar a carga de Tarefas | Anexo Execução de Fórmulas Visuais |
19 | Cadastro de Etapa | |
19.1 | Editar o cadastro de uma Etapa manualmente e verificar se é integrado | |
19.2 | Efetuar a carga de Etapas | Anexo Execução de Fórmulas Visuais |
20 | Cadastro de Local de Estoque | |
20.1 | Acessar a tabela NNR no Protheus, no campo NNR_DESCRI informar o tamanho = 40 | |
20.2 | Editar o cadastro de um Local de Estoque manualmente e verificar se é integrado | |
20.3 | Efetuar a carga de Locais de Estoque | Anexo Execução de Fórmulas Visuais |
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.
O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos RM Conector e Backoffice Protheus estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.
Observação: Este modelo de suporte está sendo revisado pela TOTVS.
O escopo deste projeto se restringe aos processos de venda gerenciados pelo PDV 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.
Escopo de cadastros
A integração é responsável pela replicação dos cadastros efetuados no BackOffice RM no módulo de retaguarda de vendas do Protheus (SigaLoja) de forma transparente ao usuário final, estando fora do escopo deste projeto toda e qualquer alteração nos processos de carga entre a retaguarda e o PDV Protheus.
O escopo dos cadastros se restringe aos necessários para utilização nos módulos de venda, listados na seção Transações/Entidades/Mensagens.
Escopo dos processos
O escopo da integração se restringe aos processos relacionados a venda que sejam pertinentes de manipulação no BackOffice, que são a integração dos dados de Cupom Fiscal e ReduçãoZ, pra posterior geração de Nota Fiscal e escrituração.
O módulo de retaguarda de vendas do Protheus (SigaLoja) deve ser utilizado somente como meio de integração dos sistemas de frente de loja com o BackOffice RM, não devendo o mesmo ser utilizado para nenhum processamento de dados, integração fiscal ou geração de relatórios.
O fluxo de integração de processos tem origem nos módulos de Frente de Loja do Protheus, sendo integrada de forma nativa para a Retaguarda de vendas Protheus, mas estando esta parte fora do escopo da integração com BackOffice RM. O escopo deste projeto se restringe à integração da Retaguarda de vendas Protheus para o BackOffice RM.
O escopo de integração dos processos se restringe aos listados na seção Transações/Entidades/Mensagens.
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 | Fórmula Visual de Gatilho | Fórmula Visual de Carga de Dados |
Cadastros
| 01 | Cliente/Fornecedor | RM | Protheus | CustomerVendor | 2.002 | MOVWKF0007 - CustomerVendor | MOVWKF0019 - Sincronizacao_Total_SigaMNT |
02 | Moeda | RM | Protheus | Currency | 2.000 | MOVWKF0006 - Currency | MOVWKF0019 - Sincronizacao_Total_SigaMNT | |
03 | Unidade de Medida | RM | Protheus | UnitOfMeasure | 2.000 | MOVWKF0017 - UnitOfMeasure | MOVWKF0019 - Sincronizacao_Total_SigaMNT | |
04 | Produto | RM | Protheus | Item | 2.000 | MOVWKF0013 - Item | MOVWKF0019 - Sincronizacao_Total_SigaMNT | |
05 | Centro de Custo | RM | Protheus | CostCenter | 2.000 | MOVWKF0005 - CostCenter | MOVWKF0019 - Sincronizacao_Total_SigaMNT | |
06 | Ativo Fixo | RM | Protheus | Assets | 1.001 | MOVWKF0002 - Assets_InclusaoAlteracao | MOVWKF0019 - Sincronizacao_Total_SigaMNT | |
07 | Transferência de Ativo Fixo | RM | Protheus | Assets | 1.001 | MOVWKF0003 - Assets_TransferenciaControle | - | |
08 | Exclusão de Ativo Fixo | RM | Protheus | Assets | 1.001 | MOVWKF0001 - Assets_Delete | - | |
09 | Cargo | RM | Protheus | EmployeePosition | 1.000 | MOVWKF0025 - Sincronização de Cargo, Função e Horário | MOVWKF0025 - Sincronização de Cargo, Função e Horário | |
10 | Função | RM | Protheus | Role | 1.000 | MOVWKF0025 - Sincronização de Cargo, Função e Horário | MOVWKF0025 - Sincronização de Cargo, Função e Horário | |
11 | Horário | RM | Protheus | Shiftwork | 1.000 | MOVWKF0025 - Sincronização de Cargo, Função e Horário | MOVWKF0025 - Sincronização de Cargo, Função e Horário | |
12 | Funcionário | RM | Protheus | Employee | 2.001 | MOVWKF0008 - Employee | MOVWKF0019 - Sincronizacao_Total_SigaMNT | |
13 | Exclusão de Funcionário | RM | Protheus | Employee | 2.001 | MOVWKF0009 - Employee_Delete | - | |
14 | Projeto | RM | Protheus | Project | 2.000 | MOVWKF0016 - Project | MOVWKF0019 - Sincronizacao_Total_SigaMNT | |
15 | Obra | RM | Protheus | SubProject | 2.000 | MOVWKF0014 - Obra Etapa Tarefa | MOVWKF0019 - Sincronizacao_Total_SigaMNT | |
16 | Tarefa | RM | Protheus | TaskProject | 2.000 | MOVWKF0014 - Obra Etapa Tarefa | MOVWKF0019 - Sincronizacao_Total_SigaMNT | |
17 | Etapa | RM | Protheus | StepProject | 2.000 | MOVWKF0014 - Obra Etapa Tarefa | MOVWKF0019 - Sincronizacao_Total_SigaMNT | |
18 | Condição de Pagamento | RM | Protheus | PaymentCondition | 2.000 | MOVWKF0015 - PaymentCondition | MOVWKF0019 - Sincronizacao_Total_SigaMNT | |
19 | Local de Estoque | RM | Protheus | Warehouse | 1.000 | MOVWKF0018 - Warehouse | MOVWKF0019 - Sincronizacao_Total_SigaMNT | |
Processos | 20 | Solicitações (SA e SC) | Protheus | RM | Request | 1.000 | - | - |
21 | Cancelamento de SA/SC | Protheus | RM | CancelRequest | 1.000 | - | - | |
22 | Ordem de Serviço | Protheus | RM | MaintenanceOrder | 1.000 | - | - | |
23 | Finalizar OS | Protheus | RM | MaintenanceOrder | 1.000 | - | - | |
24 | Faturar OS | RM | Protheus | MaintenanceOrder | 1.000 | MOVWKF0010 - Faturamento_OS | - | |
25 | Cancelamento de OS | Protheus | RM | CancelMaintenanceOrder | 1.000 | - | - | |
26 | Baixa de estoque | Protheus | RM | StockTurnover | 1.002 | - | - | |
27 | Baixa de Estoque | RM | Protheus | StockTurnover | 1.002 | MOVWKF0004 - Baixa_Estoque | - | |
28 | Cancelar Baixa de Estoque | Protheus | RM | CancelRequest | 1.000 | - | - | |
29 | Consulta Saldos e Custos | Protheus | RM | StockLevel | 1.001 | - | - | |
30 | Apropriação de Custos | Protheus | RM | AppointmentCost | 1.000 | - | - | |
31 | Ampliação Patrimonial | Protheus | RM | AssetsValuation | 1.000 | - | - | |
32 | Análise técnica de pneus | Protheus | RM | StockTurnover | 1.001 | - | - | |
33 | Controle de Abastecimento | Protheus | RM | StockLevel | 1.001 | - | - | |
34 | Controle de Abastecimento | Protheus | RM | StockTurnover | 1.001 | - | - | |
35 | Controle de Abastecimento | Protheus | RM | Order | 3.002 | - | - | |
36 | Gestão de Documentos | Protheus | RM | Order | 3.002 | - | - | |
37 | Informação de Parcelas | RM | Protheus | InfoOfParcelValues | 1.000 | MOVWKF0012 - InfoOfParcelValues | - | |
38 | Gestão de Multas | Protheus | RM | Order | 3.002 | - | - | |
39 | Honorários de Despachante | Protheus | RM | Order | 3.002 | - | - | |
40 | Ordem de Serviço de Pneus | Protheus | RM | MaintenanceOrder | 1.000 | - | - | |
41 | Transferência de Pneus | Protheus | RM | StockTurnover | 1.002 | - | - | |
42 | Ordem de Serviço Terceiros | Protheus | RM | MaintenanceOrder | 1.001 | - | - |
Obs.: As Fórmulas visuais estão disponíveis na pasta de instalação do RM em (...CORPORERM/Objetos Gerenciais/Fórmulas Visuais)
Para esta integração todos os cadastros possuem sua origem no BackOffice RM, sendo enviados à retaguarda Protheus.
Cadastro de Moeda
Identificador da Mensagem: Currency
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/VNb0E
Notas:
|
Cadastro de Unidades de Medida
Identificador da Mensagem: UnitOfMeasure
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/h9b0E
Notas:
|
Cadastro de Centro de Custo
Identificador da Mensagem: CostCenter
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/w9b0E
Notas:
|
Cadastro de Projeto
Identificador da Mensagem: Project
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/ENf0E
Notas:
|
Cadastro de Obra
Identificador da Mensagem: SubProject
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/Stf0E
Notas:
|
Cadastro de Tarefa
Identificador da Mensagem: TaskProject
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/fNf0E
Notas:
|
Cadastro de Etapa
Identificador da Mensagem: StepProject
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/udf0E
Notas:
|
Cadastro de Condição de Pagamento
Identificador da Mensagem: PaymentCondition
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/Sdj0E
Notas:
|
Cadastro de Produto/Serviço
Identificador da Mensagem: Item
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/DYD6E
Notas:
|
Cadastro de Cliente/Fornecedor
Identificador da Mensagem: CustomerVendor
Versão: 2.002
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/MYP6E
Notas:
|
Cadastro de Ativo Fixo
Identificador da Mensagem: Assets
Versão: 1.001
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/hYP6E
Notas:
|
Cadastro de Cargo
Identificador da Mensagem: EmployeePosition
Versão: 1.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/04P6E
Cadastro de Função
Identificador da Mensagem: Role
Versão: 1.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/7IP6E
Cadastro de Turno
Identificador da Mensagem: ShiftWork
Versão: 1.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/AYT6E
Cadastro de Funcionário
Identificador da Mensagem: Employee
Versão: 2.001
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/9Yv6E
Notas:
|
Cadastro de Local de Estoque
Identificador da Mensagem: Warehouse
Versão: 1.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/b4z6E
Notas:
|
Conforme descrito na seção de apresentação do escopo, o escopo da integração se restringe aos processos relacionados a Gestão de Frotas e Manutenção de Ativos que sejam pertinentes de manipulação no BackOffice, como integrações fiscais, financeiras ou controle de estoque.
Abaixo são listados os processos integrados.
Manutenção de Ativos
Solicitações de Armazém/Compra
Tipo de Fluxo: Protheus -> RM
Mensagem: Request
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/-476E
Notas:
Ciclo de vida das solicitações:
|
Consulta Situação da SA/SC
Tipo de Fluxo: Protheus -> RM
Mensagem: TranceAbilityRequest
Versão: 1.001
Especificações BackOffice RM: Consulta situação Solicitação de Armazém/Solicitação de Compras
Notas:
|
Cancelar Solicitação de Armazém/Compra
Tipo de Fluxo: Protheus -> RM
Mensagem: CancelRequest
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/apP6E
Notas:
|
Ordem de Serviço
Tipo de Fluxo: RM -> Protheus e Protheus -> RM
Mensagem: MaintenanceOrder
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/25P6E
Cancelar Ordem de Serviço
Tipo de Fluxo: Protheus -> RM
Mensagem: CancelMaintenanceOrder
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/bpT6E
Baixa de estoque
Tipo de Fluxo: RM -> Protheus e Protheus -> RM
Mensagem: StockTurnover
Versão: 1.002
Mapeamento de Campos: http://tdn.totvs.com/x/uJX6E
RM -> Protheus
Cancelar Baixa de Estoque
Tipo de Fluxo: Protheus -> RM
Mensagem: CancelRequest
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/apP6E
O cancelamento de baixa de estoque ocorre ao excluir ou alterar um insumo realizado no SigaMNT. No caso da alteração de insumos realizados a baixa original deverá ser cancelada e uma nova baixa gerada.
Consulta de Saldos e Custos
Tipo de Fluxo: Protheus -> RM
Mensagem: StockLevel
Versão: 1.001
Mapeamento de Campos: http://tdn.totvs.com/x/L5r6E
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.
Pré-requisitos para a integração de Apropriação de Custos
Notas:
|
Ampliação Patrimonial
Tipo de Fluxo: Protheus -> RM
Mensagem: AssetsValuation
Versão: 1.000
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
Tipo de Fluxo: RM -> Protheus e Protheus -> RM
Mensagem: StockTurnover
Versão: 1.002
Mapeamento de Campos: http://tdn.totvs.com/x/uJX6E
Controle de Abastecimento
Tipo de Fluxo: Protheus -> RM
Mensagem: StockTurnover
Versão: 1.002
Mapeamento de Campos: http://tdn.totvs.com/x/uJX6E
Tipo de Fluxo: Protheus -> RM
Mensagem: Order
Versão: 3.002
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
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: InfoOfParcelValues
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/op76E
Gestão de Multas
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: InfoOfParcelValues
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/op76E
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: RM -> Protheus
Mensagem: InfoOfParcelValues
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/op76E
Ordem de Serviço de Pneus
Tipo de Fluxo: Protheus -> RM
Mensagem: StockTurnover
Versão: 1.002
Mapeamento de Campos: http://tdn.totvs.com/x/uJX6E
Tipo de Fluxo: RM -> Protheus e Protheus -> RM
Mensagem: MaintenanceOrder
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/25P6E
Tipo de Fluxo: Protheus -> RM
Mensagem: Request
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/-476E
Tipo de Fluxo: Protheus -> RM
Mensagem: CancelRequest
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/apP6E
Tipo de Fluxo: Protheus -> RM
Mensagem: CancelMaintenanceOrder
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/bpT6E
Tipo de Fluxo: Protheus -> RM
Mensagem: StockLevel
Versão: 1.001
Mapeamento de Campos: http://tdn.totvs.com/x/L5r6E
Transferência de Pneu
Tipo de Fluxo: Protheus -> RM
Mensagem: StockTurnover
Versão: 1.002
Mapeamento de Campos: http://tdn.totvs.com/x/uJX6E
Tipo de Fluxo: Protheus -> RM
Mensagem: StockLevel
Versão: 1.001
Mapeamento de Campos: http://tdn.totvs.com/x/L5r6E
Ordem de Serviço Terceiros
Tipo de Fluxo: RM -> Protheus e Protheus -> RM
Mensagem: MaintenanceOrder
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/25P6E
O fluxo completo da ordem de serviço é descrito no anexo Fluxo da ordem de serviço no SigaMNT.
RM -> Protheus
A mensagem de ordem de serviço será enviada ao SigaMNT pelo BackOffice RM somente quando o movimento for faturado, para informar a alteração do status da OS para “Faturado”.
Manutenção de Ativos / Gestão de Frotas
Abertura de Atendimento
Tipo de Fluxo: RM -> Protheus e Protheus -> RM
Mensagem: MaintenanceOrder
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/25P6E
|
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:
O que Falta Implementar:
Há alguns gaps relacionados a este item. Abaixo um texto do que teria que ser implementado. O que Falta Implementar:
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.
O que Falta Implementar: Conforme descrição do processo do RM tem-se que:
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:
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.
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 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. |
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:
Siga os passos abaixo para efetuar a instalação e configuração da integração.
Acesse a rotina de cadastramento de De-para no contexto de Integração
Os passos a seguir devem se repetir para todas as coligadas e filiais.
Efetue o cadastramento do De-Para de Coligadas conforme imagem abaixo, substituindo os valores entre chaves com o valor correspondente pelo código da coligada.
Tabela RM: Fixo valor 'GCOLIGADA'
Chave Primária RM: Fixo valor 'CODCOLIGADA'
Valor Chave Primária RM: Código da coligada referente
Sistema Integrado: Fixo valor 'PROTHEUS'
Valor Chave Integração: Código da coligada referente (mesma do campo Valor Chave Primária RM)
Efetue o cadastramento do De-Para de Filiais conforme imagem abaixo, substituindo os valores entre chaves com o valor correspondente ao descrito internamente a ele.
Tabela RM: Fixo valor 'GFILIAL'
Chave Primária RM: Fixo valor 'CODCOLIGADA|CODFILIAL'
Valor Chave Primária RM: Código da coligada + '|' + Código da filial
Sistema Integrado: Fixo valor 'PROTHEUS'
Valor Chave Integração: Código do grupo de empresa do Protheus + '|' + Código completo da filial no Protheus (composto por Empresa + Filial)
A lista de Fórmulas Visuais referente a cada entidade encontra-se na seção Transações/Entidades/Mensagens.
As Fórmulas Visuais informadas na tabela estão disponíveis na pasta "...CORPORERM | Objetos Gerenciais | Fórmulas Visuais" e devem ser importadas conforme apresentado no documento Importação\Exportação de fórmula visual, com atenção à importação dos gatilhos (caso contrário a mesma não será acionada).
Segue abaixo a lista de passos para efetuar a Carga de Dados entre o BackOffice RM e o Protheus.
Segue abaixo como cadastrar o de-para das unidades de medida padrão.
Observação: No exemplo foi criado para a unidade de medida UN, é necessário fazer para as demais, conforme a cita nas informações da unidade de medida (clique aqui).
Para integrar esta entidade, o PROTHEUS exige que sejam cadastrados valores defaults para Plano de Contas em sua base (para cada filial), com os seguintes parâmetros:
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:
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.
Pendente
Pendente -> Liberado
Etapa em que a Ordem de Serviço (Manutenção) é aprovada e liberada para execução.
Ponto de início da integração, onde é gerada a OS no BackOffice sem itens, a fim de relacionar as solicitações referentes à OS. Os produtos consumidos no desenvolvimento da OS serão inseridos no BackOffice somente ao finalizar a mesma.
Caso haja insumos previstos, o SigaMNT deve gerar as respectivas solicitações de armazém/compra no BackOffice ao liberar a OS.
Liberado
Neste status podem-se executar os insumos previstos (que se tornarão realizados).
A inclusão de novos insumos na OS segue o comportamento descrito abaixo:
Insumos inseridos como previstos no SigaMNT devem gerar novas solicitações de armazém/compra.
O relacionamento das solicitações de compra/armazém e baixas de estoque com OS oriundas do SigaMNT serão feitos utilizando as tabelas de relacionamento de cópia por referência, inserido manualmente nos extensions.
Insumos inseridos no SigaMNT como realizados devem efetuar diretamente baixa de estoque no BackOffice. Fica a cargo do SigaMNT a consulta de saldo em estoque no BackOffice e, não havendo em estoque (e o parâmetro não permite estoque negativo), o mesmo não deverá possibilitar o cadastramento deste novo insumo.
Para o BackOffice o novo insumo “realizado” deverá significar uma baixa no estoque (movimento de baixa).
Insumos previstos -> Insumos realizados
Existem duas formas de inserir insumos Realizados, sendo elas:
Finalizado
Cancelado
Finalizado -> Liberado (Reabertura de OS)
Faturamento
Fluxo resumido
Diagrama de sequência da integração Protheus SigaMNT x BackOffice RM