# Tabelas SQL

## Visão Geral

As **Tabelas SQL** são o conjunto de registros no banco de dados que fazem o Sistema de Controle de Acesso funcionar.

Elas guardam todas as informações usadas pelos coletores (catracas, portas, relógios de ponto, leitores biométricos, leitores de cartão, rastreadores, etc.).

Nem todas as tabelas são usadas em todos os clientes, isso depende do modelo dos coletores e das soluções contratadas (básica, biometria, smartcard, veículos, estacionamento, escolta, palmvein, etc.).

**As tabelas são o “cérebro” do controle de acesso**, onde o sistema consulta regras e grava tudo o que acontece.

## Regras de Negócio

Para o funcionamento mínimo do Sistema de Controle de Acesso Online Básico, **são obrigatórias** as seguintes tabelas principais:

* **CONTROLE** – Cadastro das matrículas e suas permissões básicas.
* **FXHORARIA** – Definição de horários de acesso e ponto.
* **DAT07** – Cadastro dos coletores (equipamentos de acesso).
* **DAT08** – Relação entre coletores e locais/grupos de acesso.
* **DAM00** – Registro padrão de eventos de acesso.
* **SITCOLETOR** – Status online/offline dos equipamentos.
* **FERIADO** – Calendário de feriados nacionais e locais.

As demais tabelas só se tornam obrigatórias **se a empresa utilizar** módulos específicos (biometria, smartcard, veículo, estacionamento, escolta, benefício, palmvein, REP-P, rastreador RFID, Petrobrás, etc.).

## Como configurar as Tabelas

As tabelas do banco de dados são organizadas por **Solução** para facilitar a compreensão e a operação do sistema.\
Toda instalação possui um **conjunto básico obrigatório** e, conforme os módulos contratados, outras tabelas passam a ser utilizadas.

#### Sistema Online Básico

Este é o núcleo do Controle de Acesso. Sem essas tabelas o sistema não funciona.

| Tabela                     | Descrição                                                      |
| -------------------------- | -------------------------------------------------------------- |
| CONTROLE                   | Cadastro das matrículas e regras de acesso, ponto e refeitório |
| FXHORARIA                  | Faixas de horários de acesso, ponto e almoço                   |
| DAM00 / DAM01 / DAM02      | Histórico oficial de marcações (online, offline e backup)      |
| DAT07                      | Cadastro dos equipamentos                                      |
| DAT08                      | Associação de equipamentos a locais e grupos                   |
| DAT09                      | Lista alternativa de acesso                                    |
| CP\_NB / CP\_BN            | Comunicação entre sistema e equipamentos                       |
| FERIADO                    | Calendário de feriados                                         |
| TABDEV                     | Controle de débitos de refeitório/benefício                    |
| SITENTRADA                 | Alarmes dos coletores                                          |
| CONTFUNC                   | Restrições por função                                          |
| CREDLOG                    | Log de atualização de créditos                                 |
| TABLOCKS                   | Bloqueios técnicos de usuários                                 |
| SITCOLETOR                 | Status online/offline dos equipamentos                         |
| MATCODIN                   | Permissão por equipamento                                      |
| CONTPLANTA                 | Validade de acesso por planta                                  |
| DATAHORA / ICARDNSAUX      | Validações auxiliares                                          |
| MATNREFEIT / AUXMATNREFEIT | Controle de refeitório                                         |

#### Sistema Online - Solução Benefício

Usada quando há controle de listas de benefício por local ou equipamento.

| Tabela              | Descrição                          |
| ------------------- | ---------------------------------- |
| TERMBENEF           | Equipamentos x listas de benefício |
| LBENEF00 a LBENEF23 | Matrículas beneficiadas            |

#### Sistema Online - Solução Biometria

Gerencia digitais e palmas nos leitores biométricos.

| Tabela                  | Descrição                   |
| ----------------------- | --------------------------- |
| CONTDIG                 | Templates biométricos       |
| DIG001 a DIG104         | Carga e exclusão automática |
| DIGLOAD001 / DIGLOAD002 | Falhas de carga biométrica  |
| HISTDIG                 | Histórico biométrico        |
| ACEAUTOBIO              | Agenda automática           |

#### Sistema Online - Solução Petrobrás

Regras especiais de bloqueio por tipo de matrícula ou código SAD.

| Tabela   | Descrição            |
| -------- | -------------------- |
| INFOMAT  | Dados complementares |
| BLOQSAD  | Bloqueios por SAD    |
| BLOQTIPO | Bloqueios por tipo   |
| EXCESAD  | Exceções por SAD     |
| EXCETIPO | Exceções por tipo    |

#### Sistema Online - Solução Veículo

| Tabela  | Descrição                       |
| ------- | ------------------------------- |
| CONTVEI | Matrícula x veículo             |
| VEICULO | Cadastro de cartões de veículos |

#### Sistema Online - Solução MatCodin

| Tabela     | Descrição              |
| ---------- | ---------------------- |
| MATCODIN   | Acesso por equipamento |
| CONTPLANTA | Validade por planta    |

#### Sistema Online - Solução SmartCard

Gerencia atualizações e pendências de cartões inteligentes.

| Tabela                    | Descrição              |
| ------------------------- | ---------------------- |
| ATUALI                    | Atualizações de cartão |
| PEND\_ON001 a PEND\_ON008 | Pendências de cartão   |
| PEND\_GRUPO               | Pendências de grupo    |
| PENDSMART                 | Pendências gerais      |

#### Sistema Online - Solução RFID Rastreador

| Tabela | Descrição                 |
| ------ | ------------------------- |
| DAM03  | Marcações de rastreamento |

#### Sistema Online - Solução Usuários

| Tabela  | Descrição         |
| ------- | ----------------- |
| PWDTELE | Usuários e senhas |

#### Sistema Online - Solução Bloqueio Smartcard ID por Número Serial

| Tabela | Descrição          |
| ------ | ------------------ |
| DAT05  | Cartões bloqueados |

#### Sistema Online - Validação por Matricula / CPF / Numero Serial

| Tabela               | Descrição       |
| -------------------- | --------------- |
| CONTCPF              | Matrícula x CPF |
| BDCC\_CRACHA / DAM99 | Controle BDCC   |

#### Reconhecimento de Placas (seguro)

| Tabela | Descrição         |
| ------ | ----------------- |
| DAT10  | Leitura de placas |
| DAT11  | Matrícula x placa |

#### Bloqueio por mensagem

| Tabela   | Descrição              |
| -------- | ---------------------- |
| MATBMENS | Bloqueios por mensagem |

#### Ponto – ConexREP (REP/REP-P)

| Tabela      | Descrição         |
| ----------- | ----------------- |
| REPPONTO    | Integração REP    |
| ULTREPPONTO | Última marcação   |
| OFFREPPONTO | Marcações offline |

#### Solução PALMVEIN (PALMA DA MÃO)

| Tabela   | Descrição         |
| -------- | ----------------- |
| PALMV001 | Cadastro de palma |
| PALMV004 | Carga de palma    |
| PALMV014 | Exclusão de palma |
| PALMV005 | Pendências        |
| PALMV015 | Histórico         |

#### 99 Grupos Auxiliares de Acesso

| Tabela           | Descrição          |
| ---------------- | ------------------ |
| MATGRUPO         | Grupos auxiliares  |
| COUNT\_BY\_GRUPO | Contador por grupo |
| MATNGRUPOS       | Múltiplos grupos   |

#### Estacionamento Fixo/Rotativo

| Tabela   | Descrição    |
| -------- | ------------ |
| ESTAC001 | Equipamentos |
| ESTAC002 | Vagas        |
| ESTAC003 | Vagas fixas  |

#### Solução Escolta

| Tabela    | Descrição            |
| --------- | -------------------- |
| ESCOLT001 | Usuários com escolta |
| ESCOLT002 | Áreas com escolta    |

#### REP-P Dedicado

| Tabela    | Descrição          |
| --------- | ------------------ |
| DAT07REPP | Equipamentos REP-P |
| DAM00REPP | Marcações REP-P    |

#### Solução BDCC

| Tabela       | Descrição        |
| ------------ | ---------------- |
| CONT512\_AUX | Entradas mensais |

#### NR36 – Câmara Fria

| Tabela      | Descrição               |
| ----------- | ----------------------- |
| DATNR36FRIG | Controle de câmara fria |

## Estrutura das tabelas

*(Esta lista pode aparecer como seção própria no manual ou como apêndice técnico com links para cada estrutura detalhada.)*

* Estrutura da tabela de matrículas – **CONTROLE**
* Estrutura da tabela de faixas Horárias – **FXHORARIA**
* Estrutura das tabelas de Marcações – **DAM00, DAM01, DAM02, DAM03**
* Estrutura dos Números Seriais bloqueados – **DAT05**
* Estrutura dos Terminais – **DAT07**
* Estrutura dos Grupos de Acesso – **DAT08**
* Estrutura da **DAT09**
* Estrutura de Comandos – **CP\_NB**
* Estrutura de Avisos – **CP\_BN**
* Estrutura de Feriados – **FERIADO**
* Estrutura de Devedores – **TABDEV**
* Estrutura de Alarmes – **SITENTRADA**
* Estrutura Matrícula x Função – **CONTFUNC**
* Estrutura **CREDLOG**
* Estrutura **SITCOLETOR**
* Estrutura **MATCODIN**
* Estrutura **CONTPLANTA**
* Estrutura **DATAHORA / ICARDNSAUX**
* Estrutura **MATNREFEIT / AUXMATNREFEIT**
* Estruturas de Benefício – **TERMBENEF / LBENEF00–23**
* Estruturas Biométricas – **CONTDIG (todas variações), DIG001–DIG104, HISTDIG**
* Estruturas Petrobrás – **INFOMAT, BLOQSAD, BLOQTIPO, EXCESAD, EXCETIPO**
* Estruturas Veículo – **CONTVEI, VEICULO**
* Estruturas Smartcard – **ATUALI, PEND\_ON001–008, PEND\_GRUPO, PENDSMART**
* Estrutura RFID – **DAM03**
* Estrutura Usuários – **PWDTELE**
* Estruturas CPF/BDCC – **CONTCPF, BDCC\_CRACHA, DAM99**
* Estruturas Securos – **DAT10, DAT11, DAT12**
* Estrutura Bloqueio por Mensagem – **MATBMENS**
* Estruturas REP – **REPPONTO, ULTREPPONTO, OFFREPPONTO**
* Estruturas PalmVein – **PALMV001, PALMV004, PALMV014, PALMV005, PALMV015**
* Estruturas 99 Grupos – **MATGRUPO, COUNT\_BY\_GRUPO, MATNGRUPOS**
* Estruturas Estacionamento – **ESTAC001, ESTAC002, ESTAC003**
* Estruturas Escolta – **ESCOLT001, ESCOLT002**
* Estruturas REP-P – **DAT07REPP, DAM00REPP**
* Estrutura BDCC auxiliar – **CONT512\_AUX**
* Estrutura NR36 – **DATNR36FRIG**
* Estrutura Versão do Sistema – **VERSOES**

## Guia Rápido de Uso

1. Cadastrar **pessoas** na tabela **CONTROLE**.
2. Definir **horários** na tabela **FXHORARIA**.
3. Cadastrar **equipamentos** em **DAT07**.
4. Vincular equipamentos a locais/grupos em **DAT08**.
5. Definir feriados em **FERIADO**.
6. Monitorar status dos equipamentos em **SITCOLETOR**.
7. Acompanhar acessos na tabela **DAM00**.
8. Ativar módulos adicionais (biometria, smartcard, veículo, estacionamento, etc.) **somente se necessários**.

## Glossário

* **REP / REP-P:** sistema oficial de registro eletrônico de ponto.
* **SAD:** código interno usado na solução Petrobrás.
* **BDCC:** padrão específico de cartão corporativo.
* **RFID:** tecnologia de rastreamento por etiqueta eletrônica.
* **PalmVein:** biometria por leitura das veias da palma da mão.
* **EGM:** estação de gerenciamento e monitoramento do sistema.

## FAQ – Perguntas Frequentes

<details>

<summary>Preciso usar todas essas tabelas?</summary>

Não. Você usa apenas as que correspondem às soluções contratadas (básica, biometria, smartcard, veículo, etc.).

</details>

<details>

<summary>O que acontece se a tabela CONTROLE estiver errada?</summary>

O usuário pode ser bloqueado indevidamente ou ter acesso liberado sem permissão.

</details>

<details>

<summary>Como vejo quem entrou em um local?</summary>

Consulte a tabela **DAM00**.

</details>

<details>

<summary>Onde cadastro feriados?</summary>

Na tabela **FERIADO**.

</details>

<details>

<summary>Por que meu equipamento aparece offline?</summary>

Verifique a tabela **SITCOLETOR** e a comunicação de rede com o IP cadastrado em **DAT07**.

</details>

<details>

<summary>Como liberar biometria?</summary>

Ela é controlada pelas tabelas **CONTDIG** e pelas tabelas DIG001 a DIG104.

</details>

<details>

<summary>Como bloquear um cartão pelo número serial?</summary>

Use a tabela **DAT05**.

</details>

<details>

<summary>Como controlar estacionamento?</summary>

Utilize **ESTAC001, ESTAC002 e ESTAC003**.

</details>

<details>

<summary>Onde ficam os alarmes?</summary>

Na tabela **SITENTRADA**.

</details>

<details>

<summary>Como saber a versão do sistema?</summary>

Consulte a tabela **VERSOES**.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://software-telematica-com.gitbook.io/suricato-docs/conex/conex/conex-comandos-respostas-e-tabelas/tabelas-sql.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
