CVU Bulk Operations

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 nombre del titular y tipo de persona.
• El CVU y CUIT son 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 objetos con la información de cada CVU a modificar. El formato de cada objeto se detalla en la siguiente tabla.	Array	length: 1-10000	Sí

Estructura de cada objeto dentro del array data:

Campo	Descripción	Formato	Patrón	Requerido
cuit	CUIT del titular del CVU. El formato debe ser de 11 dígitos numéricos.	String	^[0-9]{11}$	Sí
name	Nombre del titular del CVU. El formato debe ser de hasta 41 caracteres alfanuméricos (incluyendo espacios).	String	^[a-zA-Z0-9 ]{1,41}$	Sí
person_type	Tipo de persona del titular del CVU. Puede ser 'F' para persona física o 'J' para persona jurídica.	String	^[FJ]$	Sí
cvu	CVU a modificar. El formato debe ser de 22 dígitos numéricos.	String	^[0-9]{22}$	Sí

Ejemplo de archivo de operaciones:

{
    "psp_id": "123",
    "cbu_collector": "2990003100000000123401",
    "currency_code": "ARS",
    "data": [
        {
            "cuit": "20123456789",
            "name": "Jane Doe",
            "person_type": "F",
            "cvu": "0000123100000000000001"
        }
    ]
}

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/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.
• En caso de error en el archivo, debe generar una nueva URL de carga (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/update/upload-url

Playground

Servidor

Autorización

bearerAuth

Headers

trace-id*

user-agent*

Cuerpo

Ejemplos

Powered by VitePress OpenAPI