GET /api/emisores/webhook-aviso/{id}/

GET /api/emisores/webhook-aviso/{id}/

Los avisos mandados a los webhooks del emisor, con lo que respondieron.

Uno por webhook y por cambio: validarse el documento o notificarse. Se mandan una sola vez, sin reintentos; aquí se ve cuáles no llegaron y por qué (codigo_http y error). De solo lectura: los escribe el sistema.

Filtros: ?webhook=<id>, ?documento=<uuid>, ?tipo=validacion|notificacion y ?estado=pendiente|entregado|fallido.

operationId: emisores_webhook_aviso_retrieve

Autenticación

Cualquiera de estas credenciales:

• LlaveApi — Llave de API de una integración. El valor completo es Api-Key <prefijo>.<secreto>, tal como lo imprime manage.py crear_llave_api. La llave alcanza exactamente los mismos emisores que la persona a cuyo nombre se creó.

Parámetros

Nombre	En	Tipo	Obligatorio	Descripción
id	path	integer	sí	Un valor de entero único que identifique este aviso de webhook.

Ejemplo

curl "https://api.rededoc.uk/api/emisores/webhook-aviso/<id>/" \
  -H "Authorization: <llaveapi>"

Respuestas

Código	Descripción
200
401	Error
404	Error
429	Error

200 — cuerpo

Campo	Tipo	Descripción
id	integer	Solo lectura.
webhook	integer	Solo lectura.
documento	string (uuid)	Solo lectura.
tipo	any	Solo lectura.
estado	any	Solo lectura.
codigo_http	integer	Solo lectura. Admite null.
error	string	Solo lectura.
cuerpo	string	Solo lectura.
creado_en	string (date-time)	Solo lectura.
enviado_en	string (date-time)	Solo lectura. Admite null.

{
  "id": 1,
  "webhook": 1,
  "documento": "00000000-0000-0000-0000-000000000000",
  "tipo": null,
  "estado": null,
  "codigo_http": 1,
  "error": "texto",
  "cuerpo": "texto",
  "creado_en": "2026-01-31T10:00:00-05:00",
  "enviado_en": "2026-01-31T10:00:00-05:00"
}

401 — cuerpo

Campo	Tipo	Descripción
detail	string	Mensaje para mostrar a la persona.
errores	array<object>	Nunca vacía. Cada error trae codigo, que es lo que el cliente mapea —los de DRF tal cual (required, invalid, does_not_exist, not_found…) y los propios en español (campo_desconocido, solicitud_invalida…)—, y mensaje, para la persona. Si el error es de un campo, su ruta va delante del mensaje: detalles[0].impuestos[0].tributo: Este campo es obligatorio.

{
  "detail": "texto",
  "errores": [
    {
      "codigo": "texto",
      "mensaje": "texto"
    }
  ]
}

404 — cuerpo

Campo	Tipo	Descripción
detail	string	Mensaje para mostrar a la persona.
errores	array<object>	Nunca vacía. Cada error trae codigo, que es lo que el cliente mapea —los de DRF tal cual (required, invalid, does_not_exist, not_found…) y los propios en español (campo_desconocido, solicitud_invalida…)—, y mensaje, para la persona. Si el error es de un campo, su ruta va delante del mensaje: detalles[0].impuestos[0].tributo: Este campo es obligatorio.

{
  "detail": "texto",
  "errores": [
    {
      "codigo": "texto",
      "mensaje": "texto"
    }
  ]
}

429 — cuerpo

Campo	Tipo	Descripción
detail	string	Mensaje para mostrar a la persona.
errores	array<object>	Nunca vacía. Cada error trae codigo, que es lo que el cliente mapea —los de DRF tal cual (required, invalid, does_not_exist, not_found…) y los propios en español (campo_desconocido, solicitud_invalida…)—, y mensaje, para la persona. Si el error es de un campo, su ruta va delante del mensaje: detalles[0].impuestos[0].tributo: Este campo es obligatorio.

{
  "detail": "texto",
  "errores": [
    {
      "codigo": "texto",
      "mensaje": "texto"
    }
  ]
}