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

Insira aqui as informações pertinentes ao Protheus.

RM

Insira aqui as informações pertinentes ao RM.

Instalação/Atualização

Este tópico tem por objetivo orientar a instalação da integração, visando o seu funcionamento completo. Instalação de produtos ou ferramentas necessárias podem referenciar outros documentos existentes, desde que estejam disponíveis no repositório de documentação da TOTVS ou sejam enviados junto com o documento da integração em si. As informações mínimas necessárias para teste tópico são:

  • Procedimentos que devem ser observados quando um dos produtos for atualizado.
  • Configuração necessária que deve ser realizada em arquivos de configuração ou programas de parâmetros etc.
  • Arquivos diversos que devem ser mantidos em determinados locais para o funcionamento da integração, exemplo: xml, xsd.
  • Atualizações necessárias em banco de dados ou instruções para que elas sejam feitas.
  • Processos, módulos ou programas que precisam ser instalados ou atualizados. Deve ser definida a versão mínima necessária dos programas envolvidos.
  • Ferramentas, servidores ou serviços que precisam ser disponibilizados e configurados, o que pode gerar necessidade de novo hardware ou aumento de capacidade. Exemplo: serviço de WebService.
  • Instruções para habilitar a comunicação da ferramenta EAI entre as partes, quais rotas devem ser definidas ou como as transações devem ser habilitadas.

 

Observação: evite o uso de Prints de telas, facilitando, assim, o trabalho de tradução e versionamento deste documento.

Datasul

Insira aqui as informações pertinentes a Datasul.

Logix

Insira aqui as informações pertinentes ao Logix.

Protheus

Insira aqui as informações pertinentes ao Protheus.

RM

Insira aqui as informações pertinentes ao RM.

Fluxo das Informações

 

Para cada fluxo de informação descreva, se necessário, alterações de comportamento que o respectivo produto irá sofrer. Por exemplo: quando o Logix recebe o PEDIDO de OUTRO ERP, este pedido não poderá ser alterado no Logix.

Liste quais as entidades integradas e como é o mapeamento entre as diferentes estruturas. Por exemplo: Classe no sistema A vira categoria no sistema B, o campo X é refletido no campo Y etc.

Liste quais transações/operações a integração fará com as entidades relacionadas. Exemplo: Insert de PEDIDO, Insert, update de ITEM, buscar saldo em estoque do ITEM no dia X ou buscar dados do FUNCIONÁRIO.

Cadastros

Descreva características gerais do fluxo de informações e que serão comuns para este tipo de entidade. Características particulares para cada entidade deverão ser citadas em tópicos específicos de cada entidade.

Sempre que existir (a sugestão é sempre criar) e for agregador ao documento acrescentar aqui os diagramas/imagens ou até mesmo colocar tais diagramas diretamente na especificação dos processos

Em seguida faça uma descrição para cada um dos fluxos para cada entidade

 

<Transação/Entidade>

Identificador da Mensagem: <mensagem>

Versão: <versão>

Módulo <marca 1>: <BackOffice – Gestão xxxxxxx>

Módulo <marca 2>: <SIGAXXX>

Tipo de Envio: <Assíncrona/Síncrona>

Mensagem Padrão

PROTHEUS

RM

Tabela

Campo

Tabela

Campo

Code

CTO990

CTO_SIMB

GMOEDA

SIMBOLO *

Description

CTO990

CTO_DESC

GMOEDA

DESCRICAO

Symbol

CTO990

CTO_SIMB

GMOEDA

SIMBOLO

Notas:

Observações sobre comportamento desta mensagem ou dos processos envolvidos nela/para ela

A seguir descrever as variações, particularidades da mensagem e processos (integração) de acordo com cada marca

Limitações/Restrições

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

Processos

Descreva características gerais do fluxo de informações e que serão comuns para este tipo de entidade. Características particulares para cada entidade deverão ser citadas em tópicos específicos de cada entidade.

Sempre que existir (a sugestão é sempre criar) e for agregador ao documento acrescentar aqui os diagramas/imagens ou até mesmo colocar tais diagramas diretamente na especificação dos processos

Em seguida faça uma descrição para cada um dos fluxos para cada entidade

 

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

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 Added

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


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 Added


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

<Transação/Processo>

Tipo de Fluxo: Protheus -> RM

Mensagem: Request_1_000

Versão: 1.000

Descrição de todo o comportamento e funcionamento do processo. Breve contexto, origem, regras, integração (geração da mensagem, envio, recebimento no destino), o quê supostamente irá ocorrer no destino, retorno, impacto, consequências, o que foi afetado, como conferir, validar, etc o retorno.

Acrescentar um diagrama do processo.

A seguir descrever as variações, particularidades da mensagem e processos (desta integração) de acordo com cada marca

Notas:

Observações sobre comportamento desta mensagem ou dos processos envolvidos nela/para ela

Limitações/Restrições

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

Limitações / Restrições Gerais

Descreva limitações e restrições para cada fluxo descrito no tópico anterior. Exemplo:

  • ERP1 envia ITEM cadastrado para o ERP2

ERP1 somente enviará o ITEM se este estiver em uma das famílias cadastradas no parâmetro FAMILIA_INTEGRACAO.

Se o tipo de valorização do estoque for FIFO.

  • ERP2 envia PEDIDO cadastrado para o ERP1

O pedido recebido no ERP1 vindo do ERP2 estará bloqueado para alteração.

 

Como fazer (opcional)

Descreva os passos que viabilizem a integração.

Exemplo:

Os passos para viabilizar a integração são:

  • No Logix ou no Protheus efetue o cadastro das seguintes informações: Clientes, fornecedores, transportadores, cidades, cotação de moeda e unidades de medida.
  • No Logix cadastrar um novo depositante e efetuar toda a parametrização necessária para a operação de WMS.
  • No Logix cadastrar um novo produto que seja controlado pelo WMS, para o depositante cadastrado anteriormente.
  • No Logix efetuar um processo de recebimento para o produto cadastrado anteriormente, utilizando uma nota fiscal provisória (tipo “A”).
  • No Protheus consultar a nota fiscal de recebimento que foi registrada no Logix, validando as informações recebidas.
  • No Logix efetuar um processamento de regularização fiscal, efetuando a cobertura dos produtos recebidos anteriormente.
  • No Protheus verificar se foi efetuado corretamente o relacionamento entre os dois documentos.
  • No Logix efetuar um processo de expedição para o novo produto cadastrado, até o momento do envio da mensagem de integração de pedido de venda.
  • No Protheus efetuar o faturamento do pedido de venda recebido.
  • No Protheus verificar se a nota fiscal gerada contém todas as informações necessárias para o segmento de operador logístico (armazém geral).
  • No Protheus efetuar a escrituração fiscal das notas fiscais, verificando se as regras da legislação deste segmento foram respeitadas.
  • No Logix é possível consultar o número do pedido de venda gerado para as notas fiscais de retorno simbólico e conta/ordem no programa WMS6333 (Consulta de Documentos). Para os processos de faturamento de serviço o número do pedido está disponível no programa WMS6411 (Movimentos a Faturar).

 

Situações comuns (opcional)

Descreva situações problemáticas comuns que podem ocorrer durante o funcionamento da integração e como solucioná-los. Neste ponto também é importante dar instruções de como reconhecer e investigar problemas que podem vir a ocorrer durante a integração. Se houver, apresente tabelas de códigos e descrições de erros que a integração poderá apresentar.

Este tópico possivelmente será alimentado com as experiências durante o desenvolvimento da integração e poderá ser realimentado durante o uso da integração no cliente.

Exemplo 1:

Tratamento de erros de integração (Produto A)

Erro

Mensagem

Solução

Código do erro

Mensagem exibida

Ação a ser tomada para resolução do erro.

Tratamento de erros de integração (Produto B)

Erro

Mensagem

Solução

Código do erro

Mensagem exibida

Ação a ser tomada para resolução do erro.

 

Exemplo 2:

Quando uma mensagem é enviada do Logix para o Protheus, podem ocorrer situações em que o WebService não estará totalmente funcional. Nestes casos uma mensagem de erro genérica irá aparecer na tela:

Exemplo:

Erro ao enviar a mensagem de Cidade via Integração

Se o arquivo de log for analisado, poderemos ver a falha na comunicação com o sistema destino:

-------------------------------------------------------------------------------

WSCERR044 / Não foi possível POST : URL http://172.16.31.57:8011/ws/FWWSEAI.apw

ADVPL WSDL Client 1.080707 / tst on 20120315 08:49:51

-------------------------------------------------------------------------------

Para resolver este problema, verifique as configurações do sistema de destino, analisando o funcionamento do servidor utilizado para esta comunicação e a habilitação do endereço do WebService. 

Checklist de suporte da aplicação

Crie um check-list de verificação de alguns pontos importantes para o funcionamento e atendimento da integração.

Instalação/Configuração

Relacione itens de verificação para garantir que a integração está corretamente instalada e configurada. Isto não pode ser uma cópia do procedimento de instalação/configuração, mas verificações pontuais que podem remeter aos itens da instalação.

Checklist de Verificações:

Relacione itens de verificações para que o atendente possa:

  • Identificar o funcionamento da integração;
  • Identificar a ocorrências de problemas;
  • Coletar evidências do mau funcionamento relatado pelo cliente;
  • Realizar possíveis ajustes na integração quanto à configuração ou negócio.
Anexos