Aprobación y rechazo masivo de legalización de documentos

Este documento cubre dos endpoints del módulo de documentos para gestionar legalización en bloque:

• PUT /legalization_documents/ (aprobar legalización)
• PUT /rejection-legality-documents/ (rechazar legalización)

Autenticación

Ambos endpoints requieren usuario autenticado vía bearer token.

• Header: Authorization: Bearer <token>

Body (JSON)

Los dos endpoints usan la misma estructura (LegalizationDocumentsRequest):

• comment (string, obligatorio): comentario que queda registrado en historial de legalización.
• document_ids (array[UUID], obligatorio): lista de IDs de documentos a procesar en lote.

Ejemplo:

{
  "comment": "Documento validado por legalidad",
  "document_ids": [
    "f2c4e4f4-81fb-474d-9155-9bb5ffdf7d0f"
  ]
}

1) Aprobar legalización masiva

• Method: PUT
• URI: /legalization_documents/

¿Qué hace?

Por cada document_id:

1. Crea registro en doc_legality con legality_state_id = 1 (aprobado).
2. Guarda logs de cambio (legality_state_id y comment).
3. Si el documento está en estado de interpretación INTERPRETED o APPROVED, dispara homologación automática.

Respuesta

• 200 OK cuando el proceso termina correctamente.

2) Rechazar legalización masiva

• Method: PUT
• URI: /rejection-legality-documents/

¿Qué hace?

Por cada document_id:

1. Crea registro en doc_legality con legality_state_id = 2 (rechazado).
2. Guarda logs de cambio (legality_state_id y comment).

Respuesta

• 200 OK cuando el proceso termina correctamente.

Notas importantes

• Si envías múltiples documentos, el procesamiento se hace en bucle uno por uno.
• El comentario aplica a todos los IDs enviados en la misma solicitud.
• Usa UUIDs válidos en document_ids para evitar errores de validación.