Cargar onboarding

Carga los datos del onboarding. Incluye la información de las personas involucradas, las respuestas al cuestionario (obtenidas en Obtener preguntas) y la aceptación de términos y condiciones.

PUT/v1/onboardings/{onboarding_id}

Request

Headers

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

Path Parameters

Campo	Tipo	Requerido	Descripción
onboarding_id	string	Sí	ID del onboarding obtenido al crear el onboarding

No aplica: Query Parameters.

Body

Campo	Tipo	Requerido	Descripción
referrer	string	No	Identificador del referido asociado al onboarding
people	array	Sí	Lista de personas involucradas (mínimo 1)

Campos de cada persona

Campo	Tipo	Requerido	Descripción
accepted_terms_and_conditions_at	string (datetime)	Sí	Fecha y hora de aceptación de T&C en formato ISO 8601
accepted_optional_terms_and_conditions_at	string (datetime) | null	No	Fecha y hora de aceptación de T&C opcionales
questions	array	Sí	Respuestas al cuestionario. Ver Campos del cuestionario
person	object	Sí	Datos de la persona. Ver Persona física o Persona jurídica

Campos del cuestionario

Campo	Tipo	Requerido	Descripción
name	string	Sí	Texto de la pregunta, tal como lo retorna Obtener preguntas
choice	string	Sí	Opción seleccionada

Response

2XX Éxito

Campo	Tipo	Descripción
status	string	Estado del procesamiento. Valores permitidos: PROCESSING, FAILED

Códigos de error

Status	Descripción
401	Unauthorized — token inválido o ausente
403	Forbidden — cliente no autorizado
400	Bad Request — los datos enviados son inválidos
404	Not Found — el onboarding no existe
409	Conflict — el onboarding está en un estado que no permite actualizaciones
422	Validation Error — los parámetros enviados son inválidos
500	Internal Server Error — error interno del servidor

---

Ejemplo de código

cURL (persona física)

curl -X PUT "https://b2b.allaria.cloud/v1/onboardings/ONBOARDING_ID" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "referrer": "referrer-id",
    "people": [
      {
        "accepted_terms_and_conditions_at": "2024-01-15T10:30:00Z",
        "accepted_optional_terms_and_conditions_at": null,
        "questions": [
          { "name": "¿Cuál es el origen de sus fondos?", "choice": "Salario" }
        ],
        "person": {
          "type": "PHYSICAL",
          "tax_type": "CUIT",
          "tax_id": "20304050607",
          "name": "Juan",
          "last_name": "Pérez",
          "email": "juan@ejemplo.com",
          "gender": "MALE",
          "civil_status": "SINGLE",
          "employment_status": "DEPENDENCY_RELATIONSHIP",
          "telephone": "+5491112345678",
          "birth_date": "1990-01-15",
          "citizenship": "Argentina",
          "birth_country": "Argentina",
          "pep": "NONE",
          "is_qualified_investor": false,
          "holder_type": "OWNER",
          "activities": ["Empleado en relación de dependencia"],
          "address": {
            "street": "Av. Corrientes",
            "number": 1234,
            "floor": "3",
            "apartment": "B",
            "zip_code": "1043",
            "city": "Buenos Aires",
            "municipality": "Buenos Aires",
            "state": "CABA",
            "country": "Argentina"
          },
          "identity_document": {
            "type": "DNI",
            "id_number": "30405060",
            "procedure_id": "12345678901",
            "version": "A",
            "creation_date": "2015-01-01",
            "expiration_date": "2025-01-01"
          }
        }
      }
    ]
  }'

cURL (persona jurídica)

curl -X PUT "https://b2b.allaria.cloud/v1/onboardings/ONBOARDING_ID" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "referrer": "referrer-id",
    "people": [
      {
        "accepted_terms_and_conditions_at": "2024-01-15T10:30:00Z",
        "accepted_optional_terms_and_conditions_at": null,
        "questions": [
          { "name": "¿Cuál es el origen de sus fondos?", "choice": "Actividad comercial" }
        ],
        "person": {
          "type": "JURIDICAL",
          "tax_type": "CUIT",
          "tax_id": "30304050607",
          "legal_name": "Empresa S.A.",
          "email": "empresa@ejemplo.com",
          "corporate_type": "SA",
          "registration_number": "123456789",
          "registration_country": "Argentina",
          "registration_province": "CABA",
          "registration_authority": "GENERAL_INSPECTION_OF_JUSTICE",
          "registration_date": "2010-05-20",
          "activities": ["Actividad comercial"],
          "has_joint_signature": false,
          "is_public_entity": false,
          "is_in_economic_group": false,
          "is_complex_structure": false,
          "is_qualified_investor": false,
          "address": {
            "street": "Av. del Libertador",
            "number": 5678,
            "zip_code": "1426",
            "city": "Buenos Aires",
            "state": "CABA",
            "country": "Argentina"
          },
          "representatives": [
            {
              "type": "OWNER",
              "name": "María",
              "last_name": "García",
              "tax_type": "CUIT",
              "tax_id": "27304050607",
              "gender": "FEMALE",
              "birth_date": "1985-03-10T00:00:00Z",
              "civil_status": "MARRIED",
              "citizenship": "Argentina",
              "birth_country": "Argentina",
              "telephone": "+5491187654321",
              "email": "maria@empresa.com",
              "pep": "NONE",
              "activities": ["Dirección y gestión empresarial"],
              "address": {
                "street": "Calle Ejemplo",
                "number": 100,
                "city": "Buenos Aires",
                "state": "CABA",
                "country": "Argentina"
              },
              "identity_document": {
                "type": "DNI",
                "id_number": "28040506",
                "procedure_id": "12345678901",
                "version": "B",
                "creation_date": "2018-06-01",
                "expiration_date": "2028-06-01"
              },
              "accepted_terms_and_conditions_at": "2024-01-15T10:30:00Z"
            }
          ],
          "shareholders": [
            {
              "ownership": 100.0,
              "person": {
                "type": "PHYSICAL",
                "tax_type": "CUIT",
                "tax_id": "27304050607",
                "name": "María",
                "last_name": "García",
                "birth_date": "1985-03-10",
                "citizenship": "Argentina",
                "civil_status": "MARRIED",
                "pep": "NONE",
                "activities": ["Dirección y gestión empresarial"],
                "address": {
                  "street": "Calle Ejemplo",
                  "number": 100,
                  "city": "Buenos Aires",
                  "state": "CABA",
                  "country": "Argentina"
                }
              }
            }
          ]
        }
      }
    ]
  }'

JavaScript

const response = await fetch('https://b2b.allaria.cloud/v1/onboardings/ONBOARDING_ID', {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    referrer: 'referrer-id',
    people: [
      {
        accepted_terms_and_conditions_at: '2024-01-15T10:30:00Z',
        accepted_optional_terms_and_conditions_at: null,
        questions: [
          { name: '¿Cuál es el origen de sus fondos?', choice: 'Salario' }
        ],
        person: {
          type: 'PHYSICAL',
          tax_type: 'CUIT',
          tax_id: '20304050607',
          name: 'Juan',
          last_name: 'Pérez',
          email: 'juan@ejemplo.com',
          gender: 'MALE',
          civil_status: 'SINGLE',
          employment_status: 'DEPENDENCY_RELATIONSHIP',
          telephone: '+5491112345678',
          birth_date: '1990-01-15',
          citizenship: 'Argentina',
          birth_country: 'Argentina',
          pep: 'NONE',
          is_qualified_investor: false,
          holder_type: 'OWNER',
          activities: ['Empleado en relación de dependencia'],
          address: {
            street: 'Av. Corrientes',
            number: 1234,
            floor: '3',
            apartment: 'B',
            zip_code: '1043',
            city: 'Buenos Aires',
            municipality: 'Buenos Aires',
            state: 'CABA',
            country: 'Argentina'
          },
          identity_document: {
            type: 'DNI',
            id_number: '30405060',
            procedure_id: '12345678901',
            version: 'A',
            creation_date: '2015-01-01',
            expiration_date: '2025-01-01'
          }
        }
      }
    ]
  })
});

const data = await response.json();
console.log(data);

Python

import requests

response = requests.put(
  'https://b2b.allaria.cloud/v1/onboardings/ONBOARDING_ID',
  headers={
    'Authorization': 'Bearer ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  json={
    'referrer': 'referrer-id',
    'people': [
      {
        'accepted_terms_and_conditions_at': '2024-01-15T10:30:00Z',
        'accepted_optional_terms_and_conditions_at': None,
        'questions': [
          { 'name': '¿Cuál es el origen de sus fondos?', 'choice': 'Salario' }
        ],
        'person': {
          'type': 'PHYSICAL',
          'tax_type': 'CUIT',
          'tax_id': '20304050607',
          'name': 'Juan',
          'last_name': 'Pérez',
          'email': 'juan@ejemplo.com',
          'gender': 'MALE',
          'civil_status': 'SINGLE',
          'employment_status': 'DEPENDENCY_RELATIONSHIP',
          'telephone': '+5491112345678',
          'birth_date': '1990-01-15',
          'citizenship': 'Argentina',
          'birth_country': 'Argentina',
          'pep': 'NONE',
          'is_qualified_investor': False,
          'holder_type': 'OWNER',
          'activities': ['Empleado en relación de dependencia'],
          'address': {
            'street': 'Av. Corrientes',
            'number': 1234,
            'floor': '3',
            'apartment': 'B',
            'zip_code': '1043',
            'city': 'Buenos Aires',
            'municipality': 'Buenos Aires',
            'state': 'CABA',
            'country': 'Argentina'
          },
          'identity_document': {
            'type': 'DNI',
            'id_number': '30405060',
            'procedure_id': '12345678901',
            'version': 'A',
            'creation_date': '2015-01-01',
            'expiration_date': '2025-01-01'
          }
        }
      }
    ]
  }
)

print(response.json())

Node.js

const axios = require('axios');

const { data } = await axios.put(
  'https://b2b.allaria.cloud/v1/onboardings/ONBOARDING_ID',
  {
    referrer: 'referrer-id',
    people: [
      {
        accepted_terms_and_conditions_at: '2024-01-15T10:30:00Z',
        accepted_optional_terms_and_conditions_at: null,
        questions: [
          { name: '¿Cuál es el origen de sus fondos?', choice: 'Salario' }
        ],
        person: {
          type: 'PHYSICAL',
          tax_type: 'CUIT',
          tax_id: '20304050607',
          name: 'Juan',
          last_name: 'Pérez',
          email: 'juan@ejemplo.com',
          gender: 'MALE',
          civil_status: 'SINGLE',
          employment_status: 'DEPENDENCY_RELATIONSHIP',
          telephone: '+5491112345678',
          birth_date: '1990-01-15',
          citizenship: 'Argentina',
          birth_country: 'Argentina',
          pep: 'NONE',
          is_qualified_investor: false,
          holder_type: 'OWNER',
          activities: ['Empleado en relación de dependencia'],
          address: {
            street: 'Av. Corrientes',
            number: 1234,
            floor: '3',
            apartment: 'B',
            zip_code: '1043',
            city: 'Buenos Aires',
            municipality: 'Buenos Aires',
            state: 'CABA',
            country: 'Argentina'
          },
          identity_document: {
            type: 'DNI',
            id_number: '30405060',
            procedure_id: '12345678901',
            version: 'A',
            creation_date: '2015-01-01',
            expiration_date: '2025-01-01'
          }
        }
      }
    ]
  },
  {
    headers: {
      Authorization: 'Bearer ACCESS_TOKEN',
      'Content-Type': 'application/json'
    }
  }
);

console.log(data);

2XX Éxito

{
  "status": "PROCESSING"
}

Persona física (INDIVIDUAL)

Campos condicionales para personas físicas

Dos campos de esta sección tienen requisitos condicionales:

• pep_details: requerido cuando pep es DIRECT o FAMILY. Debe omitirse o enviarse como null cuando pep es NONE.
• spouse: requerido cuando civil_status es MARRIED. Debe omitirse o enviarse como null para cualquier otro estado civil.

Campo	Tipo	Requerido	Descripción
type	string	Sí	Debe ser PHYSICAL
tax_type	string	Sí	Tipo de identificación tributaria. Valor: CUIT
tax_id	string	Sí	CUIT de la persona. 11 dígitos, prefijo 20, 23, 24 o 27
name	string	Sí	Nombre
last_name	string	Sí	Apellido
email	string	Sí	Email de contacto
gender	string	Sí	Género. Valores permitidos: MALE, FEMALE, OTHER
civil_status	string	Sí	Estado civil. Valores permitidos: SINGLE, MARRIED, DIVORCED, WIDOWED
employment_status	string	Sí	Situación laboral. Ver Situación laboral
telephone	string	Sí	Teléfono en formato internacional. Patrón: ^\+\d{9,19}$ (e.g. +5491112345678)
birth_date	string (date)	Sí	Fecha de nacimiento en formato YYYY-MM-DD
citizenship	string	Sí	Nacionalidad. Usar el campo citizenship retornado por Obtener países
birth_country	string	Sí	País de nacimiento. Usar el campo name retornado por Obtener países
pep	string	Sí	Persona políticamente expuesta. Valores permitidos: DIRECT, FAMILY, NONE
pep_details	string | null	No	Detalle si pep es DIRECT o FAMILY
is_qualified_investor	boolean	Sí	Indica si es inversor calificado
holder_type	string	Sí	Rol en la cuenta. Valores permitidos: OWNER, CO_OWNER. Solo se permite un OWNER por request
activities	array[string]	Sí	Actividades económicas (mínimo 1). Usar el campo name retornado por Obtener actividades con type=PHYSICAL
years_in_activity	string | null	No	Años en actividad. Ver Años en actividad
address	object	Sí	Domicilio. Ver Domicilio
identity_document	object	Sí	Documento de identidad. Ver Documento de identidad
bank_account	object | null	No	Cuenta bancaria. Ver Cuenta bancaria
foreign_tax_detail	object | null	No	Detalle tributario extranjero. Ver Detalle tributario extranjero
spouse	object | null	No	Cónyuge (requerido si civil_status es MARRIED). Ver Cónyuge

---

Persona jurídica (BUSINESS)

Campo	Tipo	Requerido	Descripción
type	string	Sí	Debe ser JURIDICAL
tax_type	string	Sí	Tipo de identificación tributaria. Valor: CUIT
tax_id	string	Sí	CUIT de la empresa. 11 dígitos, prefijo 30, 33 o 34
legal_name	string	Sí	Razón social
email	string	Sí	Email de contacto
corporate_type	string	Sí	Tipo societario. Ver Tipo societario
registration_number	string	Sí	Número de inscripción registral (solo dígitos)
registration_country	string	Sí	País de inscripción. Usar el campo name retornado por Obtener países
registration_province	string	Sí	Provincia de inscripción. Usar el campo name retornado por Obtener provincias
registration_authority	string	Sí	Autoridad de registro. Ver Autoridad de registro
registration_authority_details	string | null	No	Detalle si la autoridad es OTHER
registration_date	string (date)	Sí	Fecha de inscripción en formato YYYY-MM-DD
activities	array[string]	Sí	Actividades económicas (mínimo 1). Usar el campo name retornado por Obtener actividades con type=JURIDICAL
activities_details	string | null	No	Detalle adicional de actividades
has_joint_signature	boolean	Sí	Indica si tiene firma conjunta
is_public_entity	boolean	Sí	Indica si es un ente público
is_in_economic_group	boolean	Sí	Indica si pertenece a un grupo económico
is_complex_structure	boolean	Sí	Indica si tiene estructura compleja
is_qualified_investor	boolean	Sí	Indica si es inversor calificado
address	object	Sí	Domicilio. Ver Domicilio
representatives	array	Sí	Representantes legales (mínimo 1). Ver Representante
shareholders	array	No	Accionistas. Ver Accionista
bank_account	object | null	No	Cuenta bancaria. Ver Cuenta bancaria
foreign_tax_detail	object | null	No	Detalle tributario extranjero. Ver Detalle tributario extranjero

---

Schemas auxiliares

Domicilio

Campo	Tipo	Requerido	Descripción
street	string	Sí	Nombre de la calle
number	integer | null	No	Número de la puerta
floor	string | null	No	Piso
apartment	string | null	No	Departamento
zip_code	string | null	No	Código postal
city	string	Sí	Ciudad
municipality	string | null	No	Municipio
state	string	Sí	Provincia. Usar el campo name retornado por Obtener provincias
country	string	Sí	País. Usar el campo name retornado por Obtener países

Documento de identidad

Campo	Tipo	Requerido	Descripción
type	string	Sí	Tipo de documento. Valor: DNI
id_number	string	Sí	Número de DNI. Exactamente 8 dígitos (^\d{8}$)
procedure_id	string	Sí	Número de trámite del DNI. Exactamente 11 dígitos (^\d{11}$)
version	string	Sí	Versión del DNI. 1 letra (^[A-Za-z]$)
creation_date	string (date)	Sí	Fecha de emisión en formato YYYY-MM-DD
expiration_date	string (date)	Sí	Fecha de vencimiento en formato YYYY-MM-DD

Cuenta bancaria

Campo	Tipo	Requerido	Descripción
cxu	string	Sí	CVU/CBU de 22 dígitos (^\d{22}$)

Detalle tributario extranjero

Campo	Tipo	Requerido	Descripción
id_number	string	Sí	Número de identificación tributaria extranjera
foreign_address	object	Sí	Domicilio en el extranjero. Mismos campos que Domicilio

Cónyuge

Campo	Tipo	Requerido	Descripción
tax_type	string	Sí	Valor: CUIT
tax_id	string	Sí	CUIT del cónyuge. 11 dígitos, prefijo 20, 23, 24 o 27
name	string	Sí	Nombre
last_name	string	Sí	Apellido

Representante

Campos condicionales del representante

Dos campos de esta sección tienen requisitos condicionales:

• pep_details: requerido cuando pep es DIRECT o FAMILY. Debe omitirse o enviarse como null cuando pep es NONE.
• spouse: requerido cuando civil_status es MARRIED. Debe omitirse o enviarse como null para cualquier otro estado civil.

Campo	Tipo	Requerido	Descripción
type	string	Sí	Rol del representante. Valores permitidos: OWNER, ADMIN
tax_type	string	Sí	Tipo de identificación tributaria. Valor: CUIT
tax_id	string	Sí	CUIT de la persona. 11 dígitos, prefijo 20, 23, 24 o 27
name	string	Sí	Nombre
last_name	string	Sí	Apellido
email	string	Sí	Email de contacto
gender	string	Sí	Género. Valores permitidos: MALE, FEMALE, OTHER
civil_status	string	Sí	Estado civil. Valores permitidos: SINGLE, MARRIED, DIVORCED, WIDOWED
employment_status	string	Sí	Situación laboral. Ver Situación laboral
telephone	string	Sí	Teléfono en formato internacional. Patrón: ^\+\d{9,19}$ (e.g. +5491112345678)
birth_date	string (datetime)	Sí	Fecha de nacimiento en formato ISO 8601 con hora (YYYY-MM-DDTHH:MM:SSZ)
citizenship	string	Sí	Nacionalidad. Usar el campo citizenship retornado por Obtener países
birth_country	string	Sí	País de nacimiento. Usar el campo name retornado por Obtener países
pep	string	Sí	Persona políticamente expuesta. Valores permitidos: DIRECT, FAMILY, NONE
pep_details	string | null	No	Detalle si pep es DIRECT o FAMILY
is_qualified_investor	boolean	Sí	Indica si es inversor calificado
activities	array[string]	Sí	Actividades económicas (mínimo 1). Usar el campo name retornado por Obtener actividades con type=PHYSICAL
years_in_activity	string | null	No	Años en actividad. Ver Años en actividad
address	object	Sí	Domicilio. Ver Domicilio
identity_document	object	Sí	Documento de identidad. Ver Documento de identidad
bank_account	object | null	No	Cuenta bancaria. Ver Cuenta bancaria
foreign_tax_detail	object | null	No	Detalle tributario extranjero. Ver Detalle tributario extranjero
spouse	object | null	No	Cónyuge (requerido si civil_status es MARRIED). Ver Cónyuge
accepted_terms_and_conditions_at	string (datetime)	Sí	Fecha y hora de aceptación de T&C
accepted_optional_terms_and_conditions_at	string (datetime) | null	No	Fecha y hora de aceptación de T&C opcionales
iva_tax_payer	string | null	No	Condición ante el IVA. Valores permitidos: REGISTERED_RESPONSIBLE, EXEMPT, MONOTAX, END_CONSUMER

Accionista

Campo	Tipo	Requerido	Descripción
ownership	number	Sí	Porcentaje de participación (0–100)
person	object	Sí	Persona accionista. Puede ser física (type: "PHYSICAL") o jurídica (type: "JURIDICAL"). Ver campos a continuación

Accionista — Persona física

Campos condicionales

• pep_details: requerido cuando pep es DIRECT o FAMILY. Debe omitirse o enviarse como null cuando pep es NONE.
• spouse: requerido cuando civil_status es MARRIED. Debe omitirse o enviarse como null para cualquier otro estado civil.

Campo	Tipo	Requerido	Descripción
type	string	Sí	Debe ser PHYSICAL
name	string	Sí	Nombre
last_name	string	Sí	Apellido
tax_type	string	Sí	Tipo de identificación tributaria. Valor: CUIT
tax_id	string	Sí	CUIT de la persona. 11 dígitos, prefijo 20, 23, 24 o 27
birth_date	string (date)	Sí	Fecha de nacimiento en formato YYYY-MM-DD
citizenship	string	Sí	Nacionalidad. Usar el campo citizenship retornado por Obtener países
civil_status	string	Sí	Estado civil. Valores permitidos: SINGLE, MARRIED, DIVORCED, WIDOWED
spouse	object | null	No	Cónyuge (requerido si civil_status es MARRIED). Ver Cónyuge
pep	string	Sí	Persona políticamente expuesta. Valores permitidos: DIRECT, FAMILY, NONE
pep_details	string | null	No	Detalle si pep es DIRECT o FAMILY
address	object	Sí	Domicilio. Ver Domicilio
activities	array[string]	Sí	Actividades económicas (mínimo 1). Usar el campo name retornado por Obtener actividades con type=PHYSICAL
foreign_tax_detail	object | null	No	Detalle tributario extranjero. Ver Detalle tributario extranjero

Accionista — Persona jurídica

Campo	Tipo	Requerido	Descripción
type	string	Sí	Debe ser JURIDICAL
tax_type	string	Sí	Tipo de identificación tributaria. Valor: CUIT
tax_id	string	Sí	CUIT de la empresa. 11 dígitos, prefijo 30, 33 o 34
legal_name	string	Sí	Razón social
activities	array[string]	Sí	Actividades económicas (mínimo 1). Usar el campo name retornado por Obtener actividades con type=JURIDICAL
foreign_tax_detail	object | null	No	Detalle tributario extranjero. Ver Detalle tributario extranjero

---

Enums de referencia

Situación laboral

Valor	Descripción
DEPENDENCY_RELATIONSHIP	Relación de dependencia
STUDENT	Estudiante
INDEPENDENT	Independiente
MONOTAX	Monotributista
AUTONOMOUS	Autónomo
RETIRED	Jubilado/Pensionado
UNEMPLOYED	Desempleado

Años en actividad

Valor	Descripción
LESS_THAN_A_YEAR	Menos de un año
ONE_YEAR	1 año
TWO_YEARS	2 años
THREE_YEARS	3 años
FOUR_YEARS	4 años
FIVE_YEARS	5 años
SIX_YEARS	6 años
SEVEN_YEARS	7 años
EIGHT_YEARS	8 años
NINE_YEARS	9 años
TEN_OR_MORE_YEARS	10 años o más

Tipo societario

Valor	Descripción
SA	Sociedad Anónima
SRL	Sociedad de Responsabilidad Limitada
SAS	Sociedad por Acciones Simplificada
COOP	Cooperativa
CONS	Consorcio
FID	Fideicomiso
GOB	Entidad gubernamental
SGR	Sociedad de Garantía Recíproca
OTHER	Otro

Autoridad de registro

Valor	Descripción
GENERAL_INSPECTION_OF_JUSTICE	Inspección General de Justicia (IGJ)
DIRECTORATE_OF_LEGAL_ENTITIES	Dirección de Personas Jurídicas
OTHER	Otro

---

Validaciones

Onboarding individual

Unicidad entre personas

Las siguientes reglas de unicidad aplican entre la persona física principal y todos los co-titulares del request:

Regla	Descripción
tax_type + tax_id únicos	No puede haber dos personas con el mismo par de identificación tributaria
id_number único	No puede haber dos personas con el mismo número de documento
email único	No puede haber dos personas con el mismo email

Reglas de campos — Persona física

Aplica a la persona física principal y a cada co-titular individualmente.

Campo	Regla
pep + pep_details	Si pep es DIRECT o FAMILY → pep_details es obligatorio. Si pep es NONE → pep_details debe ser null
civil_status + spouse	Si civil_status es MARRIED → spouse es obligatorio. Cualquier otro estado civil → spouse debe omitirse o ser null
spouse.tax_id	No puede ser igual al tax_id de la persona que declara el cónyuge
years_in_activity	Obligatorio si employment_status es INDEPENDENT, MONOTAX, AUTONOMOUS o DEPENDENCY_RELATIONSHIP. Debe omitirse o ser null si employment_status es STUDENT, RETIRED o UNEMPLOYED

Actividades por situación laboral

Los valores permitidos para activities dependen de employment_status:

employment_status	Actividades permitidas
DEPENDENCY_RELATIONSHIP	Empleado/Apoderado, Empleado Público, Diplomático/Funcionario Público, Docente, Policía/Militar/otras Fuerzas de Seguridad
RETIRED	Jubilado/a y/o Pensionado/a
UNEMPLOYED	Desocupado, Ama de Casa
STUDENT, INDEPENDENT, MONOTAX, AUTONOMOUS	Cualquier actividad retornada por Obtener actividades

Validaciones contra base de datos

Aplicadas a la persona física y a cada co-titular individualmente:

Verificación	Regla
Unicidad de documento	El id_number (DNI) no puede estar registrado en el sistema para otro tax_id distinto
Unicidad de email	El email no puede existir en el sistema asociado a un documento diferente al enviado

Documentos requeridos

Aplica individualmente a la persona física y a cada co-titular:

Documento	Requerido
DNI_FRONT	Sí
DNI_BACK	Sí
WORTH_STATEMENT	No (opcional)

---

Onboarding empresarial

Reglas de campos — Persona jurídica

Campo	Regla
registration_authority_details	Obligatorio si registration_authority es OTHER. Debe omitirse o ser null si registration_authority es GENERAL_INSPECTION_OF_JUSTICE o DIRECTORATE_OF_LEGAL_ENTITIES

Estructura de representantes

Regla	Detalle
Exactamente 1 OWNER	Debe haber exactamente un representante con type: OWNER — ni cero ni más de uno
ADMIN sin firma conjunta	Si has_joint_signature es false, no se permiten representantes ADMIN
ADMIN con firma conjunta	Si has_joint_signature es true, mínimo 1 y máximo 2 representantes ADMIN
JOINT_SIGNATURE sin firma conjunta	Si has_joint_signature es false, ningún representante puede tener signature_type: JOINT_SIGNATURE
Mayoría de edad	Ningún representante puede ser menor de edad
Unicidad	Sin duplicados de tax_type + tax_id, id_number (DNI), número de pasaporte ni email entre representantes

Accionistas

Regla	Detalle
Tipos societarios permitidos	SA, SAS, SRL, OTHER admiten accionistas. COOP, CONS, FID, GOB, SGR no admiten accionistas — enviarlos resultará en error
Unicidad	Sin duplicados de tax_type + tax_id entre accionistas
tax_id del accionista	No puede ser igual al tax_id de la persona jurídica

Reglas de campos — Representantes

Cada representante está sujeto a las mismas validaciones de campos que la persona física en el onboarding individual: pep + pep_details, years_in_activity, spouse, y actividades según employment_status.

Validaciones contra base de datos

Aplicadas a cada representante nacional:

Verificación	Regla
Unicidad de email	El email no puede existir en el sistema asociado a un documento diferente al enviado
Unicidad de documento	El id_number (DNI) no puede estar registrado en el sistema para otro tax_id distinto

Documentos requeridos

Por representante:

Documento	Requerido
DNI_FRONT	Sí
DNI_BACK	Sí

Por persona jurídica — según corporate_type:

corporate_type	Documentos requeridos
SA	BALANCE, SHARES_REGISTER, STATUTE, AUTHORITIES (+ SHAREHOLDERS_NOTE si hay accionistas persona jurídica)
SAS	BALANCE, STATUTE (+ SHAREHOLDERS_NOTE si hay accionistas persona jurídica)
SRL	BALANCE, STATUTE (+ SHAREHOLDERS_NOTE si hay accionistas persona jurídica)
OTHER	STATUTE, AUTHORITIES, WORTH_STATEMENT (+ SHAREHOLDERS_NOTE si hay accionistas persona jurídica)
COOP	BALANCE, STATUTE, AUTHORITIES, MEMBERS_NOTE
CONS	BALANCE, HORIZONTAL_PROPERTY_REGULATIONS, AUTHORITIES, EXPENSE_LIQUIDATION, CO_OWNER_LIST
FID	BALANCE, TRUST_NOTE, TRUST_CONSTITUTION_CONTRACT
GOB	BALANCE, STATUTE, AUTHORITIES
SGR	BALANCE, STATUTE, AUTHORITIES, PARTNERS_NOTE, PARTNERS_LIST