Páginas filhas
  • Integração de Produto/Serviço

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Integração

Este documento tem como objetivo descrever as configurações necessárias para integrar o cadastro de Produto no EAI 2.0.

Pré-requisitos instalação/implantação/utilização

Para o correto funcionamento da integração é necessário realizar as seguintes configurações.

  • Utilizar Biblioteca RM versão 12.1.26 ou superior.
  • Possuir a base de dados convertida para o EAI 2.0.


Deck of Cards
idconfiguracao
Card
id1
labelProtheus
titleProtheus

Protheus

Compartilhamento de Tabela

O compartilhamento da tabela de Produtos no Protheus deve ser Exclusivo por Empresa e Compartilhado por Filial e Unidade de Negócio. Acesse SIGACFG / Dicionário / Base de dados / Base de dados, expande a Empresa e clica em "Dicionário de Dados", pesquise pela tabela SB1(Produto) e valide se o compartilhamento está da seguinte forma: Filial, Unidade como Compartilhado e Empresa como Exclusivo.

Configuração de Adapters

1 – Acesse: Protheus.exe / SIGACFG / Ambiente / Schedule / Adapter EAI.

Image Modified

2 – Clique em incluir e cadastre os adapters relacionados abaixo.

Produto

  • Mensagem única: Sim
  • Rotina Protheus: MATA010
  • Mensagem: ITEM
  • Descrição: Produto
  • Envia: Não
  • Recebe: Sim
  • Método: Síncrono
  • Operação: Todos
  • Canal: EAI
  • Adapter Protheus: MATA010
  • Versão: 4.005

Produto x Custo Mão de Obra

Para utilizar o recurso de insumo como mão de obra nas Ordens de Serviço do módulo Manutenção de Ativos (SIGAMNT) consulte o documento 3307388 DNG-1285 DT Conceito Centro de Custo para Custo. Na aba BackOffice RM contém o roteiro de como utilizar este recurso.

Card
id2
labelRM
titleRM

RM

Rota mapeada no EAI 2.0 para um aplicativo

Configuração do Adapter

1 – Acesse: RM.exe / Integração / EAI 2.0 / Aplicativos / Anexo Rotas.

Image Modified

2 – Clique em incluir e cadastre o adapter relacionado abaixo.

  • Transação: ITEM
  • Versão 4.005
  • Modo Habilitado: Envio
  • Mensagem Original: Inclui
Card
id3
labelRegras do Adapter Produto / Serviço
titleProduto / Serviço

Produto/Serviço

Informações referentes ao adapter de envio. 

Dados do Adapter

  • Identificador da Mensagem: Item
  • Versão: 4.005
  • Módulo RM: BackOffice – Gestão de Estoque, Compras e Faturamento
  • Módulo PROTHEUS: SIGAEST
  • Tipo de Envio: Síncrona
  • Mapeamento de Campos: http://tdn.totvs.com/x/sBzHG


Notas:

Quando o pacote de integração Manutenção de Ativos x BackOffice RM, ou, o pacote TOTVS

Rental x

Rental x BackOffice RM está habilitado serão enviados para o Protheus somente os Produtos que estiverem com o campo Disponível para Manutenção/Locação marcado no cadastro de Produto. Este campo fica localizado na tela de edição de Produto => Pasta Integração => campo Manutenção.

Image Modified


Quando o pacote de integração Manutenção de Ativos x BackOffice RM estiver habilitado não será enviado para o Protheus o número da Nomenclatura Comum do Mercosul (NCM). Este campo fica localizado na tela de edição de Produto => Pasta Detalhes => Outros Dados => campo Número.

Image Modified


Quando o pacote de integração Quirons - Segurança e Medicina do trabalho x BackOffice RM estiver habilitado somente serão enviados ao Quirons os produtos que estiverem com o campo Integrado a Equipamento de proteção individual (EPI) marcado no cadastro de produto. Este campo fica localizado na tela de edição de Produto => Pasta Integração => campo 'Integrado a Equipamento de proteção individual (EPI)'.

Image Added


No caso do sistema estar parametrizado para Controlar Níveis de Máscara (Ambiente | Parâmetros | Gestão de Estoque, Compras e Faturamento | Parâmetros Gerais | Tabelas | Produtos | Definições Gerais | Etapa Definições de Produto 1/3) serão enviados para o Protheus somente os Produtos/Serviços de Último Nível.

Não serão enviadas informações de Cliente/Fornecedor do Produto.

O campo B1_CODITE no cadastro de Produtos do Protheus deve ser alterado, via APSDU, para não obrigatório e também deve-se retirar sua validação. Para realizar a alteração é necessário abrir a tabela SX3 via APSDU e limpar a informação da coluna X3_VALID para o campo SB1_CODITE.

O campo “Código do Produto” no Protheus deve ser alterado para tamanho 30 caracteres para manter compatibilidade com o RM. A alteração é realizada no Grupo de Campos.


Envio de valor da tag MultiplicationFactorValue:

Quando o registro possuir a informação de Unidade de Compra, o valor desta tag será preenchido com o Fator de Conversão informado no cadastro de Unidade de Medida.

Image Added


Produto Global:

Produtos globais no BackOffice RM não são considerados globais no sistema de destino (SigaMNT), sendo enviada uma mensagem de inclusão para cada empresa a qual o produto faz parte.

  • Caso haja ao menos uma mensagem enviada com sucesso ao SigaMNT, mesmo havendo erro nas mensagens referentes ao produto para as outras coligadas, não será apresentada mensagem de erro e a alteração/inclusão não será desfeita no RM.
Na alteração
  • Na alteração do Produto
Global o
  • Global o RM irá replicar os produtos globais para cada filial no PROTHEUS, somente quando for alterado os campos da tabela Produtos Globais (TPRODUTO) que são sincronizados na mensagem única. São eles:
 Código
  • Código do Produto;
 Descrição
  • Descrição do Produto;
 Nome
  • Nome Fantasia;
 Inativo
  • Inativo; Tipo; Peso Bruto; Peso Líquido; Usa Número de Série; Controlado por Lote; Referência; Número da Nomenclatura Comum do Mercosul (NCM), Disponível para Manutenção,Integrado a Equipamento de proteção individual (EPI).

Visando melhoria na performance de cadastro de Produtos, apenas as alterações do campos integrados é que será acionado o gatilho para envio dos dados ao PROTHEUS. Os campos integrados são:

  • Pasta Identificação: Código do Produto, Descrição, Nome Fantasia, Inativo, Tipo e Número do Produto no Fabricante
  • Pasta Detalhes
    • Sub Pasta Descrição: Descrição
    • Sub Pasta Características: Peso Bruto e Peso Líquido
    • Sub Pasta Outros Dados: Nomenclatura Comum do Mercosul (NCM), Procedência e Tributação Cupom Fiscal
  • Pasta Preço: Preços Selecionados (Moeda, Data-Base e Preço)
  • Pasta Controle Estoque: Unidades de Controle, Compra e Venda, Usa Número de Série e Controlado por Lote
  • Pasta Custos: Valor Custo Médio e Valor do Custo Unitário
  • Pasta Integração:
    • Disponível para Manutenção
. Observação
    • : verificado apenas quando for integração Manutenção de Ativos x BackOffice RM.
    • Integrado a Equipamento de proteção individual (EPI): verificado apenas quando for integração Quírons x BackOffice RM.
  • Pasta Código de Barras: Código e Unidade.
  • Pasta Informações por Filial: Tributação Cupom Fiscal


Limitações/Restrições

Descreva limitações e restrições para a integração que está sendo

descrita.
Deck of Cards
idconfiguracao
Card
id1
labelConfiguração
titleConfiguração

Esta documentação não fará o detalhamento da instalação do Protheus . Ele orientará apenas a configuração do mesmo para integrar com o TOTVS Rental (SIGALOC) com o BackOffice RM .Para seguir as configurações descritas  é importante que já se tenha o ambiente Protheus/TOTVS Rental instalado.

Protheus : a partir da versão 12.1.33

RM : a partir da versão 12.1.33

* Independentemente se for utilizado produto global no RM, a tabela referente no Protheus deve ser exclusiva por empresa, ficando a cargo do RM replicar os produtos globais para cada filial no Protheus. A partir do release 12.1.18 da linha RM, a replicação dos dados sempre será realizada na inclusão de um novo produto global. Na alteração o RM irá replicar os produtos globais somente quando for alterado os campos da tabela Produtos Globais (TPRODUTO) que são sincronizados na mensagem única. São eles: Código do Produto; Descrição do Produto; Nome Fantasia; Inativo; Tipo; Peso Bruto; Peso Líquido; Usa Número de Série; Controlado por Lote; Referência; Número da Nomenclatura Comum do Mercosul (NCM).
** Mesmo que a empresa não utilize Cliente/Fornecedor global no RM, deve-se compartilhar a tabela referente no Protheus por empresa.

Card
id2
labelCompartilhamento de Tabelas Protheus
titleCompartilhamento de Tabelas Protheus
O compartilhamento de tabelas no Protheus deve ser coerente com a forma como o BackOffice RM trabalha, conforme

descrita

tabela abaixo.

Para alterar o compartilhamento das Tabelas acesse: SIGACFG em Dicionário | Base de dados | Base de dados, expande a Empresa e clica em Dicionário de Dados.

Cadastro

Empresa

Filial

Unidade

Tabela RM

Tabela Protheus

MoedaCompartilhadoCompartilhadoCompartilhadoGMOEDACTO
Unidade de MedidaCompartilhadoCompartilhadoCompartilhadoTUNDSAH
Centro de CustoExclusivoCompartilhadoCompartilhadoGCCUSTOCTT
Condição de PagamentoExclusivoCompartilhadoCompartilhadoTCPGSE4
ProdutoExclusivo *CompartilhadoCompartilhadoTPRODUTOSB1
Cliente/FornecedorCompartilhado **CompartilhadoCompartilhadoFCFOSA1 (Cliente) e SA2 (Fornecedor)
Local de EstoqueExclusivoExclusivoExclusivoTLOCNNR
VendedorExclusivoCompartilhadoCompartilhadoTVENSA3
Card
id3
labelConfigurando o RM
titleConfigurador RM

Instalando/Configurando a integração

Através do módulo de Integrações, acessar o novo Menu EAI 2.0 | Configurador e proceder para instalar o pacote de integração desejado.

Os passos detalhados em TOTVS RM x PROTHEUS - Configurador EAI 2.0 orienta o usuário a instalação dos pacotes de integração e, em nosso contexto, em tal passo a passo, selecione o pacote de integração "TOTVS Rental (SIGALOC) x BackOffice RM" (conforme print mais abaixo) e prossiga as orientações do passo a passo.

Image Removed

Image Removed

Image Removed

Em nosso contexto selecionar instalar o pacote de integração "TOTVS Rental (SIGALOC) x BackOffice RM".

Image Removed

Ao final do processo de instalação do pacote de integração você deve configurar os parâmetros necessários à integração. No Menu EAI 2.0, acesse o sub-menu Parâmetros adapter

Image Removed

Image Removed

Configure o parâmetro CODCLASSIFICPAIS com o código da tabela de classificação utilizada e associada aos países referente à classificação do IBGE

.

Image Removed

Informe os Códigos dos Tipos de Movimento criado/configurado anteriormente para cada um dos processos que será utilizado. É permitido configurar parâmetros de tipo de movimento para mais de uma coligada, lembrando que a coligada informada precisa estar integrada.

Image Removed

Observação: Este é apenas um exemplo, deve-se informar o Valor com o Código do Tipo de Movimento e Código de classificação de pais criado no ambiente que a integração está sendo implantada.

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 Menu EAI 2.0, acessando o sub-menu Aplicativos

Image Removed

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

Image Removed

Card
id4
labelAdapters - Protheus
titleAdapters Protheus

1 – Acesse: Protheus.exe / SIGACFG / Ambiente / Schedule / Adapter EAI.

Image Removed

<valor do parâmetro>

Card
id5
labelParâmetros - Protheus
titleParâmetros Protheus

1 – Acesse: Protheus.exe / SIGACFG / Ambiente / Cadastros / Parâmetros

Image Removed

Outras configurações recomendadas:
ParâmetroObservaçãoValor
<nome do parâmetro><Texto com explicação/uso do parâmetro>