API de Flota

Authentication — Bearer token

Your 7Transfers contact issues a long-lived Bearer token for your fleet. Store it securely on your server and send it on every request as Authorization: Bearer {token}. There is no login step and no password for API access. If a token is lost or rotated, ask us for a new one.

Example request

curl -H 'Accept: application/json' \
     -H 'Authorization: Bearer 3757|Zj1EVDhKnrLAx0V1rsSmlzU2loolWKpS35A2qtRtc9e3d716' \
     'https://walatour.com/api/driver/bookings?status=assigned'

Sandbox — try the API

Use this public sandbox Bearer token to explore the Fleet API. It always has 20 demo bookings in status assigned (ref numbers FAPISB-01 and up). Accepting or cancelling them is fine — they are reset automatically every hour.

Sandbox Bearer token

3757|Zj1EVDhKnrLAx0V1rsSmlzU2loolWKpS35A2qtRtc9e3d716

Example request

curl -H 'Accept: application/json' \
     -H 'Authorization: Bearer 3757|Zj1EVDhKnrLAx0V1rsSmlzU2loolWKpS35A2qtRtc9e3d716' \
     'https://walatour.com/api/driver/bookings?status=assigned'

Iniciar sesión — obtener token

Autenticar con credenciales de la flota para recibir un token Bearer para solicitudes posteriores.

Listar reservas asignadas a la flota

Parámetros de consulta opcional

Ejemplo

https://walatour.com/api/driver/bookings?status=assigned&from_date=2026-04-11&per_page=50

Respuesta 200

{
  "success": true,
  "data": [
    {
      "id": 9876,
      "ref_number": "T2S-12345",
      "status": "assigned",
      "status_label": "Assigned",
      "date": "2026-04-15 10:30:00",
      "from_address": "Malaga Airport (AGP)",
      "to_address": "Hotel Marbella Club",
      "passengers": 3,
      "vehicle_list": "Business Van",
      "luggage": 4,
      "hand_luggage": 3,
      "assigned_driver": null,
      "commission": 0,
      "flight_number": "FR1234",
      "meet_and_greet": true,
      "coordinate_start_lat": 36.6749,
      "coordinate_start_lon": -4.4991,
      "coordinate_end_lat": 36.5098,
      "coordinate_end_lon": -4.8826
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 3,
    "per_page": 20,
    "total": 47
  }
}

Detalles de la reserva

Devuelve la reserva completa: pasajero, contacto, direcciones, coordenadas, historial de estado, botones de acción, extras (asientos para niños, silla de ruedas, tiempo de espera, etc.) y archivos adjuntos.

Actualizar estado de la reserva

Solicitud

{
  "status": "accepted",
  "status_notes": "Nota opcional"
}

• status_notes es obligatorio cuando el estado es rejected.
• Los estados onroute, arrived, onboard, noshow y completed requieren una ubicación GPS reciente del conductor (en los últimos 5 minutos). Envía lat y lng en esta misma petición, o comparte la ubicación desde la app del conductor. Para integraciones desde oficina sin GPS, usa accepted, rejected o canceled.

Ubicación del conductor opcional

{
  "status": "arrived",
  "lat": -34.8150,
  "lng": -58.5348,
  "accuracy": 12,
  "heading": 270,
  "speed": 0
}

• lat, lng — Latitud y longitud en grados decimales. Envía las dos o ninguna.
• accuracy — Precisión del GPS en metros (opcional)
• heading — Dirección de la marcha en grados, de 0 a 360 (opcional)
• speed — Velocidad en metros por segundo (opcional)

Respuesta 200

{
  "success": true,
  "data": { "id": 9876, "status": "accepted" }
}

Listar conductores propios de la flota

Respuesta

{
  "success": true,
  "data": [
    { "id": 55, "name": "Juan Perez", "email": "juan@example.com" }
  ]
}

Asignar un conductor a una reserva

Solicitud

Envía driver_id, o un objeto driver si tus conductores están en tu propio sistema. commission y fleet_commission son opcionales.

{
  "driver_id": 55,
  "commission": 10.00,
  "fleet_commission": 5.00,
  "driver_name": "Juan Perez",
  "driver_phone": "+905551112233",
  "vehicle_make": "Mercedes-Benz",
  "vehicle_model": "Vito",
  "vehicle_license_plate": "34 ABC 123"
}

Conductor y vehículo opcional

• driver_name — Nombre completo del conductor
• driver_phone — Teléfono del conductor
• vehicle_make — Marca del vehículo
• vehicle_model — Modelo del vehículo
• vehicle_license_plate — Matrícula del vehículo

Conductores de tu propio sistema

{
  "commission": 10.00,
  "fleet_commission": 5.00,
  "driver": {
    "first_name": "Juan",
    "last_name": "Perez",
    "mobile_no": "+5491155551234",
    "vehicle_make": "Mercedes-Benz",
    "vehicle_model": "Vito",
    "vehicle_year": 2022,
    "vehicle_color": "black",
    "vehicle_license_plate": "AB 123 CD",
    "country": "AR",
    "city": "Buenos Aires"
  }
}

Campos obligatorios:

• driver.first_name — Nombre del conductor
• driver.last_name — Apellidos del conductor
• driver.mobile_no — Móvil del conductor, con prefijo de país. Lo usamos para reconocer al mismo conductor en otras reservas.
• driver.vehicle_make — Marca del vehículo
• driver.vehicle_model — Modelo del vehículo
• driver.vehicle_year — Año del vehículo (4 dígitos)
• driver.vehicle_color — Color del vehículo, uno de: white, black, silver, gray, blue, red, green, beige, brown, gold, orange, yellow, navy, burgundy
• driver.vehicle_license_plate — Matrícula del vehículo

Campos opcionales:

• driver.telephone_no, driver.address, driver.city, driver.postcode, driver.country

Respuesta

{
  "success": true,
  "message": "Conductor asignado.",
  "data": {
    "id": 9876,
    "driver_id": 55,
    "driver_name": "Juan Perez",
    "driver_phone": "+905551112233",
    "vehicle_make": "Mercedes-Benz",
    "vehicle_model": "Vito",
    "vehicle_license_plate": "34 ABC 123",
    "commission": 10.00,
    "fleet_commission": 5.00
  }
}

Cerrar sesión

Revoca el token Bearer actual.

Formato de error

Todos los errores devuelven JSON con un mensaje legible para humanos.

{ "success": false, "message": "Mensaje legible" }