Retirar o Rechazar Oferta

Endpoint

POST /api/v2/no-asignacion

Descripción

Permite retirar una oferta del sistema o informar a las centrales que ya han aceptado que la oferta ya no está disponible.

Casos de uso:

• Retiro preventivo de oferta antes de aceptación
• 📢 Notificación de no disponibilidad a centrales que aceptaron
• Cancelación por cambio de condiciones del cliente

Efecto:

La oferta se marca como no disponible y se notifica a todas las centrales involucradas en el proceso.

Autenticación

Authorization: Basic <credentials>

Parámetros de Entrada

Body (JSON)

Campo	Tipo	Requerido	Descripción
uuid	string (UUID)	Sí	UUID de la oferta que se desea retirar o rechazar

Ejemplo de Request

{
  "uuid": "123e4567-e89b-12d3-a456-426614174000"
}

Respuestas

Éxito (200 Correcto)

{
  "status": true,
  "msg": "Oferta retirada exitosamente y centrales notificadas"
}

Error de Validación (400 Solicitud Incorrecta)

{
  "status": false,
  "msg": "Oferta no encontrada o ya ha sido procesada"
}

Ejemplos de Código

cURL

curl -X POST "[URL_API]/api/v2/no-asignacion" \
  --user "tu_usuario:tu_password" \
  -H "Content-Type: application/json" \
  -d '{
    "uuid": "123e4567-e89b-12d3-a456-426614174000"
  }'

JavaScript

const retirarOferta = async (uuid) => {
  const response = await fetch('[URL_API]/api/v2/no-asignacion', {
    method: 'POST',
    headers: {
      'Authorization': `Basic ${btoa('usuario:password')}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ uuid })
  });

  const result = await response.json();
  
  if (!result.status) {
    throw new Error(result.msg);
  }
  
  return result;
};

// Uso
try {
  await retirarOferta('123e4567-e89b-12d3-a456-426614174000');
  console.log('Oferta retirada exitosamente');
} catch (error) {
  console.error('Error:', error.message);
}

Diferencia con Cancelación

Acción	No Asignación	Cancelación
Estado	Oferta sin asignar	Servicio ya asignado
Momento	Antes de aceptación	Después de aceptación
UUID	✅ UUID de oferta	❌ ID de servicio
Efecto	Retira oferta	Cancela servicio activo

---

Cuándo Usar

Usa este endpoint cuando quieras retirar una oferta que aún no ha sido aceptada por ninguna central, o cuando ya no necesites el servicio antes de que se asigne.