Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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
    languagexml
    themeRDark
    titleLayout 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
    languagexml
    themeRDark
    titleArquivo 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

    Image Removed

    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


    Image Added


    Image Added


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


    Image Added

    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
    languagexml
    themeRDark
    titleArquivo 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
    titleImportante - 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
    titleAviso - 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