> 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/buscar-eventos-por-periodo.md).

# Buscar Eventos por Período

O comando buscar eventos por período (BEP) é utilizado para realizar a busca de eventos de usuários e dispositivos ocorridos no sistema em um determinado período (entre uma data final e inicial). O valor para identificar o comando BEP é 0x39.

\
Esse comando é utilizado sempre que o dispositivo desejar coletar os eventos ocorridos no sistema entre duas datas distintas, como por exemplo os eventos ocorridos entre os dias 27/06/2012 15:14:26 e 30/01/2016 13:00:00.

\
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 que se deseja realizar sendo a única disponível busca dos dados (BUSCAR\_RECURSO).

A flag de busca (flag BUSCAR\_ RECURSO) necessita que, ao serem enviadas para o MIP 1000 IP, o campo “tamanho do campo de dados” seja 0x0D 00 com o seguinte valor no campo de dados:

| Tipo Evento | Data Inicial | Data Final |
| :---------: | :----------: | :--------: |
|   4 bytes   |    6 bytes   |   6 bytes  |

Descrição dos campos do comando:

| Campo        | Descrição                                                                                                                                                                            |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Tipo Evento  | Campo que possui valor zero para usuário e 1 para dispositivo.                                                                                                                       |
| Data Inicial | Campo que possui a Data inicial para busca de eventos. Os dados desse campo possuem o seguinte formato: exemplo para a data: 27/06/2012 15:14:26 => **MSB 0x1B 06 0C 0F 0E 1A LSB**. |
| Data Final   | Campo que possui o Data Final para busca de eventos. Os dados desse campo possuem o seguinte formato: exemplo para a data: 27/06/2012 15:14:26 => **MSB 0x1B 06 0C 0F 0E 1A LSB**.   |

Este comando com a flag de **BUSCAR\_RECURSO** tem como resposta o datagrama padrão enviado pelo MIP 1000 IP e com o campo de dados **zerado** se houver algum problema sinalizado pelas *flags* abaixo, exceto SUCESSO.

| Flag         | Descrição                                                    |
| ------------ | ------------------------------------------------------------ |
| FALHA        | Sinaliza falha na execução da operação solicitada.           |
| ERRO\_CHKS   | Enviado se ocorreu um erro de CHKS na conferência dos dados. |
| COMANDO\_INV | Sinaliza o recebimento de um comando inválido, desconhecido. |

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:

| ID do evento com a data inicial | ID do evento com a data final |
| :-----------------------------: | :---------------------------: |
|             4 Bytes             |            4 Bytes            |

Descrição dos campos de retorno do comando:

| Campo                           | Descrição                                                                   |
| ------------------------------- | --------------------------------------------------------------------------- |
| ID do evento com a data inicial | Campo que contém o ID do primeiro evento que foi gerado com a data inicial. |
| ID do evento com a data final   | Campo que contém o ID do último evento que foi gerado com a data final.     |


---

# 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/buscar-eventos-por-periodo.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.