Histórico da Página
Manual da Integração Quírons x
...
DATASUL
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.
Por meio da integração os clientes podem usufruir da potencialidade do Quírons e suas avançadas funcionalidades comunicando-se com o módulo BackOffice RM de maneira que a Gestão de Suprimentos possa gerenciar o estoque dos equipamentos de proteção individual (EPI) utilizados pelos funcionários da empresas, trazendo mais agilidade e segurança no controle de estoque dos EPIs.
A integração do Quírons com os produtos da linha TOTVS RM ficou muito mais simples e transparente. Com a atualização do Quírons basta efetuar as devidas configurações e parametrizações em ambos módulos, BackOffice RM e Quírons, para que a comunicação entre os sistemas esteja disponível imediatamente.
Por exemplo: ao realizar uma entrega de equipamento o Quírons enviará ao BackOffice RM uma solicitação de estoque de maneira a garantir a entrega do EPI. Tudo de forma rápida e sem complicação.
Sistemas Envolvidos
Descrição dos sistemas envolvidos no contexto de negócio (e que serão envolvidos na integração).
- NG Quírons - Software de gestão de medicina e segurança do trabalho:
NG Quírons: SST - Saúde e Segurança do Trabalho.
- TOTVS BackOffice - Linha RM através dos seguintes módulos:
- TOTVS Gestão de Estoque, Compras e Faturamento (RM Nucleus): Módulo utilizado pelo cliente, sendo responsável pela manutenção dos cadastros (Unidade de medida, Produto, Local de Estoque, Requisitante, Movimentações [solicitação/baixa de estoque], Gestão de estoque, integrações fiscais, financeiras e demais processos da empresa;
- TOTVS Integração: Módulo responsável pelo framework de integração.
Integração
Para atender a demanda de clientes que possuem o TOTVS BackOffice - Linha RM e o Quírons foi desenvolvida esta integração que possibilita a gestão das solicitações de produtos EPIs (sincronização de produtos EPI's, posição de estoque, requisição, baixa, vinculação do equipamento funcionário e devolução de equipamentos) a partir do BackOffice RM e a SST através do Quírons sincronizando informações entre tais módulos utilizando a plataforma de integração baseada na Mensagem Única TOTVS.
Arquitetura da Integração
BackOffice RM
Configurar a integração Quírons x BackOffice RM via host na versão 12.1.34.142 ou superior.
| 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
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.
...
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: https://tdn.totvs.com/x/sBzHG
Notas:
| Expandir | ||
|---|---|---|
| ||
Os Produtos/Serviços devem cadastrados somente no BackOffice RM e sincronizados automaticamente para o Quírons através de mensagem única Item. Os produtos que serão integrados ao Quírons deverão ser parametrizados com EPI - Equipamento de Segurança Individual. 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
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 | ||
|---|---|---|
| ||
|
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/1ANZIQ
Notas:
| Expandir | ||
|---|---|---|
| ||
|
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:
Fluxo das informações de Entrega do EPI (movimentação direta):
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:
...
| 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 | ||
|---|---|---|
| ||
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:
...
| title | Clique 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 | ||
|---|---|---|
| ||
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
...
| title | Clique aqui para expandir |
|---|
ão entre o sistema Quírons eDATASUL possibilita o intercâmbio de informações relacionadas com os módulos de Medicina e Segurança do Trabalho.
A seguir destacamos as APIs de integração e os objetos utilizados em cada processo:
Integração NG - API Treinamentos
Objetivo: integrar informações da tabela de treinamento do HCM com o sistema NG
prghur/fpp/apiClasses.p
prghur/fpp/apiClassesV1.i
prghur/fpp/fpefd561.p
rh/api/v1/Classes.p
Integração NG - API Tipos de Estabilidade
Objetivo: integrar informações da tabela de Tipos de Estabilidade do HCM com o sistema NG
prghur/fpp/apiStabilityType.p
prghur/fpp/apiStabilityTypeV1.i
prghur/fpp/fpefd561.p
rh/api/v1/StabilityType.p
Integração NG - API Informações Adicionais
Objetivo: integrar informações de Adicional da NG para integrar com as informações de funcionário para o sistema do HCM
prghur/fpp/apiAdditional.p
prghur/fpp/fpefd563b.p
rh/api/v1/Additional.p
Integração NG - API Histórico Funcional (Local de Trabalho, Função, Depto, Seção)
Objetivo: integrar informações da tabela de Histórico Funcional do HCM com o sistema NG
prghur/fpp/employeeHistoryPosition.p
database/tgpy/twp/twpy085.p
Integração NG - API Funcionario
Objetivo: integrar informações da tabela de Funcionário do HCM com o sistema NG
prghur/fpp/employee.p
database/tgpy/twp/twpy085.p
Integração NG - API Dependentes
Objetivo: integrar informações da tabela de Dependentes do HCM com o sistema NG
database/inpy/i01py00838.i
database/inpy/i01py00840.i
database/inpy/i02py00838.i
database/inpy/i02py00840.i
database/tgpy/tcp/tcpy00838.p
database/tgpy/tcp/tcpy00840.p
database/tgpy/tdp/tdpy00838.p
database/tgpy/tdp/tdpy00840.p
database/tgpy/twp/twpy00838.p
database/tgpy/twp/twpy00840.p
prghur/fpp/employeeDependents.p
rh/api/v1/generics/rh-integ.i
database/tgpy/twp/twpy047.p
Integração NG - API Pessoa Física
Objetivo: integrar informações da tabela de Pessoa Física do HCM com o sistema NG
database/tgpm/twp/twpm200.p
database/tgpy/twp/twpy085.p
database/tgpy/twp/twpy257.p
prghur/fpp/person.p
Integração NG - API Realização Treinamento
Objetivo: integrar informações da tabela de Realização Treinamento do HCM com o sistema NG
prghur/fpp/trainingHistory.p
database/tgpm/twp/twpm064.p
Integração NG - API Abono
Objetivo: integrar informações de Abono do sistema NG com a tabela de abono do HCM.
prghur/fpp/apiAllowanceControl.p
prghur/fpp/fpefd563a.p
rh/api/v1/AllowanceControl.p
Integração NG - API Afastamento
Objetivo: integrar informações de Afastamento do sistema NG com informações do Afastamento do HCM
prghur/fpp/apiLeaveOfAbsenceControl.p
rh/api/v1/LeaveOfAbsenceControl.p
Integração NG - API Centro Custo
Objetivo: Integrar informações da tabela de centro de custos do HCM com o sistema NG.
prghur/fpp/apiPayRollCostCenter.p
prghur/fpp/apiPayRollCostCenterV1.i
prghur/fpp/fpefd561.i
prghur/fpp/fpefd561.p
rh/api/v1/PayRollCostCenter.p
Integração NG - API Cargo/Função
Objetivo: Integrar informações da tabela de cargo do HCM com o sistema NG.
prghur/fpp/apiPositions.p
prghur/fpp/apiPositionsV1.i
rh/api/v1/Positions.p
prghur/fpp/fpefd561.p
Integração NG - API Tipos de Afastamentos
Objetivo: Integrar informações da tabela de tipos de afastamentos do HCM com o sistema NG.
prghur/fpp/apiLeaveOfAbsenceType.p
prghur/fpp/apiLeaveOfAbsenceTypeV1.i
rh/api/v1/LeaveOfAbsenceType.p
Integração NG - API Turno de Trabalho
Objetivo: Integrar informações da tabela de turnos de trabalhos do HCM com o sistema NG.
prghur/fpp/apiWorkingShift.p
prghur/fpp/apiWorkingShiftV1.i
rh/api/v1/WorkingShift.p
Integração NG - API Tipos de Abono
Objetivo: Integrar informações da tabela de tipos de abonos do HCM com o sistema NG.
prghur/fpp/apiWorkingShift.p
prghur/fpp/apiWorkingShiftV1.i
rh/api/v1/WorkingShift.p
Integração NG - API Necessidade de Treinamento
Objetivo: Integrar informações de Necessidade de Treinamento do sistema NG com o sistema HCM.
prghur/fpp/apiTrainingNecessity.p
prghur/fpp/fpefd563d.p
rh/api/v1/TrainingNecessity.p
Integração NG - API Estabilidade
Objetivo: Integrar informações do sistema NG com as informações de "Estabilidade" do sistema HCM
prghur/fpp/apiStabilityControl.p
prghur/fpp/fpefd563c.p
rh/api/v1/StabilityControl.p
Integração NG - API Unidade de Lotação
Objetivo: Permitir que o Datasul envie informações de unidades de lotação (departamento) para o sistema da NG.
prghur/fpp/department.p
database/inpy/i02py00840.i
database/tgpy/tdp/tdpy286.p
database/tgpy/twp/twpy286.p
Integração NG - API Cargo
Objetivo: Permitir que o Datasul envie informações de Cargo para o sistema da NG.
prghur/fpp/position.p
database/tgpy/tdp/tdpy026.p
database/tgpy/twp/twpy026.p
prghur/mtp/mt1100rp.p
Integração NG - API – Ocupação
Objetivo: Alterar a API Positions para considerar somente a informação do Cargo. A positions deve ser inativa e deve ser substituída por occupation
prghur/fpp/apiOccupation.p
prghur/fpp/apiOccupationV1.i
rh/api/v1/Occupation.p
prghur/fpp/fpefd561.p
Integração NG - API Funcionário – Complemento
Objetivo: Integração do funcionário deve contemplar as informações de Cargo, Estado Civil, Grau de Instrução, CTPS, Nome da Mãe, Estado do endereço, Código da RAIS e Categoria eSocial afim de atender exigência de relatório legais no parceiro NG.
src/prghur/fpp/employee.p
Processos de Carga de dados:
Carga NG (Homologação x Produção)
object/sopm/vwr/v09pm338.w
Carga NG (Pessoa, Funcionários e Dependentes)
Objetivo: Efetuar o processo de carga das pessoas, funcionários e dependentes para integração da NG.
prghur/fpp/employeeDependentsLog.p
prghur/fpp/employeeLog.p
prghur/fpp/personLog.p
prghur/mtp/mt1000.w
prghur/mtp/mt1000rp.p
prghur/mtp/mt1000tt.i
Carga NG – (Lotação e Cargo)
Objetivo: Permitir que o Datasul realize o processo de carga das unidades de lotação e cargo para a NG.
prghur/mtp/mt1000.w
prghur/mtp/mt1000rp.p
prghur/mtp/mt1000tt.i
Sincronizador NG
Objetivo Permitir que as mensagens, Pendentes de envio ou com erro, relacionadas a Pessoas, Funcionários, Dependentes, Histórico Funcional e Realização de Treinamentos originadas a partir da Carga e/ou gatilho possam ser enviadas ao sistema da NG.
prghur/fpp/employee.p
prghur/fpp/employeeHistoryPosition.p
prghur/mtp/mt1100.w
prghur/mtp/mt1100rp.p
prghur/mtp/mt1100tt.i
src/prghur/mtp/mt1000rp.p
univdata/men_mmt.d
Alteração de informações com mensagem Pendente
Objetivo: Automatizar os cancelamentos das mensagens Pendentes/Erro caso o registro que originou a mensagem seja alterado.
rh/api/v1/generics/rh-integ.i
Chave identificadora | Ajuste dos status | Ajuste dos Gatilhos
database/tgpm/twp/twpm064.p
database/tgpm/twp/twpm200.p
database/tgpy/twp/twpy047.p
database/tgpy/twp/twpy085.p
database/tgpy/twp/twpy257.p
prghur/fpp/apiAllowanceTypes.p
database/inpy/i01py00840.i
prghur/fpp/apiPayRollCostCenter.p
prghur/fpp/apiLeaveOfAbsenceType.p
prghur/fpp/apiWorkingShift.p
prghur/fpp/apiPositions.p
prghur/fpp/apiClasses.p
prghur/fpp/apiStabilityType.p
prghur/fpp/employee.p
prghur/fpp/employeeDependents.p
prghur/fpp/trainingHistory.p
prghur/fpp/person.p
prghur/fpp/employeeHistoryPosition.p
Senha de validação - Integração NG
Objetivo: Criar validação por arquivo com chave de acesso para tela de ativação e programa de geração da carga de integração NG.
prghur/fpp/fpefd564.p
prghur/mtp/mt0004.w
gera-ativacao-integr-ng.p
Tela de Parametros
Objetivo: Disponibilizar ao usuário uma tela de configuração para integração com a NG que permite a configuração em base de Produção ou Ambiente de Homologação.
object/sopm/vwr/v09pm338.w
prghur/mtp/mt0004.w
| Expandir | ||
|---|---|---|
| ||
Geração de token de acesso Para geração do token de acesso é necessário criar o diretório “CFGHUR”. O programa "gera_ativacao_integr_ng.p" deve ser executado pelo editor da base. Deverá ser informado no campo BASE CNPJ/CPF os primeiros 8 dígitos do CNPJ de cada empresa que participará do processo de integração. Caso tenha dúvidas de onde localizar a informação, basta acessar o programa FP0500 – Parâmetros Empresa RH Após informar a base do CGC o programa gerará um novo arquivo contendo o token de acesso. O arquivo terá o nome "config_integr_ng.xml", e estará localizado na pasta C:\temp. Atenção: O arquivo config_integr_ng.xml deverá ser copiado para a pasta "cfghur" e este diretório deverá ser informado no propath da base do cliente. Seguindo os procedimentos descritos acima, ao acessar o programa MT0004 Manutenção Paramentros Medicina/Segurança, a pasta “Integrações“ ficará visível. Parametrização de credenciais de acesso MT0004 |
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.
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 | ||
|---|---|---|
| ||
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ções da Integração
| Deck of Cards | ||||||
|---|---|---|---|---|---|---|
| ||||||
| Card | | |||||
| ||||||
| Card | ||||||
| ||||||
| Expandir | ||||||
| ||||||
| 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 | ||||||
| ||||||
| 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 | ||||||
| ||||||
| 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 | ||||||
| ||||||
| 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 | Entrada em Estoque |
| Card | ||||
|---|---|---|---|---|
| ||||
Para a configuração da integração Quírons, é necessário seguir a seguinte sequência de etapas:
|
| id | checkListQuirons |
|---|---|
| label | Check List de Implantação |
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas