Dimep (controle de acesso)

Se a sua operação usa catracas e cartões Dimep ITK, o NEXUS Flow fala direto com ela. Os nós ficam no grupo Dimep ITK da paleta do editor, e o gatilho de novas marcações fica no grupo Gatilhos.

Com eles você monta automações como: puxar as marcações da catraca e gravá-las no seu sistema, criar a pessoa e vincular o cartão assim que alguém é cadastrado em outro sistema, ou dar baixa nos cartões provisórios vencidos toda madrugada.

Antes de começar

Cadastre uma credencial do tipo Dimep ITK (controle de acesso) com:

Campo Para quê
URL base do ITK Endereço do seu Dimep
Usuário / Senha Conta de integração
Cultura Idioma das respostas. Padrão Português (BR)
Token NAK Opcional, fornecido pela Dimep, usado só na entrada

O que vale para todos os nós Dimep

  • Escolha a Credencial Dimep no topo do nó.
  • Operação define o que o nó faz; os campos abaixo dela mudam conforme a operação escolhida — só aparece o que aquela operação precisa.
  • Todo campo de texto aceita {{ … }} com dados do item que chegou, então o mesmo nó atende um lote inteiro (uma matrícula por item, por exemplo).
  • Quando a Dimep devolve uma lista, o nó emite um item por registro; quando devolve um registro só, sai um item. Lista vazia segue com o item de entrada intacto.
  • Na aba Config ficam Timeout (segundos) (padrão 60) e Saída do nó (Mesclar item, o padrão, ou Substituir item) — veja Ajustes do nó.
  • Operações de criação e atualização pedem um campo Dados (JSON), no formato que a Dimep espera. O próprio campo mostra um exemplo como sugestão.

Todos os nós têm uma saída (main). Se quiser desviar as falhas em vez de parar o fluxo, use Em caso de erro na aba Config.

Dimep — Novas marcações (gatilho)

Dispara sozinho no intervalo que você definir e traz só as marcações novas desde o disparo anterior. É o ponto de partida de qualquer automação que reage a uma passagem na catraca — os campos e o que acontece quando uma execução falha estão em Gatilhos.

Ele não traz histórico no primeiro disparo: para carregar o passado, use o nó Dimep — Marcações com um intervalo de datas.

Dimep — Marcações

Consulta marcações de acesso já registradas, ou registra um acesso manual.

Operação O que informar
Por catraca (Pointer) ID da catraca e, se quiser, o Tipo de log
Por pessoa + data Matrícula da pessoa, Ano, Mês e Dia
Por data Ano, Mês e Dia
Por intervalo de datas Ano/Mês/Dia de e até, e o Tipo de log
Por código alternativo Código alternativo
Registrar acesso manual Corpo do acesso manual (JSON)

O Tipo de log filtra entre Acesso, Cadastro ou Ambos; em branco traz todos.

Sai uma marcação por item.

Dimep — Pessoas

Lê e mantém o cadastro de pessoas.

Operação O que informar
Listar todas (completo) / (dados básicos) Nada além da credencial
Por matrícula Matrícula
Por faixa de matrícula Matrícula de e até
Por ID ID da pessoa
Por celular Celular completo
Autorizadores da pessoa Matrícula
Protocolo por matrícula Matrícula
Upsert (criar ou atualizar) Dados (JSON), com a matrícula dentro
Criar / Atualizar Dados (JSON)
Excluir ID da pessoa
Definir autorizadores Matrícula e Dados (JSON)
Atualizar protocolo Dados (JSON)

Sai uma pessoa por item, com os campos que a Dimep devolve.

Prefira Upsert quando o fluxo puder rodar de novo sobre a mesma pessoa: ele procura pela matrícula, cria se não existir, atualiza se existir, e devolve o registro já com o ID definitivo — que é o que os outros nós pedem para vincular cartão, autorização e visita. Criar direto não devolve esse ID.

Excluir apaga a pessoa na Dimep e não tem volta. Prefira ajustar a situação da pessoa quando a intenção for só tirar o acesso.

Dimep — Credenciais

Cartões e códigos de acesso.

Operação O que informar
Consultar por número Número da credencial
Buscar por código alternativo Código alternativo
Upsert (criar ou atualizar) Dados da credencial (JSON) e, se quiser, o Número
Criar Dados da credencial (JSON)
Atualizar Número e Dados da credencial (JSON)
Excluir Número da credencial

Sai o cartão por item. No Upsert, o número pode vir do campo Número ou do próprio JSON, e o nó relê o cartão depois de gravar.

Excluir remove o cartão do cadastro e não tem volta.

Dimep — Pessoa/Credencial

Liga um cartão a uma pessoa e dá baixa nos vínculos.

Operação O que informar
Credenciais da pessoa ID da pessoa
Provisórias expiradas Nada além da credencial
Garantir associação Matrícula, Número da credencial e, opcionalmente, Data inicial, Data final, uso em REP/ponto e uso facial
Associar credencial à pessoa Associação (JSON)
Baixar provisória expirada Número da credencial
Baixar permanente ID da pessoa e Número da credencial

Use Garantir associação em fluxos que repetem: ele resolve o ID da pessoa pela matrícula, confere se o cartão já está vinculado e só cria o vínculo se faltar. Sai um item com a pessoa, o cartão e o resultado — criada ou existente. O número do cartão é comparado ignorando zeros à esquerda, então 00245638032 e 245638032 são o mesmo cartão.

Associar credencial à pessoa grava direto, sem essa conferência: rodar duas vezes sobre o mesmo par costuma acusar duplicidade.

As operações de baixa encerram o vínculo — a pessoa deixa de passar com aquele cartão. Para devolver o acesso é preciso associar de novo.

Dimep — Visitantes

Cadastro de quem visita.

Operação O que informar
Listar todos Nada além da credencial
Por ID ID do visitante
Por documento Tipo de documento e Número do documento
Por celular Celular completo
Tipos de documento Nada além da credencial
Protocolo por documento Número do documento
Foto por ID ID do visitante
Criar Dados do visitante (JSON)
Atualizar ID do visitante e Dados do visitante (JSON)
Excluir ID do visitante

Use Tipos de documento para descobrir qual número informar no campo Tipo de documento das demais operações.

Excluir apaga o visitante e não tem volta.

Dimep — Visitas

A visita em si: quem está dentro agora, registrar a chegada e encerrar.

Operação O que informar
Ativas (todas) Nada além da credencial
Ativa por credencial Número da credencial
Ativas por contato (pessoa) ID do contato
Com visitante por data Ano, Mês, Dia e Documento (0 traz todos)
Credenciais disponíveis Nada além da credencial
Registrar visita Tipo de documento, Número do documento e Dados da visita (JSON)
Baixar (encerrar) por credencial Número da credencial

Credenciais disponíveis é o caminho para escolher um cartão livre antes de registrar a chegada. Baixar encerra a visita e libera o cartão para o próximo visitante.

Dimep — Veículos

Operação O que informar
Listar todos Nada além da credencial
Por placa Placa
Listar informações Nada além da credencial
Informação por veículo ID do veículo
Criar / Atualizar Dados (JSON)
Excluir ID do veículo
Criar informação / Atualizar informação Dados (JSON)

Sai um veículo (ou uma informação de veículo) por item. Excluir apaga o veículo e não tem volta.

Dimep — Autorização excepcional

Libera um acesso fora da regra normal — a visita do sábado, o acesso pontual a uma área restrita.

Operação O que informar
Listar Nada além da credencial
Consultar por ID ID da autorização
Listar tipos de autorização Nada além da credencial
Criar / Atualizar Dados da autorização (JSON); atualizar pede também o ID
Excluir ID da autorização

Excluir remove a liberação na hora — quem dependia dela deixa de passar.

Dimep — Cadastros

Consulta só de leitura, feita para descobrir os códigos que os outros nós pedem (qual é o perfil de acesso, qual o equipamento, qual a estrutura).

Recurso O que informar
Perfis de acesso Tipo de perfil (opcional) e Apenas públicos
Tipos de credencial
Equipamentos
Grupos de equipamento
Estrutura organizacional
Estrutura org. (1ª da empresa)
Biometria por pessoa ID da pessoa
Biometria por módulo Módulo biométrico
Biometria — todas (pessoas)
Biometria — visitantes
Configuração do sistema (App)
Configuração do sistema (Pessoas)

Sai um registro por item. Nenhuma dessas operações altera nada.

Dimep — Configurações

CRUD das entidades que sustentam as regras de acesso. Escolha a Entidade (Situações de pessoa, Turnos, Faixas de horário, Jornadas ou Estrutura organizacional) e depois a Operação: Listar, Por ID, Criar, Atualizar ou Excluir. Criar e atualizar pedem Dados (JSON); Por ID e Excluir pedem o ID.

Excluir apaga a configuração e não tem volta — e o que dependia dela (as pessoas naquela situação, as jornadas naquele turno) passa a se comportar diferente na hora. Confira antes.

Dimep — REP (ponto)

Registros do relógio de ponto e a fila de marcações que ainda não foram sincronizadas.

Operação O que informar
REP por catraca (Pointer) ID da catraca
REP por data Ano, Mês e Dia
Marcações pendentes Nada além da credencial
Excluir marcação pendente ID da marcação

Excluir marcação pendente descarta a marcação da fila e não tem volta — ela não chega ao destino.


Veja também: Credenciais, Gatilhos e O editor.