Saltar al contenido principal

Create New Transport Auction

POST 
/company/auction

Crea una nueva subasta de transporte de mercancías siguiendo un flujo estructurado. Requiere autenticación JWT válida y verificación de plan de pago activo.

📋 Flujo Completo para Crear un Nuevo Envío​

🔐 Paso 1: Autenticación y Preparación​

  • Requisitos previos:
    • Token JWT válido obtenido mediante login
    • Plan de pago activo en la cuenta de la compañía
    • Verificación de permisos de creación de subastas

📝 Paso 2: Preparación de Datos del Envío​

Información obligatoria a recopilar:

  • Punto de recogida (ETL): Dirección completa, fecha y hora de carga
  • Punto de entrega (ETD): Dirección completa, fecha y hora de descarga
  • Características de la carga: Tipo, peso (kg), volumen (m³)
  • Código de servicio: Identificador único del envío

Información opcional:

  • Notas especiales (mercancía frágil, temperatura, etc.)
  • Marcar como favorito para reutilización
  • Asignación privada a transportista específico

🚀 Paso 3: Creación del Borrador​

POST /company/auction
  • El sistema crea la subasta en estado draft
  • Se validan todos los datos de entrada
  • Se verifica formato UTC para fechas
  • Se asigna automáticamente el service_code si no se proporciona

✏️ Paso 4: Revisión y Edición (Opcional)​

  • Estado: La subasta permanece en draft hasta su publicación
  • Ediciones permitidas: Todos los campos pueden modificarse
  • Validaciones: El sistema verifica cada cambio automáticamente

📢 Paso 5: Publicación de la Subasta​

  • Cambio de estado: De draft a published
  • Notificación: Se envían alertas a transportistas disponibles
  • Visibilidad: La subasta aparece en el marketplace público
  • Cronómetro: Inicia el período de recepción de ofertas

💰 Paso 6: Recepción de Ofertas​

  • Transportistas: Pueden ver los detalles del envío
  • Pujas: Los transportistas envían sus ofertas económicas
  • Seguimiento: La compañía puede monitorear ofertas en tiempo real
  • Comunicación: Sistema de mensajería para aclaraciones

🔒 Paso 7: Evaluación y Bloqueo​

  • Revisión: La compañía evalúa todas las ofertas recibidas
  • Bloqueo: Cambio a estado locked para finalizar el período de pujas
  • Prevención: No se admiten más ofertas una vez bloqueada

✅ Paso 8: Selección y Adjudicación​

  • Decisión: La compañía selecciona la mejor oferta
  • Aceptación: Se acepta la puja del transportista elegido
  • Estado final: La subasta pasa a completed
  • Contrato: Se genera automáticamente la documentación

📊 Paso 9: Seguimiento y Gestión​

  • Tracking: Seguimiento del estado del transporte
  • Comunicación: Canal directo con el transportista asignado
  • Documentación: Acceso a contratos y documentos de transporte
  • Facturación: Gestión de pagos y facturación automática

🎯 Casos de Uso Específicos​

Envío Público Estándar​

  1. Crear subasta pública (is_private: false)
  2. Publicar en marketplace
  3. Recibir múltiples ofertas
  4. Seleccionar mejor precio/servicio

Envío Privado/Directo​

  1. Crear subasta privada (is_private: true)
  2. Asignar transportista específico (trucker)
  3. Negociación directa sin competencia
  4. Aceptación inmediata

Envío Urgente​

  1. Crear con fechas muy próximas
  2. Publicar inmediatamente
  3. Aceptar primera oferta válida
  4. Priorizar velocidad sobre precio

⚡ Validaciones Críticas​

  • Fechas: Formato UTC obligatorio (YYYY-MM-DDTHH:mm:ssZ)
  • Peso/Volumen: Valores numéricos positivos
  • Direcciones: Formato de dirección válido
  • Plan de pago: Verificación activa de suscripción
  • Límites: Respeto a límites de plan (número de envíos/mes)

Request​

Responses​

Subasta creada exitosamente

Response Headers