🎯 Objetivo

Orientar a configuração e utilização da rotina GPEWORD no TOTVS RH — Linha Protheus — Gestão de Pessoal (GPE) para geração e impressão de documentos através do Microsoft Word.

A rotina permite utilizar modelos do Word contendo variáveis do Gestão de Pessoal, possibilitando a geração de documentos como, por exemplo, Contrato de Trabalho, com os dados dos funcionários preenchidos pelo Protheus. TOTVS Central de Atendimento

🧩 Ambiente

• Produto: TOTVS RH — Linha Protheus
• Módulo: Gestão de Pessoal — GPE
• Rotina: GPEWORD
• Processo: Integração e impressão de documentos no Microsoft Word
• Versão: A partir da versão 12.1.17

A TOTVS informa que o programa GPEWORD deve ser utilizado para impressão de documentos através do Microsoft Word. TOTVS Central de Atendimento

🔎 Cenário

A rotina GPEWORD pode ser utilizada quando existe a necessidade de gerar documentos do Gestão de Pessoal utilizando um modelo previamente preparado no Microsoft Word.

Um exemplo apresentado pela TOTVS é a geração de um Contrato de Trabalho.

O processo envolve basicamente:

Consultar as variáveis disponíveis
        ↓
Criar o modelo no Microsoft Word
        ↓
Inserir as variáveis como DocVariable
        ↓
Salvar o modelo como .DOT ou .DOTX
        ↓
Parametrizar a rotina GPEWORD
        ↓
Gerar o documento
``` :chatgpt-content-reference{index="2"}


---

## ⚙️ 1. Consultar as variáveis disponíveis

No módulo **SIGAGPE**, acesse:

```text
Atualizações
> Integrações
> Word

Em seguida, selecione:

Impr. Variáveis

e clique em:

OK

O sistema apresentará em tela as variáveis disponíveis para utilização no modelo do documento. TOTVS Central de Atendimento

📋 Relação de variáveis

A listagem apresentada pelo Protheus deve ser utilizada como referência para identificar as variáveis que poderão ser inseridas no documento Word.

A própria TOTVS destaca que essa relação pode ser utilizada na montagem do modelo do Contrato de Trabalho.

Assim como outros relatórios do sistema, essa relação também poderá ser direcionada para impressão externa ou PDF. TOTVS Central de Atendimento

📝 2. Criar o modelo no Microsoft Word

Após identificar as variáveis necessárias, abra o Microsoft Word e monte a estrutura do documento.

Exemplo:

CONTRATO DE TRABALHO

Nome: __________________________

Matrícula: _____________________

Cargo: _________________________

Os locais que deverão receber informações provenientes do Protheus deverão ser configurados utilizando as variáveis disponibilizadas pelo GPEWORD.

🔧 3. Inserir uma variável no Word

No exemplo apresentado pela TOTVS, para inserir a variável correspondente ao nome do funcionário, posicione o cursor ao lado da informação desejada e acesse no Word:

Inserir
> Partes Rápidas
> Campo

Na tela de configuração do campo, informe:

No exemplo da documentação:

GPE_NOME

Portanto:

Categoria     = Automação de documento
Nome do campo = DocVariable
Novo nome     = GPE_NOME

O mesmo procedimento deve ser realizado para as demais variáveis necessárias no modelo. TOTVS Central de Atendimento

📄 4. Salvar o modelo do Word

Depois de incluir todas as variáveis necessárias, salve o modelo no diretório desejado utilizando uma das extensões indicadas pela TOTVS:

.dot

ou:

.dotx

Esse arquivo será posteriormente informado nos parâmetros da rotina GPEWORD. TOTVS Central de Atendimento

⚙️ 5. Parametrizar a rotina GPEWORD

Para gerar o documento, retorne à rotina:

Atualizações
> Integrações
> Word

Acesse a opção:

Parâmetros

e preencha as informações conforme a necessidade da geração.

Entre as informações utilizadas pela rotina estão o modelo Word e o arquivo de saída. TOTVS Central de Atendimento

📁 Arquivo do Word

No campo:

Arquivo do Word

utilize a lupa para selecionar o arquivo:

.dot

ou:

.dotx

que foi configurado anteriormente com as variáveis do Protheus. TOTVS Central de Atendimento

📂 Arquivo de saída

No exemplo apresentado pela TOTVS, o arquivo de saída é informado utilizando o diretório local da estação do operador.

Exemplo:

C:\CONTRATO.DOC

A documentação destaca que o caminho utilizado corresponde à máquina do operador responsável pela geração do documento. TOTVS Central de Atendimento

🖨️ 6. Gerar o documento

Após preencher os parâmetros, clique em:

OK

e posteriormente em:

Impr.Documento

No exemplo da documentação, o sistema abre o modelo .dot em modo de compatibilidade em segundo plano e disponibiliza a geração do arquivo conforme a configuração utilizada, inclusive em PDF quando essa for a saída selecionada. TOTVS Central de Atendimento

Após salvar, o modelo é fechado e os arquivos de saída são gerados nos diretórios definidos. TOTVS Central de Atendimento

🔍 Como visualizar as variáveis inseridas no Word

A documentação da TOTVS também apresenta uma forma de conferir quais variáveis foram inseridas no documento.

Abra o arquivo Word e execute:

Selecionar o texto
        ↓
Botão direito do mouse
        ↓
Alternar Códigos de Campos

O Word passará a apresentar os códigos correspondentes às variáveis inseridas no documento.

Após realizar a consulta ou alteração:

Selecionar novamente o texto
        ↓
Botão direito do mouse
        ↓
Atualizar Campo
``` :chatgpt-content-reference{index="12"}


---

## ⚠️ Documento gerado sem alguma informação

Caso determinado campo seja apresentado sem conteúdo no documento gerado, a TOTVS orienta verificar se a respectiva informação está cadastrada no sistema.

Portanto, um campo vazio no documento não significa necessariamente problema no Word ou no `GPEWORD`.

Deve-se validar também a existência do dado correspondente no cadastro do Protheus. :chatgpt-content-reference{index="13"}

---

## 👨‍👩‍👧 Parâmetro “Verific. Dependente”

Na parametrização do `GPEWORD` existe a pergunta:

```text
Verific. Dependente

Esse parâmetro interfere diretamente nos funcionários considerados na impressão.

Quando informado NÃO

Verific. Dependente = NÃO

O sistema considera os funcionários em geral.

Quando informado SIM

Verific. Dependente = SIM

A impressão considerará somente os colaboradores que possuam dependentes. TOTVS Central de Atendimento

📊 Resumo do processo

⚠️ Pontos de atenção

Antes de gerar o documento, confirme:

Variáveis corretas no modelo
        ↓
Campos configurados como DocVariable
        ↓
Modelo salvo como .DOT ou .DOTX
        ↓
Arquivo do Word corretamente informado
        ↓
Diretório e arquivo de saída definidos
        ↓
Parâmetros do GPEWORD revisados

Também verifique o parâmetro:

Verific. Dependente

principalmente quando a rotina estiver retornando uma quantidade de funcionários diferente da esperada.

✅ Resultado esperado

Após a correta configuração do modelo Word e dos parâmetros do GPEWORD, o Protheus deverá utilizar as variáveis definidas no documento para preencher as informações correspondentes do funcionário e gerar o arquivo de saída.

O fluxo esperado é:

Dados do funcionário no Protheus
           ↓
Variáveis do GPEWORD
           ↓
DocVariable no modelo Word
           ↓
Modelo .DOT / .DOTX
           ↓
Impr.Documento
           ↓
Documento preenchido

💡 Boas práticas

• consulte as variáveis disponíveis antes de criar o modelo;
• utilize exatamente o nome da variável apresentada pelo Protheus;
• configure os campos no Word utilizando DocVariable;
• salve o modelo em .dot ou .dotx;
• confira as variáveis utilizando Alternar Códigos de Campos;
• caso uma informação não seja apresentada, valide primeiro se o dado existe no Protheus;
• revise o parâmetro Verific. Dependente antes da geração;
• confirme o modelo e o caminho do arquivo de saída antes de executar Impr.Documento.

❓ FAQ

1. Qual rotina é utilizada para integração do Gestão de Pessoal com o Word?

A rotina utilizada é:

GPEWORD

Ela é responsável pela impressão de documentos através do Microsoft Word. TOTVS Central de Atendimento

2. Onde consulto as variáveis disponíveis?

Acesse:

Atualizações
> Integrações
> Word
> Impr. Variáveis

3. Como a variável deve ser configurada no Word?

Utilize:

Inserir
> Partes Rápidas
> Campo

e configure:

Categoria     = Automação de documento
Nome do campo = DocVariable
Novo nome     = Variável do GPEWORD

4. Qual exemplo de variável é apresentado pela TOTVS?

A documentação utiliza:

GPE_NOME

como exemplo para o nome do funcionário. TOTVS Central de Atendimento

5. Em qual formato devo salvar o modelo?

O modelo deverá ser salvo como:

.dot

ou:

.dotx

6. Como visualizar as variáveis que já estão inseridas no documento?

Selecione o texto, clique com o botão direito e utilize:

Alternar Códigos de Campos

7. Como retornar à visualização normal depois de consultar os códigos?

Selecione novamente o conteúdo, clique com o botão direito e utilize:

Atualizar Campo

8. O que fazer quando uma informação fica vazia no documento?

Verifique se a informação correspondente está efetivamente cadastrada no Protheus. A própria TOTVS orienta essa validação quando algum item do documento é gerado sem conteúdo. TOTVS Central de Atendimento

9. Para que serve o parâmetro “Verific. Dependente”?

Quando configurado como:

NÃO

o sistema considera os funcionários em geral.

Quando configurado como:

SIM

considera para impressão somente colaboradores que possuam dependentes. TOTVS Central de Atendimento

10. Onde informo o modelo criado no Word?

Nos parâmetros da rotina, através do campo:

Arquivo do Word

onde deverá ser selecionado o modelo .dot ou .dotx previamente configurado. TOTVS Central de Atendimento

11. Como iniciar efetivamente a geração do documento?

Após preencher os parâmetros:

OK
> Impr.Documento

12. A rotina pode gerar documentos em PDF?

A documentação apresenta exemplo de geração em PDF utilizando essa configuração de saída, além de mencionar que a relação de variáveis pode ser impressa externamente ou em PDF. TOTVS Central de Atendimento

🔗 Referência oficial

TOTVS — RH — Linha Protheus — GPE — Configuração para Impressão de Documentos no Word (GPEWORD).

Artigo oficial atualizado em 25/06/2026, aplicável ao TOTVS RH — Linha Protheus — Gestão de Pessoal a partir da versão 12.1.17. TOTVS Central de Atendimento

👤 Autor

Fabrizio Augusto Ventavolo
Consultor Especialista TOTVS — Mastersiga Consultoria

“Conectamos tecnologia, processos e pessoas para acelerar resultados com excelência em sistemas TOTVS.”