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.

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 Removed

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



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.

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

  • Transação: ITEM
  • Versão 4.005
  • Modo Habilitado: Envio
  • Mensagem Original: Inclui


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

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.


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.


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 do Produto 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 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), Disponível para Manutenção.

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.
  • 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çãoProtheus
titleConfiguraçãoProtheus

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 Added

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

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

* 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
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.




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


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



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.



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.

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


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



Card
id4
labelAdapters - Protheus
titleAdapters Protheus

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

Card
id5
labelParâmetros - Protheus
titleParâmetros Protheus

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


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