Asignar Detalles del Cliente

Endpoint

POST /api/v2/asignacion

Descripción

Completa la información de una oferta que ya ha sido aceptada por una central, agregando los datos del cliente y vehículo necesarios para la prestación del servicio.

Proceso:

1. La oferta debe haber sido previamente aceptada por una central
2. Se envían los datos del solicitante y vehículo
3. El servicio queda completamente configurado para ejecución

Autenticación

Authorization: Basic <credentials>

Parámetros de Entrada

Body (JSON)

Campo	Tipo	Requerido	Descripción
uuid	string (UUID)	Sí	UUID de la oferta previamente aceptada
codigoServicio	string	Sí	Código único del servicio asignado
riesgo	string	Sí	Número de póliza o identificador del riesgo cubierto
primerNombre	string	Sí	Primer nombre del solicitante del servicio
primerApellido	string	Sí	Primer apellido del solicitante del servicio
telefonoSolicitante	string	Sí	Número de teléfono principal del solicitante
segundoNombre	string	No	Segundo nombre del solicitante (opcional)
segundoApellido	string	No	Segundo apellido del solicitante (opcional)
telefonoSolicitante2	string	No	Número de teléfono alternativo
claseVehiculo	string	No	Tipo o clase del vehículo
marcaVehiculo	string	No	Marca del vehículo
tipoTransmisionVehiculo	string	No	Tipo de transmisión (manual, automática)
observaciones	string	No	Comentarios adicionales sobre el cliente o servicio

Ejemplo de Request

{
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "codigoServicio": "TSV202507030001",
  "riesgo": "POL-2025-001234",
  "primerNombre": "Carlos",
  "segundoNombre": "Andrés",
  "primerApellido": "Rodríguez",
  "segundoApellido": "García",
  "telefonoSolicitante": "+57 300-123-4567",
  "telefonoSolicitante2": "+57 301-234-5678",
  "claseVehiculo": "Automóvil",
  "marcaVehiculo": "Toyota",
  "tipoTransmisionVehiculo": "Automática",
  "observaciones": "Cliente prefiere contacto vía WhatsApp"
}

Respuestas

Éxito (200 Correcto)

{
  "status": true,
  "msg": "Detalles del cliente asignados correctamente al servicio"
}

Error de Validación (400 Solicitud Incorrecta)

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

Errores comunes:

• UUID no existe o no válido
• Oferta no ha sido aceptada por ninguna central
• Código de servicio ya utilizado
• Campos requeridos faltantes

Ejemplos de Código

cURL

curl -X POST "[URL_API]/api/v2/asignacion" \
  --user "tu_usuario:tu_password" \
  -H "Content-Type: application/json" \
  -d '{
    "uuid": "123e4567-e89b-12d3-a456-426614174000",
    "codigoServicio": "TSV202507030001",
    "riesgo": "POL-2025-001234",
    "primerNombre": "Carlos",
    "primerApellido": "Rodríguez",
    "telefonoSolicitante": "+57 300-123-4567"
  }'

JavaScript

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

  if (!response.ok) {
    throw new Error(`Error HTTP: ${response.status}`);
  }

  return await response.json();
};

// Uso
try {
  const resultado = await asignarDetalles({
    uuid: '123e4567-e89b-12d3-a456-426614174000',
    codigoServicio: 'TSV202507030001',
    riesgo: 'POL-2025-001234',
    primerNombre: 'Carlos',
    primerApellido: 'Rodríguez',
    telefonoSolicitante: '+57 300-123-4567'
  });
  
  console.log('Asignación exitosa:', resultado.msg);
} catch (error) {
  console.error('Error en asignación:', error.message);
}

Flujo Completo de Oferta → Asignación

sequenceDiagram
    participant C as Cliente
    participant API as TSALVA API
    participant Central
    participant CB as Callback

    C->>API: 1. POST /api/v2/oferta
    Note over C,API: Crear oferta con callbackUrl
    
    API-->>C: Oferta creada
    API->>Central: Distribuir oferta
    Central->>API: Aceptar oferta
    
    API->>CB: 2. PUT callbackUrl
    Note over API,CB: Notificar aceptación
    CB-->>API: 200 Correcto
    
    C->>API: 3. POST /api/v2/asignacion
    Note over C,API: Enviar datos del cliente
    API-->>C: Detalles asignados
    
    Note over C,Central: Servicio activo y listo para ejecución

Validaciones Importantes

UUID y Estado de Oferta

• La oferta debe existir en el sistema
• Debe haber sido aceptada por una central
• No debe haber sido previamente asignada

Código de Servicio

• Debe ser único en el sistema
• Se recomienda formato: TSV + fecha + consecutivo
• Ejemplo: TSV202507030001

Información del Cliente

• Teléfonos deben incluir código de país
• Nombres y apellidos sin caracteres especiales
• Riesgo debe seguir formato de póliza de la empresa

---

Siguiente Paso

Después de la asignación exitosa, el servicio estará activo y comenzarás a recibir webhooks de cambios de estado.

Importante

Una vez asignados los detalles, la información del cliente no se puede modificar. Asegúrate de que los datos estén correctos antes de enviar la petición.