Subí documentación legal de una persona o documentación PEP usando multipart/form-data.

Antes de empezar

1. Tené a mano el person_id de la persona a la que querés asociar la documentación.
2. Prepará la solicitud como multipart/form-data para poder enviar archivos y campos de texto en el mismo request.
3. Adjuntá solo los archivos que correspondan al tipo de persona y al flujo que estás completando.
4. Si necesitás recuperar luego los nombres de los documentos cargados, usá GET /api/accounts/persons/contracts-names/{person_id}.

Cuándo usar este endpoint

Usá este endpoint para:

• subir documentación de una persona jurídica
• adjuntar documentación societaria adicional
• enviar documentación de respaldo para una persona humana PEP

Cómo subir documentación

POST /api/accounts/persons/contracts
Content-Type: multipart/form-data

Campos del formulario

Qué cargar en cada campo

constituent_instrument

Adjuntá el instrumento constitutivo que corresponda al tipo societario, por ejemplo:

• estatuto de una sociedad anónima
• contrato social de una SRL
• contrato de fideicomiso
• reglamento de copropietarios

administrative_body_record

Adjuntá documentación que acredite la designación vigente de autoridades, por ejemplo:

• actas de asamblea y directorio con designación vigente
• actas con designación de socios gerentes
• acta de designación del administrador

latest_balance_certificate

Adjuntá el último balance anual certificado por el CPCE. Si la entidad todavía no cuenta con balance cerrado o balance inicial especial, podés adjuntar documentación patrimonial equivalente, como una certificación contable.

shareholder_registry_copy

Adjuntá la documentación que acredite la composición societaria, por ejemplo:

• registro de accionistas
• nómina de socios
• nómina de fiduciantes
• nómina de socios partícipes
• nómina de copropietarios

capital_ownership_beneficiary

Adjuntá la documentación sobre estructura societaria y beneficiario final. Según tu proceso interno, este archivo puede incluir la declaración de estructura societaria donde se informa la cadena de participación hasta llegar a las personas humanas beneficiarias finales.

other_documents

Usá este campo para adjuntar documentación societaria complementaria cuando la estructura de la entidad requiera respaldos adicionales.

pep_documents

Si la persona humana es PEP, adjuntá la documentación de respaldo correspondiente. Según tu material operativo, esto puede incluir comprobantes como recibos de sueldo, certificaciones contables, facturas, sentencias judiciales, escrituras, donaciones, préstamos o seguros.

Ejemplo con curl

curl --request POST \
  --url '{{baseUrl}}/api/accounts/persons/contracts' \
  --header 'Content-Type: multipart/form-data' \
  --form 'person_id=J-8d567d64-3043-47de-8aa8-5d1d39f56c9e' \
  --form '[email protected]' \
  --form '[email protected]' \
  --form '[email protected]'

Qué devuelve este endpoint

La respuesta exitosa devuelve un objeto con items. Cada elemento incluye el nombre de un documento procesado.

Respuesta esperada

{
  "items": [
    {
      "name": "estatuto.pdf"
    },
    {
      "name": "autoridades.pdf"
    }
  ]
}

Errores frecuentes

• 422 Validation Error: falta person_id, el formulario no está codificado como multipart/form-data o alguno de los archivos no se envió correctamente.
• Error de negocio por person_id inexistente: verificá que la persona exista antes de subir la documentación.
• Error por tipo de archivo o carga incompleta: reenviá el archivo verificando nombre, contenido y formato según las reglas operativas de tu integración.

Siguiente paso

Después de subir la documentación, recuperá los nombres disponibles con GET /api/accounts/persons/contracts-names/{person_id} o consultá un archivo puntual con GET /api/accounts/persons/contracts/{person_id}/{legal_person_document}.