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

Aviso

title	IMPORTANTE

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.

...

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

Informações

icon	false
title	Observaçã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.

...

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

Image Modified

Cadastro de Produto/Serviço

...

Expandir

title	Clique 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.

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 Qúirons 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 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.

...

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/kkstENotas:

Cadastro de Centro de custo

Identificador da Mensagem: CostCenter
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: AssincronoAssí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/1ANZIQ

...

Expandir

title	Clique 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"

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"

Nota

title	Importante

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.

...

Expandir

title	Clique 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 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.

...

Deck of Cards

id	configuracao

Card

default	true
id	configurador
label	Configuraçõ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.

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.

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.

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

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

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.

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.

Card

id	paramTipoMovimentoQuirons
label	Parametrizaçã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.

Selecionar o sistema BackOffice | Gestão de estoque, compras e faturamento.
Acessar Ambiente | Parâmetros | Gestão de estoque, compras e faturamento e Avançar.
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.
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).
Após incluir o Tipo de Movimento, selecionar o mesmo e clicar no ícone parametrizar.
Informar os parâmetros conforme as tabelas abaixo.

Atenção

.

Aviso

title	ATENÇÂ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

title	1.1.XX - Solicitação de Epi (Clique aqui para exibir a parametrização)

TMV - Solicitação de Epi

Etapa	Campo	Valor
Mov - Identificação	Código	1.1.XX (Informado na Criação do Tipo de movimento)
	Classificação (Sugestão)	Requisição de Materiais (Gestão de Estoque)
	Edita Numeração	Mostra
	Máscara Número	[Igual a Máscara do Número no Quírons]
	Buscar Número em	Filial
	Edição da Série	Mostra
Mov - Emitente / Destinatário 1/2	Emitente	Empresa
	Edição da Filial de Emissão	Edita
	Edição do Local de Emissão	Edita
	Destinatário	Empresa
	Edição do Local de Destino	Não Edita
Mov - Emitente / Destinatário 2/2	Edição do Local de Saída	Não Edita
Mov - Datas 1/2	Data de Emissão	Edita
	Data do Movimento	Data de Emissão
	Data de Entrega	Não Edita
Mov - Outros Dados	Não Calcular movimento ao abrir para edição	Marcado
Mov - Tab - Funcionários	Edição Funcionário 2	Edita
Mov - Tab - Funcionários	Título do Funcionário 2	Requisitante (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 Moeda	Não Edita
Mov - Campos Livres 1/2	Edita Observação	Marcado
Item - Identificação 1/2	Nº Máximo de itens	999
	Código do produto	Código Principal
	Tipo dos itens	Produtos
	Data Entrega	Não Edita
Item - Identificação 2/2	Unidade de Medida Padrão	Unidade de Controle
	Critério para alteração	Não permitir alterar
	Permitir item repetido	Marcado
Item - Preços	Edição de Preços	Mostra
	Aceitar preço zero	Marcado
	Recalcular Preço Obtido por Fórmula	Nunca Recalcular
Item – Tab – Global	Centro de Custo	Edita
Item – Tab – Global	Obrigatório	Marcado
Estoque / Estoque 2/3	Local de estoque por Item	Marcado
Compra/Venda – Características (Opcional)	Opção de Faturamento	Com seleção do tipo de movimento
	Movimento Gerado	[Tipo de Movimento de Baixa EPI]
	Baixar Pedido de Venda após Geração do Movimento	Baixa para Movimento Default
	Efeito do Pedido	Faturar Parcial - Quantidade
	Pedir confirmação da baixa do Pedido de Venda	Desmarcado

Expandir

title	1.1.XX - Solicitação de Devolução de EPI (Clique aqui para exibir a parametrização)

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

Etapa	Campo	Valor
Mov - Identificação	Código	1.1.XX (Informado na Criação do Tipo de movimento)
	Classificação (Sugestão)	Requisição de Materiais (Gestão de Estoque)
	Edita Numeração	Mostra
	Máscara Número	[Igual a Máscara do Número no Quírons]
	Buscar Número em	Filial
	Edição da Série	Mostra
Mov - Emitente / Destinatário 1/2	Emitente	Empresa
	Edição da Filial de Emissão	Edita
	Edição do Local de Emissão	Edita
	Destinatário	Empresa
	Edição do Local de Destino	Não Edita
Mov - Emitente / Destinatário 2/2	Edição do Local de Saída	Não Edita
Mov - Datas 1/2	Data de Emissão	Edita
	Data do Movimento	Data de Emissão
	Data de Entrega	Não Edita
Mov - Outros Dados	Não Calcular movimento ao abrir para edição	Marcado
Mov - Tab - Funcionários	Edição Funcionário 2	Edita
Mov - Tab - Funcionários	Título do Funcionário 2	Requisitante (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 Moeda	Não Edita
Mov - Campos Livres 1/2	Edita Observação	Marcado
Item - Identificação 1/2	Nº Máximo de itens	999
	Código do produto	Código Principal
	Tipo dos itens	Produtos
	Data Entrega	Não Edita
Item - Identificação 2/2	Unidade de Medida Padrão	Unidade de Controle
	Critério para alteração	Não permitir alterar
	Permitir item repetido	Marcado
Item - Preços	Edição de Preços	Não Edita
	Aceitar preço zero	Marcado
	Recalcular Preço Obtido por Fórmula	Nunca Recalcular
Item – Tab – Global	Centro de Custo	Edita
Item – Tab – Global	Obrigatório	Marcado
Estoque / Estoque 2/3	Local de estoque por Item	Marcado
Compra/Venda – Características (Opcional)	Opção de Faturamento	Com seleção do tipo de movimento
	Lançamentos Pedido Faturado Parcialmente	Não Gerar
	Movimento Gerado	[Tipo de Movimento de Entrada de EPI]
	Baixar Pedido de Venda após Geração do Movimento	Baixa para movimento Default
	Exibição Após Faturamento	Voltar para o Tipo de Movimento de Origem
	Efeito do Pedido	Faturar Parcial - Quantidade
	Pedir confirmação da baixa do Pedido de Venda	Marcado

Expandir

title	1.1.XX - Entrega de EPI (Clique aqui para exibir a parametrização)

TMV - Entrega de EPI

Etapa	Campo	Valor
Mov - Identificação	Código	1.1.XX (Informado na Criação do Tipo de movimento)
	Classificação (Sugestão)	Baixa de Estoque (Gestão de Estoque)
	Edita Numeração	Mostra
	Máscara Número	[Igual a Máscara do Número no Protheus]
	Buscar Número em	Filial
	Edição da Série	Mostra
Mov - Emitente / Destinatário 1/2	Emitente	Empresa
	Edição da Filial de Emissão	Edita
	Edição do Local de Emissão	Edita
	Destinatário	Empresa
	Edição do Local de Destino	Não Edita
Mov - Emitente / Destinatário 2/2	Edição do Local de Saída	Não Edita
Mov - Datas 1/2	Data de Emissão	Edita
	Data do Movimento	Data de Emissão
	Data de Entrega	Nã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 Moeda	Não Edita
Mov - Campos Livres 1/2	Edita Observação	Marcado
Item - Identificação 1/2	Nº Máximo de itens	999
	Código do produto	Código Principal
	Tipo dos itens	Produtos
Item - Identificação 2/2	Critério para alteração	Não Permite Alterar
Item - Identificação 2/2	Permitir item repetido	Marcado
Item - Preços	Edição de Preços	Edita
	Editar Preço total	Calcular Preço Total
	Aceitar preço zero	Marcado
	Recalcular Preço Obtido por Fórmula	Recalcular sempre ao recalcular movimento
Item – Lote/Grade/Num.	Aceita Número de Série	Marcado
	Editar Grade Numerada	Marcado
	Consiste Lote	Marcado
	Status de Lote Movimentados	Selecionar os status que podem ser movimentados (Gerencial)
Item – Tab – Global	Centro de Custo	Edita
Item – Tab – Global	Obrigatório	Marcado
Estoque / Estoque 1/3	Saldo Atual	Diminui
Estoque / Estoque 2/3	Efeito sobre o saldo atual	Diminui
Estoque / Estoque 2/3	Local de estoque por Item	Marcado
Integração Mensagem Única	Mensagem de Integração	Baixa de Estoque
Integração Mensagem Única	Fórmula Valor Item	Fórmula que altera o valor do item a ser reportado, caso esteja em branco, é retornado o valor líquido do item.

Expandir

title	1.1.XX - Devolução de EPI (Clique aqui para exibir a parametrização)

TMV - Devolução de EPI

Item - Identificação /2Item - Identificação 2

Item - Preços

Item – Lote/Grade/Num.

Estoque / Estoque 2/3

Etapa	Campo	Valor
Mov - Identificação	Código	1.1.XX (Informado na Criação do Tipo de movimento)
	Classificação (Sugestão)	Recebimento de Materiais (Gestão de Compras)
	Edita Numeração	Mostra
	Máscara Número	[Igual a Máscara do Número no Quírons]
	Buscar Número em	Filial
	Edição da Série	Mostra
Mov - Emitente / Destinatário 1/2	Emitente	Empresa
	Edição da Filial de Emissão	Edita
	Edição do Local de Emissão	Edita
	Destinatário	Empresa
	Edição do Local de Destino	Não Edita
Mov - Emitente / Destinatário 2/2	Edição do Local de Saída	Não Edita
Mov - Datas 1/2	Data de Emissão	Edita
	Data do Movimento	Data de Emissão
	Data de Entrega	Não Edita
Mov - Outros Dados	Não Calcular movimento ao abrir para edição	Marcado
Mov - Tab - Funcionário	Edição Funcionário 2	Edita
Mov - Tab - Funcionário	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 Moeda	Não Edita
Mov - Campos Livres 1/2	Edita Observação	Marcado	1	Nº Máximo de itens	999
Código do produto	Código Principal
Tipo dos itens	Produtos
Data Entrega	Não Edita
/2	Unidade de Medida Padrão	Unidade de Controle
Critério para Alteração	Não permite alterar
Permitir item repetido	Marcado
Edição de Preços	Edita
Aceitar preço zero	Marcado
Recalcular Preço Obtido por Fórmula	Recalcular sempre ao recalcular movimento
Buscar Preço Em	Preço 1
Aceita Número de Série	Marcado
Editar Grade Numerada	Marcado
Consiste Lote	Marcado
Status de Lote Movimentados	Selecionar os status que podem ser movimentados (Gerencial)
Item – Tab – Global	Centro de Custo	Edita
Item – Tab – Global	Obrigatório	Marcado
Estoque / Estoque 1/3	Saldo Atual	Aumenta
Efeito sobre o saldo atual	Aumenta
Fórmula do Valor Financeiro	[Código da fórmula do Valor Financeiro]
Local de estoque por Item	Marcado
Integração Mensagem Única	Mensagem de Integração	Entrada em Estoque
	Edita Observação	Marcado
Item - Identificação 1/2	Nº Máximo de itens	999
	Código do produto	Código Principal
	Tipo dos itens	Produtos
	Data Entrega	Não Edita
Item - Identificação 2/2	Unidade de Medida Padrão	Unidade de Controle
	Critério para Alteração	Não permite alterar
	Permitir item repetido	Marcado
Item - Preços	Edição de Preços	Edita
	Aceitar preço zero	Marcado
	Recalcular Preço Obtido por Fórmula	Recalcular sempre ao recalcular movimento
	Buscar Preço Em	Preço 1
Item – Lote/Grade/Num.	Aceita Número de Série	Marcado
	Editar Grade Numerada	Marcado
	Consiste Lote	Marcado
	Status de Lote Movimentados	Selecionar os status que podem ser movimentados (Gerencial)
Item – Tab – Global	Centro de Custo	Edita
Item – Tab – Global	Obrigatório	Marcado
Estoque / Estoque 1/3	Saldo Atual	Aumenta
Estoque / Estoque 2/3	Efeito sobre o saldo atual	Aumenta
	Fórmula do Valor Financeiro	[Código da fórmula do Valor Financeiro]
	Local de estoque por Item	Marcado
Integração Mensagem Única	Mensagem de Integração	Entrada em Estoque

Card

id	configuraQuirons
label	Configuraçõ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

Card

id	configuraQuirons
label	Configurações Quírons

Para a configuração da integração Quírons, é necessário seguir a seguinte sequência de etapas:

- Selecione opção Minha conta, encontrada na parte superior da tela;

Image Removed

- O sistema direcionará para a tela de administração da conta. Selecione a aba ORGANIZAÇÃO;

Image Removed

- Na caixa Gerenciar Filiais acesse o registro, clicando sobre a filial escolhida, preencha os seguintes campos com as seguintes informações:
  - Empresa: o campo deve ser preenchido com o código da organização no ambiente ERP Totvs;
  - Filial: o campo deve ser preenchido com o código da filial no ambiente ERP Totvs;
  - Tipo da Integração:
    - Movement
    - Request
  - URL: preencha o campo com o URL do Webservice externo do ERP;
  - Porta: caso a porta não tenha sido informada na URL, preencha o campo com a porta do Webservice do ERP;
  - Forma de Autenticação: a forma de autenticação será BasicAuth;
  - Usuário: informe o usuário de acesso ao Webservice do ERP;
  - Senha: informe a senha de acesso ao Webservice do ERP.

Image Removed

As diferenças entre Requisição e Movimentação Direta são:

Requisição (Request): Gera uma Solicitação ao Armazém, permitindo que toda baixa e/ou devolução passe pelo aceite da área de estoque antes da efetiva movimentação dos saldos do produto

Movimentação Direta (Movement): Gera uma movimentação de baixa e/ou devolução direta no estoque, movimentando os saldos dos produtos

Card

id	checkListQuirons
label	Check List de Implantação

Check List de Implantação - RMxQuírons

Páginas filhas

Versões comparadas

Versão antiga 97

Nova versão 111

Chave

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