Actualizar Perfil de Riesgo del Inversor (PRI)

Actualiza el Perfil de Riesgo del Inversor (PRI) y la fecha de aceptación de términos y condiciones de una o más cuentas. Se pueden actualizar hasta 1000 cuentas en una sola solicitud.

PATCH/v1/aperturas/cuentas/pri

Request

Headers

Campo	Tipo	Requerido	Descripción
Authorization	string	Sí	Access token en formato Bearer ACCESS_TOKEN
Content-Type	string	Sí	Debe ser application/json

No aplica: Path Parameters, Query Parameters.

Body

Campo	Tipo	Requerido	Descripción
cuentas	array	Sí	Lista de cuentas a actualizar. Máximo 1000 elementos.
cuentas[].comitente	integer	Sí	Identificador de la cuenta (número de comitente).
cuentas[].pri	string	Sí	Perfil de Riesgo del Inversor. Valores aceptados: Bajo, Medio, Alto.
cuentas[].terminos_condiciones	string	Sí	Fecha y hora en que el titular aceptó los términos y condiciones del PRI. Formato: YYYY-MM-DD HH:MM:SS.

Response

2XX Éxito

Status: 200 OK

La respuesta siempre devuelve 200. Verificar el campo error para determinar si alguna cuenta falló en la actualización. Las cuentas no encontradas en el sistema se listan en error_details.

Todas las cuentas actualizadas correctamente:

Falla parcial — algunas cuentas no encontradas:

{
  "error": true,
  "error_details": [
    {
      "comitente": 123456,
      "errorMessage": "La cuenta no se encuentra en la base de datos.",
      "error": "NOT_FOUND"
    }
  ]
}

Campo	Tipo	Descripción
error	boolean	true si una o más cuentas no pudieron actualizarse.
error_details	array | object	Lista de errores por cuenta, o un objeto vacío {} cuando no hay errores.
error_details[].comitente	integer | null	Número de comitente de la cuenta con error. null en caso de error interno del servidor.
error_details[].errorMessage	string	Descripción del error en formato legible.
error_details[].error	string	Código de error. Valores posibles: NOT_FOUND, SERVER_ERROR.

Códigos de error

Status	Descripción
400	Bad Request — parámetros inválidos o faltantes
401	Unauthorized — token de acceso inválido o ausente
403	Forbidden — el token no tiene permiso para realizar esta operación
422	Unprocessable Entity — validación fallida (ej. valor de pri inválido o formato de fecha incorrecto)
500	Internal Server Error

Ejemplo de código

cURL

curl -X PATCH "https://b2b.allaria.cloud/v1/aperturas/cuentas/pri" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "cuentas": [
      {
        "comitente": 123456,
        "pri": "Bajo",
        "terminos_condiciones": "2024-01-15 22:00:00"
      }
    ]
  }'

JavaScript

const response = await fetch('https://b2b.allaria.cloud/v1/aperturas/cuentas/pri', {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    cuentas: [
      {
        comitente: 123456,
        pri: 'Bajo',
        terminos_condiciones: '2024-01-15 22:00:00'
      }
    ]
  })
});
const data = await response.json();
console.log(data);

Python

import requests
response = requests.patch(
  'https://b2b.allaria.cloud/v1/aperturas/cuentas/pri',
  headers={
    'Authorization': 'Bearer ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  json={
    'cuentas': [
      {
        'comitente': 123456,
        'pri': 'Bajo',
        'terminos_condiciones': '2024-01-15 22:00:00'
      }
    ]
  }
)
data = response.json()
print(data)

Node.js

const axios = require('axios');
const response = await axios.patch('https://b2b.allaria.cloud/v1/aperturas/cuentas/pri', {
  cuentas: [
    {
      comitente: 123456,
      pri: 'Bajo',
      terminos_condiciones: '2024-01-15 22:00:00'
    }
  ]
}, {
  headers: {
    Authorization: 'Bearer ACCESS_TOKEN',
    'Content-Type': 'application/json'
  }
});
console.log(response.data);

2XX Éxito

{
  "error": false,
  "error_details": {}
}