xRH — Central de Integração

Dashboard

Visão geral da integração xRH

Agente

—

verificando...

Colaboradores

—

Última Sincronização

—

Erros (7 dias)

—

Status do Agente

Carregando...

Entidades — última sincronização

Carregando...

Últimos eventos

—Carregando...

Banco de Dados

Conexão direta ao SQL Server Senior Vetorh

Conexão SQL Server

Host / IP

Porta

Instância (opcional)

Banco de dados

Usuário

Senha

Parâmetros Senior

Código(s) Empresa — NumEmp

Separe múltiplas empresas com ponto e vírgula: 1;2

Tipos de Colaborador — TipCol

1=CLT, 2=Autônomo, 3=Diretor. Padrão: 1;2;3

Agente xRH

Instalação, configuração e monitoramento do agente na rede do cliente

Status da Conexão

Carregando...

Download do Instalador

Versão atual disponível: carregando...

URL da Plataforma xRH

Configure esta URL no agente (monitor web → Configurações → URL do Servidor):

—

Instalação como Serviço Windows

Passo a passo

Baixe o arquivo xrh_agent_vX.X.X.zip acima e extraia em C:\xRHAgent\
Na aba Empresas, clique em 🔑 Baixar chave em cada empresa e salve os arquivos na pasta C:\ProgramData\xRHAgent\keys\ (crie a pasta se não existir). Cada empresa tem sua própria chave — uma máquina pode atender várias empresas e até tenants diferentes que compartilham a mesma base, bastando reunir todas as chaves nessa pasta.
Abra o Prompt de Comando como Administrador e execute:

cd C:\xRHAgent
xrh_agent.exe install
xrh_agent.exe start

Acesse o monitor local em http://localhost:8765 para configurar a URL do servidor e verificar o status
No monitor local, configure a URL do servidor para a URL da plataforma xRH exibida acima
O agente deve aparecer como Online no dashboard desta Central após alguns segundos

Comandos úteis:
xrh_agent.exe status — verifica se o serviço está rodando
xrh_agent.exe stop — para o serviço
xrh_agent.exe remove — remove o serviço do Windows
Log em: C:\ProgramData\xRHAgent\xrh_agent.log

📋 Manual de Configuração do Agente xRH Este guia orienta a instalação e configuração completa do Agente xRH no servidor do cliente. Siga cada passo na ordem indicada. Em caso de dúvidas, acesse a aba Status e Downloads para informações técnicas em tempo real.

1

Pré-requisitos — O que você precisa

Antes de começar

Confirme que os itens abaixo estão disponíveis antes de iniciar a instalação:

Windows 10 ou superior (ou Windows Server 2016+)
Conta de usuário Windows com permissão de Administrador local
Acesso de rede ao servidor SQL Server do Senior Vetorh
As informações da conta do banco de dados (host, porta, usuário e senha do SQL Server)
Acesso à internet para comunicar com a plataforma xRH
E-mail e senha de acesso a esta Central (fornecidos pelo administrador)

⚠

O agente deve ser instalado em um computador ou servidor que permaneça ligado e conectado à internet durante o horário de trabalho. Idealmente, instale-o no próprio servidor onde o Senior Vetorh está instalado.

2

Baixar o Agente e a Chave de Acesso

Download

Na aba Status e Downloads desta página, clique nos dois botões a seguir:

⬇ Baixar Agente (.zip) — salve o arquivo em qualquer pasta temporária, por exemplo C:\Temp\xrh_agent.zip
As chaves das empresas — na aba Empresas, clique em 🔑 Baixar chave em cada empresa. Cada arquivo tem nome único e identifica aquela empresa (e o seu tenant) na plataforma. Guarde-os em local seguro.

ℹ

Cada chave é exclusiva de uma empresa. Um mesmo agente pode atender várias empresas — inclusive de tenants diferentes que compartilham a mesma base — reunindo todas as chaves na pasta keys\. Nunca compartilhe ou envie as chaves por e-mail; se uma chave for comprometida, use ↻ Nova chave para gerar outra.

3

Instalar os Arquivos no Servidor

Instalação

3.1 — Extrair o agente

Extraia o conteúdo do arquivo .zip para a pasta:

C:\xRHAgent\

Após extrair, a pasta deve conter o arquivo xrh_agent.exe e outros arquivos de suporte.

3.2 — Copiar as chaves de acesso

Copie todas as chaves das empresas (uma por empresa) para a pasta keys (crie-a se não existir):

C:\ProgramData\xRHAgent\keys\

⚠

A pasta C:\ProgramData pode estar oculta no Windows Explorer. Para acessá-la, clique na barra de endereço do Explorer, digite o caminho completo e pressione Enter.

4

Instalar e Iniciar o Serviço Windows

Serviço

Abra o Prompt de Comando como Administrador:

Pressione Windows + S, digite cmd
Clique com o botão direito em Prompt de Comando e selecione Executar como administrador

Execute os comandos na ordem:

C:\> cd C:\xRHAgent
C:\xRHAgent> xrh_agent.exe install
# Registra o serviço no Windows
C:\xRHAgent> xrh_agent.exe start
# Inicia o serviço

Para confirmar que o serviço está rodando:

C:\xRHAgent> xrh_agent.exe status
# Deve exibir: ATIVO

✓

O serviço xRH Agent ficará configurado para iniciar automaticamente junto com o Windows. Não é necessário nenhuma ação adicional após reinicializações do servidor.

Outros comandos úteis:

`xrh_agent.exe stop`	Para o serviço
`xrh_agent.exe restart`	Reinicia o serviço
`xrh_agent.exe remove`	Remove o serviço do Windows

📁 Log de eventos: C:\ProgramData\xRHAgent\xrh_agent.log

5

Configurar a URL da Plataforma (Monitor Local)

Configuração

Após iniciar o serviço, o agente abre um monitor local acessível pelo navegador:

Abra o navegador no computador onde instalou o agente
Acesse: http://localhost:8765
No monitor, vá em Configurações
No campo URL do Servidor, informe a URL da plataforma xRH exibida na aba Status e Downloads desta página
Clique em Salvar

ℹ

A URL da plataforma tem o formato https://central.suaempresa.com.br. Copie exatamente como exibida nesta Central — incluindo o https:// e sem barra no final.

Após salvar, o agente tentará se conectar à plataforma automaticamente. Aguarde de 10 a 30 segundos e verifique se o status muda para Conectado no monitor local.

6

Configurar a Conexão com o Banco de Dados Senior

Banco de Dados

De volta a esta Central, acesse o menu 🗄 Banco de Dados na barra lateral e preencha os dados de conexão ao SQL Server do Senior Vetorh:

Campo	Descrição	Exemplo
Host / IP	Endereço do servidor SQL Server	192.168.1.10
Porta	Porta TCP do SQL Server (padrão 1433)	1433
Instância	Nome da instância SQL (se houver)	MSSQLSERVER
Banco	Nome do banco de dados Senior	vetorh
Usuário	Login do SQL Server (autenticação SQL)	sa
Senha	Senha do usuário SQL	••••••••
NumEmp	Código(s) da empresa no Senior. Separe com `;` se houver mais de uma	1 ou 1;2
TipCol	Tipos de colaborador: 1=CLT, 2=Autônomo, 3=Diretor	1;2;3

Após preencher, clique em Salvar configuração e depois em Testar conexão.

⚠

Se o teste retornar erro de conexão, verifique se o firewall do servidor permite conexão TCP na porta 1433 a partir do endereço IP do computador onde o agente está instalado.

7

Verificar Conexão e Executar a Primeira Sincronização

Verificação final

Com o banco configurado e o agente online, acesse o menu 🔄 Entidades e execute as sincronizações na ordem recomendada:

Colaboradores — importa todos os funcionários ativos e demitidos do Senior
Férias — Saldo — importa os períodos aquisitivos e saldos de férias
Férias — Programação — importa as programações de férias agendadas

Clique em ▶ Executar em cada linha. O status mudará para Executando... e, em poucos segundos, para Sincronizado.

✓

Após a conclusão da sincronização inicial, os dados estarão disponíveis na plataforma xRH. O Dashboard exibirá o total de colaboradores e a data do último sync.

ℹ

Qualquer dúvida durante a instalação ou se o agente não aparecer como Online, acesse a aba Status e Downloads ou entre em contato com o suporte Ali Tecnologia.

Empresas

Empresas sincronizadas pelo agente xRH — NumEmp e TipCol configurados em Banco de Dados. Cada empresa tem sua própria chave (🔑) — reúna todas em C:\ProgramData\xRHAgent\keys\ para o mesmo agente atender várias empresas, inclusive de tenants diferentes na mesma base.

Empresa	Cód. Senior (NumEmp)	Tipos (TipCol)	Status SQL	Último Sync	Chave do Agente
Carregando...

Entidades

Objetos de dados sincronizados entre o Senior e a plataforma xRH

Entidade	Descrição	Modo	Último sync	Registros	Status	Ação
Carregando...

Histórico de Sincronizações

Execuções recentes por entidade e empresa

Data/Hora	Empresa	Entidade	Registros	Status	Duração
Carregando...

Logs

Registro de atividades e erros da sincronização

—Carregando...

Central de Integração

Toda a integração do escritório, em um só lugar.