ComposioHQ/Workday-Automation

Automação Workday

Automatize suas operações de RH no Workday diretamente do Claude Code. Pesquise funcionários, crie solicitações de folga, verifique saldos de ausência e valide elegibilidade para folgas — tudo sem sair do terminal.

Documentação do toolkit: composio.dev/toolkits/workday

---

Configuração

1. Adicione o servidor MCP Rube à configuração do seu Claude Code com a URL: https://rube.app/mcp
2. Quando solicitado, autentique sua conta Workday através do link de conexão fornecido
3. Comece a automatizar seus fluxos de RH com linguagem natural

---

Fluxos de Trabalho Principais

1. Pesquisar e Listar Funcionários

Recupere informações de funcionários com pesquisa e paginação.

Ferramenta: WORKDAY_LIST_WORKERS

Pesquise por funcionários chamados "Sarah" e inclua funcionários desligados

Parâmetros principais:

• search — pesquisa por nome ou ID do funcionário (sem distinção de maiúsculas/minúsculas, delimitado por espaço para pesquisa OU)
• includeTerminatedWorkers — incluir funcionários desligados nos resultados
• limit (padrão 20, máximo 100) / offset — controles de paginação

2. Criar Solicitações de Folga

Envie solicitações de folga para funcionários com suporte completo ao processo de negócios.

Ferramenta: WORKDAY_CREATE_TIME_OFF_REQUEST

Crie uma solicitação de férias para o funcionário abc123 para os dias 15 a 17 de março de 2026 (8 horas cada dia)

Parâmetros principais:

• ID (obrigatório) — ID do funcionário no Workday
• businessProcessParameters (obrigatório) — deve incluir action com campo id (use "d9e4223e446c11de98360015c5e6daf6" para ação de submissão)
• days (obrigatório) — array de entradas de folga, cada uma com:
  • date (obrigatório) — data no formato yyyy-mm-dd
  • timeOffType (obrigatório) — objeto com id do tipo de ausência elegível
  • dailyQuantity — quantidade de horas ou dias
  • comment, start, end, position, reason — campos opcionais
• businessProcessParameters.comment — comentário opcional do processo de negócios

3. Verificar Elegibilidade para Folgas

Valide em quais datas um funcionário pode tirar folga antes de enviar uma solicitação.

Ferramenta: WORKDAY_GET_WORKER_VALID_TIME_OFF_DATES

Verifique se o funcionário abc123 é elegível para tirar folga em 15 de março de 2026

Parâmetros principais:

• ID (obrigatório) — ID do funcionário no Workday
• date — data específica para validar (yyyy-mm-dd)
• position — filtrar por ID de posição específica
• timeOff — filtrar por ID do plano/tipo de folga específico
• limit (máximo 100) / offset — paginação

4. Visualizar Saldos de Ausência

Verifique os saldos de folga restantes dos funcionários em todos os planos.

Ferramenta: WORKDAY_LIST_ABSENCE_BALANCES

Mostre os saldos de ausência de todos os funcionários da organização

• Recupera saldos para planos de folga e tipos de licença
• Pode ser filtrado por ID do funcionário, categoria e data efetiva

5. Obter Perfil do Usuário Atual

Recupere as informações do perfil do funcionário autenticado.

Ferramenta: WORKDAY_GET_CURRENT_USER

Mostre minhas informações do perfil do Workday

• Nenhum parâmetro necessário
• Retorna o perfil do funcionário autenticado
• Use esta ferramenta primeiro para obter o ID do funcionário para operações subsequentes

6. Visualizar Histórico de Folgas

Recupere detalhes e histórico de folgas de um funcionário específico.

Ferramenta: WORKDAY_GET_WORKER_TIME_OFF_DETAILS

Mostre o histórico de folgas do funcionário abc123

• Recupera uma coleção de detalhes de folgas para o funcionário especificado
• Útil para auditar o uso de folgas e saldos restantes

---

Armadilhas Conhecidas

• Resolução de ID do funcionário: Sempre chame WORKDAY_GET_CURRENT_USER ou WORKDAY_LIST_WORKERS primeiro para resolver os IDs dos funcionários do Workday. Os IDs são UUIDs específicos do Workday, não números de matrícula.
• IDs de tipo de folga devem ser válidos: O campo timeOffType.id em WORKDAY_CREATE_TIME_OFF_REQUEST deve referenciar um tipo de ausência elegível válido para aquele funcionário. Use o fluxo "Obter Tipos de Ausência Elegíveis do Funcionário" para descobrir IDs de tipos válidos.
• ID da ação de submissão: O campo businessProcessParameters.action.id deve ser "d9e4223e446c11de98360015c5e6daf6" para a ação de submissão. Usar um ID incorreto fará com que o processo de negócios falhe.
• Formato de data: Todos os campos de data usam o formato yyyy-mm-dd. ISO 8601 com timestamps não é aceito para campos somente de data.
• Limites de paginação: O limite máximo é 100 em todos os endpoints do Workday. O padrão é 20. Sempre pagine para conjuntos de dados completos.
• Aprovação do processo de negócios: Criar uma solicitação de folga inicia o processo de negócios, mas não garante aprovação. A solicitação entra no fluxo de aprovação normal.

---

Referência Rápida

Slug da Ferramenta	Descrição
WORKDAY_LIST_WORKERS	Pesquisar e listar funcionários com informações de equipe
WORKDAY_GET_CURRENT_USER	Obter o perfil do funcionário autenticado
WORKDAY_CREATE_TIME_OFF_REQUEST	Enviar uma solicitação de folga (requer ID, businessProcessParameters, days)
WORKDAY_GET_WORKER_VALID_TIME_OFF_DATES	Verificar elegibilidade de datas de folga (requer ID)
WORKDAY_LIST_ABSENCE_BALANCES	Recuperar saldos de ausência em planos de folga
WORKDAY_GET_WORKER_TIME_OFF_DETAILS	Obter histórico de folgas de um funcionário

---

Desenvolvido por Composio