Emisiones simples para agencias

Antes de comenzar

Todas las rutas usan el prefijo /api. Las rutas de autenticación, cotización, emisión y consulta de seguros esperan JSON. Conserva el token de la respuesta de login y envíalo como Bearer en las siguientes solicitudes.

1. Autenticación

Obtén un token de acceso con las credenciales de la agencia. El API acepta usuario o correo en el campo usuario.

Ingresa tus credenciales y pulsa autenticar.

curl -X POST 'https://gestor.bookingassistance.co/api/auth/login' \
  -H 'Content-Type: application/json' \
  -d '{
    "usuario": "USUARIO_O_CORREO_DE_AGENCIA",
    "password": "CONTRASENA_DE_AGENCIA"
  }'

{
  "access_token": "TOKEN_GENERADO",
  "token_type": "Bearer",
  "expires_at": "AAAA-MM-DD HH:mm:ss"
}

2. Orígenes y destinos

Consulta los identificadores disponibles para construir las solicitudes de cotización. Sin parámetros devuelve países; con destino=1 agrega continentes.

La respuesta aparecerá aquí.

curl 'https://gestor.bookingassistance.co/api/lugares?destino=1'

[
  { "Id": "continente-4", "Name": "America del Norte" },
  { "Id": "pais-1", "Name": "Colombia", "Code": "CO",
    "Indicative": "+57", "Image": "https://gestor.bookingassistance.co/banderas/co.png" }
]

3. Cotización

Cotiza los planes disponibles para un origen, destino, rango de fechas y grupo de edades. El identificador del plan se obtiene en planes[].detalle.id.

La respuesta aparecerá aquí.

curl -X POST 'https://gestor.bookingassistance.co/api/seguros/cotizar' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer TOKEN_GENERADO' \
  -d '{
    "origen": "pais-1",
    "destino": "continente-4",
    "salida": "2026-12-13",
    "regreso": "2026-12-21",
    "edad": [29, 29]
  }'

{
  "planes": [{
    "detalle": { "id": 37, "nombre": "PLAN" },
    "comparacion": [],
    "valor": { "valor": 150000, "trm": 1 }
  }],
  "informacion": { "dias": 9, "personas": 2 },
  "categorias": [], "empresas": {}
}

El arreglo edad admite hasta 10 pasajeros. Usa los identificadores continente-, pais- o ciudad- devueltos por /lugares.

4. Emisión

Emite el plan seleccionado y genera un voucher por pasajero. La emisión queda asociada a la agencia del usuario autenticado.

La emisión crea una venta real. Revisa el JSON antes de enviar.

curl -X POST 'https://gestor.bookingassistance.co/api/seguros/emitir' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer TOKEN_GENERADO' \
  -d '{
    "plan": "37",
    "origen": "pais-1",
    "destino": "continente-4",
    "salida": "2026-12-13",
    "regreso": "2026-12-21",
    "edad": ["29", "29"],
    "pasajeros": [
      {
        "nombre": "Ana", "apellido": "Gómez",
        "nacimiento": "1992-12-12", "pasaporte": "PASAPORTE_DEMO_1",
        "correo": "ana@example.com", "telefono": "3100000000",
        "direccion": "Calle 1 # 2-3", "ciudad": "Bogotá"
      },
      {
        "nombre": "Luis", "apellido": "Pérez",
        "nacimiento": "1993-02-06", "pasaporte": "PASAPORTE_DEMO_2",
        "correo": "luis@example.com", "telefono": "3100000000",
        "direccion": "Calle 1 # 2-3", "ciudad": "Bogotá"
      }
    ],
    "nombreemergencia": "Contacto de emergencia",
    "correoemergencia": "emergencia@example.com",
    "telefonoemergencia": "3100000000"
  }'

{
  "id_compra": 12345,
  "pasajeros": [
    { "nombre": "Ana Gómez", "pasaporte": "PASAPORTE_DEMO_1", "voucher": "VOUCHER_1" },
    { "nombre": "Luis Pérez", "pasaporte": "PASAPORTE_DEMO_2", "voucher": "VOUCHER_2" }
  ]
}

5. Seguros emitidos

Consulta el listado paginado de seguros emitidos por la agencia del usuario autenticado. La API procesa solo la página solicitada para evitar respuestas pesadas y errores de memoria.

La respuesta aparecerá aquí.

curl 'https://gestor.bookingassistance.co/api/seguros?page=1&per_page=25' \
  -H 'Authorization: Bearer TOKEN_GENERADO'

{
  "current_page": 1,
  "per_page": 25,
  "total": 1250,
  "last_page": 50,
  "data": [{
    "id_compra": 1,
    "fecha_compra": "2026-11-04 19:34:46",
    "valor_compra": "150000",
    "salida": "2026-12-13", "regreso": "2026-12-21",
    "origen": "Colombia", "destino": "America del Norte",
    "producto": "ESTANDAR", "voucher": "VOUCHER_1",
    "nombres": "Ana", "apellidos": "Gómez", "dias": 9
  }]
}

Los enlaces next_page_url y prev_page_url de la respuesta permiten recorrer las páginas sin construir manualmente la siguiente URL.

Flujo recomendado

1. Autentica y guarda access_token junto con su expiración.
2. Consulta lugares y conserva el Id seleccionado por el usuario.
3. Cotiza con fechas ISO YYYY-MM-DD y hasta 10 edades.
4. Selecciona el plan usando planes[].detalle.id.
5. Emite con un pasajero por cada edad y guarda los vouchers devueltos.
6. Consulta /seguros para reconciliar la emisión.