...
Informações |
---|
|
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 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
...
- 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.
- 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:
Filial: o campo deve ser preenchido com o código da filial no ambiente ERP Totvs;
Tipo da Integração:
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
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 | Observação |
Cadastros
| 01 | Produto | RM | Quírons | Item | 4.005 |
|
02 | Unidade de Medida | RM | Quírons | UnitOfMeasure | 2.002 |
|
03 | Local de estoque | RM | Quírons | WareHouse | 1.000 |
|
04 | Centro de custo | RM | Quírons | CostCenter | 2.000 |
|
05 | Vendedor/Requisitante (pessoa que utilizará o EPI) | RM | Quírons | Seller | 3.002 |
|
06 | Estoque / Posição de estoque | RM | Quírons | StockLevel | 3.003 | Enviada ao Quírons sempre que houver uma movimentação de estoque no BackOffice |
Processos |
07 | Solicitações / Devoluções de EPI (Requisição produtos EPI) | Quírons | RM | Request | 1.011 | Possibilidade de dois tipos de Requisições: 1) Solicitação de EPI 2) Solicitação de Devolução de EPI |
08 | Movimentação direta de estoque (produtos EPI) | Quírons | RM | StockTurnOver | 1.007 | Possibilidade de dois tipos de movimentos de estoque: 1) Para baixa no estoque 2) Para devolução no estoque |
09 | Entrega (total ou parcial) do EPI | RM | Quírons | StockTurnOver | 1.007 | Ao 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.
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:
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 |
...
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: https://tdn.totvs.com/x/sBzHG
Notas:
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 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 |
Cadastro de Unidades de Medida
...
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 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. |
Configuração da Integração
Deck of Cards |
---|
|
Card |
---|
default | true |
---|
id | configurador |
---|
label | Configurador QuíronsEAI 2 |
---|
| Esta documentação não fará o detalhamento da instalação do Quírons . Ele orientará apenas a configuração do mesmo para integrar o Quírons com o BackOffice RM .Para seguir as configurações descritas é importante que já se tenha o ambiente Quírons/TOTVS RM instalado.
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.
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 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 |
|
|
|