O objetivo da integração do TOTVS Rental 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 TOTVS CRM Gestão de clientes 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.
Por exemplo: fechou uma venda no CRM? A informação já pode ser usada para gerar o pedido de venda no Backoffice RM. Tudo de forma rápida e sem complicação
Descrição dos sistemas envolvidos no contexto de negócio (e que serão envolvidos na integração).
MasterCRM (???): Módulo responsável pelos MasterCRM.
Para atender a demanda de clientes que possuem o TOTVS BackOffice - Linha RM e o TOTVS CRM Gestão de cliente foi desenvolvida esta integração que possibilita a gestão das movimentações a partir do Backoffice RM e a gestão do relacionamento com o cliente através do Master CRM sincronizando informações entre tais módulos utilizando a plataforma de integração baseada na 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 x SigaMNT Protheus, TOTVS Gestão Hospitalar x EAI Datasul, TOTVS Educacional x BackOffice Protheus, TOTVS Folha de Pagamento RM x BackOffice Protheus, TOTVS Construção Gestão Imóveis (TCGI) x BackOffice Protheus, TOTVS Obras e Projetos x BackOffice 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.
O ambiente de integração necessita, além dos pré-requisitos de cada módulo individualmente, das seguintes características:
BackOffice RM
Master CRM
O Master CRM 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 e Master CRM trabalham.
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.
O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos BackOffice RM e Master CRM estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.
O escopo deste projeto se restringe aos processos de integração com o Master CRM 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.
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 | Observação |
Cadastros | 01 | Cliente/Fornecedor | RM | TOTVS Rental | CustomerVendor | 2.003 | |
02 | Moeda | RM | TOTVS Rental | Currency | 2.001 | ||
| 03 | Unidade de Medida | RM | TOTVS Rental | UnitOfMeasure | 2.000 | ||
| 04 | Produto | RM | TOTVS Rental | Item | 4.005 | ||
| 05 | Local de estoque | RM | TOTVS Rental | WareHouse | 1.000 | ||
| 06 | Vendedor | RM | TOTVS Rental | Seller | 2.001 | ||
07 | Condição de pagamento | RM | TOTVS Rental | PaymentCondition | 2.000 | ||
| 08 | Centro de custo | RM | TOTVS Rental | CostCenter | 2.000 | ||
| 09 | Vendedor | RM | TOTVS Rental | Seller | 2.001 | ||
Processos | |||||||
| 10 | Pedido de venda | TOTVS Rental | RM | Order | 1.001 | ||
| 11 | Consulta Saldos e Custos | TOTVS Rental | RM | StockLevel | 4.010 | TOTVS Rental solicita ao RM e o RM retorna com os dados solicitados | |
| 12 | Consulta rastreabilidade de pedidos e movimentações decorrentes | TOTVS Rental | RM | TraceAbilityOrder | 1.000 | TOTVS Rental solicita ao RM e o RM retorna com os dados solicitados |
Para esta integração todos os cadastros possuem sua origem no BackOffice RM sendo enviados ao Master CRM.
Cadastro de Cliente/Fornecedor
Identificador da Mensagem: CustomerVendor
Versão: 2.003
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos RM: https://tdn.totvs.com/x/Uh8ZE
Cadastro de Moeda
Identificador da Mensagem: Currency
Versão: 2.001
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos RM: https://tdn.totvs.com/x/Wv8pE
Mapeamento de Campos: http://tdn.totvs.com/x/VNb0E
Notas:
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 RM: https://tdn.totvs.com/x/DYcpE
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 RM: https://tdn.totvs.com/x/sBzHG
Cadastro de Grupo de Produto
Identificador da Mensagem: StockGroup
Versão: 1.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos RM: https://tdn.totvs.com/x/pcwpE
Cadastro de Vendedor
Identificador da Mensagem: Seller
Versão: 2.001
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos RM: https://tdn.totvs.com/x/1ANZIQ
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 RM: https://tdn.totvs.com/x/mYYpE
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:
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 20 caracteres, uma vez que no RM estes campos permitem até 25 caracteres. |
Conforme descrito na seção de apresentação do escopo, o escopo da integração se restringe a alguns processos relacionados, ou que se iniciam, no Master CRM mas que sejam de alçada, controle e manipulação no BackOffice, como integrações fiscais, financeiras ou controle de estoque.
Abaixo são listados os processos integrados.
Pedido de venda
Tipo de Fluxo: MasterCRM -> RM
Mensagem: Order
Versão: 4.010
Mapeamento de Campos: https://tdn.totvs.com/x/C0fQHw
Notas:
Consulta de Saldos e Custos
Tipo de Fluxo: MasterCRM -> RM
Mensagem: StockLevel
Versão: 1.001
Mapeamento de Campos: http://tdn.totvs.com/x/L5r6E
Videos com exemplo dos Processos:
Executar a ferramenta de Diagnósticos da integração