Pular para o conteúdo principal

Generar contrato para subasta

POST 
/auction/contract

Crea un contrato preliminar para una subasta cerrada con ganador asignado.

Requisitos:

  • La subasta debe estar en estado 'closed'
  • Debe tener un ganador asignado (bidWinner)
  • El usuario debe ser administrador de la compañía
  • No debe existir contrato previo generado

Proceso interno:

  1. Valida que la subasta cumpla los requisitos
  2. Genera documento PDF con plantilla 'file_contract'
  3. Almacena el PDF en S3/almacenamiento local
  4. Actualiza la subasta con referencia al contrato
  5. Notifica al transportista ganador

Campos obligatorios en body:

  • serviceCode: Identificador de la subasta. Formato: 3 letras del origen, 3 letras del destino y 5 caracteres alfanuméricos aleatorios (ej: VIGMURnT4FN).
  • award_price: Precio acordado (debe ser >= bid_current)
  • special_conditions: Términos especiales (opcional)
  • payment_terms: Condiciones de pago (opcional)

Ejemplo de body request:

{
  "serviceCode": "ABC123",
  "award_price": 1200,
  "special_conditions": "Carga frágil - manejar con cuidado",
  "payment_terms": "50% anticipo, 50% al entregar"
}

La respuesta incluye la subasta actualizada con los datos del contrato.

Request​

Responses​

Subasta individual