Child pages
  • DI_Integracao_Protheus_PCO_x_TOTVS_Planning
Skip to end of metadata
Go to start of metadata

Integração Protheus PCO x TOTVS Planning

Contexto de negócio (Introdução)

O planejamento de um orçamento empresarial ocorre, em uma empresa, de tempos em tempos, tipicamente a cada ano. Esse processo envolve o levantamento e cálculo de informações de várias áreas de negócio, permitindo ao gestor ter uma visão de quantidades e valores que irá reservar para investimentos e execução de sua atividade durante o período orçamentário.

Normalmente, essa informação é organizada por meio de contas orçamentárias, centros de custo, unidades de negócio e outros classificadores que ajudam os gestores a organizar e posteriormente controlar os gastos realizados para o período que foi feito o orçamento.

Atualmente, os sistemas ERP se propõem a todo o ciclo de controle e execução desse orçamento, permitindo assim as empresas controlar seus gastos.

 

Sistemas Envolvidos

  • TOTVS Planning – O TOTVS Planning é um sistema de modelos de decisão aberto, que permite ao usuário, por meio de fórmulas e outras características comuns às planilhas eletrônicas, fazer o planejamento de diversas atividades de negócio, inclusive planejamento orçamentário, utilizando dados locais de outros fontes, como bancos de dados de ERPs.
  • Protheus/PCO – O Planejamento e Controle Orçamentário (PCO), é um sistema que permite o controle do orçamento por meio de movimentos de realização do orçamento e bloqueio de seu orçamento, quando necessário e configurado pelo usuário, o início do processo de controle ocorre na inclusão das planilhas orçamentária.

Nos próximos capítulos, utilizaremos o nome PCO para representar o sistema Protheus PCO e Planning para representar o sistema TOTVS Planning.

 

Integração

Essa integração diz respeito à possibilidade do usuário utilizar o Planning como ferramenta para fazer o planejamento e utilizar o PCO como ferramenta para fazer o controle e execução orçamentária.
No lado do PCO, o usuário alimentará as planilhas orçamentárias e seus cadastros relacionados, como, contas orçamentárias, classe orçamentária, operação unidade orçamentária, centros de custos, item conta e classe de valor.

No lado do Planning, o usuário poderá buscar essas informações cadastrais e associá-las aos valores que serão orçados, durante certo período. Depois de realizar a fase de planejamento, a integração permitirá que esses valores estejam disponíveis no PCO para posterior controle e execução orçamentária.

Embora todo o processo de planejamento e controle possa ser feito no PCO, a integração tem o objetivo de permitir ao usuário utilizar um produto de planejamento mais robusto e flexível. Ao mesmo tempo, embora o Planning não possa fazer o controle e execução orçamentária, poderá por meio de seus painéis, apresentar esses resultados do controle, opcionalmente.

  • Premissas
    • Pacote A38 (ou superior) do Planning para utilização de integração síncrona.
    • Pacote A40 (ou superior) do Planning para utilização de integração assíncrona.
    • Integração configurada e habilitada no módulo Metadata Manager do Planning.
    • Cadastros de Planilha, Conta e Classe Orçamentárias realizados no módulo PCO.
    • Acesso de conexão ao banco de dados do Protheus pelo Planning para leitura.
    • Versão 11.80 ou superior do ERP Protheus.
    • Fonte PCOI100 com data igual ou superior a 04/08/2014.
    • Fontes PCOXFUN e PCOA100 com data igual ou superior a 24/07/14.
    • Servidor de EAI configurado na rotina PCOA100.
  • Arquitetura (Tecnologia)
    • Servidor de aplicação do Planning ter acesso à rede do servidor de EAI do PCO e vice-versa.
    • Banco de dados do ERP Protheus deve ser MS SQL Server ou Oracle.

 

Escopo

O escopo da integração entre os dois produtos está apenas na fase de planejamento do processo de orçamento. Ela ocorre no momento em que o usuário termina o planejamento e precisa atualizar as informações orçadas no PCO a fim de iniciar a fase de controle do orçamento em questão.

Embora exista uma comunicação entre os dois sistemas para que se possa iniciar o planejamento do orçamento, momento esse em que o Planning carrega as informações de cadastros do PCO, não é esse processo que caracteriza a integração entre os sistemas já que isso ocorre por meio de uma conexão direta ao banco de dados do PCO, que é um característica do próprio Planning. A integração é caracterizada pelo envio das informações de orçamento já planejadas para o PCO por intermédio de mecanismo de mensagem única e o serviço de EAI.

Como o Planning é um sistema aberto, o usuário pode relacionar, na mesma planilha em que faz a entrada dos valores orçados, outras informações como valores e fórmulas que não serão enviadas ao PCO. A área de dados a ser enviada é definida apenas pela interseção de coluna de período e uma linha de dados da estrutura de informação que foi criada a partir da importação dos cadastros do PCO. Esse processo será detalhado no item Fluxo das Informações.

O PCO receberá do Planning os itens do orçamento na planilha orçamentária previamente cadastrada, retornará apenas confirmação de recebimento ou algum problema ocorrido no processo de importação, dependendo do envio ser síncrono ou assíncrono.

Não haverá retorno para o Planning, sobre o controle do orçamento efetuado no PCO, sobre alterações nos itens da planilha originados do Planning, validação de controle de usuário e acesso as entidades da planilha como ocorre na inclusão manual.

No processo de integração, do lado do Planning existem três papéis importantes:

  1. Papel de usuário administrador do sistema: precisa habilitar a integração do produto com o PCO. Essa configuração é por meio do módulo Metadata Manager. O administrador é responsável por criar uma conexão com o banco de dados do PCO, criar uma configuração de destino para o EAI, informando o endereço do web service, definir uma empresa padrão para checagem das tabelas e definir um tamanho de pacote para as mensagens do EAI.
  2. Papel de usuário planejador: esse papel é responsável por determinar o plano que irá conter os dados de integração com uma versão de uma planilha de orçamento. O usuário determina, nesse momento, qual a empresa, filial, planilha, versão, contas orçamentárias e outros filtros que irão compor a pasta, no Planning, em que serão associados os valores a serem enviados ao PCO.
  3. Papel de usuário integrador: esse papel é responsável por selecionar os planos que terão seus dados enviados ao PCO. Esse envio pode ser manual, plano a plano, como também ser agendado para envio em lote.

No processo de integração, do lado do Protheus são os seguintes papeis:

  1. Papel de usuário administrador do sistema: será responsável pela configuração do servidor EAI, configurar o JOB PCOA100.
  2. Papel de usuário PCO: efetuar cadastros básicos como conta orçamentária, classe orçamentária, unidade orçamentária, operação, centro de custo, item conta, classe de valor e planilha orçamentária, analisar, simular, revisar a planilha e controlar o orçamento.

Para um entendimento geral do escopo da integração, abaixo serão apresentadas as telas dos produtos em que a integração ocorre.

Tela do TOTVS Planning com a visão de uma pasta de um plano de integração:
Tela do TOTVS Planning com a visão de uma pasta de um plano de integração

Conforme apresentado na tela acima, as células B1 a B6 são valores que o usuário pode indicar os códigos para cada item, se necessário, e todas as células que compõe as contas orçamentárias e seus períodos (iniciando em B10) são as células que formam os valores a serem enviados ao PCO. Abaixo a tela do PCO em que os valores dessa planilha são cadastrados após ocorrer o processo da integração (apenas ilustrativo).

Tela do PCO onde os valores atribuídos para as contas são cadastrados:
 

 

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

Datasul

Para o Planning, a integração está disponível a partir do pacote A38 no modo síncrono e a partir do pacote A40 no modo assíncrono, que é a configuração padrão. A instalação do produto já inclui todos os itens necessários para o funcionamento da integração, no entanto, ela está desabilitada, por padrão, sendo necessário fazer a sua configuração para ativá-la.

 

Protheus

Para o PCO, será necessário ter incluso as planilhas orçamentárias e seus cadastros relacionados, como, contas orçamentárias, classe orçamentária, operação unidade orçamentária, centros de custos, item conta e classe de valor.

 

Instalação/Atualização

Datasul

O Planning possui um instalador que faz tanto a instalação do produto como sua atualização em um ambiente com uma versão anterior. O processo de instalação é automático e prepara todos os arquivos e instala todos os serviços necessários para o funcionamento da integração. A partir do pacote A40, a instalação ou atualização configura o Planning para trabalhar no modo assíncrono.

Para configurar a integração, acessar o módulo Metadata Manager:

 

    1. Configurar um escopo para conexão ao banco de dados do ERP Protheus.
    2. Configurar ao menos um destino EAI, informando um nome, o tempo máximo de espera em segundos (normalmente 30) e o endereço do servidor EAI do ERP Protheus no seguinte formato:
      “http://[endereço]:porta/EAISERVICE.apw”.
    3. Configurar os parâmetros de integração, como empresa padrão, tamanho do pacote em KBytes, sugerido um valor de 50 que pode ser estendido até 4.000, nome do destino EAI configurado no item “b” e escopo de conexão com banco de dados do PCO configurado no item “a”.
    4. Configurar o modo de envio da mensagem para “Síncrono” caso queira que os dados de cada mensagem sejam processados assim que a mensagem é enviada ou “Assíncrono” caso queira que a mensagem seja apenas entregue e processada posteriormente pelo PCO. O modo padrão é o modo “Assíncrono” porque permite que o usuário do Planning não tenha que aguardar o processamento da mensagem que pode ser lento, dependendo do volume de dados.
    IMPORTANTE: A configuração do modo de envio feita no Planning deve ser compatível com a configuração realizada no PCO para a mensagem de integração, caso contrário, a integração não ocorrerá de forma completa.

Quando a configuração do Planning é feita para o modo “Assíncrono”, as respostas de processamento das mensagens pelo PCO devem ser enviadas ao serviço de EAI do Planning, no entanto, para isso é preciso que seja configurado no PCO o endereço completo do serviço de EAI do Planning. Por padrão o endereço do serviço de EAI do Planning é configurado como “http://[nome do servidor de aplicação]:8100/EAIService.svc” e o endereço é exibido na tela de configuração da integração, caso tiver sido ajustado no arquivo de configuração.

 

Protheus

Esse documento não visa descrever os procedimentos de instalação do Protheus padrão e suas configurações. Neste documento são passadas informações referentes ao EAI da Linha Protheus.

1. Cadastrar/Configurar Adapter para Integração no Protheus

Entre no módulo Configurador (SIGACFG), em Ambiente | Schedule | Adapter EAI, e preencha da seguinte maneira:

Mensagem Única RotinaMensagemEnviaRecebeMétodoOperaçãoCanal 
Sim PCOA100 BUDGETITEMS Sim Sim Síncrono Todas EAI

Tabela 1 – Rotina com integração por Mensagem Única.

2. Configurar o EAI para Integração no Protheus

No Protheus, entre no Configurador (SIGACFG) e acesse Ambiente / Schedule / Schedule.

3. Cadastrar Agent

  1. Para abrir as opções Cadastro e Monitor.
  2. Clique no sinal de +(Soma) ao lado esquerdo do Globo Verde com o título Agent.
  3. Na opção Cadastro, clique no Globo Verde com sinal de +(Soma) que está à direita da tela.
  4. São apresentadas as informações da tela de detalhes sendo preenchidas automaticamente.

4. Cadastrar Agendamento

  1. Para abrir as opções Cadastro e Monitor.
  2. Clique no sinal de +(Soma) ao lado esquerdo do Globo Verde com o título Agendamento.
  3. Clique na opção Cadastro, na tela de detalhes na parte inferior da tela principal.
  4. Clique no primeiro Ícone de um caderno com sinal de +(soma).
  5. São apresentadas algumas informações automaticamente.
  6. Complete o campo Rotina com FWEAI.
  7. No campo Empresa/Filial, clique na lupa ao lado direito.
  8. É apresentada a tela com as empresas.
  9. Selecione a empresa desejada que será realiza a integração.
  10. Dê um duplo clique no check-box ao lado esquerdo do Nome da empresa.
  11. Clique em OK.
  12. Confira os dados e clique em Confirmar.

5. EAI – Como Visualizar os Arquivos XML Criados pelas Rotinas

São apresentadas duas telas, sendo a de Transações na parte superior, e a tela de Eventos da Tarefa na parte inferior.

Na tela de Transações:

  1. Posicione na linha da mensagem gerada.
  2. Clique na Lupa azul, na parte superior da tela.
  3. É aberto o arquivo XML no navegador padrão da estação de trabalho.

Na tela de Eventos da Tarefa, ao clicar na linha da mensagem é apresentada as informações de início de processamento, Falhas, Processo interrompido, Fim do Processo conforme consta na mensagem.

Importante:
Para identificar a cor da Legenda com o tipo de mensagem, é necessário clicar duas vezes na bolinha colorida.

6. Limpar Histórico de Mensagens

Opção Limpeza de Tabelas: Caso queira realizar uma limpeza dos históricos das mensagens.

Ao clicar nesta opção, é apresentada a tela Tabelas com a opção Selecione a Tabela.
Clique na seta preta que aponta para baixo do lado esquerdo.
São apresentadas as opções: Tarefas ou EAI.
Para a utilização, clique em EAI.
Marque um tipo de mensagem que deseja limpar do histórico.
Clique no check-box ao lado esquerdo da opção para marcar ou desmarcar. Sendo elas:

  • Aguardando Execução.
  • Executando.
  • Finalizada.
  • Falhou.
  • Bloqueado.

 

Controle de Versão

O grupo TOTVS representado por suas marcas administrará as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.

 

Suporte

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos Planning e PCO estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.

Observação: Este modelo de suporte está sendo revisado pela TOTVS.

 

Transações/Entidades/Mensagens únicas

O fluxo de dados da integração, para cada um dos sistemas, é apresentado abaixo:

Mensagem Única

Método

ID

Descrição

Origem

Destino

XSD

Cadastros

01

Itens de Orçamento

Planning

PCO

BudgetItems_1_000.xsd

 

 

Fluxo das Informações

O Planning tem uma característica, inerente ao produto, que permite ao usuário realizar conexão à bases de dados de sistemas ERP de forma a poder executar consultas mescladas às fórmulas. Essa característica é utilizada no processo de planejamento orçamentário para que o sistema possa montar a planilha na qual será feita a entrada de dados. Embora a leitura desses dados sirva a funcionalidade de integração ao orçamento, apenas a operação de exportação do orçamento caracteriza uma integração, pois apenas ela utiliza o serviço de EAI 2 e mensagens únicas para enviar os valores orçados ao PCO.

Para a mensagem utilizada nessa integração, a relação entre entidades nos dois sistemas são caracterizadas por uma relação de um registro no PCO para muitos registros no Planning e isso inviabiliza a utilização de sincronização de entidades. A figura abaixo ilustra com um dado de orçamento no Planning é armazenado na tabela do PCO e em uma das tabelas do Planning (as tabelas complementares foram suprimidas para facilitar o entendimento).

Assim, a construção de um mecanismo de sincronização entre os dois sistemas foi descartada pela complexidade e baixo desempenho, justificada pelo prazo de implementação da solução sem uma contrapartida funcional para ambos os sistemas. 

Dessa forma, o Planning não recebe dados do PCO nesse processo de integração. A integração de itens de orçamento ocorre apenas no sentido Planning => PCO, onde as informações são enviadas através do serviço de EAI 2 e posteriormente gravadas na tabela de itens de orçamento do PCO.

 

Cadastros

<BudgetItems>

Identificador da Mensagem: BudgetItems_1_000

Versão: 1.000

Tipo de Envio: Síncrono ou Assíncrono

TAGPCOPlanning
TabelaCampoOrigem1
CompanyIdSM0 – Cadastro de empresasM0_CODIGOCélula do Plano
BranchIdSM0 – Cadastro de empresasM0_FILIALCélula do Plano
BudgetWorksheetAK2 – Itens do OrçamentoAK2_ORCAMECélula do Plano
WorksheetVersionAK2 – Itens do OrçamentoAK2_VERSAOCélula do Plano
AccountIdAK2 – Itens do OrçamentoAK2_COEstrutura de informação
CostCenterAK2 – Itens do OrçamentoAK2_CCCélula ou estrutura de informação
AccountItemAK2 – Itens do OrçamentoAK2_ITCTBCélula ou estrutura de informação
ClassValueAK2 – Itens do OrçamentoAK2_CLVLRCélula ou estrutura de informação
ClassBudgetAK2 – Itens do OrçamentoAK2_CLASSECélula ou estrutura de informação
OperationAK2 – Itens do OrçamentoAK2_OPERCélula ou estrutura de informação
CurrencyAK2 – Itens do OrçamentoAK2_MOEDAImportação do orçamento
BudgetUnitAK2 – Itens do OrçamentoK2_UNIORCCélula ou estrutura de informação
AccountEnt05AK2 – Itens do OrçamentoAK2_ENT05N/A
AccountEnt06AK2 – Itens do OrçamentoAK2_ENT06N/A
AccountEnt07AK2 – Itens do OrçamentoAK2_ENT07N/A
AccountEnt08AK2 – Itens do OrçamentoAK2_ENT08N/A
AccountEnt09AK2 – Itens do OrçamentoAK2_ENT09N/A
DatePeriodAK2 – Itens do OrçamentoAK2_PERIODTabulação da estrutura de informação
AmountAK2 – Itens do OrçamentoK2_VALORCélula interna a estrutura de informação
(1) A origem se refere ao plano utilizado para importar a integração. Como o usuário pode configurar a planilha de entrada de dados de diversas formas não há um local determinado para a origem do dado.

Notas:
O valor de InternalId da mensagem é composto pelo código da empresa + código da filial que são códigos informados pelo próprio usuário.

Embora o ERP Protheus possa ser implantado em modo de Grupo de Empresa + Máscara de unidades de negócio ao invés de Empresa + Filial, a mensagem identifica apenas código para campo Empresa e Filial. Dessa forma, o usuário determina os valores a serem enviados nesses campos e deve ser compatível com a forma de implantação do ERP Protheus.

Apenas um plano orçamentário é enviado por vez ao PCO. Como um plano pode conter várias contas, centros de custo e outras informações e a mensagem tem um limite de tamanho configurado pelo usuário, pode ser necessário o envio de várias mensagens para completar os dados de um plano.

Limitações/Restrições

  • No modo síncrono, a mensagem ocorre apenas no sentido Planning -> PCO
  • Não existe DE-PARA para essa mensagem por não haver entidade receptora no lado do Planning, assim não é enviado informações no item “BusinessEvent” da mensagem.

 

Fluxo das Informações

Envio da Mensagem BudgetItems:

  • Planning seleciona o plano com integração configurada e bloqueia o plano.
  • Planning seleciona as contas orçamentárias e outros parâmetros configurados pelo usuário no plano de integração.
  • Planning seleciona as células que possuem valores associados ao orçamento. As células sem valor são ignoradas.
  • Planning faz a validação dos dados informados nos parâmetros quanto ao tamanho permitido e os parâmetros que são obrigatórios. Caso não sejam válidos, encerra.
  • Planning calcula, de acordo com o tamanho de mensagem configurado pelo usuário, as mensagens únicas que serão enviadas ao PCO.
  • Para cada uma das mensagens:
    • Planning envia a mensagem ao PCO ao mecanismo do EAI 2 do Planning.
    • EAI do Planning envia a mensagem ao EAI do ERP Protheus e aguarda.
    • EAI do ERP Protheus recebe a mensagem única.
    • Caso a mensagem tenha sido enviado no modo Síncrono:
      • EAI do ERP Protheus entrega a mensagem ao adapter do PCO.
      • PCO recebe a mensagem.
      • PCO efetua a leitura da mensagem e faz as verificações se os dados do orçamento estão corretos caso alguma informação como: planilha, versão, conta orçamentária, centro de custo, classe orçamentária, item conta, classe de valor, unidade orçamentária, operação estiver inconsistente , o mesmo retorna a mensagem erro.
      • Caso todas as informações estejam consistentes ele grava o item do orçamento na tabela AK2.
      • PCO retorna uma mensagem de resposta por meio do EAI.
      • Planning recebe a mensagem de resposta que estava aguardando. Caso confirme que os itens de orçamento foram atualizados, o processo continua até terminar todas as mensagens. Caso haja erro, o envio é interrompido.
    • Caso a mensagem tenha sido enviada no modo Assíncrono:
      • EAI do ERP Protheus retorna uma mensagem de recibo por meio do EAI.
      • Planning recebe a mensagem de recibo e continua até terminar o envio de todas as mensagens.
  • Planning desbloqueia o plano e termina o processo.

Processamento da Mensagem BudgetItems no modo assíncrono:

  • PCO recebe a mensagem da fila do EAI do ERP Protheus.PCO efetua a leitura da mensagem e faz as verificações se os dados do orçamento estão corretos.
  • PCO faz a validação das informações como: planilha, versão, conta orçamentária, centro de custo, classe orçamentária, item conta, classe de valor, unidade orçamentária.
  • Caso todas as informações estejam consistentes ele grava o item do orçamento na tabela AK2.
  • PCO retorna uma mensagem de resposta através do EAI, sendo que retorna a mensagem com erro caso a validação verifique alguma inconsistência.
  • EAI do Planning recebe a mensagem única com a resposta.
  • EAI do Planning grava o log de recebimento associando o ID da resposta com o ID da mensagem enviada anteriormente.

Quando operando em modo assíncrono, o usuário pode acompanhar no monitor EAI do Planning as mensagens que foram enviadas e para quais delas já houve uma resposta do serviço de EAI. A resposta pode ser positiva ou de erro. O usuário deverá avaliar esse monitor para saber se é necessário alguma correção nos dados e reenvio do plano.

 

Como Fazer

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

  • No PCO, cadastre as entidades gerenciais para uso do PCO, obrigatórias para utilização: conta orçamentária e classe orçamentária.
  • No PCO, efetue as configurações básicas para uso e cadastramento da planilha como: cadastro dos tipos de saldo e configuração do lançamento por processo 000252, para geração de lançamentos orçados na tabela AKD. Os cadastros de centro de custo, item conta, classe de valor, unidade orçamentária e operação, deverão ser cadastrado conforme necessidade do cliente.
  • No PCO, configure o servidor EAI para receber a mensagem BudgetItems.
  • No Planning, certifique-se que a opção de Integração com ERP Protheus esteja habilitada e configurada por meio do módulo Metadata Manager e que o modo de envio da mensagem (síncrono ou assíncrono) esteja compatível com o modo configurado no PCO.
  • No Planning, configure plano para utilizar a integração, efetuando uma importação de orçamento, configurando a empresa, filial, selecionando a planilha orçamentária, versão da planilha, contas orçamentárias e os restante do parâmetros de acordo com a necessidade do usuário.
  • No Planning, informe os valores orçados para cada conta/período. Caso configure uma estrutura com mais de um nível, os valores devem ser informados apenas nas células de último nível da hierarquia da estrutura de informação. Os outros níveis são apenas totalizadores hierárquicos.
  • No PCO, efetue a conferência da mensagem importada e utilização do módulo conforme necessidade do cliente.
  • No Planning e no PCO, utilize os monitores de envio e recebimento de mensagens para saber quando os dados precisam ser ajustados e reenviados.

 

Situações comuns

Tratamento de erros de integração (Planning):

No processo de integração, ao realizar a exportação do orçamento, seja de forma direta ou agendada, existem alguns tipos de erro que podem ocorrer:

  • Erros de Tamanho:
    • Situação: O sistema faz uma validação nos parâmetros informados na pasta do plano que contém o orçamento a ser enviado. A validação ocorre pela comparação ao tamanho máximo do código que pode ser informado em um parâmetro.
    • Solução: Ajustar o valor para o tamanho correto e reiniciar a exportação.
  • Erros de Validação:
    • Situação: Ao informar códigos de Unidade Orçamentária, Classe Valor, Item Contábil e outros que são parâmetros de cabeçalho da importação, o sistema não pode validar esses valores com o PCO antes da mensagem de integração ser enviada. Dessa forma, pode ocorrer um erro de valor inválido indicando que o PCO não aceitou o código.
    • Solução: Ao receber o erro, verifique a mensagem e altere o valor do parâmetro que está inválido. É importante verificar se a formatação da célula que tem o valor está como formatação tipo “Texto”. Alguns códigos, embora numéricos, contém zeros na esquerda e só é possível ter esse tipo de valor na célula se a célula estiver formatada como texto.
  • Erros de Estouro de Tempo:
    • Situação: Ao enviar os dados por meio da exportação de orçamento, o sistema demora e retorna uma mensagem de “estouro de tempo” ou “time out”.
    • Solução 1: Verifique o parâmetro de tempo na configuração de “Destinos EAI” no módulo Metadata Manager. Ele deve ter um valor em segundos, normalmente 30. Se o tempo que o sistema está esperando antes da mensagem for igual ao valor configurado antes de retornar o erro, verifique as próximas soluções.
    • Solução 2: Pode ser um problema de endereço de rede. Verifique o endereço do EAI na tela de “Destinos EAI” do Metadata Manager e confirme com o administrador se os endereços estão corretos.
    • Solução 3: Pode ser um problema de firewall de rede. Verifique junto ao administrador se as portas dos serviços não estão com restrição de uso.
    • Solução 4: Pode ser que o servidor de EAI do ERP Protheus está realmente carregado e não consegue responder no tempo configurado na tela “Destinos EAI”. Nesse caso aumente o tempo de espera e investigue o problema no servidor de EAI do ERP Protheus.
  • Outros Erros não previstos:
    • Situação: Ao enviar os dados uma mensagem de falha do tipo “Não foi possível enviar a mensagem” seguida de um texto aparentemente técnico como resultado.
    • Solução: Em algumas situações, erros ocorridos no processamento da mensagem no PCO são retornados como mensagem de erro. Nesse caso, verifique o erro junto ao administrador do sistema.

 

Checklist de suporte da aplicação

Instalação/Configuração

Planning:

  • Verificar a presença dos seguintes arquivos na pasta de instalação “DM\bin” no servidor de aplicação:
    • Integracaoorcamento.xml
    • Integracaopco.txt
    • totvsmsg.xsd
    • ListOfInternalid_1_000.xsd
    • BudgetItems_1_000.xsd
  • No arquivo de configuração do servidor de aplicação (Datasul.ApplicationManager.config), verificar se o adapter para a mensagem está configurado corretamente, verificando o seguinte item abaixo para o produto “Datasul.Planning”.
  • No arquivo de configuração do servidor de aplicação (Datasul.ApplicationManager.config), verificar se o serviço de EAI está configurado e o endereço informado está apontando para a máquina do servidor de aplicação em uma porta aberta no firewall, verificando o item “DMService Settings” conforme exemplo abaixo:

Checklist de Verificações:

Planning:

  • Abrir o módulo Metadata Manager e verificar se a integração com o PCO está habilitada e configurada corretamente.
  • Na tela de configuração da integração, verifique se a URL que é apresentada está respondendo por meio da entrada do endereço em um navegador web no próprio servidor de aplicação do Planning. Isso garantirá que o serviço está ativo. Depois faça o mesmo teste a partir do servidor EAI do Protheus para verificar se não existe restrição de firewall impedindo a comunicação.
  • A partir de um navegador web no servidor de aplicação do Planning, entre com a URL do serviço de EAI do Protheus para verificar se nenhuma restrição de firewall está impedindo a comunicação.
  • Verificar se o plano em que o problema está ocorrendo teve uma importação de orçamento na mesma base do ERP Protheus para o qual está tentando exportar.
    • Uma forma de fazer a verificação é criar um plano novo e configurar uma nova importação com os mesmos parâmetros e verificar se os códigos de planilhas, versão e contas orçamentárias são as mesmas.
    • Outra verificação que pode ser feita é consultar a string de conexão associada ao escopo configurado para a integração, se ela aponta para o mesmo ERP Protheus que o serviço EAI configurado na janela de “Destinos EAI”.
  • Verificar se os valores informados no plano de integração correspondem a códigos válidos no PCO.
  • Verificar os registros de alteração e o monitor de EAI no módulo administrativo a fim de identificar mensagens de erro durante o processo de integração.

PCO:

Para verificar porque os itens orçamentários não foram integrados:

  • O Protheus é versão 11.80 ou superior?
  • Digite o endereço informado em configurações iniciais dos campos Url do WS e Url do EAI no browser para verificar o status.
  • O Agent está configurado corretamente e está iniciado?
  • O agendamento está configurado e habilitado corretamente?