Skip to main content
Version: Latest

Paso 3 — Empresa (Identidad y documentos)

Registra los datos de identidad del titular y carga los documentos de soporte. En este paso también se realiza la validación CIFIN para calificar al prospecto.

Request 🚀​

URL​

https://api.aveonline.co/api-onboarding/public/api/v1/external/onboarding/createCompanyStepOne

Method​

POST

Headers​

Content-Type: application/json
Accept: application/json
Authorization: Bearer {tu_token_jwt}

Body JSON​

Campos base (siempre requeridos)​

  • seed* String (UUID) — Identificador del proceso del Paso 2
  • documentType* Numeric — Tipo de documento. Ver tabla abajo
  • idDocument* String — Número del documento

Tipos de documento​

ValorTipo
1CC — Cédula de Ciudadanía
3NIT — Persona Jurídica
4CE — Cédula de Extranjería
5PSP — Pasaporte
7PPT — Permiso de Permanencia Temporal
8RUC
9CPF
10CNPJ

Para persona NATURAL (documentType distinto de 3)​

  • fullName* String min:3, max:255 — Primer nombre y segundo nombre
  • lastname* String min:3, max:255 — Apellidos
  • cedulaFront* Object — Imagen frontal del documento
    • base64* String — Archivo codificado en base64 (imagen JPG/PNG o PDF)
    • name* String — Nombre del archivo. Ej: cedula_frente.jpg
  • cedulaBack* Object — Imagen posterior del documento
    • base64* String
    • name* String

Para persona JURÍDICA (documentType == 3)​

  • businessName* String min:3, max:255 — Razón social de la empresa
  • rut* Object — Archivo del RUT
    • base64* String
    • name* String
  • camara_comercio* Object — Cámara de comercio
    • base64* String
    • name* String
  • nombrelegal* String — Nombre del representante legal
  • cedulalegal* String — Número de documento del representante legal

Campo opcional (ambos tipos)​

  • phone Numeric — Teléfono de contacto

Ejemplo de payload — Persona Natural​

{
  "seed": "994f9ccf-d22b-4cea-9565-3920d2ba2bbe",
  "documentType": 1,
  "idDocument": "1010215802",
  "fullName": "Juan Carlos",
  "lastname": "Perez Lopez",
  "phone": "3108001234",
  "cedulaFront": {
    "base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...",
    "name": "cedula_frente.jpg"
  },
  "cedulaBack": {
    "base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...",
    "name": "cedula_reverso.jpg"
  },
  "aveMetrics": false
}

Ejemplo de payload — Persona Jurídica​

{
  "seed": "994f9ccf-d22b-4cea-9565-3920d2ba2bbe",
  "documentType": 3,
  "idDocument": "900123456",
  "businessName": "Empresa Ejemplo SAS",
  "nombrelegal": "Juan Carlos Perez",
  "cedulalegal": "1010215802",
  "rut": {
    "base64": "data:application/pdf;base64,JVBERi0xLjQ...",
    "name": "rut_empresa.pdf"
  },
  "camara_comercio": {
    "base64": "data:application/pdf;base64,JVBERi0xLjQ...",
    "name": "camara_comercio.pdf"
  }
}

Response​

201 — Datos guardados​

{
  "status": "ok",
  "message": "Data saved",
  "data": {
    "score": 0
  }
}
  • score Number — Puntuación CIFIN del prospecto (puede ser 0 si no aplica)

406 — Validación CIFIN fallida​

El prospecto no califica según la evaluación crediticia.

{
  "status": "ok",
  "message": "No Valid",
  "data": {
    "responseCifin": "error",
    "messageError": "Titular no calificable",
    "score": 0,
    "nameIsValid": false,
    "isItCurrent": false
  }
}

212 — Documento ya existe en AVE​

{
  "errors": [
    {
      "title": "Error control",
      "detail": "The document already exists in Companies"
    }
  ]
}

422 — Error de validación​

{
  "errors": [
    {
      "title": "cedulaFront",
      "detail": "El archivo de cedulaFront debe ser una imagen o un PDF válido"
    }
  ]
}

Notas importantes​

  • Los archivos deben enviarse en base64 con el prefijo MIME correspondiente: data:image/jpeg;base64,... o data:application/pdf;base64,...
  • Los formatos aceptados son: JPG, PNG, PDF
  • Si el prospecto falla la validación CIFIN (código 406), el proceso no puede continuar al Paso 4 (Datos Comerciales)
  • Usa aveMetrics: true únicamente en ambientes de prueba o cuando se indique explícitamente