Histórico da Página
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 | 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 | 3.000 | ||
08 | Centro de custo | RM | TOTVS Rental | CostCenter | 2.000 | ||
Processos | |||||||
09 | Pedido de venda | TOTVS Rental | RM | Order | 3.002 | ||
10 | Consulta Saldos e Custos | TOTVS Rental | RM | StockLevel | 1.001 | TOTVS Rental solicita ao RM e o RM retorna com os dados solicitados | |
11 | 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 | |
12 | Notifica Cancelamento de Nota Fiscal / Fatura de Locação | RM | TOTVS Rental | CancelInvoiceNotify | 1.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. |
Cadastro de Local de 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
...
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:
...