CVU Bulk Operations Collect

Modificación masiva CVU: Solicitud URL prefirmada para carga de archivo

Endpoint para solicitar URL de carga de archivos para modificaciones masivas de CVU.

Características

• Hasta 10000 CVU pueden ser procesados por cada archivo.
• Al enviar un CVU, está sujeto a cambios: la cuenta recaudadora asociada.
• El CVU es el identificador único para realizar las modificaciones sobre el mismo.

Archivo de operaciones

El archivo contiene la información necesaria para las modificaciones masivas de CVUs. El formato del archivo es JSON y debe cumplir con la siguiente estructura:

---

Raíz del JSON:

Campo	Descripción	Formato	Patrón	Requerido
psp_id	Identificador del PSP del cliente. El formato debe ser de 1 a 4 dígitos numéricos.	String	^[0-9]{1,4}$	Sí
cbu_collector	CBU de la cuenta recaudadora asociada a los CVUs. El formato debe ser de 22 dígitos numéricos.	String	^[0-9]{22}$	Sí
currency_code	Código de moneda ISO 4217. Actualmente solo se acepta 'ARS'.	String	^ARS$	Sí
data	Array de strings con los CVUs a modificar.	Array	^[\s*"(?:[0-9]{22})"\s*(?:,\s*"(?:[0-9]{22})"\s*){0,9999}]$	Sí

Ejemplo de archivo de operaciones:

{
    "psp_id": "123",
    "cbu_collector": "2990003100000000123401",
    "currency_code": "ARS",
    "data": ['0000123100000000000001', '0000123100000000000002']
}

Importante:

• El campo psp_id en el archivo debe coincidir con el psp_id enviado en la solicitud para obtener la URL de carga. De lo contrario, el archivo será rechazado durante el procesamiento asíncrono.
• Solo se aceptan archivos con extensión .json y tipo de contenido application/json.

Modificación masiva de CVU's

POST

/v1/cvu/bulk/collect/update/upload-url

Atención:

• El id de archivo file_id debe ser único
• La validación y procesamiento del archivo ocurren de forma asíncrona.
• No se permite reintento.
• En caso de una respuesta no exitosa (http status code >= 500 o timeout), se debe consultar antes de reintentar la petición.

Autorizaciones

bearerAuth

Tipo

HTTP (bearer)

Parámetros

Header Parameters

trace-id*

Id único de la petición

Tipo

string

Requerido

Ejemplo"550e8400-e29b-41d4-a716-446655440000"

Formato

"uuid"

user-agent*

Identificador del cliente que realiza la request

Tipo

string

Requerido

Ejemplo"nombre-cliente"

Cuerpo de la petición

application/json

{

  

"psp_id": "123",

  

"file_id": "019e75aa-c4d7-7383-b297-d56b9dcbf4ed",

  

"content_type": "application/json"

}

Respuestas

Accepted

Content-Type

application/json

{

  

"file_upload_data": {

  

  

"url": "https://example.com/presigned-url",

  

  

"method": "PUT",

  

  

"expiration": "2026-06-16T17:08:27.843Z",

  

  

"expiration_in_minutes": 60

  

}

}

POST

/v1/cvu/bulk/collect/update/upload-url

Playground

Servidor

Autorización

bearerAuth

Headers

trace-id*

user-agent*

Cuerpo

Ejemplos

Powered by VitePress OpenAPI