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

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.

Quírons 

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 escopo deste projeto se restringe aos processos de integração com o Quírons 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.

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

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

Notas: 

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

...

• 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

Escopo

O escopo deste projeto se restringe aos processos de integração com o Quírons 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.

...

Descrição

...

Origem

...

Destino

...

Mensagem Única

...

Versão da Mensagem

...

Cadastros

...

06

...

Estoque / Posição de estoque

...

RM

...

Quírons

...

StockLevel

...

Processos

...

RM

...

Cadastros

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

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: httpshttp://tdn.totvs.com/x/sBzHG

Notas: 

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: UnitOfMeasureSeller
Versão: 23.002
Mandatário: Backoffice BackOffice RM
Tipo de Envio: Assíncrono Assíncrono
Mapeamento de Campos RM: https://tdn.totvs.com/x/DYcpE1ANZIQ

Notas:

...

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

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

Notas:

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)

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

Tipo de Envio: Síncrono
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

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:

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

Quírons -> RM

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

...

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

...

Configurações da Integração

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. 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 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. Image Added Acessar Ambiente | Parâmetros | Gestão de estoque, compras e faturamento e Avançar. Image Added 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 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 Após incluir o Tipo de Movimento, selecionar o mesmo e clicar no ícone parametrizar. Image Added Informar os parâmetros conforme as tabelas abaixo. 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 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 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 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 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 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 Obrigatório Marcado Estoque / Estoque 1/3 Saldo Atual Diminui Estoque / Estoque 2/3 Efeito sobre o saldo atual Diminui Local de estoque por Item Marcado Integração Mensagem Única Mensagem de Integração Baixa de Estoque 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 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 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 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 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 seguinte sequência de etapas: Selecione opção Minha conta, encontrada na parte superior da tela;  Image Added O sistema direcionará para a tela de administração da conta. Selecione a aba ORGANIZAÇÃO; Image Added 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 Added 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
Deck of Cards
id configuracao
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 TMV - Solicitação de Epi Mov - Identificação Mov - Emitente / Destinatário 1/2 Mov - Datas 1/2 Mov - Valores Financeiros 2/4 (Default, pode ser alterado) Item - Identificação 1/2 Item - Preços Compra/Venda – Características (Opcional) TMV - Solicitação de Devolução de EPI Mov - Identificação Mov - Emitente / Destinatário 1/2 Mov - Datas 1/2 Mov - Valores Financeiros 2/4 (Default, pode ser alterado) Item - Identificação 1/2 Item - Preços Compra/Venda – Características (Opcional) TMV - Entrega de EPI Mov - Identificação Mov - Emitente / Destinatário 1/2 Mov - Datas 1/2 Mov - Valores Financeiros 2/4 (Default, pode ser alterado) Item - Identificação 1/2 Item - Preços Item – Lote/Grade/Num. TMV - Devolução de EPI Mov - Identificação Mov - Emitente / Destinatário 1/2 Mov - Datas 1/2 Mov - Valores Financeiros 2/4 (Default, pode ser alterado) Item - Identificação 1/2 Item - Preços Item – Lote/Grade/Num. Estoque / Estoque 2/3 Entrada em Estoque Card default true id configurador label Configurador EAI 2 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. Image Removed Acessar Ambiente | Parâmetros | Gestão de estoque, compras e faturamento e Avançar. Image Removed 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 Removed 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 Removed Image Removed Image Removed Após incluir o Tipo de Movimento, selecionar o mesmo e clicar no ícone parametrizar. Image Removed Informar os parâmetros conforme as tabelas abaixo. 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) Etapa Campo Valor 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 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 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 Título do Funcionário 2 Requisitante (ou o nome que achar melhor) 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 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 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 Obrigatório Marcado Estoque / Estoque 2/3 Local de estoque por Item Marcado 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) Etapa Campo Valor 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 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 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 Título do Funcionário 2 Requisitante (ou o nome que achar melhor) 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 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 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 Obrigatório Marcado Estoque / Estoque 2/3 Local de estoque por Item Marcado 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) Etapa Campo Valor 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 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 Data de Emissão Edita Data do Movimento Data de Emissão Data de Entrega Não Edita 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 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 Permitir item repetido Marcado 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 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 Obrigatório Marcado Estoque / Estoque 1/3 Saldo Atual Diminui Estoque / Estoque 2/3 Efeito sobre o saldo atual Diminui Local de estoque por Item Marcado Integração Mensagem Única Mensagem de Integração Baixa de Estoque 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) Etapa Campo Valor 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 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 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 Título do Funcionário 2 (Nome que desejar) 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 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 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 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 Card id checkListQuirons label Check List de Implantação Check List de Implantação - RMxQuírons