Eventos

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

Este é o catálogo completo no momento. Novos eventos serão adicionados e anunciados no Changelog. 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:

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

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.

Módulo: Compras · Versão do envelope: 1

Campos de `dados`

number

required

Número do pedido de compra.

integer

required

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

integer | null

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

object

required

Fornecedor do pedido.

Show propriedades

integer | null

Código do fornecedor no Gestio.

string | null

Nome do fornecedor.

number

required

Valor total do pedido.

string (date-time)

required

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

string

required

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

string

required

Usuário que processou o pedido.

integer

required

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

Exemplo de envelope

{
  "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
  }
}

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.

Webhooks

Referência das rotas

Catálogo

compras.pedido-de-compra.processado

Campos de `dados`

Exemplo de envelope

Catálogo

compras.pedido-de-compra.processado

Campos de dados

Exemplo de envelope

Campos de `dados`