Importação de dados para Planilha Orçamentária via arquivo xml

Produto:	Microsiga Protheus
Versões:	12

.1.7


Ocorrência:	Documentação da Rotina (PCOA009/PCOA041) - Importação de dados para Planilha Orçamentária
Passo a passo:	Importação de dados para Planilha Orçamentária Objetivo: Esta funcionalidade possibilita a integração do módulo Planejamento e Controle Orçamentário (SIGAPCO), através da Planilha Orçamentária (PCOA100), importando informações de outro ERP, por meio de arquivos XML. Pré-requisitos No Planejamento e Controle Orçamentário (SIGAPCO)

cadastrar Título a pagar na rotina Contas a Pagar

cadastrar os seguintes itens:

Menu :

Conta Orçamentária na rotina Contas Orçament. (PCOA010)

Centro de custo, item contábil e classe de valor na rotina Centro de Custos (CTBA180)

Operação na rotina Operações (PCOA080)

Planilha orçamentária na rotina Orçamentos (PCOA100)

No Financeiro (SIGAFIN) cadastradar os seguintes itens:

Fornecedor na rotina Fornecedores (MATA020)

Natureza Financeira na rotina Naturezas (FINA010)

Atualizações → Cadastros;

Contas Orçamentárias ->(PCOA010)
Classes Orçamentárias -> (PCOA020)
Centros de Custos -> (CTBA030)
Item contábil -> (CTBA040)
Classe de Valor -> (CTBA060)
Operações -> (PCOA080)

Menu : Atualizações → Planilhas;

Orçamentos -> (PCOA100)
OBS: Cadastrar uma planilha orçamentária vinculada a um conta orçamentária que receberá os valores a serem importados

No FINANCEIRO (SIGAFIN) cadastrar os seguintes itens:

Menu : Atualizações → Cadastros

Fornecedores ->(MATA020)
Naturezas -> (FINA010)

Menu : Atualizações → Contas a Pagar → Contas a Pagar

Contas a Pagar ->

(FINA050)

Importação de dados do ERP através do arquivo XML, para a Área de Integração

1

1. No Planejamento e Controle Orçamentário (SIGAPCO) acesse Miscelânea / Reprocessamentos / Lctos. Integração (PCOA009).

2. O sistema

apresenta

apresentara a tela de importação

3. Clique em Importar XML.

Importação de dados do ERP através dos pontos de

lançamento

lançamentos

1. No

1. No Planejamento e Controle Orçamentário (SIGAPCO) acesse Atualizações / Lançamentos / Por processo (

PCOA041

PCOA040).

2. Habilite o processo que deseja importar.

3. É permitido o reprocessamento do processo escolhido, que neste caso é a importação de Títulos a Pagar do módulo Financeiro (SIGAFIN).

4. Selecione o processo 000002, item 01

5. Altere o campo Perm. Reproc? para Sim.

2 - Importação dos dados da Área de Integração para a Planilha Orçamentária

1. No Planejamento e Controle Orçamentário (SIGAPCO) acesse Planilhas / Orçamentos (PCOA100).

2. Posicione na Conta Orçamentária a receber os dados

3. Clique em Ferramentas.

4. Clique no item Importar dados Integração (PCOA106).

5. É exibido o assistente de importação dos dados da Área de Integração.

6. Deixe em branco os campos Processo? e Item? para que o assistente identifique a origem nos arquivos XML.

7. Preencha os demais campos conforme help de campo

8. Clique em Finalizar.

Para utilizar o Assistente para dados do ERP

1. No Assistente de Importação preencha os campos Processo? e Item? Com o número de processo 000002 e o Item 01.

2. Preencha os demais campos conforme help de

Importante:

Na planilha orçamentária não tem campo para informar se é débito ou crédito (uma vez que por conceito o orçamento os valores orçados são sempre crédito), mas pode ser importado da area de integração crédito ou débito, sendo que a regra para os valores são crédito acrescenta e débito diminui. Mas frisamos que ao importar débito que diminui o valor e possa ficar negativo (o que não é permitido) será exibido help informando a ocorrência e será abortado a importação dos dados da area de integração.

Para utilizar o Assistente para dados do ERP

1. No Assistente de Importação preencha os campos Processo? e Item? Com o número de processo 000002 e o Item 01.

2. Preencha os demais campos conforme help de campo

3. Clique em Finalizar.

O Engine de Integração auxilia o desenvolvimento do orçamento, disponibilizado por meio de integração de diferentes módulos do Microsiga Protheus, unificando as informações em apenas um lugar.

É necessário realizar todos os cadastros e configurações padrão do Planejamento e Controle Orçamentário (SIGAPCO), com o cadastro da planilha orçamentária e as entidades. O Engine de integração deve ser configurado para realizar o vínculo entre Engine x Planilha orçamentária x Entidades da planilha. É possível realizar uma carga inicial para atualização dos dados de orçamento da planilha.

Esta atualização acontece da seguinte forma:

Leitura do arquivo XML

O sistema utilizado gera o arquivo XML com o layout definido e o disponibiliza na pasta desejada pelo usuário.

Bloco de código

language	xml
theme	RDark
title	Layout do

arquivo

Arquivo XML
<root>



 <processo idProcesso="0001" dtMovimento="01/01/2011">



  <itens>

   <item dtplanej="01/01/2011" valor="101.00"  CO="0011" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="02/01/2011" valor="102.00"  CO="0011" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="04/01/2011" valor="104.00"  CO="0011" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="07/01/2011" valor="107.00"  CO="0011" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="12/01/2011" valor="112.00"  CO="0011" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="17/01/2011" valor="117.00"  CO="0011" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="27/01/2011" valor="127.00"  CO="0011" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="01/02/2011" valor="200.00"  CO="0011" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="01/03/2011" valor="300.00"  CO="0011" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="01/04/2011" valor="400.00"  CO="0011" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="01/05/2011" valor="500.00"  CO="0011" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="01/06/2011" valor="600.00"  CO="0011" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="01/07/2011" valor="700.00"  CO="0011" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="01/08/2011" valor="800.00"  CO="0011" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="01/09/2011" valor="900.00"  CO="0011" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="01/10/2011" valor="1000.00" CO="0011" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="01/11/2011" valor="1100.00" CO="0011" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="01/12/2011" valor="1200.00" CO="0011" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="01/01/2011" valor="100.00"  CO="0012" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="01/02/2011" valor="200.00"  CO="0012" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="01/03/2011" valor="300.00"  CO="0012" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="01/04/2011" valor="400.00"  CO="0012" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="01/05/2011" valor="500.00"  CO="0012" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="01/06/2011" valor="600.00"  CO="0012" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="01/07/2011" valor="700.00"  CO="0012" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="01/08/2011" valor="800.00"  CO="0012" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="01/09/2011" valor="900.00"  CO="0012" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="01/10/2011" valor="1000.00" CO="0012" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="01/11/2011" valor="1100.00" CO="0012" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>

   <item dtplanej="01/12/2011" valor="1200.00" CO="0012" CLASSE="000001" OPER="000001" CC="001" ITCTB="001" CLVLR="001" IDREF="001001" TIPO="1"/>



  </itens>



 </processo>

</root>
 Informações
titleDicionário de tags do arquivo XML
IdProcesso: 

é o número

Número de identificação da importação,

é gravado no

campo Chave (AMJ_CHAVE)

.

;
DtMovimento: 

data

Data da importação do arquivo

, é gravada no campo

-> Data (AMJ_DATA)

.

;
DtPlanej: 

data

Data do registro

que é gravada no campo

-> Data Planej. (AMJ_DATPLA)

.

;
Valor: 

valor

Valor do item

que é gravado no campo

-> Vlr. Lancto (AMJ_VALOR1)

.

;
CO: conta orçamentária 

que é gravada no campo

-> Conta Orçam. (AMJ_CO)

.

;
Classe: classe orçamentária 

que é gravada no campo

-> Classe Orc. (AMJ_CLASSE)

.

;
Oper: operação 

que é gravada no campo

-> Operação (AMJ_OPER)

.

;
CC: centro de 

custo que é gravado no campo

custo -> Centro Custo (AMJ_CC)

.

;
ItCtb: item contábil 

que é gravado no campo It

-> It. Contábil (AMJ_ITCTB)

.

;
ClVlr: classe de valor 

que é gravada no campo

-> Classe Valor (AMJ_CLVLR)

.

;
IdRef:  é o número 

seqüencial que é o

sequencial item de cada lote

, gravado no campo

-> Item (AMJ_ID)

.

;
Tipo: define se o lançamento é 1=Crédito/2=Débito 

, gravado no campo

->  Tipo (AMJ_TIPO);
UNIORC: Unidade Orçamentária - > Unid. 

Orçamentária (AMJ_UNIORC);
ENT05: Entidade Adicional 05 - > Entidade 05 (AMJ_ENT05);
ENT06: Entidade Adicional 06 - > Entidade 06 (AMJ_ENT06);
ENT07: Entidade Adicional 07 - > Entidade 07 (AMJ_ENT07);
ENT08: Entidade Adicional 08 - > Entidade 08 (AMJ_ENT08);
ENT09: Entidade Adicional 09 - > Entidade 09 (AMJ_ENT09);

O Engine de Integração decodifica este arquivo XML e grava suas informações na tabela AMJ – Área de Integração do PCO.

Importação dos dados via Pontos de Lançamento

O Engine de Integração busca a configuração dos pontos de lançamento e através delas, insere a tabela da área de integração.

A configuração do Engine de Integração deve ser realizada para

O Engine de Integração decodifica este arquivo XML e grava suas informações na tabela AMJ – Área de Integração do PCO.

Importação dos dados via Pontos de Lançamento

O Engine de Integração busca a configuração dos pontos de lançamento e através delas, insere a tabela da área de integração.

A configuração do Engine de Integração deve ser realizada para

todas as planilhas orçamentárias que dependam de resultados de processamento de outros ERPs.

Exemplo

Simples

: Arquivo de interação xml para integração

( Processo 000001 - Contas a Receber).

Bloco de código

language	xml
theme	RDark
title	Arquivo de interação xml para integração

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>


<root>


<processo idProcesso="000001" dtMovimento="01/01/2016">


<itens>

<item DTPLANEJ="01/01/2016" VALOR="100.01" CO="4101001" CLASSE="000001" CC="01" ITCTB="07" CLVLR="04" IDREF="00001" ID="1" TIPO="1"/>

<item DTPLANEJ="01/02/2016" VALOR="100.02" CO="4101001" CLASSE="000001" CC="02" ITCTB="07" CLVLR="04" IDREF="00001" ID="2" TIPO="1"/>

<item DTPLANEJ="01/06/2016" VALOR="100.03" CO="4101001" CLASSE="000001" CC="03" ITCTB="07" CLVLR="04" IDREF="00001" ID="3" TIPO="1"/>

<item DTPLANEJ="01/07/2016" VALOR="100.04" CO="4101001" CLASSE="000001" CC="04" ITCTB="07" CLVLR="04" IDREF="00001" ID="4" TIPO="1"/>

<item DTPLANEJ="01/08/2016" VALOR="100.05" CO="4101001" CLASSE="000001" CC="05" ITCTB="07" CLVLR="04" IDREF="00001" ID="5" TIPO="1"/>


</itens>


</processo>


</root>

Entrar na tela de Integração

No Planejamento e Controle Orçamentário (SIGAPCO) acesse :

Miscelânea / Reprocessamentos / Lctos. Integração (PCOA009).

Image Removed

Pressionar Importar xml e preencher parametros

Image Removed

Será exibido tela de reprocessamento com sucesso

Image Removed

Ir para Atualizações / Planilhas / Orçamento

Alterar planilha

Image Removed

Pressionar Outras Ações / Ferramentas / Importar dados de Integração

Image Removed

Itens Orçamentarios são preenchidos de acordo com arquivo xml importado

Image Removed

IMPORTANTE : Antes de iniciar a execução certifique-se que todas as informações a serem importadas estejam pré cadastradas no sistema :

No exemplo acima utilizamos : Conta Orçamentaria, Classe, Item Contábil, Classe de valor e a Planilha orçamentária vinculada a Conta Orçamentaria.

Image Added

Clicar no Botão -> Importar xml, preencher parâmetros de acordo com dados que estão disponíveis no arquivo xml.

Image Added

451px

Será exibido tela de reprocessamento com sucesso

Image Added

Após efetuado os processos acima entrar em Planilhas Orçamentária PCOA100 e seguir os processos abaixo:

Menu -> Atualizações / Planilhas / Orçamento

Alterar planilha

Image Added

Posicionar na conta orçamentaria que receberá os valores

Pressionar Outras Ações / Ferramentas / Importar dados de Integração

Image Added

Veja abaixo que os Itens Orçamentários são preenchidos de acordo com arquivo xml importado

Image Added

Exemplo : Arquivo de interação xml para integração ( Processo 000001 - Contas a Receber) utilizando Unidade Orçamentária e Entidade Adicional.

Bloco de código

language	xml
theme	RDark
title	Arquivo de interação xml para integração utilizando Unic.Orc e Ent.Adicional

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<root>
<processo idProcesso="000001" dtMovimento="01/01/2023">
<itens>
<item DTPLANEJ="05/01/2023" VALOR="200.02" CO="COTST02" CLASSE="CLO001" CC="CCUSTOTST" ITCTB="ITEMTST01" CLVLR="CLASTST01" UNIORC="000004" ENT05="005" IDREF="00001" ID="1" TIPO="1"/>
</itens>
</processo>
</root>

Nota

title	Importante - Etapas de Integração

As etapas de Integração é exatamente igual ao exemplo anterior, nesse exemplo foi apenas acrescentado as Tags referente a Unidade Orçamentária e Entidade Adicional, na importação do XML marcada as opções de "Arquivo contém Unid. Orçamentária ? " e " Arquivo contém ENTIDADE05?".

Miscelânea / Reprocessamentos / Lctos. Integração (PCOA009). Clicar no Botão -> Importar xml, preencher parâmetros de acordo com dados que estão disponíveis no arquivo xml.

Image Added

Os Itens Orçamentários são preenchidos de acordo com arquivo xml importado:

Image Added

Aviso

title	Aviso - Entidades Adicionais

As unidades adicionais devem ser adicionadas na Tag ENT+Número da Entidade sendo cada tag referente a uma Entidade Adicional.

ENT05: Entidade Adicional 05 - > Entidade 05 (AMJ_ENT05);
ENT06: Entidade Adicional 06 - > Entidade 06 (AMJ_ENT06);
ENT07: Entidade Adicional 07 - > Entidade 07 (AMJ_ENT07);
ENT08: Entidade Adicional 08 - > Entidade 08 (AMJ_ENT08);
ENT09: Entidade Adicional 09 - > Entidade 09 (AMJ_ENT09);

IMPORTANTE: Caso necessitar que estes movimentos sejam inclusos na rotina PCOA050 Lançamentos configurar o processo 000252.

Observações:

A área de integração do SIGAPCO (AMJ) pode ser populada via ponto de integração com qualquer processo do ERP.

Link Boletim Técnico :

Documento de Referência:

Importação de dados para Planilha Orçamentária

-- 115167

Árvore de páginas

Versões comparadas

Versão antiga 7

Nova versão Atual

Chave

Importação de dados para Planilha Orçamentária via arquivo xml

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 7

Nova versão Atual

Chave

Importação de dados para Planilha Orçamentária via arquivo xml