Histórico da Página
Integração
Este documento tem como objetivo descrever as configurações necessárias para integrar o cadastro de Projetos quando o cliente utilizar o pacote de integração BackOffice RM x Manutenção de Ativos (SIGAMNT) e utiliza o módulo TOTVS Construções e Projetos da linha RM.
Pré-requisitos
Para o correto funcionamento da integração é necessário realizar as seguintes configurações.
Protheus
Definir Criar Calendário de Projetos
Criar Fase do Projeto
Compartilhamento de Tabela
Parâmeros de Integração
Configuração de Adapters
RM
Insira aqui as informações pertinentes ao RM.
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.
- Acessar SIGAMNT > Atualizações / Cadastros Básicos / Calendários.
- Incluir um novo calendário com código 001 e selecionar os horários por dia da semana.
- Acessar SIGACFG > Cadastros > Parâmetros e informar o código do calendário cadastrado no parâmetro MV_INTCAL.
Criar Fase do Projeto
- Passo a passo.
- Acessar SIGACFG > Cadastros > Parâmetros e informar o código da fase no parâmetro MV_PRJINIC.
Compartilhamento de Tabela
O compartilhamento da tabela de Projetos no Protheus deve ser tudo Exclusivo. Acesse SIGACFG / Dicionário / Base de dados / Base de dados, expande a Empresa e clica em "Dicionário de Dados", pesquise pela tabela AF8 e valide se o compartilhamento está da seguinte forma: Filial, Unidade e Empresa como Exclusivo
Parâmeros de Integração
Acesse: Protheus.exe / SIGACFG / Ambiente / Cadastros / Parâmetros e defina os seguintes valores para os parâmetros abaixo:
Nome | Descrição | Valor |
---|---|---|
MV_PMSITMU | Habilita integração com o TOTVS Obras e Projetos através da mensagem única TOTVS. | 1 |
MV_INTPMS | Habilita integração de Gestão de Projetos para outros módulos do Protheus. | S |
MV_INTCAL | Calendário padrão a ser utilizado na criação do projeto. | 001 |
MV_PRJINIC | Define a fase em que os projetos importados do TOTVS Obras e Projetos serão criados. | 06 |
Configuração de Adapters
1 – Acesse: Protheus.exe / SIGACFG / Ambiente / Schedule / Adapter EAI.
2 – Clique em incluir e cadastre os adapters relacionados abaixo.
- Mensagem única: Sim
- Rotina Protheus: PMSA200
- Mensagem: PROJECT
- Descrição: Projeto
- Envia: Não
- Recebe: Sim
- Método: Síncrono
- Operação: Todos
- Canal: EAI
- Adapter Protheus:PMSA200
- Versão: 2.000
RM
Utilizar Biblioteca RM versão 12.1.26 ou superior e já possuir a base de dados convertida para o EAI 2.0.
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.