Registro de clientes vía API
La integración de Registro de Clientes API permite que fuentes externas registradas en AVE puedan crear clientes directamente desde sus plataformas, sin necesidad de que el usuario pase por el flujo web manual.
Tu plataforma debe estar registrada y autorizada en AVE antes de consumir estos servicios.
Cuando te encuentres con un * al final de un parámetro significa que corresponde a la obligatoriedad de ingreso de dicha información.
URL Base
https://api.aveonline.co/api-onboarding/public/api/v1/external/onboarding
Autenticación
Todas las rutas requieren un token JWT válido en el header Authorization. Este token lo obtiene tu plataforma al estar registrada en AVE.
Authorization: Bearer {tu_token_jwt}
Si no envías el token o está expirado, la API retorna 401 Unauthorized.
Flujo de registro — 4 pasos
El proceso de registro de un cliente se divide en 4 pasos secuenciales. El seed generado en el Paso 2 es el identificador del proceso y debe enviarse en los pasos siguientes.
─────────────────────────────────────────────────────
Paso 1 → Aceptar Términos (crea el registro)
↓
Paso 2 → Completar datos del Lead (password, etc.)
↓ (retorna seed)
Paso 3 → Empresa - Identidad y documentos
↓
Paso 4 → Empresa - Datos comerciales
─────────────────────────────────────────────────────
Todos los registros creados quedan automáticamente asociados a tu plataforma como fuente de origen.
Códigos de respuesta
| Código | Significado |
|---|---|
200 | Operación exitosa / actualización |
201 | Recurso creado correctamente |
211 | El email ya tiene un proceso de onboarding en curso |
212 | El email o documento ya existe como empresa en AVE |
401 | Token no proporcionado o inválido |
406 | Validación CIFIN fallida |
409 | Error al guardar en base de datos |
422 | Error de validación en los campos enviados |
500 | Error interno del servidor |
Headers requeridos
Content-Type: application/json
Accept: application/json
Authorization: Bearer {tu_token_jwt}