Estado de la cuenta

Informa en qué punto está la creación de la cuenta. La apertura es asincrónica — el 201 de Abrir cuenta de persona humana o Abrir cuenta de persona jurídica significa que el request fue aceptado, no que la cuenta ya exista.

Consultá por tu propio external_id, o por el número de documento del titular si no enviaste uno.

Por external ID

GET/v1/aperturas/estado-por-external-id

Request

Headers

Campo	Tipo	Requerido	Descripción
`Authorization`	string	Sí	Access token en formato `Bearer ACCESS_TOKEN`

No aplica: Path Parameters, Body.

Query Parameters

Campo	Tipo	Requerido	Descripción
`external_id`	string	Sí	Uno o más identificadores propios, separados por coma.

Response

2XX Éxito

Ver Campos de la respuesta.

Ejemplo de código

cURL
JavaScript
Python
Node.js

curl -X GET "https://b2b.allaria.cloud/v1/aperturas/estado-por-external-id?external_id=12a34,12a35" \
  -H "Authorization: Bearer ACCESS_TOKEN"

const response = await fetch('https://b2b.allaria.cloud/v1/aperturas/estado-por-external-id?external_id=12a34,12a35', {
  method: 'GET',
  headers: { 'Authorization': 'Bearer ACCESS_TOKEN' }
});
const data = await response.json();
console.log(data);

import requests
response = requests.get(
  'https://b2b.allaria.cloud/v1/aperturas/estado-por-external-id',
  params={'external_id': '12a34,12a35'},
  headers={'Authorization': 'Bearer ACCESS_TOKEN'}
)
print(response.json())

const axios = require('axios');
const response = await axios.get('https://b2b.allaria.cloud/v1/aperturas/estado-por-external-id', {
  params: { external_id: '12a34,12a35' },
  headers: { Authorization: 'Bearer ACCESS_TOKEN' }
});
console.log(response.data);

2XX Éxito
[
  {
    "estado": "CREACION_FINALIZADA",
    "ejecutados": ["Esco", "Nasdaq"],
    "pendientes": [],
    "comitente": 30000552,
    "checked": "2026-08-20T15:43:33.169306Z",
    "segundosEnCrear": 17,
    "fechaFin": "2026-08-20T15:03:11.000000Z",
    "error": false,
    "errorMessage": null,
    "external_id": "12a34"
  },
  {
    "estado": "CREACION_PENDIENTE",
    "ejecutados": ["Nasdaq"],
    "pendientes": ["Esco"],
    "comitente": 60001522,
    "checked": "2026-08-20T15:43:33.169306Z",
    "segundosEnCrear": null,
    "fechaFin": null,
    "error": false,
    "errorMessage": null,
    "external_id": "12a35"
  }
]

Por número de documento

GET/v1/aperturas/estado/documento/{documento}

Usá esta variante cuando no enviaste external_id, o cuando ya no lo tenés.

Request

Headers

Campo	Tipo	Requerido	Descripción
`Authorization`	string	Sí	Access token en formato `Bearer ACCESS_TOKEN`

Path Parameters

Campo	Tipo	Requerido	Descripción
`documento`	string	Sí	Número de documento del titular de la cuenta.

No aplica: Query Parameters, Body.

Response

2XX Éxito

Misma forma que Por external ID. Ver Campos de la respuesta.

Códigos de error

Status	Descripción
`401`	Unauthorized — access token inválido o ausente
`403`	Forbidden — tus credenciales no están autorizadas para Aperturas
`422`	Unprocessable Entity — el identificador falta o es inválido
`500`	Internal Server Error — error interno del servidor

Ejemplo de código

cURL
JavaScript
Python
Node.js

curl -X GET "https://b2b.allaria.cloud/v1/aperturas/estado/documento/31232123" \
  -H "Authorization: Bearer ACCESS_TOKEN"

const response = await fetch('https://b2b.allaria.cloud/v1/aperturas/estado/documento/31232123', {
  method: 'GET',
  headers: { 'Authorization': 'Bearer ACCESS_TOKEN' }
});
const data = await response.json();
console.log(data);

import requests
response = requests.get(
  'https://b2b.allaria.cloud/v1/aperturas/estado/documento/31232123',
  headers={'Authorization': 'Bearer ACCESS_TOKEN'}
)
print(response.json())

const axios = require('axios');
const response = await axios.get('https://b2b.allaria.cloud/v1/aperturas/estado/documento/31232123', {
  headers: { Authorization: 'Bearer ACCESS_TOKEN' }
});
console.log(response.data);

Campos de la respuesta

Campo	Tipo	Descripción
`estado`	string	Estado de creación. Ver Estados de creación
`ejecutados`	array[string]	Servicios que ya terminaron de procesar esta cuenta
`pendientes`	array[string]	Sistemas downstream que faltan. Vacío cuando `estado` es `CREACION_FINALIZADA`
`comitente`	integer \| null	El número de comitente. `null` hasta que se asigna; se puede usar una vez que `estado` es `CREACION_FINALIZADA`
`checked`	string	Cuándo se calculó este estado
`segundosEnCrear`	integer \| null	Cuánto tardó la creación. `null` mientras sigue en curso
`fechaFin`	string \| null	Cuándo terminó la creación. `null` mientras sigue en curso
`error`	boolean	`true` cuando la creación falló
`errorMessage`	string \| null	Detalle de la falla cuando `error` es `true`. No lo devuelve Por número de documento — ver Diferencias por número de documento
`external_id`	string	El identificador que enviaste al abrir la cuenta

Estados de creación

El listado también se sirve en vivo en GET /v1/aperturas/estados-posibles-para-external-id.

Estado	Significado
`NO_ENCONTRADO`	Ninguna cuenta coincide con ese identificador bajo tus propias credenciales. Revisá el `external_id` o el documento que enviaste — no podés ver las cuentas de otro PSP
`EN_DB`	Registrada en Allaria, la creación todavía no arrancó
`CREACION_PENDIENTE`	En creación. `pendientes` nombra los sistemas que faltan
`COMPLIANCE_CHEQUEO_PENDIENTE`	Esperando revisión de compliance antes de procesarse. No hay nada que reintentar — se destraba del lado de Allaria
`RECHAZADO`	La cuenta fue rechazada. Permanece en análisis por un período limitado (21 días) y, si no se resuelve en ese plazo, Allaria la rechaza automáticamente. Es final para vos: no hay nada que reintentar. Contactá a Allaria si creés que debería reabrirse
`BLOQUEADO`	La cuenta está bloqueada. No puede operar hasta que Allaria la desbloquee
`CREACION_FINALIZADA`	Lista. El `comitente` ya se puede usar

Ambos endpoints usan el mismo criterio y devuelven los mismos estados. ejecutados y pendientes listan todos los sistemas que la cuenta necesita — Esco, Byma o Nasdaq y, cuando corresponde a tu cuenta, OmsPersona, OmsCliente y EscoCrypto — por lo que CREACION_FINALIZADA significa que todos terminaron.

El estado de la cuenta tiene prioridad sobre el avance de la creación: una cuenta bloqueada, rechazada o en análisis informa BLOQUEADO, RECHAZADO o COMPLIANCE_CHEQUEO_PENDIENTE aunque sus sistemas ya estén creados. COMPLIANCE_CHEQUEO_PENDIENTE también cubre el período de espera antes de que una cuenta nueva pueda operar.

El listado de estados también se sirve en GET /v1/aperturas/estados-posibles-documento; ambos endpoints de catálogo devuelven los mismos valores.

Diferencias por número de documento

La forma es la misma que por external ID, con estas excepciones:

Campo	Por número de documento
`documento`	Reemplaza a `external_id`: el documento que consultaste
`message`	Reemplaza a `errorMessage`: una descripción legible del estado. Siempre presente, no solo ante una falla

Los mensajes se devuelven en español. Para EN_DB y CREACION_PENDIENTE el mensaje lista los sistemas que faltan, p. ej. La creación está pendiente en: Esco, Nasdaq.; para RECHAZADO es La cuenta fue rechazada.

Códigos de error

Status	Descripción
`401`	Unauthorized — access token inválido o ausente
`403`	Forbidden — tus credenciales no están autorizadas para Aperturas
`422`	Unprocessable Entity — el identificador falta o es inválido
`500`	Internal Server Error — error interno del servidor

Por external ID​

Request​

Headers​

Query Parameters​

Response​

2XX Éxito​

Ejemplo de código​

Por número de documento​

Request​

Headers​

Path Parameters​

Response​

2XX Éxito​

Códigos de error​

Ejemplo de código​

Campos de la respuesta​

Estados de creación​

Diferencias por número de documento​

Códigos de error​

Por external ID

Request

Headers

Query Parameters

Response

2XX Éxito

Ejemplo de código

Por número de documento

Request

Headers

Path Parameters

Response

2XX Éxito

Códigos de error

Ejemplo de código

Campos de la respuesta

Estados de creación

Diferencias por número de documento

Códigos de error