Crear cuenta comitente

cuentaId int — REQUERIDO
Identificador de la cuenta para la cual se quiere crear la cuenta comitente.

cuentaRemuneradaActiva boolean — REQUERIDO
Indica si la funcionalidad de cuenta remunerada para esta cuenta debe estar activada o no.

cuentaComitente object — REQUERIDO
Objeto con la información requerida para dar de alta la cuenta comitente en el broker.

cuentaComitente.persona object — REQUERIDO
Objeto que agrupa los datos de la persona titular de la cuenta comitente.

cuentaComitente.persona.personaFisica boolean — REQUERIDO
Indica si el titular es una persona física. En caso de ser falso, se procesará como persona jurídica.

cuentaComitente.persona.nombre string — REQUERIDO
Nombres del titular.
Permite un máximo de 80 caracteres. No acepta números ni caracteres especiales.
Ejemplos permitidos: "Luciana Agostina"
Ejemplos no permitidos: "Luciana Agostina 1234", "Luciana Agostina !%&/" Código de error: INVALID_NAME

cuentaComitente.persona.apellido string — REQUERIDO
Apellidos del titular.
Permite un máximo de 80 caracteres. No acepta números ni caracteres especiales.
Ejemplos permitidos: "Rudaz", "Agüero"
Ejemplos no permitidos: "Rudaz 1234", "Rudaz !%&/"
Código de error: INVALID_LASTNAME

cuentaComitente.persona.nacionalidad string — REQUERIDO
Nacionalidad de la persona. Requiere el código de dos letras según el estándar ISO 3166-1 alfa-2. No posee validaciones restrictivas de país.
Ejemplos permitidos: "AR", "BR", "ZM"

cuentaComitente.persona.paisResidencia string — OPCIONAL
País de residencia de la persona. Requiere el código de dos letras según el estándar ISO 3166-1 alfa-2. No posee validaciones restrictivas de país.
Ejemplos permitidos: "AR", "BR", "ZM"

cuentaComitente.persona.tipoIdentificacion string — REQUERIDO Tipo de documento de identidad de la persona. El sistema está diseñado exclusivamente para documentos de identidad tradicionales.
Valor fijo: "DNI"
Código de error: INVALID_IDENTIFICATION_TYPE

cuentaComitente.persona.identificacion string — REQUERIDO
Número de documento de identidad de la persona. Debe corresponder a un formato numérico de documento nacional válido. No admite strings vacíos ni letras.
Ejemplos permitidos: "41355086"
Ejemplos no permitidos: "asd", " ", "27413550861" (formato CUIT)
Código de error: INVALID_IDENTIFICATION

cuentaComitente.persona.paisIdentificacion string — REQUERIDO
País de emisión del documento de identidad. Requiere el código de dos letras según el estándar ISO 3166-1 alfa-2.
Ejemplos permitidos: "AR", "BR", "ZM"

cuentaComitente.persona.estadoCivil string — OPCIONAL
Estado civil del titular de la cuenta. No admite valores nulos o vacíos si el campo es enviado.
Valores posibles: "SINGLE", "WIDOWED", "MARRIED", "DIVORCED", "CONCUBINAGE", "OTHER"
Código de error: INVALID_MARIAL_STATE_TYPE (para strings incorrectos) o HTTP 400 (para null / "")

cuentaComitente.persona.fechaNacimiento string — REQUERIDO
(Formato ISO-8601 YYYY-MM-DD) Fecha de nacimiento de la persona. El sistema valida de manera estricta que el usuario sea mayor de edad al momento del alta.
Ejemplos permitidos: "2000-01-12"
Ejemplos no permitidos: Fechas de menores de edad, "1234", "2025-01-32" (fecha inválida)
Código de error: PERSON_IS_NOT_LEGAL_AGE (menor de edad) o GENERAL_ERROR (formato incorrecto)

cuentaComitente.persona.lugarNacimiento string — REQUERIDO
País de nacimiento de la persona en formato de código de dos letras ISO 3166-1 alfa-2.
Ejemplos permitidos: "AR", "BR", "ZM"

cuentaComitente.persona.genero string — REQUERIDO
Género autopercibido de la persona conforme a las opciones del sistema externo.
Valores posibles: "M" (Masculino), "F" (Femenino)
Código de error: INVALID_GENDER_TYPE

cuentaComitente.persona.informacionFiscal object — REQUERIDO
Objeto que contiene las condiciones impositivas, declaraciones juradas y datos fiscales del usuario ante los organismos de control.

cuentaComitente.persona.informacionFiscal.tipo string — REQUERIDO
Tipo de clave de identificación fiscal utilizada en el territorio nacional.
Valor fijo: "CUIT"

cuentaComitente.persona.informacionFiscal.numero string — REQUERIDO
Número de identificación fiscal (CUIT/CUIL) de la persona, enviado como un string continuo de 11 dígitos sin guiones ni espacios.

cuentaComitente.persona.informacionFiscal.actividadComercial string — REQUERIDO
Código numérico de la actividad económica del usuario regulada por ARCA (ex AFIP). Debe tener exactamente 6 caracteres. Si el usuario trabaja en relación de dependencia o no cuenta con una actividad comercial independiente, se deben enviar los códigos genéricos de ocupación del sistema de 1 o 2 dígitos. No acepta campos vacíos ni nulos.
Ejemplos permitidos (códigos especiales de ocupación): "7" (Jubilado), "8" (Estudiante), "9" (Ama de casa), "10" (Ex-Agente de la Adm. Pública), "11" (Trabajo en Relación de Dependencia), "12" (Sin Actividad Económica), "13" (Agricultura Familiar).
Ejemplos permitidos (actividades ARCA): "939030", "011111".
Ejemplos no permitidos: null, "", "123" (longitud errónea), "000011" (rellenado con ceros).
Código de error: REQUIRED_FIELD_WITH_NULL_VALUE (para nulos/vacíos) o INVALID_BUSINESS_ACTVITY (formatos incorrectos)

cuentaComitente.persona.informacionFiscal.pep object — REQUERIDO
Objeto con la declaración jurada sobre la condición de Persona Expuesta Políticamente (PEP).

cuentaComitente.persona.informacionFiscal.pep.esPep boolean — REQUERIDO
Flag que determina si la persona es considerada políticamente expuesta.

cuentaComitente.persona.informacionFiscal.pep.descripcion string — REQUERIDO
Especificación del cargo o motivo por el cual es considerado PEP (ej: "Gobernador"). Si el flag esPep es falso, permite el envío de un string vacío o con espacios, pero rechazará valores nulos.
Ejemplos permitidos: "Gobernador", "", " "
Ejemplos no permitidos: null Código de error: HTTP 400

cuentaComitente.persona.informacionFiscal.inscripcionIngresos object — REQUERIDO
Objeto que detalla la condición del usuario frente al impuesto a las ganancias.

cuentaComitente.persona.informacionFiscal.inscripcionIngresos.tipo string — REQUERIDO
Categoría de inscripción impositiva de la persona. No admite nulos ni vacíos.
Valores posibles: "EXE" (Exento), "INS" (Inscripto), "NOINS" (No inscripto)
Código de error: HTTP 400

cuentaComitente.persona.informacionFiscal.inscripcionIngresos.fecha string — REQUERIDO
(Formato YYYY-MM-DD) Fecha de alta en el impuesto a las ganancias. Si el tipo de inscripción seleccionado es "INS", es obligatorio declarar una fecha válida para evitar bloqueos operativos posteriores en la cuenta comitente. Admite string vacío, pero prohíbe valores nulos.
Ejemplos permitidos: "2025-07-01", ""
Ejemplos no permitidos: null
Código de error: HTTP 400

cuentaComitente.persona.informacionFiscal.condicionIva string — REQUERIDO
Condición de la persona frente al Impuesto al Valor Agregrado (IVA). No admite valores nulos ni vacíos.
Valores posibles: "RI" (Responsable Inscripto), "RNI" (Responsable No Inscripto), "EX" (Exento), "RM" (Responsable Monotributista), "CF" (Consumidor Final)
Código de error: HTTP 400 (para nulos) o INVALID_IVA_CONDITION_TYPE (para strings inválidos como "ASD")

cuentaComitente.persona.informacionFiscal.paisResidenciaFiscal string — REQUERIDO
País de residencia donde el usuario tributa sus obligaciones principales.
Código de dos letras ISO 3166-1 alfa-2.
Ejemplos permitidos: "AR", "BR", "ZM"

cuentaComitente.persona.informacionFiscal.fatca object — REQUERIDO
Objeto que contiene la información vinculada al cumplimiento de la normativa fiscal estadounidense Foreign Account Tax Compliance Act (FATCA).

cuentaComitente.persona.informacionFiscal.fatca.esFatca boolean — REQUERIDO
Flag que determina si el usuario aplica dentro de las condiciones de reporte de la ley FATCA.

cuentaComitente.persona.informacionFiscal.fatca.ssn string — REQUERIDO
Número de Seguro Social (SSN) o número de identificación fiscal de EE. UU. en caso de corresponder. Si el flag esFatca es falso, se permite enviar un string vacío, pero no se acepta un valor nulo.
Ejemplos permitidos: "12345", ""
Ejemplos no permitidos: null
Código de error: HTTP 400

cuentaComitente.persona.informacionFiscal.ocde object — REQUERIDO
Objeto que agrupa la información sobre la residencia fiscal del usuario bajo los lineamientos del Estándar Común de Reporte (CRS) de la OCDE.

cuentaComitente.persona.informacionFiscal.ocde.esOcde boolean — REQUERIDO
Flag que determina si la persona declara obligaciones impositivas en países firmantes del convenio de la OCDE externos a su residencia principal.

cuentaComitente.persona.informacionFiscal.ocde.paisResidenciaFiscalPrincipal string — REQUERIDO
Código de dos letras ISO 3166-1 alfa-2 del país de residencia fiscal CRS principal. Admite ser enviado como un string vacío o nulo si la condición no aplica.
Ejemplos permitidos: "AR", "", null

cuentaComitente.persona.informacionFiscal.ocde.nitPrincipal string — REQUERIDO
Número de Identificación Tributaria (NIT) correspondiente al país fiscal principal. Admite valores vacíos o nulos si no aplica.
Ejemplos permitidos: "1234", "", null

cuentaComitente.persona.informacionFiscal.ocde.paisResidenciaFiscalOpcional string — REQUERIDO
Código de dos letras ISO 3166-1 alfa-2 del país de residencia fiscal secundario u opcional.
Admite valores vacíos o nulos.
Ejemplos permitidos: "BR", "", null

cuentaComitente.persona.informacionFiscal.ocde.nitOpcional string — REQUERIDO
Número de Identificación Tributaria (NIT) secundario u opcional. Admite valores vacíos o nulos.
Ejemplos permitidos: "5678", "", null

cuentaComitente.persona.informacionFiscal.sujetosObligados object — REQUERIDO
Objeto con la declaración jurada sobre el estado de la persona ante la Unidad de Información Financiera (UIF).

cuentaComitente.persona.informacionFiscal.sujetosObligados.esSujetoObligado boolean — REQUERIDO
Flag explicativo que determina si el usuario es considerado un Sujeto Obligado ante la UIF de acuerdo con la normativa vigente de prevención de lavado de activos.

cuentaComitente.persona.informacionFiscal.sujetosObligados.tipo string — REQUERIDO
Clasificación o subtipo de sujeto obligado del usuario. Permite el envío de campos nulos o strings vacíos si el usuario no encuadra en la norma.
Ejemplos permitidos: "1234", "", null

cuentaComitente.persona.informacionFiscal.sujetosObligados.fechaCreacion string — REQUERIDO
Fecha de designación o inscripción en el registro de la UIF. Campo informativo que permite valores nulos o vacíos.
Ejemplos permitidos: "2024-05-10", "", null

cuentaComitente.direccion object — REQUERIDO
Objeto con la información estructurada del domicilio del titular.

cuentaComitente.direccion.tipo string — REQUERIDO
Propósito o categoría del domicilio proporcionado. No acepta strings vacíos ni valores nulos.
Valores posibles: "LEGAL", "HOME", "WORK"
Código de error: INVALID_ADDRESS_TYPE

cuentaComitente.direccion.calle string — REQUERIDO
Nombre de la arteria vial, calle o ruta del domicilio. Soporta letras, números, espacios, puntos (".") y acentos. No admite guiones ("-") ni diéresis ("ü").
Ejemplos permitidos: "San Martín", "Gral. San Martín", "RUTA 12"
Ejemplos no permitidos: "Agüero" (por la ü), "Gral - San Martin" (por el guion)
Código de error: INVALID_STREET_CHARACTERS

cuentaComitente.direccion.numero string — REQUERIDO
Numeración de la vivienda o edificio del domicilio. Admite caracteres alfanuméricos (letras y números). Posee una restricción estricta de longitud de hasta un máximo de 5 caracteres. No se permite enviar un valor nulo o vacío.
Ejemplos permitidos: "12345", "ABC"
Ejemplos no permitidos: "-", "123456" (supera el límite de longitud), null, ""
Código de error: INVALID_NUMBER_LENGTH

cuentaComitente.direccion.piso string — REQUERIDO
Número de piso del domicilio. Permite caracteres alfanuméricos. No admite caracteres especiales ni espacios intermedios. Su longitud máxima permitida es de 5 caracteres. Es un campo opcional en su lógica de negocio por lo que se pueden enviar strings vacíos o nulos.
Ejemplos permitidos: "1", "piso1", "", null
Ejemplos no permitidos: "P 1" (contiene espacio), "AC-13" (contiene guion), "$$$"
Código de error: INVALID_FLOOR_LENGTH

cuentaComitente.direccion.departamento string — REQUERIDO
Identificador de la oficina, departamento o unidad del domicilio. Permite caracteres alfanuméricos sin espacios intermedios ni caracteres especiales. Posee una longitud máxima de 5 caracteres. Admite strings vacíos o nulos si no aplica.
Ejemplos permitidos: "B", "depto1", "", null
Ejemplos no permitidos: "D 2", "AC-13", "$$$"
Código de error: INVALID_APARTMENT_LENGTH

cuentaComitente.direccion.bloque string — REQUERIDO
Identificador del bloque de la edificación del domicilio. Sigue las mismas reglas que piso y departamento: caracteres alfanuméricos, longitud máxima de 5 caracteres, sin espacios ni caracteres especiales. Admite vacíos y nulos.
Ejemplos permitidos: "3", "blqA", "", null
Ejemplos no permitidos: "B 1", "BL-1", "$$$"
Código de error: INVALID_BLOQUE_LENGTH

cuentaComitente.direccion.sector string — REQUERIDO
Sector del barrio o complejo habitacional del domicilio. Máximo 5 caracteres alfanuméricos sin espacios ni caracteres especiales. Admite vacíos y nulos.
Ejemplos permitidos: "A", "sec1", "", null
Ejemplos no permitidos: "S 1", "S-1", "$$$"
Código de error: INVALID_SECTOR_LENGTH

cuentaComitente.direccion.torre string — REQUERIDO
Identificador de la torre dentro de un complejo habitacional. Máximo 5 caracteres alfanuméricos sin espacios ni caracteres especiales. Admite vacíos y nulos.
Ejemplos permitidos: "Torre1", "A", "", null
Ejemplos no permitidos: "T 1", "T-1", "$$$"
Código de error: INVALID_TOWER_LENGTH

cuentaComitente.direccion.codigoPostal string — REQUERIDO
Código postal de la localización del domicilio. Se valida bajo los formatos oficiales de la República Argentina: el formato tradicional numérico de 4 dígitos (CP) o el Código Postal Argentino alfanumérico de 8 caracteres (CPA). Prohíbe nulos, vacíos y longitudes intermedias incorrectas.
Ejemplos permitidos: "1407", "C1407PO"
Ejemplos no permitidos: null, "", "14077", "CP1402OP"
Código de error: INVALID_ZIP_CODE

cuentaComitente.direccion.pais string — REQUERIDO
Código de dos letras ISO 3166-1 alfa-2 que identifica al país de localización de la vivienda. No restringe el listado a países específicos en la etapa de validación estructural.
Ejemplos permitidos: "AR", "BR", "ZM"

cuentaComitente.direccion.provincia string — REQUERIDO
Identificador de la provincia del domicilio del titular. El validador en producción acepta cualquier string, incluyendo nulos y vacíos, pero se aconseja seguir el estándar internacional de códigos ISO para provincias argentinas.
Ejemplos permitidos: "AR-C", "", null

cuentaComitente.direccion.localidad string — REQUERIDO
Denominación de la ciudad o localidad del domicilio. Admite caracteres alfanuméricos, espacios, acentos y puntos. Rechaza de forma estricta guiones ("-") o diéresis ("ü").
Ejemplos permitidos: "San Martín", "Gral. San Martín", "RUTA 12"
Ejemplos no permitidos: "Agüero", "Gral - San martin"
Código de error: INVALID_LOCALITY_CHARACTERS

cuentaComitente.contacto object — REQUERIDO
Objeto que agrupa los canales de comunicación y contacto directo con la persona titular.

cuentaComitente.contacto.codigoArea string — REQUERIDO
Código de área interurbano de la línea telefónica sin el prefijo de acceso a larga distancia (0). Solo permite caracteres numéricos y debe corresponder a un código geográfico de área válido de la red telefónica nacional. No acepta nulos ni vacíos.
Ejemplos permitidos: "11", "221", "351"
Ejemplos no permitidos: "12345" (código inexistente), null, ""
Código de error: INVALID_AREA_CODE_PHONE (para códigos inválidos) o REQUIRED_FIELD_WITH_NULL_VALUE (para nulos/vacíos)

cuentaComitente.contacto.correoElectronico string — REQUERIDO
Dirección de correo electrónico del usuario. Valida sintácticamente que contenga un formato de email válido (usuario@dominio.extension). No se admiten valores nulos ni strings vacíos.
Ejemplos permitidos: "hola@gmail.com"
Ejemplos no permitidos: "asd@asd.com.ar" (si falla la estructura interna del proveedor), null, ""
Código de error: INVALID_EMAIL o REQUIRED_FIELD_WITH_NULL_VALUE

cuentaComitente.contacto.telefono string — REQUERIDO
Número de teléfono celular o fijo de la persona (sin el código de área, ni el prefijo celular 15). Admite números, letras y algunos caracteres especiales de separación. Permite una extensión de longitud de hasta un máximo de 10 caracteres. No puede enviarse nulo o vacío.
Ejemplos permitidos: "6855673322", "AB55673322", "68-5673322"
Ejemplos no permitidos: "68556733222" (supera los 10 caracteres), null, ""
Código de error: INVALID_PHONE_NUMBER o REQUIRED_FIELD_WITH_NULL_VALUE

cuentaComitente.documentos array — REQUERIDO
Listado indexado de objetos que contienen las imágenes digitalizadas de la documentación respaldatoria de la persona para los procesos de validación de identidad KYC (Know Your Customer). Para nuestro caso sólo enviar el frente del DNI

cuentaComitente.documentos[].tipo string — REQUERIDO
Tipo de pieza documental que se adjunta en el objeto del arreglo.
Valores posibles: "FRONT_DNI" (Foto del frente del DNI).

cuentaComitente.documentos[].descripcion string — REQUERIDO Breve descripción o etiqueta aclaratoria sobre el documento adjunto.

cuentaComitente.documentos[].nombreArchivo string — REQUERIDO
Nombre físico asignado al archivo de la imagen.

cuentaComitente.documentos[].extension string — REQUERIDO
Extensión o formato de compresión del archivo de la imagen (ej: "jpg", "png").

cuentaComitente.documentos[].verificado boolean — REQUERIDO
Flag lógico que determina si el documento fue pre-procesado y aprobado por sistemas internos de la organización antes de su envío.

cuentaComitente.documentos[].archivo object — REQUERIDO
Objeto contenedor del flujo de datos de la imagen del documento. Permite realizar la transferencia mediante un enlace de descarga o mediante la carga directa del binario.

cuentaComitente.documentos[].archivo.url string — OPCIONAL
Dirección URL remota y pública donde el broker puede realizar la descarga directa de la imagen del documento.

cuentaComitente.documentos[].archivo.base64 string — OPCIONAL
Cadena de texto con la imagen codificada en formato Base64. Utilizar cuando no se dispone de una URL de almacenamiento externa.

cuentaComitente.verificacionIdentidad string — OPCIONAL
Identificador único unívoco (ID) generado por la plataforma de validación biométrica o validación de rostro de la propia entidad, que certifica que el usuario superó los controles de vivacidad y su identidad coincide con el DNI proporcionado. Admite caracteres alfanuméricos y especiales. No se permite el envío de strings vacíos o campos nulos.
Ejemplos permitidos: "123", "ABC123", "ABC$123"
Ejemplos no permitidos: null, ""
Código de error: 400 (para nulos) o REQUIRED_FIELD_WITH_NULL_VALUE (para vacíos)

cuentaComitente.bancos object — REQUERIDO
Objeto que detalla la información de la cuenta bancaria o virtual de origen vinculada a la persona, utilizada para fondear o retirar el capital de la cuenta comitente.

cuentaComitente.bancos.tipo string — REQUERIDO
Naturaleza de la cuenta financiera declarada.
Valor fijo: "CVU"

cuentaComitente.bancos.identificacion string — REQUERIDO
Clave Virtual Uniforme (número de 22 dígitos del CVU) asociada a la cuenta virtual del usuario en la plataforma de origen, sobre la cual se registran los movimientos de saldos.