Páginas filhas
  • DI Quírons x BackOffice RM - EAI 2.0

Versões comparadas

Chave

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

...

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


Cadastro de Produto/Serviço

Identificador da Mensagem: Item
Versão: 4.005
Mandatário: BackOffice RM
Tipo de Envio: Assíncrono
Mapeamento de Campos RM: https://tdn.totvs.com/x/sBzHG

...

Expandir
titleClique aqui para expandir

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

As regras referente à esta entidade pode ser conferida no documento de Integração de Produto/Serviço


Cadastro de Unidades de Medida

Identificador da Mensagem: UnitOfMeasure
Versão: 2.002
Mandatário: Backoffice RM
Tipo de Envio: Assíncrono
Mapeamento de Campos RM: https://tdn.totvs.com/x/DYcpE

Notas


Cadastro de Local de Estoque

Identificador da Mensagem: Warehouse
Versão: 1.000
Mandatário: BackOffice RM
Tipo de Envio: Assíncrono
Mapeamento de Campos: http://tdn.totvs.com/x/kkstE

Notas:


Cadastro de Centro de custo

Identificador da Mensagem: CostCenter
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Assincrono
Mapeamento de Campos: http://tdn.totvs.com/x/w9b0E

Notas


Cadastro de Vendedor / Requisitante

Identificador da Mensagem: Seller
Versão: 3.002
Mandatário: BackOffice RM
Tipo de Envio: Assíncrono
Mapeamento de Campos RM: https://tdn.totvs.com/x/1ANZIQ

...

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 Quirons mas que sejam de alçada, controle e manipulação no Backoffice, como integrações fiscais, financeiras ou controle de estoque ou que sofram ações no TOTVS RM mas precisam ser informadas/relatadas ao Quirons. Abaixo são listados os processos integrados.

Solicitações/Devoluções de EPI / Requisições de Armazém/Compra (produtos de EPIs)

Tipo de Fluxo: Quirons → RM
Mensagem: Request
Versão: 1.011
Mapeamento de Campos: Solicitações (Request)

...

Expandir
titleClique aqui para expandir

As solicitações recebidas no BackOffice RM poderão ser: Solicitação de EPI ou Solicitação de Devolução de EPI. Na mensagem padronizada Request o campo que irá identificar qual é o tipo de solicitação será o valor enviado na tag Type que podem ser:

  • 000 - Será criado um movimento de Solicitação de EPI
  • 001 - Será criado um movimento de Solicitação de Devolução de EPI

Além disso é necessário definir nos Parâmetros do Adapter, no módulo de Integrações, qual é o código do tipo de movimento que será utilizado para cada tipo de solicitação. Para maiores informações acesse a página Configurador EAI 2.0 - Quírons x BackOffice RM#3.

Relembrando que, nesta integração, o vendedor no TOTVS RM (seller) está associado a uma pessoa (tabela PPESSOA) que é o colaborador/funcionário e tais registros são integrados com o Quirons.

O requisitante do EPI é dado pelo SellerCode/SellerInternalId que trafega na mensagem de request então este requisitante é a pessoa vinculada ao vendedor (seller) que foi informada/enviada na mensagem. Com base nisso orientamos que nos tipos de movimentos utilizados para Solicitação/Devolução de EPI seja configurado como Edita o parâmetro Edição Funcionário 2 localizado na Etapa Movimento - Tabelas - Funcionários dos parâmetros de Tipos de Movimentos.

Os movimentos criados pelo Quírons não poderão ser cancelados e/ou excluídos pelo usuário do BackOffice RM. Caso necessite realizar a ação de excluir item de movimento ou excluir movimento de solicitações/devoluções de EPI esta ação deverá ser realizado no sistema Quírons que deverá enviar ao RM uma mensagem Request com evento de Delete (tag Event igual a delete).


Tipo de movimento de Solicitação de EPI

É muito importante que a propriedade "Movimento Gerado (Default)" do tipo de movimento que representará as solicitações de EPI esteja valorado com o tipo de movimento de baixa de estoque informado nos "Parâmetros do adapter"

   


Tipo de movimento de Solicitação de devolução de EPI

É muito importante que a propriedade "Movimento Gerado (Default)" do tipo de movimento que representará as solicitações de devolução de EPI esteja valorado com o tipo de movimento de entrada de estoque informado nos "Parâmetros do adapter"

     



Movimentação direta de estoque (produtos EPI), baixa de estoque

Tipo de Fluxo: Quirons → RM 
Mensagem: StockTurnOver
Versão: 1.007
Mapeamento de Campos: Movimentação de estoque

...

Expandir
titleClique aqui para expandir

A integração da baixa/entrada de estoque para o BackOffice RM ocorrerá quando o almoxarife/Quirons efetuar a entrega direta (ou devolução) de um item de EPI (produto) ao requisitante onde não ocorreu a necessidade de uma requisição/solicitação ao BackOffice, isto é, já tem-se o produto EPI em estoque.

ATENÇÃO: Relembrando que, nesta integração, o vendedor no TOTVS RM (seller) está associado a uma pessoa (tabela PPESSOA) que é o colaborador/funcionário e tais registros são integrados com o Quirons.

O requisitante do EPI é dado pelo SellerCode/SellerInternalId que trafega na mensagem de StockTurnOver então este requisitante é a pessoa vinculada ao vendedor (seller) que foi informada/enviada na mensagem

Os movimentos criados pelo Quírons não poderão ser cancelados e/ou excluídos pelo usuário do BackOffice RM. Caso necessite realizar a ação de excluir item de movimento ou excluir movimento de baixa de EPI esta ação deverá ser realizada no sistema Quírons que deverá enviar ao RM uma mensagem StockTurnOver com evento de Delete (tag Event igual a delete).


Atendimento a uma requisição de armazém/compra de EPI, entrega do EPI (total ou parcial), baixa de estoque

Tipo de Fluxo: RM → Quirons
Mensagem: StockTurnover
Versão: 1.007
Mapeamento de Campos: Movimentação de estoque

...

Expandir
titleClique aqui para expandir

A integração da baixa de estoque para o BackOffice RM ocorrerá quando o almoxarife e/ou técnico de segurança do trabalho efetuar a entrega direta de um item de EPI (produto) ao requisitante onde não ocorreu a necessidade de uma requisição/solicitação ao BackOffice, isto é, já tem-se o produto EPI em estoque.

Backoffice RM -> NG Quírons

A integração de movimentação de estoque para o NG Quírons ocorre ao efetuar a baixa ou a entrada de estoque no BackOffice a partir do faturamento de uma solicitação gerada pelo sistema Quírons. Neste processo é necessário configurar o tipo de movimento para gerar integração com sistema de medicina e segurança do trabalho (parametrização do tipo de movimento Etapa Integração Mensagem Única, opção Mensagem de Integração = Baixa de Estoque ou Mensagem de Integração = Entrada de Estoque).

Baixa de Estoque

O Movimento de baixa de estoque pode ser criado através de Faturamento da Solicitação do EPI, ou seja, não é permitido incluir manualmente uma Baixa de estoque no BackOffice RM sem ter uma origem de solicitação do Quírons. É recomendado que seja definido nas Permissões do Tipo de Movimento a configuração de Incluir desmarcado para o usuário que irá movimentar os produtos de EPI. Para realizar esta configuração acesse o módulo Serviços Globais menu Segurança \ Usuários \ Sistema: Gestão de Estoque, Compras e Faturamento \ Anexos.

Caso na etapa Integração Mensagem Única dos parâmetros do tipo do movimento de Baixa esteja preenchido a Fórmula Valor Item, o resultado da fórmula será o Custo Total do Item enviado ao Quírons. Caso a fórmula não esteja preenchida, o sistema irá considerar o Valor Liquido do Item.

O tipos de movimento que será utilizado pelo Quírons como Baixa de Estoque de EPI deve ter o seu código informado nos Parâmetros Adapter do módulo Integração parâmetro: TMVEpiBaixaEstoque. As configurações mínimas exigidas para o tipo de movimento utilizado pode ser consultado na página BackofficeRM x Quirons - Parametrização Movimentos - EAI 2.0.

Será permitido realizar a Baixa parcial ou total dos itens de EPI em estoque. Após salvar o movimento será enviado ao Quírons uma mensagem StockTurnOver onde esta mensagem conterá a informação de vínculo entre o item de baixado e o item solicitado.

Ao excluir uma baixa de estoque no RM será enviado ao Quírons uma mensagem StockTurnOver sinalizando a exclusão da baixa de estoque do EPI. Não será permitido excluir itens, somente o movimento por completo.


Entrada de Estoque

O Movimento de entrada de estoque pode ser criado através de Faturamento da Solicitação de Deveolução do EPI, ou seja, não é permitido incluir manualmente uma Entrada de estoque no BackOffice RM sem ter uma origem de solicitação de devolução do Quírons. É recomendado que seja definido nas Permissões do Tipo de Movimento a configuração de Incluir desmarcado para o usuário que irá movimentar os produtos de EPI. Para realizar esta configuração acesse o módulo Serviços Globais menu Segurança \ Usuários \ Sistema: Gestão de Estoque, Compras e Faturamento \ Anexos.

O tipos de movimento que será utilizado pelo Quírons Entrada de EPI deve ter o seu código informado nos Parâmetros Adapter do módulo Integração parâmetro: TMVEpiEntradaEstoque. As configurações mínimas exigidas para o tipo de movimento utilizado pode ser consultado na página BackofficeRM x Quirons - Parametrização Movimentos - EAI 2.0.

Será permitido realizar a Entrada parcial ou total dos itens de EPI em estoque. Após salvar o movimento será enviado ao Quírons uma mensagem StockTurnOver onde esta mensagem conterá a informação de vínculo entre o item de entrada e o item solicitado.

Ao excluir uma entrada de estoque no RM será enviado ao Quírons uma mensagem StockTurnOver sinalizando a exclusão da entrada de estoque do EPI. Não será permitido excluir itens, somente o movimento por completo.


Cancelamento de Movimento

Não será permitido Cancelar os movimentos definidos como Baixa de Estoque de EPI e Entrada de Estoque EPI utilizados na integração com Quírons. Caso seja executado processo de Cancelar de movimentos para um destes tipos de movimento, será apresentado ao usuário a mensagem "Movimentações de estoque integrados com Quírons não podem ser cancelados no BackOffice, podem somente ser excluídos. Use a ação de excluir movimento."

Lembrando que os tipos de movimentos utilizados pelo Quírons como Baixa de EPI e Entrada de EPI são os movimentos informados nos Parâmetros Adapter do módulo Integração, parâmetros: TMVEpiBaixaEstoque e TMVEpiEntradaEstoque.


Consulta de Saldos e Custos, Posição de estoque pós movimentação 

Tipo de Fluxo: RM → Quirons

...

Deck of Cards
idconfiguracao
Card
defaulttrue
idconfigurador
labelConfigurador EAI 2

Esta documentação não fará o detalhamento da instalação do Quírons . Ele orientará apenas a configuração do mesmo para integrar o Quírons com o BackOffice RM .Para seguir as configurações descritas  é importante que já se tenha o ambiente Quírons/TOTVS RM instalado.

Quírons : a partir da versão XXX

RM : a partir da versão 12.1.34

label
Card
defaulttrue
idconfigurador

Configurador EAI 2


Instalando/Configurando a integração

Através do módulo de Gestão de Estoque, Compras e Faturamento, acessar o menu Integrações | Integrações com Parceiros | Configurador EAI 2.0 Quírons x BackOffice RM e proceder para instalar o pacote de integração.

Image Modified

Na etapa de 1 do processo, informe os dados de acesso ao ambiente do Quírons e clique em validar. Observação: o botão Avançar ficará habilitado somente quando validar a Url.

Image Modified


Após a validação avance para o próximo passo e realize o De/Para de Empresa. Selecione a coligada e filial do RM e informe o seu correspondente no Quírons e clique no botão Adicionar De/Para.

Image Modified

Ao final do processo de instalação do pacote de integração serão criados na base o aplicativo, pacote instalado da integração do Quírons.


Confirmando a instalação da integração

Caso deseje verificar, ou se precisar alterar, pode-se acessar os detalhes das configurações/parametrizações da integração através do módulo Integração \  Menu EAI 2.0 \  Aplicativos

Image Modified

Image Modified


Para visualizar as entidades integradas (sejam cadastros ou consultas) pode-se acessar o anexo de Rotas no cadastro de Aplicativos (mostrado logo acima).

Image Modified


Para visualizar os De/Para de empresa, caso tenha sido informando durante a configuração, pode-se verificá-los acessando o menu EAI 2.0 \ De/Para.

Image Modified


Image Modified


Verificação dos parâmetros criados para a definição dos tipos de movimentos a serem utilizados para a requisição/devolução de EPI onde os valores, tipos de movimento, poderão serão de acordo com desejo/definição do cliente.

Image Modified


Image Modified

Card
idparamTipoMovimentoQuirons
labelParametrização Movimentos

BackofficeRM x Quirons - Parametrização Movimentos

Card
idcheckListQuirons
labelCheck List de Implantação

Check List de Implantação - RMxQuirons


Como fazer

Videos com exemplo dos Processos:

...