> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gestio.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Eventos

> Catálogo completo de eventos disponíveis e o conteúdo do campo dados de cada um.

Cada webhook assina um ou mais eventos pelo **código** do evento. O catálogo atualizado pode ser consultado a qualquer momento em `GET /v2/webhooks/eventos` — e, na tela do Gestio, aparece como a lista de caixas de seleção da seção **Eventos**.

## Catálogo

| Código | Módulo | Descrição |
| - | - | - |
| `compras.pedido-de-compra.processado` | Compras | Pedido de compra processado |

> [!NOTE]
>
> Este é o catálogo completo no momento. Novos eventos serão adicionados e anunciados no [Changelog](https://docs.gestio.com.br/changelog.md). Assinar um evento é sempre opcional: seu webhook só recebe os eventos que assinou, e um webhook que não assina nenhum evento não pode ser salvo.

**Exemplo de resposta de `GET /v2/webhooks/eventos`:**

```json theme={null}
{
  "success": true,
  "data": [
    {
      "codigo": "compras.pedido-de-compra.processado",
      "descricao": "Pedido de compra processado",
      "modulo": "Compras"
    }
  ]
}
```

> [!TIP]
>
> Consulte o catálogo pela API em vez de manter a lista de códigos fixa no seu sistema: assim você descobre novos eventos assim que forem publicados.

***

## compras.pedido-de-compra.processado

Enviado quando um **pedido de compra é processado** no Gestio. Se o mesmo pedido for processado novamente, um novo log é criado, com um novo `id` — não há deduplicação por pedido.

> [!NOTE]
>
> **Módulo:** Compras  ·  **Versão do envelope:** `1`

### Campos de `dados`

**numeroDoPedido** `number` *required*

Número do pedido de compra.

**sequencia** `integer` *required*

Sequência do pedido. Junto com o `numeroDoPedido`, identifica o pedido no Gestio.

**codigoDaFilial** `integer | null`

Código da filial do pedido. Pode ser `null`.

**fornecedor** `object` *required*

Fornecedor do pedido.

**propriedades**

**codigo** `integer | null`

Código do fornecedor no Gestio.

**nome** `string | null`

Nome do fornecedor.

**valorTotal** `number` *required*

Valor total do pedido.

**dataDeEmissao** `string (date-time)` *required*

Data de emissão do pedido, em ISO 8601.

**situacao** `string` *required*

Situação do pedido no Gestio (por exemplo, `F` = Finalizado).

**codigoDoUsuario** `string` *required*

Usuário que processou o pedido.

**quantidadeDeItens** `integer` *required*

Quantidade de itens do pedido (produtos + serviços).

### Exemplo de envelope

```json theme={null}
{
  "id": "3f2b8c1e-6a4d-4f0b-9c2e-1d7a5b8e9f10",
  "tipo": "compras.pedido-de-compra.processado",
  "versao": 1,
  "ocorridoEm": "2026-11-06T14:30:00Z",
  "dados": {
    "numeroDoPedido": 1024,
    "sequencia": 1,
    "codigoDaFilial": 1,
    "fornecedor": {
      "codigo": 350,
      "nome": "Fornecedor Exemplo Ltda"
    },
    "valorTotal": 1500.0,
    "dataDeEmissao": "2026-11-06T00:00:00Z",
    "situacao": "F",
    "codigoDoUsuario": "joao.silva",
    "quantidadeDeItens": 2
  }
}
```

> [!TIP]
>
> Os dados enviados são um resumo do pedido. Para obter o pedido completo (itens, serviços, condições de pagamento), consulte `GET /v2/compras/pedido/{numeroPedido}` usando o `numeroDoPedido` recebido.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.