---
title: "Webhook del buzón de correo (Brevo Inbound Parse)"
method: POST
path: "/buzon/brevo/webhook"
tags: ["compras"]
---

# Webhook del buzón de correo (Brevo Inbound Parse)

`POST /buzon/brevo/webhook`

## Request

- Base URL: `https://contadeo.com/api`
- URL: `https://contadeo.com/api/buzon/brevo/webhook`
- Auth: HTTP bearer

Entrada PÚBLICA del buzón de recepción por correo: Brevo entrega aquí cada correo reenviado a la dirección `<token>@buzon.contadeo.com` de una cuenta. Autenticación por el parámetro `secreto` (configurado en Brevo; 401 si falta o no coincide, y sin `BUZON_WEBHOOK_SECRETO` en el despliegue el buzón está deshabilitado). Con secreto válido responde SIEMPRE 200: cada XML adjunto se ingesta al módulo Compras con `origen: email` resolviendo el emisor por el RUC RECEPTOR del comprobante; los PDF sin XML se guardan para revisión; los fallos por-correo quedan en la bandeja (`GET /buzon/mensajes`), no en el status. Dedupe por Message-ID y por clave de acceso.

## Query parameters

- `secreto` string, required

## Request body

- object: Payload de Brevo Inbound Parse ({items: [...]}); los adjuntos llegan como DownloadToken y se descargan de Brevo

## Response `200`

Correos aceptados

- object
  - `recibidos` integer
  - `aceptados` integer

## Other responses

- `401`: Secreto ausente, inválido o buzón deshabilitado

---

[API](https://skmtc.dev/contadeo/apis/api-de-contadeo.md) · [All operations](https://skmtc.dev/contadeo/apis/api-de-contadeo/llms.txt) · [OpenAPI document](https://skmtc.dev/contadeo/apis/api-de-contadeo/revisions/461bbb9a74ce?raw)