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 Saúde e Segurança do Trabalho através da comunicação nativa dos sistemas que enviam e recebem as informações de provisões e estocagem. 

...

Por exemplo: ao realizar uma entrega de equipamento o Quírons enviará ao BackOffice RM uma solicitação de estoque de maneira a garantir a reserva e baixa deste equipamento. 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).

• NG Quirons - Software de gestão de medicina e segurança do trabalho:

  • NG Quirons: Saúde e segurança do trabalho.

• TOTVS BackOffice - Linha 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, Requisitante, Movimentações [solicitação/baixa de estoque], Gestão de estoque, integrações fiscais, 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 Framework: Módulo responsável pelo framework de 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.

...

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:

...

• O compartilhamento de tabelas deve ser coerente com a forma como o BackOffice RM e Quírons trabalham.

• Configurar os adapters utilizados na integração Quirons x Backoffice RM, conforme detalhado em [Configurações Adapter Quirons].

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

Cadastros

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

...

• É premissa para a integração que os Requisitantes estejam cadastros no TOTVS Gestão de Estoque Compras e Faturamento.
• Quando existir apenas a integração Quírons x BackOffice RM, os requisitantes cadastrados no TOTVS Gestão de Estoque Compras e Faturamento obrigatoriamente deverá ter preenchido o campo Identificador da Pessoa.
• Qualquer alteração no cadastro, inclusive ao alterar o campo Identificador da Pessoa em um Requisitante, deverá ser enviado a alteração para o sistema Quírons.

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.

...

Enviada ao Quirons sempre que houver uma movimentação de estoque no BackOffice RM. No momento que for alterado o saldo do produto deverá ser enviando o valor do saldo de estoque do local de estoque atualizado para o Quirons.

Como fazer

Videos com exemplo dos Processos:

...