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.

Manual da Integração Quírons x BackOffice RM 


Aviso
titleIMPORTANTE

Este pacote de integração não está liberado para implantação, pois é necessário realizar primeiro o projeto piloto.

Contexto de Negócio

A integração Quírons xBackOfficeRM 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. 

...

Arquitetura da Integração


DESENHOImage Added



BackOffice RM

Configurar a integração Quírons x BackOffice RM via host na versão 12.1.34.142 ou superior.

Informações
iconfalse
titleObservação

Os cadastros mantidos pelo BackOffice RM, como por exemplo Requisitantes, Produtos e etc., devem estar desabilitados no Quírons em suas respectivas entidade evitando concorrência de dados.

Quírons 

  • Confi
  • Configurar os adapters utilizados na integração Quírons x BackOffice RM, conforme detalhado em [Configurações Adapter Quírons].

Escopo

O Quírons foi construído com base na arquitetura SaaS, permitindo o acesso e integração em nuvem. Desta forma suas liberações ocorrem de maneira automática, sendo que a aplicação sempre se encontra em sua versão mais atual.


Escopo

O O escopo deste projeto se restringe aos processos de integração com o Quírons e os cadastros utilizados por estes.

...

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



Descrição

Origem

Destino

Mensagem Única

Versão da Mensagem

Observação

Cadastros






01ProdutoRMQuíronsItem4.005
02Unidade de MedidaRMQuíronsUnitOfMeasure2.002
03Local de estoqueRMQuíronsWareHouse1.000
04Centro de custoRMQuíronsCostCenter2.000
05Vendedor/Requisitante (pessoa que utilizará o EPI)RMQuíronsSeller3.002

06

Estoque / Posição de estoque

RM

Quírons

StockLevel

3.003Enviada ao Quírons sempre que houver uma movimentação de estoque no BackOffice

Processos

07Solicitações / Devoluções de EPI  (Requisição produtos EPI)QuíronsRMRequest1.011Possibilidade 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)QuíronsRMStockTurnOver1.007Possibilidade 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

QuíronsStockTurnOver1.007Ao atender a solicitação do EPI (Request) deverá enviar para o Quírons 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 Quírons.

Image Added

Cadastro de Produto/Serviço

...

Expandir
titleClique aqui para expandir

Os Produtos/Serviços devem cadastrados somente no BackOffice RM e sincronizados automaticamente para o Quírons 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

Expandir
titleClique aqui para expandir
  • O sistema Quírons consiste unidades de medidas que possuem a mesma descrição, sendo assim deverá ser revisado as descrições dos registros e ajustá-los.

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

Os produtos que serão integrados ao Quírons deverão ser parametrizados com EPI - Equipamento de Segurança Individual no cadastro do produto na Aba Integração marcando o parâmetro Integrado ao à Equipamento de Segurança Individual (EPI), após marcado este parâmetro o produto é integrado ao Quírons e este não poderá ser desmarcado, caso deseje não utilizar o EPI no Quírons e no RM o produto deverá ser inativo no RM e automaticamente será inativado no Quírons.

Vale ressaltar que para utilizar está integração a integração com o Totvs Segurança e Saúde Ocupacional (RM Vitae) não poderá esta ativa, ou seja, não é possível utilizar as duas integrações ao mesmo tempo, portanto deverá finalizar o uso da integração com o  Totvs Segurança e Saúde Ocupacional (RM Vitae) para iniciar a integração com o Quírons.. Importante avaliar os processos que estão em andamento no  Totvs Segurança e Saúde Ocupacional (RM Vitae) e parametrizações da integração, antes de finaliza-la.

O preço do produto enviado ao Quírons é o Preço 1 do Produto. Para que este campo seja habilitado no cadastro de Produto, o sistema deve usar a parametrização de Usa Preço 1 de Produtos. Esta parametrização é realizada através do módulo Gestão de Estoque, Compras e Faturamento menu Ambiente \ Parâmetros \ 04.01 - Parâmetros Gerais \ 04.01.04 - Tabelas \ 04.01.04.07 - Produtos \ 04.01.04.07.06 - Preços.

Importante: Os produtos que serão integrados com o Quírons não podem ser controlados grade e número de série, portando somente os produto padrões e controlados por lote podem ser utilizados na integração.

Cadastro de Unidades de Medida

Identificador da Mensagem: UnitOfMeasure
Versão: 2.002
Mandatário: Backoffice RM
Tipo de Envio: AssíncronoIdentificador 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/1ANZIQDYcpE

Notas: 

Expandir
titleClique aqui para expandir
  • É 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.
  • No cadastro da Pessoa deverá ser informado o CPF/CNPJ obrigatoriamente
  • 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 Quírons 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 Quírons. Abaixo são listados os processos integrados.

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

  • O sistema Quírons consiste unidades de medidas que possuem a mesma descrição, sendo assim deverá ser revisado as descrições dos registros e ajustá-los.

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

Cadastro de Centro de custo

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

Cadastro de Requisitante (vendedor)

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/1ANZIQTipo de Fluxo: Quírons → RM
Mensagem: Request
Versão: 1.011
Mapeamento de Campos: Solicitações (Request)

Notas:

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 Quírons.

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"

Image Removed     Image Removed

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"

 Image Removed    Image Removed

Expandir
titleClique aqui para expandir

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

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

Quírons -> RM

Expandir
titleClique aqui para expandir

A integração da baixa/entrada de estoque para o BackOffice RM ocorrerá quando o almoxarife/técnico de segurança 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 Quírons.

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 → Quírons
Mensagem: StockTurnover
Versão: 1.007
Mapeamento de Campos: Movimentação de estoque

RM -> Quírons

...

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

...

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.

Image Removed

O tipo de movimentos que será utilizado pelo Quírons como Entrega 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 Quírons - Parametrização Movimentos - EAI 2.0.

Será permitido realizar a Baixa parcial ou total da solicitação 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.

Devolução de EPI

O Movimento de devolução de estoque pode ser criado através de Faturamento da Solicitação de Devoluçã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 tipo de movimento que será utilizado pelo Quírons de Devolução 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 BackOffice x Quírons - Parametrização Movimentos - EAI 2.0.

Será permitido realizar a Entrada parcial ou total das Devolução de EPI. 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 devolução 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 Entrega de  EPI e Devolução de 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 Entrega de EPI e Devolução de EPI são os movimentos informados nos Parâmetros Adapter do módulo Integração, parâmetros: TMVEpiBaixaEstoque e TMVEpiEntradaEstoque.

  • É 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.
  • No cadastro da Pessoa deverá ser informado o CPF/CNPJ obrigatoriamente
  • Tipo do registro deve ser Vendedor e Comprador. Esta opção torna-se necessária, pois os tipos de movimento do Quírons são classificados como Emitente Empresa, Destinatário Empresa e começam com código 1. Mais informações sobre as regras desta entidade podem ser consultadas em Funcionário.
  • 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 Quírons 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 Quírons. 

Fluxo das informações de Solicitação e Entrega do EPI:

Image Added

Fluxo das informações de Entrega do EPI (movimentação direta):

Image Added


Abaixo são listados os processos integrados.

Solicitações/Devoluções de EPI (produtos de EPIs)

Tipo de Fluxo: Quírons → RM
Mensagem: Request
Versão: 1.011

Tipo de Envio: Síncrono
Mapeamento de Campos: Solicitações (Request)

Notas:

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 Devolução de EPI
  • 001 - Será criado um movimento de Solicitaçã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 Configuração RM.

Relembrando que, nesta integração, o requisitante\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 Quírons.

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"

Image Added     Image Added


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"

 Image Added    Image Added

Nota
titleImportante

A definição de utilização do processo de Solicitação é definida no Quírons ao cadastrar uma empresa, podendo ser definida por filial. Uma vez definido que na filial será utilizado Solicitação (Request) esta não poderá utilizar movimentação direta (entrega/devolução de EPI).

Portanto para cada filial é parametrizado um das duas regras de negócios.

Para configurar uma empresa no Quírons clique aqui.

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

Tipo de Fluxo: Quírons → RM 
Mensagem: StockTurnOver
Versão: 1.007

Tipo de Envio: Síncrono
Mapeamento de Campos: Movimentação de estoque

Notas:

Expandir
titleClique aqui para expandir

A integração da baixa/entrada de estoque para o BackOffice RM ocorrerá quando o almoxarife/técnico de segurança 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 Quírons.

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


Nota
titleImportante

A definição de utilização do processo de Movimentação direta (entrega de EPI) é definida no Quírons ao cadastrar uma empresa, podendo ser definida por filial. Uma vez definido que na filial será utilizado Movimentação (Movement) esta não poderá utilizar solicitação de EPI.

Portanto para cada filial é parametrizado um das duas regras de negócios.

Para configurar uma empresa no Quírons clique aqui.

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

Tipo de Fluxo: RM → Quírons
Mensagem: StockTurnover
Versão: 1.007

Tipo de Envio: Síncrono
Mapeamento de Campos: Movimentação de estoque

RM -> Quírons

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.

Image Added

O tipo de movimentos que será utilizado pelo Quírons como Entrega 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 Quírons - Parametrização Movimentos - EAI 2.0.

Será permitido realizar a Baixa parcial ou total da solicitação 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.


Devolução de EPI

O Movimento de devolução de estoque pode ser criado através de Faturamento da Solicitação de Devoluçã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 tipo de movimento que será utilizado pelo Quírons de Devolução 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 BackOffice x Quírons - Parametrização Movimentos - EAI 2.0.

Será permitido realizar a Entrada parcial ou total das Devolução de EPI. 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 devolução 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 Entrega de  EPI e Devolução de 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 Entrega de EPI e Devolução 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 → Quírons

Mensagem: StockLevel

Versão: 3.003

Tipo de Envio: Assíncrono
Mapeamento de Campos: Consultas de saldos e custos (StockLevel)

Notas

Expandir
titleClique aqui para expandir

A posição de estoque será enviada no processo de Carga de Dados realizada no inicio da implantação.

Enviada ao Quírons 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 Quírons.

A StockLevel é do tipo request mas na integração com o NG Quírons existe a particularidade de o BackOffice RM enviar as informações de saldos e custos (sempre que houver uma movimentação que afete o estoque de produtos que são EPI) sem a necessidade de um request por parte do Quírons então ela se comporta com uma mensagem do tipo event. Neste caso o BusinessContent da mensagem nada mais é que o ReturnContent do schema padronizado (e acordado entra as linhas) quando se trata de um request para tal mensagem.

Configurações da Integração

Deck of Cards
idconfiguracao
Card
defaulttrue
idconfigurador
labelConfigurações RM

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.


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 Quírons e proceder para instalar o pacote de integração.

Image Added

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 Added


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 Added

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 Added

Image Added


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

Image Added


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 Added


Image Added


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 Added


Image Added

Card
idparamTipoMovimentoQuirons
labelParametrização Movimentos

Este documento tem como objetivo demonstrar as parametrizações dos tipos de movimento utilizados na integração do BackOffice RM x Quírons.
Consta apenas as parametrizações utilizadas na integração, outras informações necessárias pela empresa (contábil, financeiro, fiscal e etc) devem ser parametrizados conforme a necessidade.
IMPORTANTE: A integração envolve vários processos e vários tipos de movimento, não é obrigatório parametrizar todos, somente os tipos de movimento dos processos que serão utilizados na integração.

Ponto de Atenção: O Ideal é criar novas séries para os movimentos da integração, assim, o RM e Quírons começam da numeração 0 e não ocorre problema de número repetido.


  1. Selecionar o sistema BackOffice | Gestão de estoque, compras e faturamento.
    Image Added

  2. Acessar Ambiente | Parâmetros | Gestão de estoque, compras e faturamento e Avançar.
    Image Added

  3. Selecionar a Classificação de acordo com o Tipo de Movimento que está criando (Exemplo: Baixa de Estoque seria selecionado em Gestão de Estoque).
    Observação: A classificação é Gerencial da empresa, para o funcionamento do sistema pode ser qualquer classificação para os movimentos.
    Image Added

  4. Incluir os tipos de movimento, informando os parâmetros necessários.
    Observação: Os prints são apenas um exemplo. Os campos que precisam ser preenchidos exatamente igual estão citados nas tabelas dos tipos de movimento (Passo 6).
    Image Added
    Image Added
    Image Added

  5. Após incluir o Tipo de Movimento, selecionar o mesmo e clicar no ícone parametrizar.
    Image Added

  6. Informar os parâmetros conforme as tabelas abaixo.


Aviso
titleATENÇÂO

Os tipos de movimentos para serem utilizados nos processos do Quírons devem ser novos. Não utilizar os tipos de movimentos já existentes na base.



Expandir
title1.1.XX - Solicitação de Epi (Clique aqui para exibir a parametrização)

TMV - Solicitação de Epi

EtapaCampoValor



Mov - Identificação
Código1.1.XX (Informado na Criação do Tipo de movimento)
Classificação (Sugestão)Requisição de Materiais (Gestão de Estoque)
Edita NumeraçãoMostra
Máscara Número[Igual a Máscara do Número no Quírons]
Buscar Número emFilial
Edição da SérieMostra



Mov - Emitente / Destinatário 1/2

EmitenteEmpresa
Edição da Filial de EmissãoEdita
Edição do Local de EmissãoEdita
DestinatárioEmpresa
Edição do Local de DestinoNão Edita
Mov - Emitente / Destinatário 2/2Edição do Local de SaídaNão Edita


Mov - Datas 1/2


Data de EmissãoEdita
Data do MovimentoData de Emissão
Data de EntregaNão Edita
Mov - Outros DadosNão Calcular movimento ao abrir para ediçãoMarcado
Mov - Tab - FuncionáriosEdição Funcionário 2Edita
Título do Funcionário 2Requisitante (ou o nome que achar melhor)


Mov - Valores Financeiros 2/4

(Default, pode ser alterado)

Fórmula do Valor Bruto[Código da fórmula do Valor Bruto]
Fórmula do Sub-Total[Código da fórmula do Sub-Total]
Fórmula do Valor Líquido[Código da fórmula do Valor Líquido]
Edita MoedaNão Edita
Mov - Campos Livres 1/2Edita ObservaçãoMarcado


Item - Identificação 1/2

Nº Máximo de itens999
Código do produtoCódigo Principal
Tipo dos itensProdutos
Data EntregaNão Edita
Item - Identificação 2/2Unidade de Medida PadrãoUnidade de Controle
Critério para alteraçãoNão permitir alterar
Permitir item repetidoMarcado


Item - Preços

Edição de PreçosMostra
Aceitar preço zeroMarcado
Recalcular Preço Obtido por FórmulaNunca Recalcular

Item – Tab – Global

Centro de CustoEdita
ObrigatórioMarcado
Estoque / Estoque 2/3Local de estoque por ItemMarcado



Compra/Venda – Características (Opcional)

Opção de FaturamentoCom seleção do tipo de movimento
Movimento Gerado[Tipo de Movimento de Baixa EPI]
Baixar Pedido de Venda após Geração do MovimentoBaixa para Movimento Default
Efeito do PedidoFaturar Parcial - Quantidade
Pedir confirmação da baixa do Pedido de VendaDesmarcado
Expandir
title1.1.XX - Solicitação de Devolução de EPI (Clique aqui para exibir a parametrização)

TMV - Solicitação de Devolução de EPI

EtapaCampoValor



Mov - Identificação
Código1.1.XX (Informado na Criação do Tipo de movimento)
Classificação (Sugestão)Requisição de Materiais (Gestão de Estoque)
Edita NumeraçãoMostra
Máscara Número[Igual a Máscara do Número no Quírons]
Buscar Número emFilial
Edição da SérieMostra



Mov - Emitente / Destinatário 1/2

EmitenteEmpresa
Edição da Filial de EmissãoEdita
Edição do Local de EmissãoEdita
DestinatárioEmpresa
Edição do Local de DestinoNão Edita
Mov - Emitente / Destinatário 2/2Edição do Local de SaídaNão Edita


Mov - Datas 1/2


Data de EmissãoEdita
Data do MovimentoData de Emissão
Data de EntregaNão Edita
Mov - Outros DadosNão Calcular movimento ao abrir para ediçãoMarcado
Mov - Tab - FuncionáriosEdição Funcionário 2Edita
Título do Funcionário 2Requisitante (ou o nome que achar melhor)


Mov - Valores Financeiros 2/4

(Default, pode ser alterado)

Fórmula do Valor Bruto[Código da fórmula do Valor Bruto]
Fórmula do Sub-Total[Código da fórmula do Sub-Total]
Fórmula do Valor Líquido[Código da fórmula do Valor Líquido]
Edita MoedaNão Edita
Mov - Campos Livres 1/2Edita ObservaçãoMarcado


Item - Identificação 1/2

Nº Máximo de itens999
Código do produtoCódigo Principal
Tipo dos itensProdutos
Data EntregaNão Edita
Item - Identificação 2/2Unidade de Medida PadrãoUnidade de Controle
Critério para alteraçãoNão permitir alterar
Permitir item repetidoMarcado


Item - Preços

Edição de PreçosNão Edita
Aceitar preço zeroMarcado
Recalcular Preço Obtido por FórmulaNunca Recalcular

Item – Tab – Global

Centro de CustoEdita
ObrigatórioMarcado
Estoque / Estoque 2/3Local de estoque por ItemMarcado




Compra/Venda – Características (Opcional)

Opção de FaturamentoCom seleção do tipo de movimento
Lançamentos Pedido Faturado ParcialmenteNão Gerar
Movimento Gerado[Tipo de Movimento de Entrada de EPI]
Baixar Pedido de Venda após Geração do MovimentoBaixa para movimento Default
Exibição Após FaturamentoVoltar para o Tipo de Movimento de Origem
Efeito do PedidoFaturar Parcial - Quantidade
Pedir confirmação da baixa do Pedido de VendaMarcado
Expandir
title1.1.XX - Entrega de EPI (Clique aqui para exibir a parametrização)

TMV - Entrega de EPI

EtapaCampoValor



Mov - Identificação
Código1.1.XX (Informado na Criação do Tipo de movimento)
Classificação (Sugestão)Baixa de Estoque (Gestão de Estoque)
Edita NumeraçãoMostra
Máscara Número[Igual a Máscara do Número no Protheus]
Buscar Número emFilial
Edição da SérieMostra



Mov - Emitente / Destinatário 1/2

EmitenteEmpresa
Edição da Filial de EmissãoEdita
Edição do Local de EmissãoEdita
DestinatárioEmpresa
Edição do Local de DestinoNão Edita
Mov - Emitente / Destinatário 2/2Edição do Local de SaídaNão Edita


Mov - Datas 1/2


Data de EmissãoEdita
Data do MovimentoData de Emissão
Data de EntregaNão Edita


Mov - Valores Financeiros 2/4

(Default, pode ser alterado)

Fórmula do Valor Bruto[Código da fórmula do Valor Bruto]
Fórmula do Sub-Total[Código da fórmula do Sub-Total]
Fórmula do Valor Líquido[Código da fórmula do Valor Líquido]
Edita MoedaNão Edita
Mov - Campos Livres 1/2Edita ObservaçãoMarcado


Item - Identificação 1/2

Nº Máximo de itens999
Código do produtoCódigo Principal
Tipo dos itensProdutos
Item - Identificação 2/2Critério para alteraçãoNão Permite Alterar
Permitir item repetidoMarcado


Item - Preços

Edição de PreçosEdita
Editar Preço totalCalcular Preço Total
Aceitar preço zeroMarcado
Recalcular Preço Obtido por FórmulaRecalcular sempre ao recalcular movimento


Item – Lote/Grade/Num.

Aceita Número de SérieMarcado
Editar Grade NumeradaMarcado
Consiste LoteMarcado
Status de Lote MovimentadosSelecionar os status que podem ser movimentados (Gerencial)

Item – Tab – Global

Centro de CustoEdita
ObrigatórioMarcado
Estoque / Estoque 1/3Saldo AtualDiminui
Estoque / Estoque 2/3Efeito sobre o saldo atualDiminui
Local de estoque por ItemMarcado
Integração Mensagem ÚnicaMensagem de IntegraçãoBaixa de Estoque
Fórmula Valor ItemFórmula que altera o valor do item a ser reportado, caso esteja em branco, é retornado o valor líquido do item.
Expandir
title1.1.XX - Devolução de EPI (Clique aqui para exibir a parametrização)

TMV - Devolução de EPI

EtapaCampoValor



Mov - Identificação
Código1.1.XX (Informado na Criação do Tipo de movimento)
Classificação (Sugestão)Recebimento de Materiais (Gestão de Compras)
Edita NumeraçãoMostra
Máscara Número[Igual a Máscara do Número no Quírons]
Buscar Número emFilial
Edição da SérieMostra



Mov - Emitente / Destinatário 1/2

EmitenteEmpresa
Edição da Filial de EmissãoEdita
Edição do Local de EmissãoEdita
DestinatárioEmpresa
Edição do Local de DestinoNão Edita
Mov - Emitente / Destinatário 2/2Edição do Local de SaídaNão Edita


Mov - Datas 1/2


Data de EmissãoEdita
Data do MovimentoData de Emissão
Data de EntregaNão Edita
Mov - Outros DadosNão Calcular movimento ao abrir para ediçãoMarcado
Mov - Tab - FuncionárioEdição Funcionário 2Edita
Título do Funcionário 2(Nome que desejar)


Mov - Valores Financeiros 2/4

(Default, pode ser alterado)

Fórmula do Valor Bruto[Código da fórmula do Valor Bruto]
Fórmula do Sub-Total[Código da fórmula do Sub-Total]
Fórmula do Valor Líquido[Código da fórmula do Valor Líquido]
Edita MoedaNão Edita
Mov - Campos Livres 1/2Edita ObservaçãoMarcado


Item - Identificação 1/2

Nº Máximo de itens999
Código do produtoCódigo Principal
Tipo dos itensProdutos
Data EntregaNão Edita
Item - Identificação 2/2Unidade de Medida PadrãoUnidade de Controle
Critério para AlteraçãoNão permite alterar
Permitir item repetidoMarcado


Item - Preços

Edição de PreçosEdita
Aceitar preço zeroMarcado
Recalcular Preço Obtido por FórmulaRecalcular sempre ao recalcular movimento
Buscar Preço EmPreço 1


Item – Lote/Grade/Num.

Aceita Número de SérieMarcado
Editar Grade NumeradaMarcado
Consiste LoteMarcado
Status de Lote MovimentadosSelecionar os status que podem ser movimentados (Gerencial)

Item – Tab – Global

Centro de CustoEdita
ObrigatórioMarcado
Estoque / Estoque 1/3Saldo AtualAumenta


Estoque / Estoque 2/3

Efeito sobre o saldo atualAumenta
Fórmula do Valor Financeiro[Código da fórmula do Valor Financeiro]
Local de estoque por ItemMarcado
Integração Mensagem ÚnicaMensagem de IntegraçãoEntrada em Estoque
Card
idconfiguraQuirons
labelConfigurações Quírons

Para a configuração da integração Quírons, é necessário seguir a documentação abaixo:

https://intercom.help/quirons/pt-BR/articles/6097239-configuracao-integracao-estoque

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

Tipo de Fluxo: RM → Quírons

Mensagem: StockLevel

Versão: 3.003
Mapeamento de Campos: Consultas de saldos e custos (StockLevel)

Notas

Expandir
titleClique aqui para expandir

A posição de estoque será enviada no processo de Carga de Dados realizada no inicio da implantação.

Enviada ao Quírons 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 Quírons.

A StockLevel é do tipo request mas na integração com o NG Quírons existe a particularidade de o BackOffice RM enviar as informações de saldos e custos (sempre que houver uma movimentação que afete o estoque) sem a necessidade de um request por parte do Quírons então ela se comporta com uma mensagem do tipo event. Neste caso o BusinessContent da mensagem nada mais é que o ReturnContent do schema padronizado (e acordado entra as linhas) quando se trata de um request para tal mensagem.

Deck of Cards
idconfiguracao

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.

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 Removed

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 Removed

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 Removed

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 Removed

Image Removed

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

Image Removed

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 Removed

Image Removed

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 Removed

Image Removed

Card
defaulttrue
idconfigurador
labelConfigurador EAI 2
Card
idparamTipoMovimentoQuirons
labelParametrização Movimentos

BackofficeRM x Quírons - Parametrização Movimentos


Card
idcheckListQuirons
labelCheck List de Implantação

Check List de Implantação - RMxQuírons