Ambientes: homologação e produção

1. Ambientes

O tenant, os caminhos e o formato da key são os mesmos nos dois ambientes. Mudam o endereço, a key (cada ambiente tem a sua, seção 5) e, no gateway, a cadeia do certificado (seção 2).

Para onde a sua integração aponta

O masterData atende por duas rotas que chegam ao mesmo serviço, cada uma com o seu caminho. Homologue pela rota que a sua integração usa em produção, trocando só o endereço e a key.

Outros endereços de cada ambiente

Especificação OpenAPI

Cada arquivo traz os dois servidores, produção (https://integrations.fhinck.com) e homologação (https://integrations-hml.fhinck.com): ao importar no seu cliente HTTP, escolha o servidor do ambiente.

• Cadastro (masterData)
• Registro de ponto (recordPunch)
• Pedido de extensão de jornada (requestExtension)

2. Certificados

Cadeia medida em 2026-10-30. O certificado de integrations é gerenciado pelo Google, que pode renovar por outra autoridade (documentação do Google): confie em todas as autoridades listadas, não só na da cadeia do dia.

3. Rede

A Fhinck não tem IP de saída fixo: não libere acesso por IP. Quando a Fhinck chama o seu sistema (o webhook cadastrado para a sua empresa), ela se autentica pelo OAuth2 do seu ambiente: pede o token com o client ID e o client secret que a sua empresa criou para a Fhinck. O client secret de homologação fica no cofre de segredos do ambiente de homologação da Fhinck, e o cadastro da sua empresa guarda só a referência a ele.

Não confunda o client secret com a key de integração da seção 5: a key é o que a sua integração usa para chamar a Fhinck; o client secret é o que a Fhinck usa para chamar o seu sistema. Para cadastrar ou trocar o client secret, fale com o Suporte Fhinck.

4. Diferenças declaradas da homologação

• Notificações não saem do ambiente: em homologação nada é enviado por e-mail, WhatsApp ou Teams; cada notificação fica registrada só do lado da Fhinck.
• Os recursos de IA ficam desligados nesta primeira fase da homologação.
• Só dado sintético: é proibido enviar dado real de colaborador ao ambiente de homologação.
• Os dados ficam no máximo 35 dias; as tabelas de cadastro são recriadas com a massa de teste a cada 35 dias.
• O reCAPTCHA do painel de homologação usa nota fixa e não mostra desafio.
• Teto de 100 identidades por tenant: um cadastro que passe do teto é recusado inteiro.
• Credencial de produção usada em homologação é recusada com mensagem explícita ("credencial de produção usada em homologação"). Credencial de homologação usada em produção é recusada como key inválida, a mesma resposta de qualquer key que não vale em produção.
• O gateway do software em homologação usa certificado gerenciado do balanceador do Google, com as autoridades GTS Root R1, GlobalSign Root CA e ISRG Root X1; o certificado do gateway de produção é outro (seção 2).
• O validador de dados aceita 10 requisições a cada 60 s por IP em cada instância, contadas na memória da instância. O limite efetivo por IP multiplica pelo número de instâncias de pé: em homologação até 2 instâncias (de 10 a 20 requisições a cada 60 s por IP); em produção até 10 instâncias. O número exato não é garantido nos dois ambientes.
• Em homologação, a primeira chamada depois de um período sem uso é lenta, porque o serviço sobe do zero: pode levar até cerca de 50 s (medido em 30/10/2026: 45,8 s na primeira chamada a /approveRequest e 12,6 s na primeira chamada a /masterData; nas demais, a mediana ficou abaixo de 0,1 s). Configure o tempo limite do seu cliente HTTP para pelo menos 60 s e repita a chamada se o tempo esgotar.

5. Credencial

A key de integração de homologação é entregue só por bilhete de uso único, válido por 72 horas: a primeira abertura devolve a key; a segunda abertura, ou qualquer abertura depois de 72 horas, devolve 410. A key nunca é enviada por e-mail nem por WhatsApp em texto.

Como abrir o bilhete

Abra o bilhete com um POST em https://integrations-hml.fhinck.com/integrationCredentialTicket. O corpo leva só o campo ticket; troque <bilhete> pelo bilhete que o Suporte Fhinck enviou:

curl -X POST https://integrations-hml.fhinck.com/integrationCredentialTicket \
  -H "Content-Type: application/json" \
  -d '{"ticket":"<bilhete>"}'

Guarde a key no cofre do seu sistema assim que abrir o bilhete: a segunda abertura devolve 410, e aí só um bilhete novo, pedido ao Suporte Fhinck, entrega a key de novo. A resposta vem com Cache-Control: no-store: nenhum cache ou proxy deve guardá-la.

6. Perfil SAP

Caminho usado hoje pela integração SAP NetWeaver em produção: https://fhinckgateway.fhinck.com/integrations/masterData; o mesmo caminho em homologação: https://gateway-hml.fhinck.com/integrations/masterData. Formato da key, medido em 2026-10-29T06:34:56Z: campo KEY no topo do corpo JSON (Content-Type application/json; charset=utf-8), ao lado do bloco DATA; valor em base64; o tamanho varia de empresa para empresa (não valide a key pelo tamanho).

7. Checklist do integrador

Para homologar

1. Peça ao Suporte Fhinck o bilhete da key de homologação e abra-o como na seção 5. A key de produção não funciona neste ambiente.
2. Importe TODAS as raízes da seção 2 (as medidas, as alternativas e as futuras) no STRUST do sistema de qualidade E no de produção antes do 1º teste: importar só a raiz do dia quebra a integração na próxima troca de emissor.
3. Aponte a integração para o endereço de homologação da rota que ela usa em produção (seção 1), com a key recebida pelo bilhete. Na integração SAP NetWeaver: https://gateway-hml.fhinck.com/integrations/masterData.
4. Envie só dado sintético e confira a resposta de cada chamada pela tabela abaixo. Depois de um masterData, o Validador mostra o cadastro que ficou gravado.

Resposta que aprova cada chamada documentada, lida do código da API; é a mesma regra da Referência de Erros:

Para ir à produção

1. Confirme que todas as raízes da seção 2 estão no STRUST de produção.
2. Volte ao endereço de produção da mesma rota (na integração SAP NetWeaver, https://fhinckgateway.fhinck.com/integrations/masterData) e troque a key de homologação pela key de produção, a que a sua empresa recebeu no onboarding (Autenticação); para pedir ou renovar a de produção, fale com o Suporte Fhinck.

8. Status

Situação do componente "Ambiente de homologação (integrações)" em status.fhinck.com.

9. Teste de contrato

• Produção: aprovado em 2026-10-29 (15 caminhos documentados, 0 ausentes).
• Homologação: aprovado em 2026-10-30 (15 caminhos documentados, 0 ausentes).

10. Login corporativo (SSO) na homologação

A homologação aceita o login corporativo com o mesmo provedor de identidade da produção. Como os endereços da homologação são outros, o administrador do provedor de identidade da sua empresa precisa autorizá-los antes do primeiro login.

Microsoft Entra ID. No registro do aplicativo que a sua empresa usa com a Fhinck, na plataforma "Aplicativo de página única (SPA)", acrescente os URIs de redirecionamento:

• https://new-dashboard-hml.fhinck.com/callback
• https://new-dashboard-hml.fhinck.com/login/<identificador da sua empresa>

Se preferir um registro separado para a homologação, envie ao Suporte Fhinck o ID do aplicativo (cliente) e o ID do diretório (locatário).

Na homologação, o login corporativo é feito pelo painel novo, em https://new-dashboard-hml.fhinck.com/login/<identificador da sua empresa>.

Aplica-se a: login pelo Microsoft Entra ID com OpenID Connect, no painel novo.

Cada pessoa que vai testar precisa estar cadastrada pela Fhinck com o mesmo e-mail que o Entra ID devolve no login.