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
  • cityType* String — Tipo de código de ciudad: D (DANE) o P (Postal)
  • city* String — Código de la ciudad, según el tipo indicado en cityType
ValorTipoEjemplo
DCódigo DANE05001
PCódigo Postal110111

Ejemplo de payload — con código DANE​

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

Ejemplo de payload — con código Postal​

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

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 — cityType no enviado o inválido​

{
  "errors": [
    {
      "title": "Error control",
      "detail": "El campo cityType es obligatorio y debe ser D (DANE) o P (Postal)"
    }
  ]
}

❌ 422 — Código DANE no encontrado​

{
  "errors": [
    {
      "title": "Error control",
      "detail": "No se encontro una ciudad con el codigo DANE enviado"
    }
  ]
}

❌ 422 — Código Postal no encontrado​

{
  "errors": [
    {
      "title": "Error control",
      "detail": "No se encontro una ciudad con el codigo postal enviado"
    }
  ]
}

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
  • 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