Abrir cuenta de persona jurídica

Abre una cuenta en Allaria para una persona jurídica que tu empresa ya verificó, junto con sus representantes, accionistas y beneficiarios finales. Una cuenta por request.

POST/v1/aperturas/apertura-cuenta-juridica

Leé esto antes de armar el body

Varios de los campos de abajo están marcados como Condicional porque es tu grupo de PSP el que define si son obligatorios — ver PSPs internos y externos. Además, la apertura de cuentas se acepta únicamente de 09:30 a 17:00 en días hábiles.

Las imágenes del documento se suben antes

A diferencia de Abrir cuenta de persona humana, este endpoint no acepta imágenes en base64. Subí cada archivo a POST /v1/aperturas/storage/push y después referenciá en frente_dni / dorso_dni el nombre de archivo que devuelve.

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í	Exactamente una cuenta. El array lleva la entidad y todas las personas vinculadas a ella.

La entidad

Campo	Tipo	Requerido	Descripción
`persona_juridica`	object	Sí	El titular de la cuenta. Ver Persona jurídica.
`actividad`	array[string]	Sí	`codigo`s de actividad económica de `actividades`.
`fecha_constitucion`	string	Sí	Fecha de constitución, `YYYY-MM-DD HH:mm:ss`.
`numero_inscripcion`	integer	Sí	Número de inscripción.
`tipo_registracion_juridica`	integer	Sí	El `codigo` de `tipos-registracion-juridica`.
`estructura_accionaria`	string	Sí	`Simple` o `Compleja`.
`grupo_economico`	boolean	Sí	Si la entidad pertenece a un grupo económico.
`es_especulativo_oportunista`	boolean	Sí	Si el perfil de la entidad es especulativo/oportunista.
`lugar_constitucion`	string	Condicional	Provincia del lugar de constitución. Obligatorio para PSPs externos.
`canal_ingreso`	string	Condicional	`On Line` o `Presencial`. Obligatorio para PSPs externos.
`fecha_ingreso`	string	Condicional	Rango de antigüedad de la relación, por ejemplo `Entre 2 y 5 años`. Obligatorio para PSPs externos.
`valuacion`	string	Condicional	Rango de valuación, por ejemplo `Entre 5 y 50 millones`. Obligatorio para PSPs externos.
`es_entidad_publica`	boolean	Condicional	Si la entidad es un organismo público. Obligatorio para PSPs externos, opcional para los internos.
`perfil_transaccional`	string	No	Perfil transaccional.

Personas vinculadas a la entidad

Cada array contiene registros de persona armados sobre la misma forma base — ver Registro de persona humana.

Campo	Tipo	Requerido	Descripción
`personas_fisicas`	array	Sí	Representantes / firmantes. Al menos uno.
`accionistas_fisicos`	array	No	Accionistas personas humanas. Cada uno requiere además `porcentaje_participacion` y los campos de tributación en el exterior.
`accionistas_juridicos`	array	No	Accionistas personas jurídicas. Cada uno toma la forma de Persona jurídica más `porcentaje_participacion`, `tipo_contribuyente_iva` y los campos de tributación en el exterior.
`beneficiarios`	array	No	Beneficiarios finales. Misma forma que `accionistas_fisicos`.

Riesgo y fechas

Campo	Tipo	Requerido	Descripción
`pri`	string	Sí	Perfil de Riesgo del Inversor: `Riesgo Bajo`, `Riesgo Medio` o `Riesgo Alto`. A diferencia del endpoint de persona humana, acá es siempre obligatorio — incluso para PSPs externos.
`matriz_riesgo_descripcion`	string	No	Resultado de la matriz de riesgo: `Bajo`, `Medio`, `Medio Forzado`, `Alto`, `Alto Forzado` o `Alto-Comité`.
`terminos_condiciones`	string	Sí	Cuándo la entidad aceptó los términos y condiciones, `YYYY-MM-DD HH:mm:ss`.
`fecha_psp_apertura_cuenta`	string	Sí	Cuándo se solicitó la cuenta de tu lado, `YYYY-MM-DD HH:mm:ss`.

Inversor calificado

Campo	Tipo	Requerido	Descripción
`es_inversor_calificado`	boolean	No	Cuando es `true`, exactamente uno de `tope_uva` o `sujeto_institucional` también debe ser `true`.
`tope_uva`	boolean	No	Califica por el tope en UVA. Mutuamente excluyente con `sujeto_institucional`.
`sujeto_institucional`	boolean	No	Califica como sujeto institucional. Mutuamente excluyente con `tope_uva`.

Cuenta e identificadores

Campo	Tipo	Requerido	Descripción
`external_id`	string	Condicional	Tu propio identificador. Obligatorio u opcional según el acuerdo que Allaria configuró para vos, y siempre obligatorio cuando `crypto` es `true`. Es con lo que después consultás el estado, así que enviá uno incluso cuando sea opcional.
`comitente`	integer	Condicional	Número de comitente. Se rechaza directamente para PSPs externos — se asigna desde un rango reservado. Para PSPs internos, no debe existir previamente.
`crypto`	boolean	No	Abre una cuenta habilitada para cripto. Vuelve obligatorio a `external_id`.

Esquemas auxiliares

Persona jurídica

Se usa en persona_juridica y en cada ítem de accionistas_juridicos.

Campo	Tipo	Requerido	Descripción
`razon_social`	string	Sí	Razón social. Máximo 255 caracteres.
`cuit`	integer	Sí	CUIT.
`cuil`	integer	No	De 10 a 13 dígitos. Debe ser distinto dentro del payload.
`tomar_cuit_como`	string	No	Interpretar `cuit` como otro identificador: `cuit`, `cdi`, `cie` o `nif`.
`emails`	string	Sí	Una o más direcciones de email, separadas por coma.
`domicilio`	object	Sí	Ver Domicilio.
`ssn`	string	Condicional	Obligatorio cuando `residencia_fiscal` es Estados Unidos. Máximo 24 caracteres.
`residencia_fiscal_id`	integer	No	El `id` de la fila en `residencia-fiscal` — no su `opcion`, a diferencia del endpoint de persona humana.
`provincia_fiscal_id`	integer	No	El `id` de la fila en `provincia-fiscal` — no su `opcion`.

Registro de persona humana

Se usa en personas_fisicas, accionistas_fisicos y beneficiarios.

Campo	Tipo	Requerido	Descripción
`nombres`	string	Sí	Nombres. Máximo 255 caracteres.
`apellido`	string	Sí	Apellido. Máximo 255 caracteres.
`tipo_documento`	string	Sí	El `codigo` de `tipos-documento`.
`documento`	integer	Sí	Número de documento.
`numero_tramite_dni`	integer	Condicional	11 dígitos. Obligatorio cuando `tipo_documento` es `6` (DNI argentino).
`cuit`	integer	Sí	CUIT/CUIL.
`emails`	string	Sí	Una o más direcciones de email, separadas por coma.
`fecha_nacimiento`	string	Sí	Fecha de nacimiento, `YYYY-MM-DD HH:mm:ss`. Debe corresponder a 18 años o más.
`sexo`	string	Sí	`1`, `2` o `3` — el `codigo` de `sexo`.
`estado_civil`	string	Sí	El `codigo` de `estado-civil`.
`nacionalidad`	string	Sí	El `codigo` del catálogo `paises` de Esco.
`lugar_nacimiento`	string	Sí	El `name` de `paises-cv`, por ejemplo `Argentina` — no un código.
`actividad`	string	No	El `codigo` de `actividades`.
`tipo_contribuyente_iva`	string	Condicional	El `codigo` de `tipos-contrib-iva`. Obligatorio en cada ítem de `accionistas_juridicos`; opcional en los otros arrays de personas.
`es_pep`	string	Sí	La `opcion` de `es-pep`.
`motivo_consideracion_pep`	string	Condicional	Motivo de la condición PEP. Obligatorio salvo que `es_pep` sea `No` o null. Máximo 255 caracteres.
`frente_dni`	string	No	Nombre de archivo devuelto por `POST /v1/aperturas/storage/push`. Solo en `personas_fisicas`.
`dorso_dni`	string	No	Nombre de archivo devuelto por `POST /v1/aperturas/storage/push`. Solo en `personas_fisicas`.
`porcentaje_participacion`	number	Condicional	Ownership percentage, 0 to 100. Obligatorio en `accionistas_fisicos`, `accionistas_juridicos` y `beneficiarios`.
`domicilio`	object	Sí	Ver Domicilio.

Domicilio

Se usa como objeto domicilio en cada entidad y cada persona.

Campo	Tipo	Requerido	Descripción
`calle`	string	Sí	Nombre de la calle. Máximo 255 caracteres.
`altura_domicilio`	string	Sí	Altura. Máximo 12 caracteres.
`cp`	string	Sí	Código postal.
`localidad`	string	Sí	El `code` de `localidades-cv` — no el nombre de la localidad.
`codigo_pais_domicilio`	integer	Sí	El `codigo` del catálogo `paises` de Esco.
`codigo_provincia_domicilio`	integer	Sí	El `codigo` del catálogo `provincias` de Esco.
`piso`	string	No	Piso.
`departamento`	string	No	Departamento. Máximo 3 caracteres.
`telefono`	string	No	Teléfono. Máximo 100 caracteres.

Tributación en el exterior

Obligatorio en accionistas_fisicos, accionistas_juridicos y beneficiarios.

Campo	Tipo	Requerido	Descripción
`tributa_exterior`	boolean	Sí	Si la persona o entidad tributa en el exterior.
`tributa_exterior_pais_codigo`	integer	Condicional	El `codigo` del catálogo `paises` de Esco. Obligatorio cuando `tributa_exterior` es `true`.
`tributa_exterior_nif`	integer	Condicional	Identificación tributaria del exterior. Obligatorio cuando `tributa_exterior` es `true`.

Response

2XX Éxito

Mismo envoltorio que Abrir cuenta de persona humana, incluidas las tablas de mensajes de renaper, repet y detalle_errores — el listado completo está en esa página. El 201 significa que el request fue aceptado; errores indica si la cuenta se creó efectivamente.

Campo	Tipo	Descripción
`total_cuentas`	integer	Cuentas recibidas en el request
`errores`	boolean	`true` cuando la cuenta falló
`ejecutado`	string	Cuándo se procesó el request
`renaper`	object \| null	Rechazos de Renaper, indexados por CUIL. Solo se completa para PSPs externos
`repet`	object \| null	Rechazos de Repet, indexados por CUIL
`esco`	object \| null	Resultado indexado por CUIT. `null` cuando el request falló antes de llegar a Esco
`detalle_errores`	object	Errores de validación a nivel campo, indexados por el path que falló (por ejemplo `cuentas.0.personas_fisicas.0.es_pep`)

La cuenta se crea de forma asincrónica. Consultá Estado de la cuenta hasta que llegue a CREACION_FINALIZADA.

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`	Falló la validación. El body varía según la causa: errores de campo, fuera de la ventana de operación, o sin grupo de PSP asignado (`{"error": "No hay una campania asociada al usuario. Hablar con Allaria."}`)
`500`	Un sistema externo no está disponible: `{"error": true, "msg": "El sistema X está caído, por favor reintente más tarde"}`. También ante errores internos inesperados

Ejemplo de código

cURL
JavaScript
Python
Node.js

curl -X POST "https://b2b.allaria.cloud/v1/aperturas/apertura-cuenta-juridica" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "cuentas": [
      {
        "external_id": "12a34",
        "persona_juridica": {
          "razon_social": "Acme S.A.",
          "cuit": 30123123235,
          "emails": "contacto@acme.com",
          "domicilio": {
            "calle": "Av. Siempreviva",
            "altura_domicilio": "742",
            "cp": 1425,
            "localidad": "CABALLITO",
            "codigo_pais_domicilio": 1,
            "codigo_provincia_domicilio": 1
          }
        },
        "personas_fisicas": [
          {
            "nombres": "Juan Gabriel",
            "apellido": "Pérez",
            "tipo_documento": "6",
            "documento": 31232123,
            "numero_tramite_dni": 12345678910,
            "cuit": 20312321234,
            "emails": "juan.perez@acme.com",
            "fecha_nacimiento": "1985-04-12 00:00:00",
            "sexo": "1",
            "estado_civil": "2",
            "nacionalidad": "1",
            "lugar_nacimiento": "ARGENTINA",
            "es_pep": "No",
            "domicilio": {
              "calle": "Calle Falsa",
              "altura_domicilio": "123",
              "cp": 1425,
              "localidad": "CABALLITO",
              "codigo_pais_domicilio": 1,
              "codigo_provincia_domicilio": 1
            }
          }
        ],
        "accionistas_fisicos": [],
        "accionistas_juridicos": [],
        "beneficiarios": [],
        "actividad": ["16"],
        "fecha_constitucion": "2002-01-15 00:00:00",
        "lugar_constitucion": "CORDOBA",
        "numero_inscripcion": 1234,
        "tipo_registracion_juridica": 1,
        "estructura_accionaria": "Simple",
        "grupo_economico": false,
        "es_especulativo_oportunista": false,
        "es_inversor_calificado": false,
        "pri": "Riesgo Medio",
        "matriz_riesgo_descripcion": "Medio",
        "terminos_condiciones": "2026-08-20 14:30:00",
        "fecha_psp_apertura_cuenta": "2026-08-20 14:30:00"
      }
    ]
  }'

const response = await fetch('https://b2b.allaria.cloud/v1/aperturas/apertura-cuenta-juridica', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    cuentas: [
      {
        external_id: '12a34',
        persona_juridica: {
          razon_social: 'Acme S.A.',
          cuit: 30123123235,
          emails: 'contacto@acme.com',
          domicilio: {
            calle: 'Av. Siempreviva',
            altura_domicilio: '742',
            cp: 1425,
            localidad: 'CABALLITO',
            codigo_pais_domicilio: 1,
            codigo_provincia_domicilio: 1
          }
        },
        personas_fisicas: [
          {
            nombres: 'Juan Gabriel',
            apellido: 'Pérez',
            tipo_documento: '6',
            documento: 31232123,
            cuit: 20312321234,
            emails: 'juan.perez@acme.com',
            fecha_nacimiento: '1985-04-12 00:00:00',
            sexo: '1',
            estado_civil: '2',
            nacionalidad: '1',
            lugar_nacimiento: 'ARGENTINA',
            es_pep: 'No',
            domicilio: {
              calle: 'Calle Falsa',
              altura_domicilio: '123',
              cp: 1425,
              localidad: 'CABALLITO',
              codigo_pais_domicilio: 1,
              codigo_provincia_domicilio: 1
            }
          }
        ],
        actividad: ['16'],
        fecha_constitucion: '2002-01-15 00:00:00',
        numero_inscripcion: 1234,
        tipo_registracion_juridica: 1,
        estructura_accionaria: 'Simple',
        grupo_economico: false,
        es_especulativo_oportunista: false,
        pri: 'Riesgo Medio',
        terminos_condiciones: '2026-08-20 14:30:00',
        fecha_psp_apertura_cuenta: '2026-08-20 14:30:00'
      }
    ]
  })
});
const data = await response.json();
console.log(data);

import requests

payload = {
  'cuentas': [
    {
      'external_id': '12a34',
      'persona_juridica': {
        'razon_social': 'Acme S.A.',
        'cuit': 30123123235,
        'emails': 'contacto@acme.com',
        'domicilio': {
          'calle': 'Av. Siempreviva',
          'altura_domicilio': '742',
          'cp': 1425,
          'localidad': 'CABALLITO',
          'codigo_pais_domicilio': 1,
          'codigo_provincia_domicilio': 1
        }
      },
      'personas_fisicas': [
        {
          'nombres': 'Juan Gabriel',
          'apellido': 'Pérez',
          'tipo_documento': '6',
          'documento': 31232123,
          'cuit': 20312321234,
          'emails': 'juan.perez@acme.com',
          'fecha_nacimiento': '1985-04-12 00:00:00',
          'sexo': '1',
          'estado_civil': '2',
          'nacionalidad': '1',
          'lugar_nacimiento': 'ARGENTINA',
          'es_pep': 'No',
          'domicilio': {
            'calle': 'Calle Falsa',
            'altura_domicilio': '123',
            'cp': 1425,
            'localidad': 'CABALLITO',
            'codigo_pais_domicilio': 1,
            'codigo_provincia_domicilio': 1
          }
        }
      ],
      'actividad': ['16'],
      'fecha_constitucion': '2002-01-15 00:00:00',
      'numero_inscripcion': 1234,
      'tipo_registracion_juridica': 1,
      'estructura_accionaria': 'Simple',
      'grupo_economico': False,
      'es_especulativo_oportunista': False,
      'pri': 'Riesgo Medio',
      'terminos_condiciones': '2026-08-20 14:30:00',
      'fecha_psp_apertura_cuenta': '2026-08-20 14:30:00'
    }
  ]
}

response = requests.post(
  'https://b2b.allaria.cloud/v1/aperturas/apertura-cuenta-juridica',
  headers={
    'Authorization': 'Bearer ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  json=payload
)
print(response.json())

const axios = require('axios');

const response = await axios.post(
  'https://b2b.allaria.cloud/v1/aperturas/apertura-cuenta-juridica',
  {
    cuentas: [
      {
        external_id: '12a34',
        persona_juridica: {
          razon_social: 'Acme S.A.',
          cuit: 30123123235,
          emails: 'contacto@acme.com',
          domicilio: {
            calle: 'Av. Siempreviva',
            altura_domicilio: '742',
            cp: 1425,
            localidad: 'CABALLITO',
            codigo_pais_domicilio: 1,
            codigo_provincia_domicilio: 1
          }
        },
        personas_fisicas: [
          {
            nombres: 'Juan Gabriel',
            apellido: 'Pérez',
            tipo_documento: '6',
            documento: 31232123,
            cuit: 20312321234,
            emails: 'juan.perez@acme.com',
            fecha_nacimiento: '1985-04-12 00:00:00',
            sexo: '1',
            estado_civil: '2',
            nacionalidad: '1',
            lugar_nacimiento: 'ARGENTINA',
            es_pep: 'No',
            domicilio: {
              calle: 'Calle Falsa',
              altura_domicilio: '123',
              cp: 1425,
              localidad: 'CABALLITO',
              codigo_pais_domicilio: 1,
              codigo_provincia_domicilio: 1
            }
          }
        ],
        actividad: ['16'],
        fecha_constitucion: '2002-01-15 00:00:00',
        numero_inscripcion: 1234,
        tipo_registracion_juridica: 1,
        estructura_accionaria: 'Simple',
        grupo_economico: false,
        es_especulativo_oportunista: false,
        pri: 'Riesgo Medio',
        terminos_condiciones: '2026-08-20 14:30:00',
        fecha_psp_apertura_cuenta: '2026-08-20 14:30:00'
      }
    ]
  },
  {
    headers: {
      Authorization: 'Bearer ACCESS_TOKEN',
      'Content-Type': 'application/json'
    }
  }
);
console.log(response.data);

2XX Éxito
{
  "data": {
    "total_cuentas": 1,
    "errores": false,
    "ejecutado": "2026-08-20T15:03:54+00:00",
    "renaper": null,
    "repet": null,
    "esco": {
      "30123123235": {
        "error": false,
        "errorMensaje": "",
        "cuenta_creada": true,
        "habilitada": "2026-08-24T15:03:54+00:00"
      }
    }
  }
}

Request​

Headers​

Body​

La entidad​

Personas vinculadas a la entidad​

Riesgo y fechas​

Inversor calificado​

Cuenta e identificadores​

Esquemas auxiliares​

Persona jurídica​

Registro de persona humana​

Domicilio​

Tributación en el exterior​

Response​

2XX Éxito​

Códigos de error​

Ejemplo de código​