Integrações

Sem rip-and-replace. O HumanR conecta-se ao que já executa.

Terminais em cada local, livros de cálculo que a HR mantém há anos, um sistema de contabilidade que a finanças não vai mudar, e um grupo de bate-papo onde o trabalho realmente é perseguido. Esta página lista cada uma dessas conexões por direção — o que entra, e o que sai.

Comes in

Biometric punchesZKTeco terminals
Excel & CSVRegisters and salary sheets
REST APIYour own systems, inbound
HHumanROne employee record. One audit trail.

Goes out

Accounting journalsQuickBooks, SUN, SAP, Sage…
Bank filesPer currency, transfer-ready
Slack & TeamsSigned event cards
Files & mailCSV, Excel, your own SMTP

Dados dentro

O que a sua operação já produz

Duas coisas existem antes do HumanR: os punções saindo dos seus terminais, e os livros de cálculo que a sua equipa de HR tem mantido durante anos. Ambos entram como estão — e uma vez que está a funcionar, um endpoint autenticado por token deixa os seus próprios sistemas ler e alimentá-lo diretamente.

ZKTeco
Device push
Excel logo
Import
CSV
Import
REST API
Inbound API

Terminais biométricos ZKTeco

Os dispositivos a falar o protocolo de push iClock/ADMS conectam-se diretamente ao HumanR e transmitem punções de impressão digital, face e cartão conforme acontecem — cada terminal em cada local, sem middleware, um agente de consulta ou alguém a caminhar uma pen USB para o escritório. Cada dispositivo é registado por número de série antes de ser aceito.

Como funciona →

Os seus registos de Excel e CSV existentes

Trazemos estes para si durante a configuração inicial: o nosso importador lê os registos de funcionários, folhas de salários e rastreadores de documentos que já mantém, corresponde-os contra o que está no sistema, e produz um relatório de validação nomeando exatamente o que foi importado, correspondido e sinalizado. O livro de cálculo consegue ficar vivo em paralelo enquanto a equipa muda.

Como funciona →

Os seus próprios sistemas, sobre a API de REST

Uma superfície versionada /api/v1 que o seu código chama com um token de portador: leia funcionários, dias de frequência, pedidos de licença, ciclos de revisão e objetivos, e as listas de referência — e poste punções de frequência de um sistema de tempo que fala apenas HTTP. Os tokens são mostrados uma vez, armazenados com hash, e nunca conseguem carregar uma permissão que o administrador que os emitiu não já tinha.

Como funciona →

Folha de pagamento fora

No sistema de contabilidade que a finanças já executa

Cada corrida finalizada torna-se um diário equilibrado contra o seu próprio plano de contas. Duas formas de chegar lá: lançada diretamente sobre a API do sistema de contabilidade, ou escrita como um ficheiro no seu próprio formato de importação. O mesmo mapeamento atrás de ambos.

QuickBooks Online logo
Direct API
SAP logo
Journal file
Sage 300 logo
Journal file
Excel logo
Journal file
SunSystems
Journal file
iScala
Journal file
Dynamics NAV
Journal file
CSV
Journal file

QuickBooks Online — lançado diretamente

Conecte uma empresa QuickBooks uma vez e os diários entram sobre a sua API sem ficheiro no meio. Você mapeia para o seu plano de contas ao vivo em vez de digitar códigos da memória, e uma exportação retentada encontra o diário que já tinha lançado em vez de lançar um segundo.

Como funciona →

SUN, SAP, iScala, Dynamics NAV e Sage 300 — como um ficheiro de diário

Cada um recebe um ficheiro de importação no seu próprio formato, mais CSV e Excel genérico para qualquer coisa não nessa lista. Uma corrida é validada contra o mapeamento primeiro: componentes não mapeados e diários desequilibrados impedem a exportação e são nomeados, porque um ficheiro que importa errado é pior do que nenhum ficheiro.

Como funciona →

Os seus bancos

A lista líquida de pagável exporta agrupada por banco e por moeda — a forma em que as transferências são realmente apresentadas — com salários retidos listados separadamente para que o total corresponda ao que sai da conta.

Como funciona →

Executando algo que não está nesta lista? A maioria dos sistemas ainda pegará num diário — os formatos CSV e Excel genéricos são deliberadamente simples, e o próprio formato de um sistema é um exercício de mapeamento em vez de uma reconstrução. Diga-nos qual é e vamos dizer honestamente se é uma semana de trabalho ou um trimestre's. Contacte-nos.

Eventos fora

No momento em que algo acontece, não na próxima vez que alguém se recline

Os webhooks empurram os próprios eventos do HumanR para onde quer que a sua equipa já vê. Slack e Teams não precisam de código — cole uma URL de webhook de entrada e selecione os eventos. Qualquer coisa que receba um POST JSON assinado, que é o que torna Zapier, Make, n8n ou o seu próprio serviço um recetor sem nós construir qualquer coisa específica para isso.

Slack
Chat app
Microsoft Teams
Chat app
Any HTTPS endpoint
Signed HTTP

Slack e Microsoft Teams

Os eventos chegam como cartões legíveis no canal onde o trabalho realmente é perseguido. A configuração é uma cola e um conjunto de caixas de verificação: a URL de webhook de entrada é a única credencial, e não há nada para instalar de um diretório de aplicações — ambas as plataformas aceitam um webhook de entrada simples, que é exatamente o que HumanR envia.

Como funciona →

Webhooks assinados nos seus próprios sistemas

Um envelope JSON canónico assinado com HMAC-SHA256, para que o seu recetor possa provar que o evento veio do HumanR. Cada evento carrega uma identificação estável que sobrevive às retentativas, portanto os duplicados são seguros de soltar, e as entregas falhadas recuam — um minuto, cinco, trinta, depois horas — em vez de o martelar.

Como funciona →

Os eventos que consegue subscrever

As corridas de folha de pagamento finalizando e reabrindo, cada decisão de aprovação em todos os dez tipos de pedido, e documentos, autorizações de trabalho, contratos e períodos de teste aproximando-se de expiração. Subscreva um evento, uma família como aprovação.*, ou tudo — e escopo um endpoint a uma única empresa se executar vários.

Como funciona →

Tudo mais fora

Ficheiros, correio e os dados que possui

A metade não glamourosa de integração: colocar dados para fora numa forma que outra coisa consegue ler, e conseguir correio entregue através de infraestrutura que controla.

Excel logo
Export file
CSV
Export file
SMTP
Your SMTP

CSV e Excel de cada lista

Cada lista no sistema — filtrada, ordenada, exatamente como aparece no ecrã — exporta para um ficheiro. As colunas sensíveis são largadas para qualquer um sem permissão para vê-las, e a exportação em si é registada no registo de auditoria.

Como funciona →

O seu próprio servidor de correio

As notificações, digestões de validade e correio de portal saem através do seu hospedeiro SMTP, do seu domínio, para que os funcionários vejam correio do seu empregador e não de um fornecedor. Deixe-o não configurado e o correio é registado em vez de enviado — útil para um piloto que não deve enviar mensagens a ninguém ainda.

Relatórios como fonte de dados

Os resumos de folha de pagamento, registos de exportação, agregações de frequência e relatórios de contagem de pessoal são todos consultáveis e exportáveis, portanto os números que entram num pacote de conselho ou numa consolidação de grupo saem do sistema em vez de sair da retecla de alguém.

Como funciona →

Três coisas diferentes que as pessoas chamam de “uma integração”

Estas são usadas intercavelmente em sites de fornecedor e não são o mesmo mecanismo. Qual é que quer depende do que tem de acontecer, e quando.

MecanismoQuando se disparaComo funcionaQuem a pede
Exportação GLUma vez por mês, quando uma corrida de folha de pagamento é finalizadaAlguém finaliza a corrida e exporta. Os diários entram QuickBooks sobre a sua API, ou transferem como um ficheiro para SUN, SAP, iScala, NAV ou Sage.Finanças
WebhooksNo instante em que um evento acontece, com ninguém a verO HumanR POSTs um evento JSON assinado para uma URL que configura, e retenta se está em baixo. Slack e Teams recebem cartões formatados em vez.Ops, TI, quem quer que possua o canal
Exportações e importaçõesSempre que um humano precisa dos dados noutro lugarQualquer lista para CSV ou Excel; registos existentes e folhas de salários trazidas para si durante a configuração.Todos

Questões de integração

Incluindo as que têm um "não ainda" por resposta — preferiríamos que leia aqui do que descobrir numa chamada.

O HumanR se integra com QuickBooks?

Sim, diretamente sobre a sua API. Conecte uma empresa QuickBooks Online uma vez, mapeie os seus componentes de pagamento para contas escolhidas do seu plano de contas ao vivo, e as corridas de folha de pagamento finalizadas entram como diários equilibrados sem ficheiro no meio. Uma exportação retentada encontra o diário que já tinha entrado em vez de duplicar.

Quais dispositivos biométricos funcionam com ele?

Terminais ZKTeco falando o protocolo de push iClock/ADMS — impressão digital, face e cartão. O dispositivo empurra punções para o HumanR conforme acontecem em vez de ser consultado, para que um local com uma ligação fraca alcance por conta própria uma vez que a ligação volta. Os dispositivos são registados por número de série antes de aceitar os seus dados.

Os eventos de folha de pagamento e HR conseguem entrar no nosso canal Slack ou Teams?

Sim, e demora cerca de um minuto. Cole a URL de webhook de entrada do canal, selecione os eventos que quer — folha de pagamento finalizada, aprovações decididas, autorizações e documentos expirando — e os cartões começam a chegar. Sem programador, e nada para instalar de um diretório de aplicações.

Qual é a diferença entre a exportação GL e webhooks?

Tempo e audiência. A exportação GL é um empurrão mensal acionado por humano de totais de folha de pagamento no seu sistema de contabilidade. Os webhooks são automáticos e imediatos: no instante em que uma corrida é finalizada ou uma autorização está a 30 dias de expiração, um evento aterra no canal ou sistema em que o apontou. As finanças querem o primeiro; operações e TI querem o segundo.

O HumanR tem uma API pública?

Sim — uma API de REST versionada que o seu código chama com um token de portador. Lê funcionários, dias de frequência, pedidos de licença, ciclos de desempenho, revisões e objetivos, e as listas de referência (empresas, departamentos, designações, locais de trabalho), e aceita punções de frequência como uma escrita. Os tokens são exibidos uma vez na emissão e armazenados apenas como um hash, portanto ninguém — nós incluídos — consegue ler um de volta para fora da base de dados, e um token nunca consegue carregar uma permissão que o administrador que o emitiu não já tinha a si próprio. Cada emissão e revogação é auditada pelo prefixo do token, nunca o seu hash. Dois qualificadores honestos: a API é um comutador por inquilino em vez de algo que cada instalação carrega, por isso está ativada para a sua instância em vez de encontrada pela digitalização, e ainda não é uma superfície de escrita completa — os punções entram, mas os registos de funcionários e licença são apenas de leitura hoje.

Outro sistema consegue empurrar dados para HumanR?

Sim, duas formas. Os terminais biométricos empurram punções sobre o protocolo iClock/ADMS que já falam, e qualquer sistema que consegue fazer um pedido de HTTP consegue postar punções para a API de REST com um token de portador. O que ainda não existe é um webhook de entrada — não há endpoint que registar com um terceiro para que possa notificar-nos dos seus próprios eventos. Os dados em massa ainda são uma importação em vez de um feed ao vivo, portanto uma sincronização noturna de outro sistema de HR ou finanças é uma importação de livro de cálculo programada hoje.

Apoiam single sign-on?

Não ainda. As contas usam palavras-passe armazenadas com hash, com uma lista ao vivo de cada sessão que consegue desligar remotamente, e os resets do portal de funcionários são feitos pela HR em pessoa em vez de por uma ligação de correio enviado. SSO e two-factor são ambos itens de roteiro, e esta resposta muda o dia qualquer um dos dois envia em vez de o dia em que decidimos implicar.

Conseguimos sair com os nossos dados se sairmos?

Sim. Cada lista no sistema exporta para CSV ou Excel, os relatórios são exportáveis, e as instalações auto-alojadas guardam a sua própria base de dados. Não há taxas de exportação e sem formatos desenhados para serem difíceis de ler noutro lugar.

Precisa de algo que não está aqui?

Diga-nos o sistema e o que tem de se mover entre ele e HumanR, e vamos dizer honestamente se já funciona, se é um exercício de mapeamento, ou se é uma construção real. Entre em contacto — or see the página de segurança for how any of this is protected in transit.

Veja os conectores funcionando em dados reais

Request a demo and we'll email you a personal login to a fully loaded demo company — explore real screens with realistic data within minutes.

Sem cartão de crédito. Sem necessidade de chamada de vendas. Um login real, enviado por correio eletrónico.