> For the complete documentation index, see [llms.txt](https://portal-integracao.intelbras.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://portal-integracao.intelbras.com.br/mip-1000-ip/eventos/manutenir-eventos.md).

# Manutenir Eventos

O comando manutenir evento de usuário (**ME**) é utilizado para realizar as operações de Read (leitura) nos dados de evento de todo o sistema SCA. O valor para identificar o comando **ME** é **0x05**. Esse comando é utilizado sempre que algum dispositivo deseja buscar os dados de eventos de usuário do MIP.

\
As manutenções referentes ao cadastro dos eventos podem ser realizadas através de qualquer dispositivo com acesso ao MIP 1000 IP. Esse comando é complementado através de flags de apoio que sinalizam a opção desejada, ou seja, através do campo “flag” é sinalizado a operação de busca dos dados (**BUSCAR\_RECURSO**) que se deseja realizar com o evento de usuário.

\
A flag de busca (flag **BUSCAR\_ RECURSO**) necessitam que, ao serem enviadas para o MIP 1000 IP, o campo “dados” deste comando contenha somente o ID (4 bytes) do evento que deseja fazer a operação e consequentemente o campo “tamanho do campo de dados” será de 0x04 00.

\
Este comando tem como resposta o datagrama padrão enviado pelo MIP 1000 IP e com o campo de dados zerado se o ID não for encontrado ou houver algum problema sinalizado pela flags abaixo, exceto SUCESSO.

|                Campo               | Descrição                                                                                                                        |
| :--------------------------------: | -------------------------------------------------------------------------------------------------------------------------------- |
|         <sub>Sucesso</sub>         | <sub>Enviado caso a operação tenha sido realizada com sucesso.</sub>                                                             |
|          <sub>Falha</sub>          | <sub>Sinaliza falha na execução da operação solicitada.</sub>                                                                    |
|        <sub>ERRO\_CHKS</sub>       | <sub>Enviado se ocorreu um erro de CHKS na conferência dos dados.</sub>                                                          |
| <sub>IDENTIFICADOR\_RECUSADO</sub> | <sub>Sinaliza que o id (identificador) enviado é inválido, pois já existe um recurso cadastrado no sistema com o mesmo id.</sub> |
|       <sub>COMANDO\_INV</sub>      | <sub>Sinaliza o recebimento de um comando inválido, desconhecido.</sub>                                                          |

Caso o comando tenha sido executado com sucesso o datagrama retornará com a flag SUCESSO e com o campo de dados com os seguintes dados com seu tamanho dado em bytes:

<table><thead><tr><th width="90.6666259765625" align="center">ID</th><th width="97.5" align="center">ID Usuário</th><th width="124.50006103515625" align="center">ID Dispositivo</th><th width="104" align="center">ID Recurso</th><th width="101.8333740234375" align="center">Tipo do recurso</th><th width="95" align="center">Status</th><th width="99.833251953125" align="center">Data</th></tr></thead><tbody><tr><td align="center"><code>4 Bytes</code></td><td align="center"><code>4 Bytes</code></td><td align="center"><code>4 Bytes</code></td><td align="center"><code>4 Bytes</code></td><td align="center"><code>1 Byte</code></td><td align="center"><code>1 Byte</code></td><td align="center"><code>6 Bytes</code></td></tr></tbody></table>

<table><thead><tr><th width="136.5" align="center">ID do acionamento</th><th width="97.5" align="center">Tipo do evento</th><th width="124.50006103515625" align="center">Categoria</th><th width="104" align="center">Nome</th><th width="97.666748046875" align="center">Apto</th><th width="88.3333740234375" align="center">Bloco</th><th width="92.333251953125" align="center">CPF</th></tr></thead><tbody><tr><td align="center"><code>1 Byte</code></td><td align="center"><code>1 Byte</code></td><td align="center"><code>1 Byte</code></td><td align="center"><code>34 Bytes</code></td><td align="center"><code>5 Bytes</code></td><td align="center"><code>5 Bytes</code></td><td align="center"><code>6 Bytes</code></td></tr></tbody></table>

<table><thead><tr><th width="92.333251953125" align="center">RG</th><th width="99.16668701171875" align="center">Modelo</th><th width="124.50006103515625" align="center">Marca</th><th width="104" align="center">Placa</th><th width="101.8333740234375" align="center">Cor</th><th width="140.8333740234375" align="center">RG complemento</th></tr></thead><tbody><tr><td align="center"><code>4 Bytes</code></td><td align="center"><code>18 Bytes</code></td><td align="center"><code>18 Bytes</code></td><td align="center"><code>7 Bytes</code></td><td align="center"><code>18 Bytes</code></td><td align="center"><code>4 Bytes</code></td></tr><tr><td align="center"></td><td align="center"></td><td align="center"></td><td align="center"></td><td align="center"></td><td align="center"></td></tr></tbody></table>

<table><thead><tr><th width="104.833251953125" align="center">Código</th><th width="146.66668701171875" align="center">Timestamp_xtr</th><th width="165.75006103515625" align="center">Bateria baixa</th><th width="197.75" align="center">Leitor escarvo (desenvolvedor</th></tr></thead><tbody><tr><td align="center"><code>4 Bytes</code></td><td align="center"><code>4 Bytes</code></td><td align="center"><code>1 Byte</code></td><td align="center"><code>1 Byte</code></td></tr></tbody></table>

<sub>Descrição dos campos do comando:</sub>

<table><thead><tr><th width="110.5" align="center">Campo</th><th width="617.5">Descrição</th></tr></thead><tbody><tr><td align="center"><sub>ID</sub></td><td><sub>Campo que possui um número único identificador do evento. Sempre maior que zero e seu valor máximo corresponde ao total de eventos cadastrados no MIP 1000 IP. Os dados desse campo possuem o seguinte formato: Exemplo para o ID: 1 <strong>MSB</strong> 0x01 00 00 00 <strong>LSB</strong>.</sub></td></tr><tr><td align="center"><sub>ID usuário</sub></td><td><sub>Campo que possui um número único identificador do usuário, já cadastrado no MIP, que efetuou o evento. Os dados desse campo possuem o seguinte formato: Exemplo para o ID: 1 <strong>MSB</strong> 0x01 00 00 00 <strong>LSB</strong>.</sub></td></tr><tr><td align="center"><sub>ID dispositivo</sub></td><td><sub>Campo que possui um número único identificador do usuário, já cadastrado no MIP, que efetuou o evento. Os dados desse campo possuem o seguinte formato: Exemplo para o ID: 1 <strong>MSB</strong> 0x01 00 00 00 <strong>LSB</strong>.</sub></td></tr><tr><td align="center"><sub>ID recurso</sub></td><td><sub>Campo que possui um número único identificador do recurso que foi utilizado para efetuar o evento. Pode ser o id do XID, do XTR ou zero caso tenha sido realizado através de senha ou botoeira. Os dados desse campo possuem o seguinte formato: Exemplo para o ID: 1 <strong>MSB</strong> 0x01 00 00 00 <strong>LSB</strong>.</sub></td></tr><tr><td align="center"><sub>Tipo do recurso</sub></td><td><p><sub>0 = Senha</sub><br><sub>1 = Chaveiro RFID(XID 1000)</sub><br><sub>2 = Controle RF (XTR 1000)</sub></p><p><sub>3 = Via Apartamento</sub> <br><sub>4 = Via botoeira</sub>
<br><sub>5 = Remotamente</sub> <br><sub>6 = Digital/Template</sub> <br><sub>7 = RECURSO_CHAMADA</sub> <br><sub>8 = RECURSO_ARQUIVO_CONDOMINIO</sub> <br><sub>9 = RECURSO_ARQUIVO_CONFIG</sub> <br><sub>10 = RECURSO_ARQUIVO_DISPOSITIVO</sub> <br><sub>11 = RECURSO_ARQUIVO_RF</sub> <br><sub>12 = RECURSO_ARQUIVO_TAG</sub> <br><sub>13 = RECURSO_ARQUIVO_RELACAO</sub> <br><sub>14 = RECURSO_ARQUIVO_VEICULO</sub> <br><sub>15 = RECURSO_ARQUIVO_STATUSM</sub> <br><sub>16 = RECURSO_ARQUIVO_USUARIO</sub> <br><sub>17 = RECURSO_ARQUIVO_TEMPLATE</sub> <br><sub>18 = RECURSO_ARQUIVO_CFGNETWORK</sub> <br><sub>19 = RECURSO_ARQUIVO_FERIADO</sub> <br><sub>20 = RECURSO_ARQUIVO_USUARIO_VISITANTE</sub> <br><sub>21 = RECURSO_ARQUIVO_RF_VISITANTE</sub> <br><sub>22 = RECURSO_ARQUIVO_TAG_VISITANTE</sub> <br><sub>23 = RECURSO_ARQUIVO_TEMPLATE_VISITANTE</sub> <br><sub>24 = RECURSO_INCLUSAO_TODOS_USUARIOS</sub> <br><sub>25 = RECURSO_EXCLUSAO_TODOS_USUARIOS</sub> <br><sub>26 = RECURSO_CARONA</sub> <br><sub>27= RECURSO_FACE</sub> <br><sub>28 = RECURSO_ARQUIVO_FACIAL</sub> <br><sub>29 = RECURSO_ARQUIVO_FACIAL_VISITANTE</sub> <br><sub>255 = RECURSO_PADRAO: (Sinaliza que o “Tipo do Evento” não tem um recurso especifico, Ex Acionamento tecla rápida “Eventos de dispositivo do protocolo v1”).</sub></p></td></tr><tr><td align="center"><sub>Status</sub></td><td><sub>Este campo é “oculto” no cadastro e deve ser utilizado para sinalizar se o evento está ativo ou inativo. O status inativo é utilizado para realizar uma exclusão lógica, pois o evento não pode ser excluído fisicamente do sistema. Os dados desse campo possuem o seguinte formato: 0x00 para registro ativo, 0x01 para inativo.</sub></td></tr><tr><td align="center"><sub>Data</sub></td><td><sub>Campo que contém a data de cadastro do evento. Essa data é formada pelos campos: dd -> dia, mm -> mês, aa -> ano, hh -> hora, mm -> minuto, ss -> segundo. Os dados desse campo possuem o seguinte formato: exemplo para a data: 27/06/2012 15:14:26 => <strong>MSB</strong> 0x1B 06 0C 0F 0E 1A <strong>LSB</strong>.</sub></td></tr><tr><td align="center"><sub>ID do acionamento</sub></td><td><sub>Indica qual saída foi acionada, sendo 1 = para o acionamento 1, 2 = para o acionamento 2 e 3 = para o acionamento 1 e 2</sub></td></tr><tr><td align="center"><sub>Tipo do evento</sub></td><td><sub>Sinaliza o status/tipo do evento. Esses status estão caracterizados abaixo: EVENTO_ACESSO_LIBERADO = 0 (Sinaliza que o acesso foi liberado.) EVENTO_BLOQ_DISPOSITIVO = 1 (Evento bloqueado sem acesso ao dispositivo) EVENTO_BLOQ_USUARIO = 2 (Evento bloqueado sem acesso do usuário) EVENTO_BLOQ_DATA = 3 (Evento bloqueado devido ao código não cadastrado) EVENTO_ARMAZENADO = 4 (Evento já tratado e armazenado em arquivo)</sub><br><sub>EVENTO_IGNORADO = 5 (Evento ocorrido por controles/apartamentos/chaveiros não cadastrados)</sub> <br><sub>EVENTO_ROUBADO_PERDIDO = 6 (Evento ocorrido por controles/apartamentos/ chaveiros que foram roubados/perdidos)</sub> <br><sub>EVENTO_LIBERADO_DISPOSITIVO = 7 (Evento ocorrido no dispositivo e armazenado no MIP 1000 IP depois que o dispositivo volta a rede)</sub> <br><sub>EVENTO_ACION_SENSOR01 = 8 Sinaliza que o Dispositivo Acionou o Sensor 01. EVENTO_DESACION_SENSOR01 = 9 Sinaliza que o Dispositivo Desativou o Sensor 01. EVENTO_ACION_SENSOR02 = 10 Sinaliza que o Dispositivo Acionou o Sensor 02. EVENTO_DESACION_SENSOR02 = 11 Sinaliza que o Dispositivo Desativou o Sensor 02. EVENTO_ACION_TAMPER = 12 Sinaliza que o Dispositivo Acionou o Tamper. EVENTO_ACION_TIMEOUT = 13 Sinaliza que o Dispositivo está fora da rede. EVENTO_DESACION_TIMEOUT =14 Sinaliza que o Dispositivo voltou a rede. EVENTO_NENHUM_ALERTA = 15 Sinaliza que o Dispositivo não tem nenhuma flag ativa. EVENTO_ALERTA_PORT_ON = 16 Sinaliza que o dispositivo está com o alerta porteiro ativo. EVENTO_ALERTA_PORT_OFF = 17 Sinaliza que o dispositivo desativou o alerta porteiro. EVENTO_ACION_TECLA_RAPIDA_1 = 18 Sinaliza que uma tecla de acionamento foi ativa. EVENTO_ACION_TECLA_RAPIDA_2 = 19 Sinaliza que uma tecla de acionamento foi ativa. EVENTO_ACION_TECLA_RAPIDA_3 = 20 Sinaliza que uma tecla de acionamento foi ativa. EVENTO_ACION_TECLA_RAPIDA_4 = 21 Sinaliza que uma tecla de acionamento foi ativa. EVENTO_ACION_TECLA_RAPIDA_5 = 22 Sinaliza que uma tecla de acionamento foi ativa. EVENTO_ACION_PANICO = 23 (0x17) Sinaliza que o pânico foi ativado. EVENTO_ACION_REMOTO = 24 Sinaliza que a abertura foi feita por um dispositivo remoto. EVENTO_ACION_SENSOR03 = 25 Sinaliza que o Dispositivo Acionou o Sensor 03. EVENTO_DESACION_SENSOR03 = 26 Sinaliza que o Dispositivo Desativou o Sensor 03. EVENTO_ACION_SENSOR04 = 27 Sinaliza que o Dispositivo Acionou o Sensor 04. EVENTO_DESACION_SENSOR04 = 28 Sinaliza que o Dispositivo Desativou o Sensor 04. EVENTO_ACION_SENSOR05 = 29 Sinaliza que o Dispositivo Acionou o Sensor 05. EVENTO_DESACION_SENSOR05 = 30 Sinaliza que o Dispositivo Desativou o Sensor 05. EVENTO_ACION_SENSOR06 = 31 Sinaliza que o Dispositivo Acionou o Sensor 06. EVENTO_DESACION_SENSOR06 = 32 Sinaliza que o Dispositivo Desativou o Sensor 06. EVENTO_ACION_SENSOR07 = 33 Sinaliza que o Dispositivo Acionou o Sensor 07. EVENTO_DESACION_SENSOR07 = 34 Sinaliza que o Dispositivo Desativou o Sensor 07. EVENTO_ACION_SENSOR08 = 35 Sinaliza que o Dispositivo Acionou o Sensor 08. EVENTO_DESACION_SENSOR08 = 36 Sinaliza que o Dispositivo Desativou o Sensor 08. EVENTO_DESACION_PANICO = 37 Sinaliza que o pânico foi desativado.</sub> <br><sub>EVENTO_RESERVADO= 38 reservado em implementação.</sub> <br><sub>EVENTO_ATUALIZACAO_ARQUIVO = 39 sinaliza que houve um evento que atualizou algum arquivo.</sub> <br><sub>EVENTO_CHAMADA = 40 sinaliza que houve um evento de chamada pelo XPE. EVENTO_ARRROMBAMENTO = 41 (0x29) sinaliza que houve um evento de arrombamento. EVENTO_DESACION_TAMPER = 42 Sinaliza que o operador desativou o Tamper. EVENTO_DESACION_ARROMBAMENTO = 43(0x2b) Sinaliza que o operador desativou o Arrombamento.</sub><br><sub>EVENTO_CONSULTA_RAPIDA = 44.</sub> <br><sub>EVENTO_DESCONEXAO_FORCADA = 45 (Quando entra no menu do MIP).</sub></td></tr><tr><td align="center"><sub>Categoria</sub><br><sub>Nome</sub><br><sub>Apto</sub><br><sub>Bloco</sub><br><sub>CPF</sub><br><sub>RG</sub><br><sub>Modelo</sub><br><sub>Marca</sub><br><sub>Placa</sub><br><sub>Cor</sub><br><sub>Completo do RG</sub></td><td><sub>Campos com os dados do usuário que gerou o evento para eventos de acesso de usuário “Acesso liberado”, caso evento não seja de acesso liberado não terá essas informações e os campos estarão zerados exceto o campo de nome que terá “Usuário Desconhecido”.</sub></td></tr><tr><td align="center"><sub>Código</sub></td><td><sub>Campo que contém o código que realizou o acesso, pode ser o codigo da tag, controle, senha ou digital.</sub></td></tr><tr><td align="center"><sub>Timestamp XTR</sub></td><td><sub>Código do timestamp do XTR para atualização.</sub></td></tr><tr><td align="center"><sub>Bateria Baixa</sub></td><td><sub>Indica se o controle está ou não com a bateria quando gerou esse evento.</sub>
<br><sub>0 – Bateria OK</sub>
<br><sub>1 – Bateria Baixa;</sub></td></tr><tr><td align="center"><sub>Leitor Escravo</sub></td><td><sub>Indica qual o leitor escravo usado para acesso. Os valores do campo são:</sub>
<br><sub>0 – Acesso realizado no leitor principal do dispositivo</sub>
<br><sub>1 – Leitor 1;</sub>
<br><sub>2 – Leitor 2;</sub>
<br><sub>3 – Leitor 3;</sub>
<br><sub>4 – Leitor 4.</sub></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://portal-integracao.intelbras.com.br/mip-1000-ip/eventos/manutenir-eventos.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.