Introducción
La API de Aperturas abre cuentas en Allaria para clientes que tu empresa ya verificó. Vos enviás el legajo completo y validado; Allaria crea la cuenta en Caja de Valores y en Esco y devuelve el número de comitente.
Para PSPs internos no hay cola de revisión. Para PSPs externos, Allaria corre las validaciones de Renaper y Repet al momento del envío y puede requerir revisión de documentación.
Para quién es esta sección
Este flujo existe para empresas que sí son sujetos obligados: inscriptas ante la UIF, que realizan su propia debida diligencia y son legalmente responsables del KYC/AML de los clientes que traen.
Como esa responsabilidad es tuya, Allaria no repite la verificación. Ese es el intercambio: vos enviás datos que ya están completos y correctos, y a cambio la cuenta se crea de punta a punta.
No uses esta sección — usá Onboarding, donde Allaria hace la verificación y se hace responsable del KYC.
Una empresa que no está inscripta ante la UIF no puede recolectar y transmitir los datos personales de sus clientes con fines de apertura de cuenta por cuenta propia.
¿No tenés certeza de cuál le corresponde a tu empresa? Consultá a integraciones@allaria.com.ar antes de desarrollar.
| Onboarding | Aperturas | |
|---|---|---|
| Tu empresa es sujeto obligado | No | Sí |
| Quién hace el KYC | Allaria | Vos |
| Documentación | Se sube a Allaria para revisión | Allaria no la revisa |
| Resultado | PENDING → APPROVED / REJECTED tras la revisión | La cuenta se crea de punta a punta |
| Volumen | Un cliente por onboarding | Una persona humana por request |
PSPs internos y externos
Tus credenciales te ubican en uno de dos grupos, y el grupo cambia lo que los endpoints de apertura te exigen.
El grupo se resuelve desde tu access token — no hay nada que enviar en el request.
- PSP externo — un integrador de terceros. Este sos vos, si estás leyendo esta doc como cliente de Allaria.
- PSP interno — los productos propios de Allaria (la billetera, agro, el flujo de onboarding asistido).
La diferencia es quién hace las verificaciones de identidad:
| PSP externo | PSP interno | |
|---|---|---|
| Chequeos de Renaper y Repet | Allaria los corre al recibir el request | No se corren |
frente_dni / dorso_dni | Obligatorios | No se requieren |
pri / matriz_riesgo_descripcion | Los calcula Allaria — no los envíes | Obligatorios — los envías vos |
| Las cuentas jurídicas requieren además | lugar_constitucion, canal_ingreso, fecha_ingreso, valuacion, es_entidad_publica | — |
Todo campo cuya obligatoriedad dependa de esto está marcado como Condicional en las páginas de endpoint, con el grupo nombrado en su descripción.
Dos cosas más varían según el acuerdo puntual que Allaria haya configurado para vos, independientemente del grupo:
- si
external_ides obligatorio; - si podés elegir el
comitente, o Allaria lo asigna desde un rango reservado.
Pedile a integraciones@allaria.com.ar que te confirme las dos antes de armar el body.
Si tus credenciales no tienen ningún grupo asignado, toda llamada de apertura falla con 422 y el mensaje No hay una campania asociada al usuario. Hablar con Allaria.
La apertura de cuentas se acepta únicamente entre las 09:30 y las 17:00, de lunes a viernes, en días hábiles. Encolá los envíos de tu lado en vez de reintentar.
Fuera de esa ventana el request falla con 422 y:
{"cuentas": ["La ventana de operación es de 9.30hs a 17hs de lunes a viernes días hábiles..."]}
Prerrequisitos
Todos los endpoints de esta sección requieren autenticación. Antes de tu primera llamada necesitás tu IP whitelisteada y un access token — ver Primeros pasos.
El flujo
GET /v1/aperturas/cuentas-por-cuit consulta Esco en vivo y te dice si ese CUIT/CUIL ya tiene cuentas abiertas en Allaria, sin importar por qué canal se abrieron.
Ejecutalo antes de abrir, para no crear un duplicado de una persona que ya entró por otro canal.
Campos como actividad, nacionalidad, tipo_documento, codigo_provincia_domicilio y lugar_nacimiento se validan contra los catálogos de Allaria. Son códigos, no texto libre, y se sirven desde endpoints de solo lectura — ver Datos de referencia:
- Catálogos de Esco — actividades, países, provincias, tipos de documento. Se envía el
codigo. - Catálogos de Caja de Valores — lugar de nacimiento y localidad. En uno se envía el
namey en el otro elcode. - Catálogos de persona e impositivos — sexo, estado civil, condición PEP, residencia y provincia fiscal.
Hay dos catálogos de países con códigos distintos (el paises de Esco y el paises-cv de Caja de Valores) y no son intercambiables. Leé las páginas de datos de referencia antes de armar el body.
Dos endpoints, que se eligen según quién es el titular — no con un flag:
POST /v1/aperturas/apertura-cuenta— personas humanas. Una por request.POST /v1/aperturas/apertura-cuenta-juridica— personas jurídicas. Una por request, porque el payload lleva además los representantes, accionistas y beneficiarios finales de la entidad.
Los dos devuelven 201 aunque la cuenta haya fallado. La respuesta es por cuenta: leé errores y el detalle por CUIL, nunca el status code solo.
La creación de la cuenta es asincrónica — el 201 significa "aceptado y encolado", no "creado". GET /v1/aperturas/estado-por-external-id informa en qué punto está cada cuenta:
| Estado | Significado |
|---|---|
NO_ENCONTRADO | Ninguna cuenta coincide con ese identificador |
EN_DB | Registrada en Allaria, la creación no arrancó |
CREACION_PENDIENTE | En creación — pendientes lista los sistemas que faltan |
COMPLIANCE_CHEQUEO_PENDIENTE | Retenida por un chequeo de compliance |
RECHAZADO | Rechazada — quedó en análisis más allá del plazo permitido, o fue rechazada |
BLOQUEADO | Bloqueada — no puede operar |
CREACION_FINALIZADA | Lista — el comitente ya se puede usar |
Crear la cuenta no alcanza por sí solo para que tus credenciales puedan leerla — la cuenta también debe estar vinculada a tu client_id. Allaria lo hace automáticamente cuando la cuenta queda operativa; ya no vinculás las cuentas vos.
GET /v1/aperturas/link-accounts/{accountNumber} devuelve el estado de esa vinculación. Hasta que esté COMPLETED, Movimientos y Posición devuelven 403 para la cuenta.
PATCH /v1/aperturas/cuentas/pri actualiza el Perfil de Riesgo del Inversor y la fecha de aceptación de términos y condiciones de hasta 1000 cuentas por vez. Usalo cuando un cliente vuelve a completar el cuestionario de idoneidad de tu lado.
Un flujo aparte para cuotapartistas de fondos comunes de inversión, solo para credenciales que Allaria habilitó. No usa el flujo de comitente anterior: la cuenta se identifica por el CUIT de la empresa.
GET /v1/aperturas/unit-holder/catalogs: los valores aceptados para los campos de catálogo.POST /v1/aperturas/unit-holder/accounts: una empresa y sus titulares por request. Devuelve202: la cuenta se crea de forma asíncrona.GET /v1/aperturas/unit-holder/accounts/{tax_id}: consultácreation_statehasta que sea final. Una cuentaFAILEDoSTUCKpuede reenviarse.
GET /v1/aperturas/unit-holder/by-document/{document_number} lista las cuentas de una persona; requiere un permiso de lectura.
Persona humana vs. persona jurídica
| Persona humana | Persona jurídica | |
|---|---|---|
| Endpoint | POST /v1/aperturas/apertura-cuenta | POST /v1/aperturas/apertura-cuenta-juridica |
| Cuentas por request | Exactamente 1 | Exactamente 1 |
| Qué se declara | La persona | La entidad, más personas_fisicas (representantes), accionistas_fisicos, accionistas_juridicos y beneficiarios |
| Imágenes del documento | En base64 dentro del body | Se suben primero a POST /v1/aperturas/storage/push y se referencian por nombre de archivo |
pri | Obligatorio solo para PSPs internos | Siempre obligatorio |
| Campos societarios extra | — | fecha_constitucion, numero_inscripcion, tipo_registracion_juridica, estructura_accionaria, grupo_economico, es_especulativo_oportunista |
Errores frecuentes
| Síntoma | Causa |
|---|---|
422 con No hay una campania asociada al usuario | Tus credenciales no tienen grupo de PSP asignado — contactá a integraciones@allaria.com.ar |
422 en un campo que la doc marca como opcional | Tu grupo de PSP lo vuelve obligatorio. Ver PSPs internos y externos |
422 en actividad, nacionalidad, tipo_documento, lugar_nacimiento | El valor no es un código de catálogo válido — leelo de los endpoints de catálogo, no lo hardcodees |
422 puntualmente en lugar_nacimiento o localidad | Enviaste un código donde se espera un nombre, o al revés. Ver Catálogos de Caja de Valores |
201 pero errores: true | La cuenta falló. El detalle está en el body, no en el status code |
Cuenta trabada en CREACION_PENDIENTE | Un sistema downstream (Esco, Nasdaq) no terminó. pendientes lo nombra. Si no se destraba, contactá a soporte |
403 en todos los endpoints de esta sección | Tus credenciales no están autorizadas para Aperturas — contactá a integraciones@allaria.com.ar |
422 con La ventana de operación es de 9.30hs a 17hs | Enviaste fuera de la ventana de 09:30 a 17:00 en días hábiles |
500 con El sistema RENAPER está caído | Renaper o Repet no está disponible. Reintentá más tarde — el request no estaba mal |
| El request expira por timeout, sin código de estado | Tu IP no está whitelisteada — ver Acceso |
Todavía no documentado acá
Esta sección cubre apertura de cuentas, estado, PRI y los catálogos que esos necesitan. El servicio también expone:
- cuentas con múltiples titulares (
comitente-multiples-fisicos,titular-fisico); - carga de archivos (
storage/push); - consultas de matriz de riesgo (
matriz/*).
Consultá a integraciones@allaria.com.ar si los necesitás antes de que se publiquen acá.