Extensão de Jornada

Solicite extensões de jornada de trabalho. O sistema notifica automaticamente o gestor por e-mail para aprovação.

Fluxo completo de aprovação

A extensão de jornada é um fluxo de três etapas encadeadas. Cada endpoint cobre uma etapa:

Solicitação

POST /requestExtension — O sistema externo registra o pedido e o gestor recebe e-mail com link de aprovação.

Listagem

POST /listExtensionRequests — O gestor (ou sistema delegado) lista as solicitações pendentes de aprovação.

Aprovação

POST /approveRequest — O gestor aprova ou rejeita. Aprovado = extensão é integrada à jornada do colaborador.

Endpoints

POST https://integrations.fhinck.com/requestExtension

Cria uma solicitação de extensão de jornada e notifica o gestor por e-mail.

GET https://integrations.fhinck.com/requestExtension

Health check — retorna RequestExtension service is running.

Request body

Campo	Tipo	Obrigatório	Descrição
`key`	string	Sim	Chave criptografada da empresa.
`user`	string	Sim	Login do colaborador no sistema Fhinck.
`reqMinutes`	integer	Sim	Minutos extras solicitados.
`justification`	string	Sim	Justificativa da solicitação.
`extraTime`	string	Não	Data/hora da solicitação. Formato `YYYY-MM-DD HH:mm:ss`. Default: data/hora atual.
`manager`	string	Não	Email do gestor específico. Se omitido, usa o gestor configurado para o colaborador.

Exemplos por linguagem

cURL

curl -X POST https://integrations.fhinck.com/requestExtension \
  -H "Content-Type: application/json" \
  -d '{
    "key": "SUA_CHAVE_DE_INTEGRACAO",
    "user": "joao.silva",
    "extraTime": "2026-04-24 18:30:00",
    "reqMinutes": 60,
    "justification": "Projeto urgente com deadline apertado",
    "manager": "maria.gestora@empresa.com"
  }'

JavaScript (fetch)

const response = await fetch('https://integrations.fhinck.com/requestExtension', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    key: process.env.FHINCK_KEY,
    user: 'joao.silva',
    extraTime: '2026-04-24 18:30:00',
    reqMinutes: 60,
    justification: 'Projeto urgente com deadline apertado',
    manager: 'maria.gestora@empresa.com',
  }),
});

const data = await response.json();
if (data.err) throw new Error(data.message);
console.log('Solicitação criada:', data.requestTime, 'segundos');

Python (requests)

import os
import requests

url = 'https://integrations.fhinck.com/requestExtension'
payload = {
    'key': os.environ['FHINCK_KEY'],
    'user': 'joao.silva',
    'extraTime': '2026-04-24 18:30:00',
    'reqMinutes': 60,
    'justification': 'Projeto urgente com deadline apertado',
    'manager': 'maria.gestora@empresa.com',
}

response = requests.post(url, json=payload, timeout=30)
data = response.json()
if data.get('err'):
    raise RuntimeError(data.get('message'))
print(f"Solicitação criada: {data['requestTime']} segundos")

C# (HttpClient)

using System.Net.Http;
using System.Text;
using System.Text.Json;

var client = new HttpClient();
var payload = new {
    key = Environment.GetEnvironmentVariable("FHINCK_KEY"),
    user = "joao.silva",
    extraTime = "2026-04-24 18:30:00",
    reqMinutes = 60,
    justification = "Projeto urgente com deadline apertado",
    manager = "maria.gestora@empresa.com"
};

var content = new StringContent(
    JsonSerializer.Serialize(payload),
    Encoding.UTF8,
    "application/json"
);

var response = await client.PostAsync(
    "https://integrations.fhinck.com/requestExtension",
    content
);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

Response

Sucesso 200

{
  "err": false,
  "message": "Solicitação de extensão criada com sucesso",
  "requestTime": 3600,
  "approvalLinkKey": "abc123xyz789"
}

Campo	Tipo	Descrição
`err`	boolean	`false` indica sucesso.
`message`	string	Mensagem de confirmação.
`requestTime`	integer	Tempo total solicitado em segundos (acumulado no dia).
`approvalLinkKey`	string\|null	Chave do link enviado ao gestor. `null` em homologação.

Acumulação de tempo

Se o colaborador já tiver solicitações pendentes no mesmo dia, o tempo é acumulado em requestTime (em segundos). O campo sempre retorna o total acumulado do dia, não apenas a solicitação atual.

Exemplo:

1ª solicitação: 60 min → requestTime: 3600
2ª solicitação no mesmo dia: 30 min → requestTime: 5400

Seleção automática de gestor

Se você não enviar o campo manager, o sistema aplica uma cascata de fallback para decidir quem recebe a notificação.

Ordem de resolução:

Gestor específico do colaborador (campo Manager no perfil).
Lista overtimeManagers configurada para a empresa.
Gestor padrão configurado no perfil do colaborador.

Se desejar sobrescrever a cascata para uma solicitação específica, envie o campo manager com o e-mail do aprovador.

Empresas de homologação

Empresas com "HOMOLOG" no nome (ex.: ACME_HOMOLOG) não disparam e-mails de aprovação e o campo approvalLinkKey retorna null. Ideal para testes de integração sem impacto em gestores reais.

Erros

Status	Código	Causa
400	`MISSING_KEY`	Campo `key` ausente.
400	`INVALID_KEY`	Chave não corresponde a nenhuma empresa.
400	`MISSING_REQUIRED_FIELDS`	Campos obrigatórios ausentes.
400	—	Formato de `extraTime` ou `reqMinutes` inválido.
500	`PROCESSING_ERROR`	Erro ao processar a solicitação.