Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Manual da Integração

...

Rental x Backoffice RM - Mensagem Única EAI 2.0

Contexto de negócio

A integração TOTVS Rental x Backoffice RM  - que contempla o TOTVS Rental Rental - 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 meio da integração os clientes podem usufruir da potencialidade do TOTVS do Rental 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. 

  • Melhor controle das receitas, alocação e disponibilidade dos ativos, entregas e devoluções de equipamentos, proporcionando muito mais eficiência em todos os processos operacionais e administrativos da sua empresa;

  • Controle mais rigoroso e focado sobre a medição e execução dos seus contratos deixando o BackOffice se encarregar dos processos administrativos, legais, fiscais do negócio;

  • Indicadores de medições e execuções de contratos, receitas, produtividade, qualidade permitem uma visão mais ampla ao gestor facilitando identificação de processos que precisam ser melhorados dentro da empresa e a criação de estratégias para aumentar a rentabilidade do seu negócio alinhadas à meta da organização.


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

  • TOTVS Rental - Sistema de locação de equipamentos através dos seguintes módulos:
    • TOTVS Rental (SIGALOC): Módulo responsável pelo sistema de locação.

  • 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, Condição de Pagamento, Movimentações [solicitação/pedido de venda], Gestão de estoque, integrações fiscais, 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, Moedas), 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 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 TOTVS o Rental foi desenvolvida esta integração que possibilita a possibilita a gestão das movimentações (produtos, estoque, posição de estoque, nota fiscal, nota remessa, nota retorno, fatura) a partir do Backoffice RM e a gestão de locação de equipamentos através do TOTVS Rental 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:

...

Backoffice RM

  • Configurar a integração TOTVS integração Rental x Backoffice RM via host na versão 12.1.33 ou superior.
  • Os cadastros mantidos pelo Backoffice RM, como por exemplo de Clientes, Produtos e etc., devem estar desabilitados no TOTVS Rental em suas respectivas entidade evitando concorrência de dados.

...

  • O compartilhamento de tabelas deve ser coerente com a forma como o Backoffice RM e TOTVS Rental trabalham.

  • Configurar os adapters utilizados na integração TOTVS integração Rental x Backoffice RM, conforme detalhado em [Configurações Adapter 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






01Cliente/FornecedorRMTOTVS RentalCustomerVendor2.003

02

Moeda

RM

TOTVS Rental

Currency

2.001
03Unidade de MedidaRMTOTVS RentalUnitOfMeasure2.000
04ProdutoRMTOTVS RentalItem

4.005


05Local de estoqueRMTOTVS RentalWareHouse1.000
06VendedorRMTOTVS RentalSeller2.001

07

Condição de pagamento

RM

TOTVS Rental

PaymentCondition

3.000
08Centro de custoRMTOTVS RentalCostCenter2.000

Processos

09Pedido de vendaTOTVS RentalRMOrder3.002
10Consulta Saldos e CustosTOTVS RentalRMStockLevel1.001TOTVS Rental solicita ao RM e o RM retorna com os dados solicitados
11Consulta rastreabilidade de pedidos e movimentações decorrentes

TOTVS Rental

RMTraceAbilityOrder1.000TOTVS Rental solicita ao RM e o RM retorna com os dados solicitados
12Notifica Cancelamento de Nota Fiscal / Fatura de LocaçãoRMTOTVS RentalCancelInvoiceNotify1.000

Cadastros

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

Cadastro de Cliente/Fornecedor

...

Expandir

Os Produtos/Serviços devem cadastrados somente no BackOffice RM e sincronizados automaticamente para o Protheus através de mensagem única Item. 

As regras referente à esta entidade pode podem ser conferida conferidas no documento de de Integração de Produto/Serviço, é de suma importancia importância o entendimento da regra definido definida neste documento.

Dentro do cadastro de produto na aba integrações deve estar marcado Disponível para Manutenção/Locação para que sejam integrados.

...

Expandir

Os Centros de Custo devem ser cadastrados somente no BackOffice RM e sincronizados automaticamente para o Protheus através de mensagem única CostCenter. 

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.

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 Rental -> RM
Mensagem: Order
Versão: 3.002
Mapeamento de Campos: https://tdn.totvs.com/x/C0fQHw

...

Expandir

As Solicitações de Emissão de NF/Fatura (Pedido de Vendas) serão registradas no TOTVS Rental e enviadas para o Backoffice RM, via mensagem única Order.

Poderão ser utilizadas quatro tipos de solicitações: Solicitações de Emissão NF de Remesssa, Solicitações de Emissão de Fatura Locação, Solicitações de Emissão NFe e Solicitações de Emissão de NFSe.

Para cada tipo de solicitação deverá ser criado e parametrizado um tipo de movimento e este vinculado ao parâmetro do sistema.


Restrição do Processo:

Não é possível agrupar "n" solicitações  para faturamento em uma NF/Fatura, ou seja, uma solicitação só é possível ser fatura para um movimento de NF/Fatura.


Ponto de Atenção:

O cadastro de bens não fazem partem do escopo desta integração, portanto os equipamentos devem ser cadastrados no Protheus.

Para emitir as NF de remessa de equipamentos deverá ser realizado o cadastro dos equipamentos com os seu respectivos valores.


Consulta de Saldos e Custos

Tipo de Fluxo:  TOTVSRental Rental -> RM

Mensagem: StockLevel

...

Consulta Rastreabilidade de Pedido de Vendas

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

...

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

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

...

Expandir

Quando for executado o processo de Cancelamento de Movimento, caso o movimento seja Nota Fiscal e tenha como origem um Pedido de Venda gerado pelo TOTVS Rental, o BackOffice RM irá enviar ao TOTVS Rental a mensagem CancelInvoiceNotify, contendo os dados da nota fiscal cancelada. Os dados que serão enviados são: Data de emissão da NF, Número da NF Série da NF, Tipo da Nota (Entrada ou Saída).

Como fazer

Videos com exemplo dos Processos:

...