Integração com o Orçamento do ERP Protheus

Visão Geral

Configurando a Funcionalidade

No módulo TOTVS Metadata Manager, crie um escopo que represente a fonte de dados do ERP Protheus. Adicione ao escopo a fonte de dados para o ERP Protheus. Esta fonte de dados pode ser Oracle ou MS-SQL Server.

Por intermédio do menu “Arquivo > Configurar Destinos EAI” cadastre o nome e o endereço de destino (URI) do serviço de EAI do ERP Protheus. Configure também o time-out para a conexão. Caso tenha dúvidas sobre qual o endereço URI (Identificador Uniforme de Recursos/Uniform Resource Identifier) informar, procure o administrador do ambiente do ERP Protheus.

Por intermédio do menu “Arquivo > Configurar Integração”. Na tela de configuração, selecione a opção “ERP Protheus”, informe um código de empresa válido e selecione a fonte de dados para o ERP Protheus, destino EAI configurado e o tamanho máximo para os pacotes de envio de mensagem (em kilobytes).

Integração com o Orçamento

Ao configurar a integração com o ERP Protheus, será exibido no módulo de Edição de Planos, sob o menu “Ferramentas”, o menu relacionado ao processo de integração. O processo de integração é dividido em duas partes: Importação dos cadastros para criação da estrutura hierárquica de orçamento e a exportação dos dados da planilha após serem entrados os valores orçados.

Criação da Estrutura de Orçamento

Para iniciar a criação de uma estrutura de orçamento, acesse o menu “Ferramentas > Integração de Orçamento > Importar estrutura de orçamento”. Será aberta uma tela para que seja selecionado os dados que serão utilizados na estrutura.

Na tela de configuração da estrutura, deve ser informado o código da empresa e o código da filial para o qual a estrutura de integração está sendo criada e em seguida utilizar o botão “Aplicar” para que os campos sejam habilitados para configuração. No caso onde uma configuração já tenha sido feita no plano, a tela será aberta com os campos desabilitados e será possível apenas fazer a consulta dos das informações configuradas.

As opções de configuração da estrutura são as seguintes:

• Período: Deve ser informado o período para o qual a estrutura está sendo criada. O período define a data inicial e a data final a ser utilizada. Essa informação é utilizada em conjunto ao campo “Periodicidade” de forma a definir a quantidade de períodos que a estrutura de informação terá. Por exemplo, se informado o período de “01/01/2010” a “31/12/2010” e periodicidade “Mensal”, serão criadas 12 colunas na estrutura onde cada coluna irá representar cada um dos 12 meses.

• Planilha Orçamentária: Deve ser selecionada a planilha orçamentária e sua versão para que possa ser identificada a estrutura de contas orçamentárias que foi configurada no ERP Protheus.

• Contas Orçamentárias: Deve ser selecionada a opção de seleção de contas por conta ou por nível e em seguida utilizar o botão “Selecionar”. Será apresentada a tela com a estrutura de contas cadastradas no ERP Protheus e devem ser selecionadas as contas que farão parte da estrutura final.

• Cabeçalho: Nessa lista são apresentados os campos que terão apenas um valor definido para toda estrutura de integração. Os valores para cada campo selecionado serão definidos pelo usuário, na pasta do plano, depois que a estrutura for criada. A ordem dos campos não lista não é relevante. Os campos disponíveis são: Conta Orçamentária, Classe Orçamentária, Operação Orçamentária, Centre de Custo, Item Contábil, Classe de Valor e Unidade Orçamentária.

• Níveis da Estrutura: Nessa lista hierárquica são apresentados os campos que terão valores definidos conforme o cadastro no ERP Protheus. Deve-se utilizar os botões acima dessa lista para mover o item selecionado para a lista de cabeçalho ou para a lista de níveis da estrutura. A ordem dos itens nessa lista determina a ordem dos campos na hierarquia da estrutura de informação que será criada. Os botões no lado direito dessa lista podem ser utilizados para determinar a ordem dos campos. É necessário que, no mínimo, um campo esteja presente nessa lista.

• Botão de Filtro da Estrutura: Esse botão está localizado no canto inferior direito da lista de níveis da estrutura. Por intermédio dele, pode ser configurado filtros para os campos da estrutura. No caso do campo “Contas Orçamentárias” utilize a seleção no próprio formulário, para os demais campos pode-se definir filtros de seleção ou de critério utilizando o mesmo mecanismo de filtro da estrutura de informação.

• Periodicidade: Esse campo define a periodicidade de entrada dos valores na estrutura a ser criada. Essa configuração funciona em conjunto com o “Período”.

• Moeda: Esse é um campo opcional onde pode ser informado o código da moeda para a informação dos valores. Para o ERP Protheus, quando não informado é utilizada a moeda padrão do sistema.

• Opção de Concatenar o Código na Descrição: Essa opção, quando selecionada, permite que o item na estrutura de informação utilize o formato “[Código] – Descrição” ao invés de informar apenas a descrição do campo.

Para confirmar as configurações, no caso de estar sendo criada uma nova estrutura, deve ser acionado o botão “OK” que iniciará o processo de importação dos cadastros e geração da estrutura de informação conforme as configurações selecionadas. Ao final, a tela será fechada e será apresentado, no plano, a pasta com o nome “Orçamento” com a estrutura do orçamento pronta para iniciar a entrada dos valores. Dependendo do volume de informações no cadastro, esse processo pode levar algum tempo.

O botão “Cancelar” fecha a tela e retorna sem alterar o plano.

Exportação da Estrutura de Orçamento

Para exportar a estrutura do orçamento de uma pasta do plano, acesse o menu “Ferramentas > Integração de Orçamento > Exportar estrutura de orçamento”. Caso a pasta em foco, seja uma pasta com estrutura de orçamento anteriormente importada, é aberta a tela para que o usuário confirme a exportação. A pasta pode ser a pasta principal, uma pasta replicada ou a pasta resumo da reprodução.

Antes de efetuar a exportação, o usuário deve verificar se todos os campos de cabeçalho, que foram configurados durante a criação da estrutura, têm valores válidos informados. Dessa forma, antes de iniciar a exportação, consulte se os valores associados a integração são valores válidos no ERP Protheus, caso contrário uma mensagem de erro será exibida durante a exportação.

Ao confirmar a exportação, o sistema fará a conexão com o ERP Protheus por intermédio do serviço de EAI e enviará os dados da pasta. O envio é feito em blocos e se algum tipo de erro de conexão ou de validação pelo ERP ocorrer, o usuário será questionado se continua o envio do bloco que ocorreu o erro ou se cancela a operação.

Reprodução de Pastas de Orçamento

Para reproduzir a pasta em que foi criada a integração com o orçamento, é necessário selecionar a pasta de “Orçamento”, clicar com o botão direito e selecionar a opção de menu “Reproduzir”.

Na tela serão exibidas as opções para reprodução da pasta de orçamento. A reprodução da pasta de orçamento pode ser utilizada para facilitar o preenchimento e organização das informações, pois possibilita que a estrutura importada seja dividida em estruturas menores em cada pasta gerada pela reprodução.

Para mais detalhes sobre a reprodução de pastas, consulte o tópico Criando um Novo Plano > Reprodução de Pastas.

Conteúdos Relacionados:

A funcionalidade de integração requer o ERP Protheus 11.8 ou superior que utilize como banco de dados o MS-SQL Server ou Oracle com os serviços de integração (EAI) configurados para a mensagem BudgetItems. Os cadastros necessários no ERP para que a integração possa ser feita são os seguintes:

• Contas Orçamentárias.

• Planilha Orçamentária.

• Plano de Contas Contábeis.

• Classe Orçamentária.

Além desses cadastros mínimos, os seguintes cadastros podem ser utilizados durante a seleção dos dados para criação da estrutura de informação do orçamento:

• Centro de Custo.

• Item Contábil.

• Classe de Valor.

• Unidade Orçamentária.

• Operação Orçamentária.