Manual da Integração Quirons x Backoffice RM - Mensagem Única EAI 2.0

Contexto de negócio

A integração Quirons x Backoffice RM - que contempla o Quirons - entrega aos clientes uma experiência diferenciada nos processos e controle da gestão de locação de equipamentos a partir da integração de diferentes setores da empresa. Garantindo uma comunicação eficiente e segura entre os departamentos, facilitando fluxos de informações e de rotinas operacionais e administrativas a integração reflete em uma otimização no processo de locação como um todo tornando-os processos mais eficientes, lucrativos e satisfatórios para os consumidores.

Por meio da integração os clientes podem usufruir da potencialidade do Quirons e suas avançadas funcionalidades comunicando-se com o módulo BackOffice RM de maneira que o departamento de faturamento, estoque, financeiro e o setor comercial possam negociar e efetivar contratos de locações e o sistema de locações realize a gestão operacional das locações com mais agilidade e segurança. 


A integração do TOTVS Rental com os produtos da linha TOTVS RM ficou muito mais simples e transparente. Com a atualização do TOTVS Rental basta efetuar as devidas configurações e parametrizações em ambos módulos, Backoffice RM e TOTVS Rental, para que a comunicação entre os sistemas esteja disponível imediatamente.

Por exemplo: fechou uma locação no TOTVS Rental? A informação já pode ser usada para gerar o pedido de venda, notas ficais de remessa, retorno, fatura no TOTVS Backoffice – Linha RM. Tudo de forma rápida e sem complicação.


Sistemas Envolvidos

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 TOTVS Backoffice - Linha RM e o Quirons foi desenvolvida esta integração que possibilita a gestão das solicitações de produtos EPIs (sincronização de produtos EPI's, posição de estoque, requisição, baixa, vinculação do equipamento funcionário e devolução de equipamentos) a partir do Backoffice RM e a gestão de medicina e segurança do trabalho através do Quirons 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 ou REST/JSON ú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 ou REST/JSON para uma mesma entidade, vamos supor que tenhamos um XML ou REST/JSON 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 ou REST/JSON 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

TOTVS Rental

Controle de Versão

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

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

Suporte

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos Backoffice RM e TOTVS Rental 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 TOTVS Rental e os cadastros utilizados por estes.

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

Transações/Entidades/Mensagens únicas

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

Método

ID

Descrição

Origem

Destino

Mensagem Única

Versão da Mensagem

Observação

Cadastros






01ProdutoRMQuironsItem4.005
02Unidade de MedidaRMQuironsUnitOfMeasure2.000
03Local de estoqueRMQuironsWareHouse1.000
04Centro de custoRMQuironsCostCenter2.000
05Vendedor/Requisitante (pessoa que utilizará o EPI)RMQuironsSeller3.002

06

Estoque / Posição de estoque

RM

Quirons

StockLevel

3.000Enviada ao Quirons sempre que houver uma movimentação de estoque no backoffice

Processos

07Requisição (produtos EPI)QuironsRMRequest?.???Possibilidade de dois tipos de Requisições:
1) Solicitação de EPI
2) Solicitação de Devolução de EPI
08Movimentação direta de estoque (produtos EPI)QuironsRMStockTurnOver?.???Possibilidade de dois tipos de movimentos de estoque:
1) Para baixa no estoque
2) Para devolução no estoque
09Entrega (total ou parcial) do EPI

RM

QuironsStockTurnOver1.006Ao atender a solicitação do EPI (Request) deverá enviar para o Quirons a informação dos itens baixados (total\parcial)

Cadastros

Para esta integração todos os cadastros possuem sua origem no BackOffice RM sendo enviados ao TOTVS Rental.

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

Notas


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

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 RM: https://tdn.totvs.com/x/DYcpE

Notas


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

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

Notas:


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

Notas:

Cadastro de Condição de Pagamento

Identificador da Mensagem: PaymentCondition
Versão: 3.000
Mandatário: Backoffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos RM: https://tdn.totvs.com/x/mYYpE

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

Processos

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

Solicitação de Emissão NF\Fatura - Pedido de venda

Tipo de Fluxo: TOTVSRental -> RM
Mensagem: Order
Versão: 3.002
Mapeamento de Campos: https://tdn.totvs.com/x/C0fQHw

Notas


Consulta de Saldos e Custos

Tipo de Fluxo: TOTVSRental -> RM

Mensagem: StockLevel

Versão: 1.001
Mapeamento de Campos: http://tdn.totvs.com/x/L5r6E

Notas


Consulta Rastreabilidade de Pedido de Vendas

Tipo de Fluxo: TOTVSRental -> RM 
Mensagem: TraceAbilityOrder
Versão: 1.000
Mapeamento de Campos: https://tdn.totvs.com/x/BQFAJQ

Notas


Notifica Cancelamento de Nota Fiscal/Fatura de Locação

Tipo de Fluxo: RM -> TOTVSRental 
Mensagem: CancelInvoiceNotify
Versão: 1.000
Mapeamento de Campos: Notifica Cancelamento de Nota Fiscal/Fatura

Notas

Como fazer

Videos com exemplo dos Processos:

Executar a ferramenta de Diagnósticos da integração