Insert Persons

Time	Status	User Agent
Retrieving recent requests…

Crea una o más personas y obtén el person_id que luego usarás para vincular cuentas comitentes.

triangle-exclamation
Este endpoint quedará inhabilitado. Usá POST /api/accounts/v2/persons para nuevas integraciones.

Antes de empezar

Reuní los códigos de catálogos que correspondan, como actividad AFIP, país, tipo de documento, estado civil y provincia.
Armá el arreglo persons con entre 1 y 10 registros.
Incluí human_person para una persona humana o legal_person para una persona jurídica.
Guardá el person_id de la respuesta para usarlo más adelante al crear una cuenta comitente.

Qué envía este endpoint

El body acepta un objeto PersonsInput con un único campo requerido: persons.

Campo	Tipo	Requerido	Restricciones	Descripción
`persons`	array de objetos	Sí	mínimo `1`, máximo `10`	Lista de personas a crear en una sola solicitud.

Estructura de cada objeto `person`

Campo	Tipo	Requerido	Descripción
`job_activity_id`	integer	Sí	Código de actividad AFIP.
`country_document_id`	string	Sí	Código de país del documento.
`nationality_id`	string	Sí	Código de país de nacionalidad.
`is_aml_cft_subject`	boolean	Sí	Indica si la persona es sujeto obligado.
`is_pep`	boolean	Sí	Indica si la persona es políticamente expuesta.
`tax_identifications`	object	Sí	Datos impositivos de la persona.
`domiciles`	array de objetos	Sí	Domicilios asociados a la persona.
`contact`	object	Sí	Datos de contacto.
`human_person`	object	No	Datos de persona humana. Incluilo cuando des de alta una persona física.
`legal_person`	object	No	Datos de persona jurídica. Incluilo cuando des de alta una persona jurídica.

Objeto `tax_identifications`

Campo	Tipo	Requerido	Restricciones	Descripción
`tax_identification_value`	string	Sí	longitud exacta `11`	CUIT, CUIL o CDI.
`residence_country_id`	string	Sí	—	Código de país de residencia.
`tax_identification_type_id`	string	Sí	—	Tipo de identificación tributaria.
`taxpayer_income_tax_type_id`	string	Sí	—	Tipo de contribuyente de impuesto a las ganancias o ingresos.
`vat_taxpayer_type_id`	string	Sí	—	Tipo de contribuyente IVA.
`vat_country_taxpayer_type_id`	string	Sí	—	País donde tributa IVA.

Objeto `human_person`

Campo	Tipo	Requerido	Restricciones	Descripción
`surname`	string	Sí	—	Apellido.
`name`	string	Sí	—	Nombre.
`document_type_id`	string	Sí	—	Tipo de documento.
`document_num`	string	Sí	mínimo `7` caracteres	Número de documento.
`civil_status_id`	string	Sí	—	Estado civil.
`birth_date`	string	Sí	formato `date`	Fecha de nacimiento.
`birth_place`	string	Sí	—	Lugar de nacimiento.
`gender_id`	string	Sí	máximo `1` carácter	Género.
`signature`	string	Sí	base64 PNG	Firma en PNG con transparencia.

Objeto `legal_person`

Campo	Tipo	Requerido	Descripción
`company_name`	string	Sí	Razón social.
`registration_number`	string	Sí	Número de inscripción.
`incorporation_place`	string	Sí	Lugar de constitución.
`country_id`	string	Sí	Código de país.
`constitution_date`	string	Sí	Fecha de constitución.
`book`	string	Sí	Libro.
`volume`	string	Sí	Tomo o volumen.
`page`	string	Sí	Folio o página.
`is_state_supplier`	boolean	Sí	Indica si es proveedora del Estado.
`corporate_type`	integer	Sí	Tipo societario.

Objeto `domiciles`

Cada elemento del arreglo domiciles representa un domicilio.

Campo	Tipo	Requerido	Descripción
`domicile_type_id`	string	Sí	Tipo de domicilio.
`house_number`	integer	Sí	Altura de la calle.
`street`	string	Sí	Calle.
`floor`	integer	No	Piso.
`apartment`	string	No	Departamento.
`country_id`	string	Sí	Código de país.
`province_id`	string	Sí	Código de provincia.
`zip_code`	integer	Sí	Código postal.
`location_id`	integer	Sí	Localidad.

Objeto `contact`

Campo	Tipo	Requerido	Descripción
`email`	string	Sí	Correo electrónico.
`mobile_phone`	string	Sí	Teléfono móvil en formato E.164.

Ejemplo: persona humana

{
  "persons": [
    {
      "job_activity_id": 12112,
      "nationality_id": "ARG",
      "country_document_id": "ARG",
      "is_pep": false,
      "is_aml_cft_subject": false,
      "tax_identifications": {
        "tax_identification_value": "20341111111",
        "residence_country_id": "ARG",
        "tax_identification_type_id": "CUIT",
        "taxpayer_income_tax_type_id": "NOINS",
        "vat_taxpayer_type_id": "RM",
        "vat_country_taxpayer_type_id": "ARG"
      },
      "human_person": {
        "surname": "Doe",
        "name": "Jane",
        "document_type_id": "CUIL",
        "document_num": "34111112",
        "civil_status_id": "SOL",
        "birth_date": "2022-12-15",
        "birth_place": "ARG",
        "gender_id": "M",
        "signature": "<base64_png>"
      },
      "domiciles": [
        {
          "domicile_type_id": "PA",
          "house_number": 121,
          "street": "9 de Julio",
          "floor": 7,
          "apartment": "C",
          "country_id": "ARG",
          "province_id": "AR-B",
          "zip_code": 2324,
          "location_id": 1
        }
      ],
      "contact": {
        "email": "[email protected]",
        "mobile_phone": "+541112345678"
      }
    }
  ]
}

Respuesta esperada

La respuesta devuelve un arreglo items. Cada elemento incluye el resultado de una persona procesada.

{
  "items": [
    {
      "person_id": "F-8d567d64-3043-47de-8aa8-5d1d39f56c9e",
      "name": "Juan",
      "surname": "Perez",
      "tax_identification_value": "20341111111",
      "error": null
    }
  ]
}

Si una alta falla, error incluye error_code y message para ese registro.

Errores frecuentes

422 Validation Error: revisá tipos, campos obligatorios y formatos como birth_date, email o mobile_phone.
tax_identification_value_already_exists: el CUIT, CUIL o CDI ya fue registrado.
Errores de catálogos, como invalid_country_id, invalid_document_type o invalid_civil_status: verificá que los códigos enviados existan en las tablas maestras que usa tu integración.

Siguiente paso

Después de crear la persona, usá el person_id devuelto para crear una cuenta comitente con POST /api/accounts/investment-accounts.

triangle-exclamation
El endpoint POST /api/accounts/investment-accounts también está deprecado. Usá POST /api/accounts/v2/persons y POST /api/v2/accounts/investment-accounts para nuevas integraciones.

Antes de empezar

Qué envía este endpoint

Estructura de cada objeto person

Objeto tax_identifications

Objeto human_person

Objeto legal_person

Objeto domiciles

Objeto contact

Ejemplo: persona humana

Respuesta esperada

Errores frecuentes

Siguiente paso

200Successful Response

201Created

202Accepted

422Validation Error

Estructura de cada objeto `person`

Objeto `tax_identifications`

Objeto `human_person`

Objeto `legal_person`

Objeto `domiciles`

Objeto `contact`