Dúvida Como devo atualizar o arquivo dbapi.dll do DBAccess no meu AppServer? Ambiente Protheus - AppServer - A partir da versão 12 Solução O arquivo dbapi.dll é uma biblioteca de integração do AppServer com o DBAccess. Para atualizá-lo, siga o procedimento abaixo: 1. Pare os serviços do Protheus 2. Na pasta do...

Procedimento para efetuar a atualização básica do Protheus 12

Resumo 🧩 Este artigo ensina, de forma objetiva, como atualizar a biblioteca dbapi.dll (DBAPI) usada pelo TOTVS | Application Server (AppServer) para se conectar ao TOTVS | DBAccess. Inclui checklist, passo a passo, validações pós-atualização, rollback e erros comuns. Aplicabilidade Produto: Microsiga Protheus —...

Dúvida Quais Artefatos devo atualizar para utilizar a Release 33 do Protheus? Ambiente Protheus - AppServer - A partir da versão 12 Solução Seguem abaixo passos e caminhos para o download e aplicação dos artefatos do Protheus para o binário Harpia (necessário para Release 33 e posteriores). DOWNLOAD Binário Harpia...

Dúvida Quais Artefatos devo atualizar para utilizar a Release 33 do Protheus? Ambiente Protheus - AppServer - A partir da versão 12 Solução Seguem abaixo passos e caminhos para o download e aplicação dos artefatos do Protheus para o binário Harpia (necessário para Release 33 e posteriores). DOWNLOAD Binário Harpia...

Dúvida Como atualizar o License Server Virtual? Ambiente Protheus – Servidor de Licenças - Todas as versões Solução Realize os seguintes passos: 1. Baixe o instalador conforme sistema operacional utilizado através dos links:  Windows - https://suporte.totvs.com/portal/p/10098/download?e=1022351 Linux...

OLETINS DOS MÓDULOS Através desta funcionalidade, é possível exibir boletins com informações dos módulos (que disponibilizarem informações) na tela do Menu Funcional do Smartclient. A funcionalidade se torna nativa do sistema a partir da LIB indicada no quadro ao lado. Características: - O usuário tem a opção de...

Dúvida Qual a finalidade da chave SpecialKey no arquivo appserver.ini? Ambiente Cross Segmento - Backoffice Linha Protheus - AppServer - Todas as versões Solução A chave SpecialKey define uma string que é concatenada à string básica nas funções de controle para acesso simultâneo (semáforo). Essa chave deve ser...

🧭 Resumo Antes de migrações ou cargas de dados, é essencial garantir que não existam chaves duplicadas nas tabelas. A rotina CheckDupl (Configurar > Wizard de Verificação de Duplicidade) identifica e auxilia na eliminação de duplicidades com segurança, gravando os registros removidos em tabelas de backup com sufixo...

Ocorrência Como ativar e desativar customizações no Protheus? Ambiente Microsiga Protheus - Gestão de Pessoal - A partir da versão 12 Solução Muitos clientes utilizam Pontos de Entrada / funções customizadas para a execução de rotinas, ou seja, uma otimização para atendimento de necessidade específica. Estas...

Dúvida Como ativar e desativar customizações no Protheus? Ambiente Cross Segmento - TOTVS Backoffice (Linha Protheus) - Financeiro - Todas as versões Solução Muitos clientes utilizam Pontos de Entrada para a execução de rotinas, ou seja, uma otimização para atendimento de necessidade específica. Estas...

 A partir do release 12.1.25 não é possível chamar uma função de usuário (User Function) pelo Lançamento Padronizado, maneira que muitos desenvolvedores ADVPL utilizavam para testarem e validarem suas rotinas desenvolvidas. Dessa forma, o desenvolvedor deve criar o acesso a rotina no menu pelo configurador do Protheus...

 partir do release 12.1.25 não é possível chamar uma função de usuário (User Function) pelo Lançamento Padronizado, maneira que muitos desenvolvedores ADVPL utilizavam para testarem e validarem suas rotinas desenvolvidas. Dessa forma, o desenvolvedor deve criar o acesso a rotina no menu pelo configurador do Protheus a...

Dúvida Como fazer para converter arquivos do tipo DBF para o formato DTC? Ambiente Protheus - APSDU - Até a Release 17 do Protheus 12 Solução Segue abaixo o procedimento para conversão dos arquivos: 01. Primeiramente, faça um backup das pastas System (ou Sigaadv) e Profile. Efetue cópia com os serviços parados...

Dúvida Como realizar uma configuração básica de Broker ? Ambiente Protheus – Frame – A partir da versão 12 Solução O Broker é utilizado e recomendado sempre que o cliente de problema de queda do smartclient por erro de sincronismo, ou seja, a transação de dados do smartclient com o appserver ficou desincronizada e...

01. Renomear seu arquivo de senha sigapss e abrir sistema para ser recriado com user => admin e senha => em branco. 02. Compilar o fonte abaixo: #INCLUDE "TOTVS.CH" /*/{Protheus.doc} SPFCLOSE Fechar arquivo de senha @author Eurai Rapelli @since 18/09/2014 @Example U_SPFCLOSE() @Example U_SPFCLOSEX() /*/ User...

Dúvida Como aplicar arquivo de emergência? Ambiente Protheus - A partir da versão 11.8 Solução Para solucionar essa ocorrência, realize os seguintes passos: 1. Acesse o Portal do Cliente: http://suporte.totvs.com 2. No menu, clique em Atendimento CST; 3. Clique em Senhas, Chave/Arquivo de Emergência; 4. Baixe o...

❓ Dúvida Como configurar o TOTVS Protheus para que usuários inativos sejam automaticamente desconectados após um período de tempo, considerando corretamente as regras de prevalência entre AppServer, Usuário e Grupo? 🧩 Ambiente Produto: TOTVS Backoffice — Linha Protheus Módulo: Configurador Framework...

Controle de Transação - MV_TTS O controle de transação é uma ferramenta importante que garante a integridade de dados quando uma determinada operação é realizada no Banco de Dados. As alternativas existentes quando da atualização de tabelas são : Efetivar a transação - quando realizada com sucesso Voltar a status...

Ponto-de-Entrada: CriaSXE - Controle de Numeração Descrição: Programa Fonte Sintaxe CriaSXE - Controle de Numeração ( [ PARAMIXB ] ) --> cRet Parâmetros: Retorno cRet (caracter) Número que será utilizado pelo controle de numeração. Caso seja retornado Nulo ( NIL ), a regra padrão do sistema será aplicada. Esta...

Dúvida Como criar uma Base de Teste para acesso com o Grupo de Empresas 99 e com acesso de até dois usuários? Ambiente Protheus - Configurador - A partir da Versão 12 Solução Criação de uma Base de Teste para acesso com o Grupo de Empresas 99 e com acesso de até dois usuários. Introdução A Totvs disponibiliza...

Dúvida Como criar filtros inteligentes no Protheus? Ambiente Protheus - Configurador - A partir da versão 11 Solução Os Filtros Inteligentes servem para que sejam criados filtros que possam ser utilizados por vários usuários, ao invés de cada usuário ter que criá-los individualmente. Devem ser criados no...

Dúvida Quais medidas tomar quando ocorrer o erro de código ERR0002? Ambiente Protheus - Servidor de Aplicação - Todas as versões Solução Ao tentar iniciar o SmartClient, ocorre o erro: ERR0002: Não foi possível estabelecer conexão com TOTVS Application Server. Verifique suas configurações (rede ou TOTVS...

Dúvida Qual a a finalidade do Banco de Conhecimento? Ambiente Microsiga Protheus – Banco de Conhecimento – Versão 12 Solução O Banco de Conhecimento do Protheus é um banco de informações genéricas, armazenadas em arquivos. Essas informações podem ser figuras, textos, planilhas ou qualquer tipo de arquivo que...

Dúvida Como configurar o sistema para que usuários inativos sejam automaticamente desconectados após um período de tempo? Ambiente Protheus - Configurador - A partir da versão 11 Solução A configuração de Inactive TimeOut no Protheus serve para desconectar usuários que estejam ociosos no sistema. A configuração pode...

Dúvida Como identificar o ofensor quando o Protheus 12 está apresentando lentidão generalizada? Ambiente Protheus – A partir da versão 12 Solução Avalie inicialmente as informações das documentações abaixo: Protheus Hardware Mínimo...

Dúvida O que devo fazer se for exibida a mensagem Mensagem de autorização de uso vencida? Ambiente Protheus - LS Virtual - Todas as versões Solução Para contornar essa situação, siga o procedimento abaixo: 1. Pare todos os serviços 2. Renomeie os diretórios db_sys , db_tmp, licenseagreement e Semaforo 3...

Ocorrência Mensagem de necessidade de renovação manual do LS Ambiente Framework - Framework (Linha Logix) - Administração Logix - Todas as versões. Causa Esse alerta é apresentado quando o sistema identifica que a renovação automática das licenças não está sendo realizada. Solução Para realizar o sincronismo...

Apresentamos a melhoria de utilização do Dicionário de Dados no Banco de Dados, que visa proporcionar maior agilidade na leitura do dicionário, centralização dos dados no SGBD, otimização nas buscas de informações, entre outras. Para que seu dicionário de dados seja migrado para o banco de dados, a partir do uso da...

Apresentamos a melhoria de utilização do Dicionário de Dados no Banco de Dados, que visa proporcionar maior agilidade na leitura do dicionário, centralização dos dados no SGBD, otimização nas buscas de informações, entre outras. Para que seu dicionário de dados seja migrado para o banco de dados, a partir do uso da...

Até a versão 11 do sistema Protheus, os textos passíveis de tradução de um programa eram armazenados em arquivos include (*.CH). A separação por idiomas ocorria dentro do próprio arquivo .CH através de diretivas de compilação que selecionavam o idioma desejado. A partir da versão 12 passou-se a utilizar um novo...

té a versão 11 do sistema Protheus, os textos passíveis de tradução de um programa eram armazenados em arquivos include (*.CH). A separação por idiomas ocorria dentro do próprio arquivo .CH através de diretivas de compilação que selecionavam o idioma desejado. A partir da versão 12 passou-se a utilizar um novo...

Seguindo a evolução tecnológica do Protheus com relação ao uso de novas linguagens e arquiteturas, a partir da Lib de Label 20201123 será disponibilizada a nova interface do Protheus. Nessa primeira fase, a novidade chega com a tela de login e a de seleção de ambiente: Além da renovação na aparência, que segue o...

Seguindo a evolução tecnológica do Protheus com relação ao uso de novas linguagens e arquiteturas, a partir da Lib de Label 20201123 será disponibilizada a nova interface do Protheus. Nessa primeira fase, a novidade chega com a tela de login e a de seleção de ambiente: Além da renovação na aparência, que segue o...

Dúvida Como configurar o tipo de numeração automática que meu ambiente irá utilizar? Ambiente Protheus - AppServer - A partir da versão 11 Solução Para a utilização de numeração automática, é recomendável que se utilize o modo de controle via License Server (Enablenumber=1). A numeração das tabelas em License...

Dúvida Como configurar o tipo de numeração automática que meu ambiente irá utilizar? Ambiente Protheus - AppServer - A partir da versão 11 Solução Para a utilização de numeração automática, é recomendável que se utilize o modo de controle via License Server (Enablenumber=1). Informação O desempenho da numeração...

Função: Posicione - Posiciona tabela em registro Descrição: Programa Fonte: Sintaxe: Posicione - Posiciona tabela em registro ( cAliasnOrdemcSeekcField [ cNickName ] ) --> cReturn Retorno: cReturn(qualquer) Será o conteudo do campo informado no parâmetro cField Parâmetros:

Dúvida Por que ocorre a mensagem: Tentativa de reservar registro no Alias em EOF Stack de chamadas em MSRLOCK.eof Controle de transações Habilitado? Ambiente TOTVS RH - TOTVS RH (Linha Protheus) - Gestão de Pessoal – A partir da versão 12.1.17 Solução Mensagem:  Conceito: O controle de transação é uma ferramenta...

Dúvida Qual Collation utilizar na criação do Banco de Dados? Ambiente Protheus - DBAccess - Todas as versões Solução Segue abaixo o Collation utilizado pelos bancos de dados homologados pela Totvs. Banco de Dados  | Collation IBM DB2               | IBM-1252 IBM Informix         | EN_US_CP1252 Microsoft SQL  ...

Para utilizar o REST com o ERP Microsiga Protheus é necessário configurar a chave PrepareIn da(s) seção(ões) URI. PrepareIn para apenas um Grupo de Empresas Deve-se informar, na linha PrepareIn, o código do Grupo de Empresas PrepareIn para apenas um Grupo de Empresas e Filial Neste caso deve-se informar, na...

01. Renomear seu arquivo de senha sigapss e abrir sistema para ser recriado com user => admin e senha => em branco. 02. Compilar o fonte abaixo: #INCLUDE "TOTVS.CH" User Function SPFCLOSE() SPF_CLOSE("SIGAPSS.SPF") Return( Nil ) 03. Abrir SIGACFG e ir no formulas. 04. Com formulas aberto, clicar em incluir e...

Sintaxe   SUPERGETMV( <nome do parâmetro>, <lHelp>, <cPadrão>, <Filial do sistema> )   Propósito   Retorna o conteúdo do parâmetro especificado no Arquivo SX6.   Argumentos   <nome do parâmetro>   Nome do parâmetro do sistema no Arquivo SX6, sem a especificação da filial do sistema...

Conceitos O Schedule Protheus permite que rotinas do sistema sejam agendadas para que possam ser executadas posteriormente, em um período determinado pelo usuário. É possível definir quando (dias, horários e quantidades de execuções) e em qual Grupo de Empresas e Filiais o processo será executado. O Schedule Protheus...

Dúvida Como faço para executar rotinas de forma automatizada no Protheus? Ambiente Protheus - Configurador - A partir da Versão 11 Solução O Schedule Protheus permite que rotinas do sistema sejam agendadas para que possam ser executadas posteriormente, em um período determinado pelo usuário. É possível definir...

Dúvida Como proceder caso o Servidor de Licenças pare de responder? Ambiente Protheus  - License Server Virtual - Todas as versões Solução Problema ocorre pois o Servidor de Licenças perdeu a comunicação com o Protheus ou as configurações de apontamento não estão corretas. Favor realizar os seguintes...

O TOTVS CodeAnalysis é uma ferramenta desenvolvida para permitir aos clientes efetuarem uma verificação em seus fontes customizados, afim de certificar a qualidade dos mesmos. Através de regras pré-determinadas, a ferramenta possibilita que os requisitos indicados sejam corrigidos evitando um maior impacto em...

BOLETINS DOS MÓDULOS Através desta funcionalidade, é possível exibir boletins com informações dos módulos (que disponibilizarem informações) na tela do Menu Funcional do Smartclient. A funcionalidade se torna nativa do sistema a partir da LIB indicada no quadro ao lado. Características: - O usuário tem a opção de...

Dúvida Como alterar o tema do Protheus 12? Ambiente Protheus - Todo o sistema - Versão 12 Solução Para alterar o Tema, siga os passos abaixo: 1. Abra o arquivo appserver.ini do Servidor de Aplicação, que fica na pasta bin/appserver; 2. Dentro da sessão do Ambiente, inclua a seguinte linha: Theme=Sunset 3. Salve o...

A ferramenta UPDBATCH permite enfileirar a execução de diversos pacotes SDF de atualização (gerados por Projetos do Gestão de Ambientes, por exemplo), permitindo sua execução em sequência, facilitando e agilizando sua aplicação nos ambientes. O UPDBATCH exibe na tela o status de aplicação de cada pacote, e em caso de...

A ferramenta UPDBATCH permite enfileirar a execução de diversos pacotes SDF de atualização (gerados por Projetos do Gestão de Ambientes, por exemplo), permitindo sua execução em sequência, facilitando e agilizando sua aplicação nos ambientes. O UPDBATCH exibe na tela o status de aplicação de cada pacote, e em caso de...

1. Preparando a base para o Upgrade Recomendamos fortemente que: Qualquer processo que envolva atualização do dicionário e base de dados do sistema seja efetuado inicialmente em ambiente de homologação e que os processos mais importantes para a operação da empresa sejam validados. Seja efetuada uma CÓPIA FRIA (todos...

1. Preparando a base para o Upgrade Recomendamos fortemente que: Qualquer processo que envolva atualização do dicionário e base de dados do sistema seja efetuado inicialmente em ambiente de homologação e que os processos mais importantes para a operação da empresa sejam validados. Seja efetuada uma CÓPIA FRIA (todos...

1. Preparando a base para o Upgrade Recomendamos fortemente que: Qualquer processo que envolva atualização do dicionário e base de dados do sistema seja efetuado inicialmente em ambiente de homologação e que os processos mais importantes para a operação da empresa sejam validados. Seja efetuada uma CÓPIA FRIA (todos...

O web service REST do AdvPL não utiliza as seções HTTP e WebServices utilizadas para o configurar o modelo SOAP. Apesar disso o REST também utiliza working threads para atender as requisições recebidas também pelo protocolo HTTP. A chave MAXSTRINGSIZE é obrigatória na seção GENERAL com valor mínimo 10 para que o...

A regra de dependência entre campos é utiliza por rotina escritas em MVC, para se forçar o preenchimento em ordem de campos, fazendo que um campo dependa do outro para liberar sua edição. Por exemplo, podemos definir que o campo Código da Loja de uma entidade, só pode ser preenchido após o preenchimento do campo...

Data de publicação: 25/06/2026 Produto: TOTVS Backoffice — Linha Protheus Módulo: Framework / AppServer Release relacionada: 12.1.2510 Tema: Padronização de nomes de ambientes no Protheus 📌 Objetivo Orientar sobre a nova regra de validação de nomes de ambientes no TOTVS Protheus, aplicada a partir da Release...

Data de publicação: 11/02/2026 🎯 Objetivo Orientar a configuração do SMTP no TOTVS Protheus (Framework) para permitir o envio de relatórios por e-mail, garantindo que rotinas e impressões possam disparar mensagens com anexos (PDF/CSV/TXT, conforme cenário). 🧩 Quando usar Relatórios que precisam ser enviados...

Data de publicação: 07/05/2026 🎯 Objetivo Orientar sobre a nova validação de bloqueio no uso de bibliotecas (libs) distintas no mesmo ambiente do Protheus, explicando o que mudou, como o controle funciona, quais os impactos nas rotinas de atualização e quais cuidados devem ser adotados na administração do ambiente...

Data de publicação: 11/02/2026 🎯 Objetivo Orientar a configuração do envio automático do arquivo por e-mail no TOTVS Protheus (Framework/Configurador), facilitando o monitoramento e a análise de falhas sem depender do envio manual do log. 🧩 Quando usar Para receber automaticamente o quando ocorrerem falhas no...

📌 Resumo A partir da Release 12.1.2510, a configuração da Porta Multiprotocolo passa a ser obrigatória para inicialização e operação dos ambientes TOTVS Protheus, exceto em ambientes de PDV — Ponto de Venda. Essa mudança tem como objetivo melhorar a comunicação entre serviços, reforçar a segurança das conexões de...

📅 Data de publicação 06/03/2026 🎯 Objetivo A rotina Cons.log Aplicação é um recurso do Framework do Protheus voltado à consulta do log de atualização gerado durante a execução do compatibilizador UPDDISTR. Na prática, ela permite que o administrador ou consultor técnico visualize o histórico da atualização aplicada...