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.