Appearance
CVU Bulk Operations
CVU Bulk Operations Collect
Notifications CVU Bulk Operations
Webhook estados archivo operaciones masivas CVU
POST
/v1/notification/cvu/bulk
Endpoint para recibir notificaciones del archivo sobre validación del body cargado por el cliente y resultado del procesamiento de ABM Masivo de CVU.
Estados en la notificación:
- READY
Estado Intermedio: El archivo está listo para ser enviado al proveedor para ser procesado. - FAILED
Estado Final: El archivo falló en validación de estructura del archivo subido o datos. - COMPLETED
Estado Final: El archivo fue procesado.
Atención:
- La validación y procesamiento del archivo ocurren de forma asíncrona.
- En caso de que el archivo no cumpla con las validaciones, se recibirá una notificación con estado
FAILEDy el detalle de los errores encontrados para que el cliente pueda corregirlos. No se permite reintentos sobre el mismo file_id o URL prefirmada de carga usada, por lo que el cliente deberá generar una nueva URL prefirmada de carga con nuevo file_id y subir archivo para que sea procesado. - Al recibir la notificación con estado
COMPLETEDdebe descargar el archivo resultado para conocer que operaciones fueron fallidas.
Autorizaciones
xApiKey
Tipo
API Key (header: x-api-key)
Parámetros
Header Parameters
x-api-key*
API Key para autenticar la solicitud de notificación. Debe ser enviado en el header de la solicitud.
Tipo
Requeridostring
Ejemplo
"1b2f3a4c-5566-7788-9900-aabbccddeeff"Cuerpo de la petición
application/json
JSON "notification_id": "987f6543-21ba-43cd-9e8f-123456789abc", "notification_date": "2025-12-01T09:00:00 -03:00", "file_id": "019e75aa-c4d7-7383-b297-d56b9dcbf4ed", "operation_type": "UPDATE", "status": "READY", "psp_id": "123"
{
}
Respuestas
Accepted
application/json
JSON "message": "Notification received successfully"
{
}