Saltar al contenido principal

Create private auction

POST 
/company/auction/private

Crea una subasta privada con asignación directa a un transportista específico. Requiere autenticación JWT válida y permisos de compañía multitenant.

🚚 Flujo Específico para Envíos Privados/Directos​

🔐 Paso 1: Validación de Permisos​

  • Autenticación: Token JWT válido
  • Permisos: Verificación de cuenta multitenant activa
  • Plan: Confirmación de plan de pago que permite subastas privadas

👥 Paso 2: Selección de Transportista​

  • Identificación: Especificar trucker (ID del transportista)
  • Verificación: El transportista debe estar activo y disponible
  • Relación: Debe existir relación comercial previa o acuerdo

🚛 Paso 3: Asignación de Vehículo (Opcional)​

  • Especificidad: Definir vehicle si se requiere tipo específico
  • Propiedad: El vehículo debe pertenecer al transportista asignado
  • Capacidad: Verificar que el vehículo puede manejar peso/volumen

📋 Paso 4: Configuración de Datos del Envío​

Campos obligatorios únicos para privadas:

  • is_private: true - Marca la subasta como privada
  • trucker: "TRK_ID" - ID del transportista asignado

Campos opcionales específicos:

  • vehicle: "VH_ID" - ID del vehículo específico requerido

🚀 Paso 5: Creación y Notificación Directa​

POST /company/auction/private
  • Estado inicial: draft (igual que subastas públicas)
  • Visibilidad: Solo visible para el transportista asignado
  • Notificación: Alerta directa al transportista específico
  • Sin competencia: No aparece en marketplace público

💬 Paso 6: Negociación Directa​

  • Comunicación: Canal directo compañía ↔ transportista
  • Flexibilidad: Posibilidad de ajustar términos sin competidores
  • Agilidad: Proceso más rápido al eliminar periodo de pujas

✅ Paso 7: Aceptación Simplificada​

  • Oferta única: El transportista envía su propuesta
  • Decisión binaria: Aceptar o rechazar (sin comparar con otros)
  • Rapidez: Proceso de adjudicación inmediato

🎯 Ventajas del Flujo Privado​

⚡ Velocidad​

  • Eliminación del periodo de espera de ofertas
  • Comunicación directa sin intermediarios
  • Decisión inmediata de adjudicación

🤝 Relaciones Comerciales​

  • Fortalecimiento de vínculos con transportistas de confianza
  • Garantía de servicio por relación establecida
  • Precios negociados basados en volumen/frecuencia

🔒 Confidencialidad​

  • Información del envío no expuesta públicamente
  • Protección de datos comerciales sensibles
  • Control total sobre quién accede a la información

📊 Casos de Uso Específicos​

Transporte Especializado​

  • Mercancías peligrosas: Transportistas con licencias específicas
  • Temperatura controlada: Vehículos con refrigeración
  • Sobredimensionado: Transportistas con permisos especiales

Envíos Urgentes​

  • Tiempo crítico: Transportista conocido disponible inmediatamente
  • Sin esperas: Eliminación de periodo de pujas
  • Confiabilidad: Historial comprobado de cumplimiento

Relaciones Comerciales Establecidas​

  • Contratos marco: Transportistas con acuerdos previos
  • Tarifas negociadas: Precios preestablecidos por volumen
  • Servicios premium: Transportistas con servicios adicionales

⚠️ Validaciones Específicas para Privadas​

  • Transportista activo: Verificación de estado operativo
  • Vehículo disponible: Confirmación de disponibilidad en fechas
  • Capacidad adecuada: Peso/volumen dentro de límites del vehículo
  • Permisos necesarios: Transportista habilitado para tipo de carga
  • Zona de cobertura: Transportista opera en rutas requeridas

Request​

Responses​

Subasta privada creada exitosamente

Response Headers