A integração do Protheus com Excel permite utilizar funções do sistema diretamente em planilhas para extração de dados, via assistente de função, digitação direta, ou função SIGA. Diversas funções contábeis estão disponíveis, facilitando a montagem de relatórios e análises financeiras no Excel.
Dúvida:
Como utilizar as funções e fórmulas do Protheus através da rotina de Integração com Excel (ApExcel)?
Ambiente:
Cross Segmento - TOTVS Backoffice (Linha Protheus) - Contabilidade Gerencial - Versões 11 e 12
Solução:
A integração do Protheus com o Microsoft Excel® permite utilizar funções do sistema diretamente em planilhas para a extração de dados e montagem de relatórios.
Para utilizar este recurso, realize os seguintes passos:
- Acesse o módulo desejado no Protheus.
-
No menu principal, navegue até: Miscelânea > Integrações > Planilha Excel.
-
O sistema apresentará uma janela de confirmação. Clique em OK para iniciar a comunicação com o Microsoft Excel®.
-
Aguarde a barra de progresso de conexão.
-
Com o Excel aberto, existem 4 formas de utilizar as funções do Protheus. Confira abaixo os métodos disponíveis:
Opção 1: Assistente de Função (Recomendado)Este método é indicado para facilitar a visualização dos parâmetros necessários.
No Excel, clique no botão Inserir Função (fx).
Na categoria, selecione Definido pelo Usuário.
Selecione a função desejada na lista (Ex: Ap5BarButtons, Posicione, etc.).
Ao clicar em OK, será aberta a janela de argumentos da função. Preencha os campos solicitados (Alias, Ordem, Chave, Campo) e confirme.
Opção 2: Digitação Direta
Caso conheça a sintaxe da função, é possível digitá-la diretamente na célula, iniciando com o sinal de igual =.
Exemplo: =MesExtenso("04")
Resultado: Retornará "Abril".
Opção 3: Função SIGA (Parâmetros separados)
Utiliza-se a função SIGA() como um interpretador para chamar funções do Protheus. Neste formato, o nome da função Protheus deve estar entre aspas, e os parâmetros separados por ponto e vírgula (ou o separador padrão do seu Excel).
Sintaxe: =SIGA("NomeDaFuncao"; Parâmetro1; Parâmetro2...)
Exemplo: =Siga("MesExtenso";"04")
Opção 4: Função SIGA (Parâmetros encapsulados)
Nesta variação, a função Protheus e seus parâmetros são passados como uma única string (texto) dentro da função SIGA().
Sintaxe: =SIGA("NomeDaFuncao(Parâmetros)")
Exemplo: =Siga("MesExtenso(04)")
Observação: A conexão pode ser cancelada através do Protheus, clicando no botão “Sair”, ou fechando o Microsoft Excel®.
O módulo SIGACTB possui algumas funções disponíveis para extração de dados, abaixo estão listas as funções disponíveis:
| Função | Descrição da função |
| SALDOITEM | Retorna o Saldo de uma Conta Contábil + Centro de Custo + Item Contábil |
| SALDOCCUS | Retorna o Saldo de uma Conta contábil + Centro de custo |
| SALDOCLASS | Retorna o Saldo de uma Conta Contábil + Centro de Custo + Item Contábil + Classe de Valor |
| MOVITEM | Retorna o Movimento de uma Conta Contábil + Centro de Custo + Item Contábil |
| MOVCUSTO | Retorna o Movimento de uma Conta Contábil + Centro de Custo |
| MOVCONTA | Retorna o Movimento de uma Conta Contábil |
| MOVCLASS | Retorna o Movimento de uma Conta Contábil + Centro de Custo + Item Contábil + Classe de Valor |
| CTSMCONTA | Retorna o saldo de um grupo de Contas Contábeis na data e moeda informadas. |
| CTSMCUSTO | Retorna o saldo de um grupo de Centros de Custo na data e moeda informadas. |
| CTSMITEM | Retorna o saldo de um grupo de Itens Contábeis na data e moeda informadas. |
| CTSMMOV | Retorna a soma de movimentos de um intervalo e/ou conjunto de entidades (Conta e/ou Centro de Custo e/ou Item Contábil e/ou Classe de Valor) dentro de um intervalo de datas com a livre combinação das entidades |
| SALDOCONTA | Retorna o saldo de uma Conta Contábil na data e moeda informadas. |
| CTSMENTMOV | Retorna a soma de movimentos do intervalo de códigos de uma das entidades (Conta, Centro de Custo, Item Contábil ou Classe de Valores) e de um intervalo de datas. |
| CTBSMSALDOS | Retorna o saldo de um grupo de entidades em uma determinada data. |
| CTSMCLVL | Retorna o saldo de um grupo de Classes de Valores na data e moeda informadas. |
Saiba Mais
Planilha Excel
Validar funções advpl na integração Excel
2 Comentários