Cargar documento

Solicita una URL prefirmada (presigned URL) para subir un documento al onboarding. Una vez obtenida, el archivo debe cargarse directamente con un PUT a esa URL.

POST/v1/onboardings/{onboarding_id}/documents

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 (uuid)	Sí	ID del onboarding obtenido al crear el onboarding

No aplica: Query Parameters.

Body

Campo	Tipo	Requerido	Descripción
cuit	string	Sí	CUIT de la persona titular del documento (11 dígitos)
document	object	Sí	Información del documento a cargar

Campos de documento

Campo	Tipo	Requerido	Descripción
type	string	Sí	Tipo de documento. Ver tipos de documento
extension	string	Sí	Tipo MIME del archivo. Ver extensiones admitidas
file_name	string	Sí	Nombre del archivo

Response

2XX Éxito

Campo	Tipo	Descripción
url	string	URL prefirmada para subir el documento vía PUT
expires_in_seconds	integer	Cuánto tiempo sigue siendo válida la URL prefirmada, en segundos. Actualmente 600 (10 minutos), contados desde que se emite

Códigos de error

Status	Descripción
401	Unauthorized — token inválido o ausente
403	Forbidden — cliente no autorizado
404	Not Found — el onboarding no existe
422	Validation Error — los parámetros enviados son inválidos
500	Internal Server Error — error interno del servidor

Ejemplo de código

cURL

curl -X POST "https://b2b.allaria.cloud/v1/onboardings/ONBOARDING_ID/documents" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "cuit": "20304050607",
    "document": {
      "type": "DNI_FRONT",
      "extension": "image/jpeg",
      "file_name": "dni_frente.jpg"
    }
  }'

# Con la URL obtenida, subir el archivo:
curl -X PUT "PRESIGNED_URL" \
  -H "Content-Type: image/jpeg" \
  --data-binary @dni_frente.jpg

JavaScript

const response = await fetch('https://b2b.allaria.cloud/v1/onboardings/ONBOARDING_ID/documents', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    cuit: '20304050607',
    document: {
      type: 'DNI_FRONT',
      extension: 'image/jpeg',
      file_name: 'dni_frente.jpg'
    }
  })
});

const { url } = await response.json();

// Subir el archivo a la presigned URL
await fetch(url, {
  method: 'PUT',
  headers: { 'Content-Type': 'image/jpeg' },
  body: fileBlob
});

Python

import requests

response = requests.post(
  'https://b2b.allaria.cloud/v1/onboardings/ONBOARDING_ID/documents',
  headers={
    'Authorization': 'Bearer ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  json={
    'cuit': '20304050607',
    'document': {
      'type': 'DNI_FRONT',
      'extension': 'image/jpeg',
      'file_name': 'dni_frente.jpg'
    }
  }
)

presigned_url = response.json()['url']

# Subir el archivo a la presigned URL
with open('dni_frente.jpg', 'rb') as f:
  requests.put(presigned_url, data=f, headers={'Content-Type': 'image/jpeg'})

Node.js

const axios = require('axios');
const fs = require('fs');

const { data } = await axios.post(
  'https://b2b.allaria.cloud/v1/onboardings/ONBOARDING_ID/documents',
  {
    cuit: '20304050607',
    document: {
      type: 'DNI_FRONT',
      extension: 'image/jpeg',
      file_name: 'dni_frente.jpg'
    }
  },
  {
    headers: {
      Authorization: 'Bearer ACCESS_TOKEN',
      'Content-Type': 'application/json'
    }
  }
);

// Subir el archivo a la presigned URL
await axios.put(data.url, fs.readFileSync('dni_frente.jpg'), {
  headers: { 'Content-Type': 'image/jpeg' }
});

2XX Éxito

{
  "url": "https://storage.example.com/upload/presigned-url?...",
  "expires_in_seconds": 600
}

Tipos de documento

Persona física (INDIVIDUAL)

Tipo	Descripción
DNI_FRONT	Frente del DNI
DNI_BACK	Dorso del DNI
WORTH_STATEMENT	Declaración de bienes

Persona jurídica (BUSINESS)

Tipo	Descripción
BALANCE	Balance contable
WORTH_STATEMENT	Declaración de bienes
SHARES_REGISTER	Libro de registro de acciones
STATUTE	Estatuto social
POA	Poder notarial
AUTHORITIES	Acta de autoridades
MEMBERS_NOTE	Nota de socios
SHAREHOLDERS_NOTE	Nota de accionistas
TRUST_NOTE	Nota de fideicomiso
PARTNERS_NOTE	Nota de partícipes
PARTNERS_LIST	Listado de partícipes
UIF_INSCRIPTION_CERTIFICATE	Certificado de inscripción UIF
EXPENSE_LIQUIDATION	Liquidación de gastos
HORIZONTAL_PROPERTY_REGULATIONS	Reglamento de propiedad horizontal
TRUST_CONSTITUTION_CONTRACT	Contrato de constitución de fideicomiso
CO_OWNER_LIST	Listado de condóminos
OTHERS	Otros

Extensiones admitidas

Valor	Descripción
image/png	Imagen PNG
image/jpeg	Imagen JPEG
application/pdf	Documento PDF
application/msword	Documento Word (.doc)
application/vnd.openxmlformats-officedocument.wordprocessingml.document	Documento Word (.docx)