A integração via API conecta a Zorya ao sistema da Domínio. Na prática, as rubricas calculadas na folha de ponto são enviadas direto para a Domínio, sem digitação manual e com menos risco de erro na folha de pagamento.
Para funcionar, a integração depende de três configurações: o cadastro do empregador, o cadastro dos colaboradores e o token de acesso. Siga as etapas abaixo na ordem.
Configurando o empregador
O primeiro passo é informar, no cadastro do empregador, os IDs que identificam a empresa e as rubricas dentro da Domínio.
Caminho: Pessoas e Organização > Empregadores
- Na tela de empregadores, clique em Editar no empregador que será integrado
- Acesse a aba Parâmetros do ponto
- Clique em Integrações
- Na seção da Domínio, preencha o ID da empresa e os IDs das rubricas, usando os mesmos códigos cadastrados na Domínio
- Salve as alterações
Importante: os IDs precisam ser exatamente iguais aos da Domínio. Um código diferente faz com que a rubrica não seja reconhecida no envio.
Rúbricas de dias: o cadastro também tem duas rúbricas opcionais. A Rúbrica de dias de faltas (com datas) envia a quantidade de dias de falta e a data de cada uma. A Rúbrica de dias trabalhados no horário noturno envia a quantidade de dias com trabalho no horário noturno, e as horas continuam na rúbrica de horas noturnas. Cada código aceita até 9 dígitos, só números, sem repetir.
Intrajornada indenizada: a Rúbrica de horas de intrajornada indenizada envia o tempo que faltou para completar o intervalo previsto na jornada. Por exemplo, intervalo previsto de 1h30 e realizado de 1h envia 00:30. A Rúbrica de dias com intrajornada indenizada envia em quantos dias o intervalo ficou menor que o previsto. Com mais de um intervalo no dia, todos são somados. O tempo vai sem adicional: o adicional e as demais regras de pagamento ficam na rúbrica que você configura na Domínio.
Faltas em horas: abaixo da Rúbrica de faltas fica o botão Enviar faltas em horas. Desligado (padrão), envia 1 unidade por dia de falta. Ligado, envia as horas da jornada prevista em cada dia de falta. Por exemplo, falta em dia de jornada de 8h48 envia 8h48.
Complementando o cadastro dos colaboradores
Cada colaborador também precisa de duas informações para que os dados cheguem ao cadastro certo na Domínio:
- Código da categoria
- ID do colaborador na Domínio
Caminho: Pessoas e Organização > Colaboradores
- Clique em Editar no cadastro do colaborador
- Na tela que abrir, navegue até a seção Jornada e trabalho e selecione o Código da categoria
- Clique na aba Configurações do ponto
- Clique em Integrações
- Na seção da Domínio, preencha o ID do colaborador
- Salve as alterações
Repita esse processo para todos os colaboradores do empregador que terão as rubricas enviadas para a Domínio.
Cadastrando o token de acesso
Com os cadastros completos, falta o token de acesso. É ele que permite que a Zorya se comunique com o sistema da Domínio. Cada empregador tem o seu próprio token, gerado na Domínio para aquela empresa.
Caminho: Controle de ponto > Integrações > Domínio > aba Integração via API > Configurações
- Na lista de empregadores, clique em Configurar no empregador que será integrado. A coluna Token de acesso mostra quais empregadores já estão configurados
- Em Autenticação, preencha o campo Token de acesso com o token gerado na Domínio para esse empregador
- Clique em Salvar
Depois de salvo, a tela mostra Token configurado, com as opções Substituir e Remover. Se você integra mais de um empregador, repita o processo para cada um: cada empregador tem seu próprio token e seu próprio envio automático.
Já usava a integração antes? Se a sua conta já tinha um token cadastrado, a Zorya mostra o aviso Associe o token atual a um empregador. Selecione o empregador ao qual o token pertence e clique em Associar. O token e os eventos do envio automático passam a valer para esse empregador.
Ainda não tem o token? A geração do token e outras configurações necessárias são feitas no sistema da Domínio. Veja o passo a passo na documentação oficial da Domínio clicando aqui.
Habilitando o envio automático
Com tudo configurado, você pode definir que as rubricas sejam enviadas para a Domínio sempre que a folha de ponto for fechada.
Caminho: Controle de ponto > Integrações > Domínio > aba Integração via API > Configurações
- Clique em Configurar no empregador
- Em Fechamento de ponto, ative Enviar rúbricas automaticamente no fechamento de ponto
- Em Eventos a exportar, marque as rúbricas que devem ser enviadas. A lista inclui Dias trabalhados no horário noturno, Dias de faltas (com datas), Horas de intrajornada indenizada e Dias com intrajornada indenizada
- Clique em Salvar
Você decide quais rubricas entram no envio. As que ficarem desmarcadas não são enviadas para a Domínio. Eventos novos, como os de intrajornada indenizada, não entram sozinhos: marque-os se quiser enviá-los.
Fazendo envios manuais
Precisa enviar fora do fechamento da folha ou reenviar alguma informação? Use a aba Sincronização manual, na mesma tela da integração.
Caminho: Controle de ponto > Integrações > Domínio > aba Sincronização manual
Clique em Iniciar sincronização, escolha o empregador e os colaboradores e clique em Próximo. Na etapa Período e eventos, informe o período e marque os eventos, incluindo Dias trabalhados no horário noturno, Dias de faltas (com datas), Horas de intrajornada indenizada e Dias com intrajornada indenizada. Clique em Confirmar para enviar.
Acompanhando o status dos envios
Na aba Histórico, você acompanha o status de cada envio, automático ou manual, e confirma se as rubricas chegaram à Domínio. Nos detalhes de cada envio, as rubricas de horas mostram o Valor e a de dias com intrajornada indenizada mostra os Dias.
Caminho: Controle de ponto > Integrações > Domínio > aba Histórico
Ficou com dúvidas? Fale com o nosso time pelo chat do sistema.