Descripción General

Este flujo cubre el proceso de obtención de información y reserva de seguros de viaje a través de diferentes APIs. El flujo consta de varios pasos organizados de la siguiente manera:

1. 1. Obtención de regiones de seguros (Autocomplete).
   2. Búsqueda de seguros disponibles.
   3. Confirmación de un seguro seleccionado.
   4. Creación de una reserva de seguro.
   5. Verificación del estado de la reserva.
   6. Consulta de información detallada de la reserva.

Cada paso está respaldado por uno o más endpoints con detalles específicos de parámetros y respuestas.

1. Autocomplete Regiones

Endpoint:

GET /catalog/travel-insurances-regions

URL Completa: https://api.basset.ws/catalog/travel-insurances-regions?language=es

Cabeceras Requeridas:

• • x-api-key: Tu clave de API.

• • x-client-id: Tu ID de cliente.

Parámetros de Query:

• • language: Idioma de la respuesta (por ejemplo, es).

Ejemplo de Respuesta:

[
    {
        "id": "36831d79-6588-47b4-b5be-d117009bb89d",
        "name": "América del Sur",
        "type": "INTERNATIONAL"
    },
    ...
]

---

2. Búsqueda de Seguros Disponibles

Endpoint:

GET /travel-insurances/search

URL Completa: https://api.basset.ws/travel-insurances/search

Cabeceras Requeridas:

• • x-api-key: Tu clave de API.

• • x-client-id: Tu ID de cliente.

Parámetros de Query:

• • origin_region_id (requerido): ID de la región de origen.

• • destination_region_id (requerido): ID de la región de destino.

• • from y to (requeridos): Fechas de inicio y fin del viaje (formato YYYY-MM-DD).

• • ages (requerido): Edad(es) de los viajeros.

• • limit y offset (opcional): Paginación de resultados.

Ejemplo de Respuesta:

{
    "insurances": [
        {
            "id": "39db126c-c330-4d91-97a7-5e84dbfd5f46",
            "name": "AC 60",
            "provider": "ASSIST_CARD",
            "rate": {
                "total": 71760.57,
                "currency": "ARS"
            }
        },
        ...
    ]
}

---

3. Confirmación de Seguro Seleccionado

Endpoint:

GET /travel-insurances/search/{insurance_id}

URL Completa: https://api.basset.ws/travel-insurances/search/{insurance_id}

Cabeceras Requeridas:

• • x-api-key: Tu clave de API.

• • x-client-id: Tu ID de cliente.

Parámetros de Query:

• • site y channel (opcional): Información del sitio y canal.

Ejemplo de Respuesta:

{
    "id": "39db126c-c330-4d91-97a7-5e84dbfd5f46",
    "name": "AC 60",
    "description": "Asistencia Médica USD 60K + Preexistencia USD 10K",
    "rate": {
        "total": 71760.57,
        "currency": "ARS"
    }
}

---

4. Creación de Reserva

Endpoint:

POST /reservations/async

URL Completa: https://api.basset.ws/reservations/async

Cabeceras Requeridas:

• • x-api-key: Tu clave de API.

• • x-client-id: Tu ID de cliente.

Cuerpo de la Solicitud:

{
    "products": [
        {
            "item_id": "39db126c-c330-4d91-97a7-5e84dbfd5f46",
            "type": "TRAVEL_INSURANCE",
            "travel_insurances_passengers": [
                {
                    "firstname": "jorge",
                    "lastname": "sanchez",
                    "birth": "1992-10-05",
                    "document": {
                        "type": "PAS",
                        "number": "97345234"
                    }
                }
            ]
        }
    ],
    "contact": {
        "email": "jorge.sanchez@basset.la",
        "telephone": {
            "country_code": "54",
            "area_code": "011",
            "number": "87653443"
        }
    }
}

Ejemplo de Respuesta:

{
    "id": "ee82e49e-510f-4f4a-83c7-88695d977e24",
    "status": "BOOKING"
}

---

5. Verificación del Estado de la Reserva

Endpoint:

GET /reservations/process/{reservation_id}

URL Completa: https://api.basset.ws/reservations/process/{reservation_id}

Cabeceras Requeridas:

• • x-api-key: Tu clave de API.

• • x-client-id: Tu ID de cliente.

Ejemplo de Respuesta:

{
    "id": "ee82e49e-510f-4f4a-83c7-88695d977e24",
    "status": "OK",
    "reservation_id": "175237956"
}

---

6. Información Detallada de la Reserva

Endpoint:

GET /reservations/{reservation_id}

URL Completa: https://api.basset.ws/reservations/{reservation_id}

Cabeceras Requeridas:

• • x-api-key: Tu clave de API.

• • x-client-id: Tu ID de cliente.

Ejemplo de Respuesta:

{
    "id": "175237956",
    "products": [
        {
            "name": "AC 60",
            "status": "ISSUED",
            "rate": {
                "total": 71760.57,
                "currency": "ARS"
            }
        }
    ]
}

---

Errores Comunes

• • 401 Unauthorized: La API key o el client ID no son válidos.

• • 404 Not Found: La reserva o seguro solicitado no existe.

• • 500 Internal Server Error: Problemas en el servidor.

Notas Finales

Acá esta colección de postman con ejemplos paso a paso.