#Buzón Tributario

El Buzón Tributario es el canal oficial del SAT para comunicarse con el contribuyente. Estos endpoints exponen sus notificaciones (con efecto legal) y comunicados (informativos), y permiten descargar el documento asociado.

#El objeto Mensaje del Buzón

Campo	Tipo	Descripción
`id`	string	Identificador del mensaje (`bz_…`).
`kind`	string	`notification` (notificación) o `comunicado`.
`subject`	string	Asunto del mensaje.
`sender`	string	Área o autoridad emisora.
`has_document`	boolean	Si tiene un documento descargable.
`received_at`	string	Fecha de recepción en el buzón (ISO 8601).
`read_at`	string	Fecha de lectura, o `null` si no se ha leído.

#Lista de notificaciones y comunicados

GET/fiscal-entities/{id}/buzon/notifications

Devuelve los mensajes del Buzón Tributario de la FiscalEntity. Incluye tanto notificaciones como comunicados; filtra con kind.

#Parámetros

Parámetro	Tipo	Descripción
`id`	string	Ruta. Identificador de la `FiscalEntity`.
`kind`	string	`notification` o `comunicado`. Sin valor, ambos.
`unread`	boolean	Si `true`, solo mensajes no leídos.
`limit`	integer	Resultados por página (1–100, por defecto 25).
`cursor`	string	Cursor de paginación.

#Ejemplo

curl "https://api.clarisfy.com/api/v1/fiscal-entities/fe_9a1c2b3d4e5f6071/buzon/notifications?kind=comunicado" \
  -H "Authorization: Bearer clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe"

{
  "data": [
    {
      "id": "bz_7c3e1f9a2b8d4056",
      "kind": "comunicado",
      "subject": "Recordatorio de declaración mensual",
      "sender": "Administración General de Servicios al Contribuyente",
      "has_document": true,
      "received_at": "2026-07-10T09:30:00Z",
      "read_at": null
    }
  ],
  "has_more": false,
  "next_cursor": null
}

#Descarga el documento de un mensaje

GET/fiscal-entities/{id}/buzon/document

Devuelve una URL temporal y firmada para descargar el documento (PDF) asociado a un mensaje del buzón.

#Parámetros

Parámetro	Tipo	Descripción
`id`	string	Ruta. Identificador de la `FiscalEntity`.
`message_id`	string	Query, requerido. Mensaje del buzón (`bz_…`).

{
  "message_id": "bz_7c3e1f9a2b8d4056",
  "content_type": "application/pdf",
  "download_url": "https://files.clarisfy.com/buzon/bz_7c3e1f9a2b8d4056.pdf?sig=…",
  "expires_at": "2026-07-25T19:15:00Z"
}