PATCH /api/emisores/webhook/{id}/

PATCH /api/emisores/webhook/{id}/

Los webhooks del emisor: a qué URL avisarle, y de qué.

Un emisor puede tener varios. estado_validado y estado_notificado dicen si a ese webhook se le avisa de la validación de la DIAN y de la notificación al adquiriente. Por ahora solo se guardan: el envío de los avisos todavía no está hecho.

Filtro: ?emisor=<id>.

operationId: emisores_webhook_partial_update

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 webhook.

Cuerpo de la petición

Tipo de contenido: application/json.

Campos

Campo	Tipo	Obligatorio	Descripción
emisor	integer	no
nombre	string	no
url	string (uri)	no
estado_validado	boolean	no
estado_notificado	boolean	no

Ejemplo

curl -X PATCH "https://api.rededoc.uk/api/emisores/webhook/<id>/" \
  -H "Authorization: <llaveapi>" \
  -H "Content-Type: application/json" \
  -d '{
    "emisor": 1,
    "nombre": "texto",
    "url": "texto",
    "estado_validado": true,
    "estado_notificado": true
  }'

Respuestas

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

200 — cuerpo

Campo	Tipo	Descripción
id	integer	Solo lectura.
emisor	integer
nombre	string
url	string (uri)
estado_validado	boolean
estado_notificado	boolean
creado_en	string (date-time)	Solo lectura.
actualizado_en	string (date-time)	Solo lectura.

{
  "id": 1,
  "emisor": 1,
  "nombre": "texto",
  "url": "texto",
  "estado_validado": true,
  "estado_notificado": true,
  "creado_en": "2026-01-31T10:00:00-05:00",
  "actualizado_en": "2026-01-31T10:00:00-05:00"
}

400 — 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"
    }
  ]
}

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