Skip to main content
Version: Latest

Paso 4 — Empresa (Datos Comerciales)

Completa los datos comerciales de la empresa. Al ejecutar este paso exitosamente se crea la empresa en AVE y se retorna el ID de la empresa creada.

Request 🚀​

URL​

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

Method​

POST

Headers​

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

Body JSON​

Campos requeridos​

  • seed* String (UUID) — Identificador del proceso del Paso 2
  • tradename* String min:4, max:255 — Nombre comercial de la empresa
  • address* String min:6, max:255 — Dirección de la empresa
  • city* String min:2, max:255 — Ciudad. Ej: Medellin (Antioquia)

Ejemplo de payload​

{
  "seed": "994f9ccf-d22b-4cea-9565-3920d2ba2bbe",
  "tradename": "Empresa Ejemplo SAS",
  "address": "Calle 22 # 3-21 Piso 2",
  "city": "Medellin (Antioquia)"
}

Response​

201 — Empresa creada en AVE​

Este es el paso final del registro. La respuesta incluye el ID de la empresa creada en AVE.

{
  "status": "ok",
  "message": "New company created",
  "data": {
    "id_empresa_ave": 43210
  }
}
  • id_empresa_ave Number — ID único de la empresa creada en AVE. Guárdalo para asociar pedidos, envíos y demás operaciones a este cliente

212 — Email ya existe como empresa​

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

422 — Error de validación​

{
  "errors": [
    {
      "title": "tradename",
      "detail": "nombre de empresa must be at least 4 characters"
    }
  ]
}

409 — Error al guardar​

{
  "errors": [
    {
      "title": "Error control",
      "detail": "Error trying to save data"
    }
  ]
}

Notas importantes​

  • Una vez completado este paso, el cliente queda registrado y activo en AVE
  • Guarda el id_empresa_ave — lo necesitarás para asociar pedidos, envíos y demás operaciones a este cliente
  • El email y la contraseña del cliente son los que enviaste en los pasos 1 y 2. Con esos datos el cliente puede iniciar sesión en AVE
  • Con este paso el flujo de registro queda completamente finalizado ✅