VIAZU API — B2B

Integra servicios de transporte VIAZU en tus sistemas: hoteles, aeropuertos, call centers, ERPs y más.

Base URL: https://us-central1-viazu-596b0.cloudfunctions.net

Descripción general

La API B2B de VIAZU permite que sistemas empresariales externos creen, monitoreen y cancelen viajes en nombre de sus clientes, sin necesidad de una cuenta de usuario de VIAZU por cada petición.

• Todas las peticiones usan HTTPS.
• El cuerpo de las peticiones y respuestas es JSON.
• La moneda es siempre DOP (Peso dominicano).
• Los precios incluyen ITBIS 18%.

Autenticación

Cada petición debe incluir tu API key en el header Authorization como Bearer token:

Authorization: Bearer vz_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Formato de la API key

vz_live_<40 caracteres hexadecimales>

Las claves se almacenan como hash SHA-256 en nuestros servidores. La clave en texto plano se muestra solo una vez al momento de generarse.

Errores

Los errores se devuelven con el HTTP status code correspondiente y un body JSON:

{
  "error": {
    "code":    "invalid_params",
    "message": "Descripción del error"
  }
}

Rate limiting

El límite de peticiones se aplica por cliente y por minuto. El límite estándar es 60 req/min. Al superarlo recibirás un 429 rate_limited.

POST /apiEstimateFare

curl -X POST https://us-central1-viazu-596b0.cloudfunctions.net/apiEstimateFare \
  -H "Authorization: Bearer vz_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "servicio":     "carro",
    "distanciaKm":  8.5,
    "duracionMin":  18
  }'

{
  "servicio":       "carro",
  "distanciaKm":    8.5,
  "duracionMin":    18,
  "surgeFactor":    1.0,
  "precioEstimado": 432,
  "moneda":         "DOP",
  "itbis":          0.18
}

POST /apiCreateRide

curl -X POST https://us-central1-viazu-596b0.cloudfunctions.net/apiCreateRide \
  -H "Authorization: Bearer vz_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "servicio": "ejecutivo",
    "origen":   { "address": "Hotel Barceló Bávaro", "lat": 18.5680, "lng": -68.3733 },
    "destino":  { "address": "Aeropuerto Internacional de Punta Cana", "lat": 18.5674, "lng": -68.3633 },
    "distanciaKm":  3.8,
    "duracionMin":  12,
    "metodoPago":   "card"
  }'

{
  "tripId":  "abc123xyz",
  "estado":  "pendiente",
  "precio":  1475,
  "moneda":  "DOP",
  "success": true
}

GET /apiGetRideStatus

curl "https://us-central1-viazu-596b0.cloudfunctions.net/apiGetRideStatus?tripId=abc123xyz" \
  -H "Authorization: Bearer vz_live_..."

{
  "tripId":      "abc123xyz",
  "estado":      "aceptado",
  "servicio":    "ejecutivo",
  "precio":      1475,
  "moneda":      "DOP",
  "origen":      { "address": "Hotel Barceló Bávaro", "latitude": 18.568, "longitude": -68.3733 },
  "destino":     { "address": "Aeropuerto PUJ", "latitude": 18.5674, "longitude": -68.3633 },
  "conductorId": "uid_del_conductor"
}

POST /apiCancelRide

curl -X POST https://us-central1-viazu-596b0.cloudfunctions.net/apiCancelRide \
  -H "Authorization: Bearer vz_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "tripId": "abc123xyz", "motivo": "Cliente cambió de planes" }'

{
  "tripId":  "abc123xyz",
  "estado":  "cancelado",
  "success": true
}

GET /apiEnterpriseHistory

curl "https://us-central1-viazu-596b0.cloudfunctions.net/apiEnterpriseHistory?limit=10&estado=finalizado&desde=2026-06-01T00:00:00Z" \
  -H "Authorization: Bearer vz_live_..."

{
  "total":    2,
  "clientId": "mi_cliente_id",
  "viajes": [
    {
      "tripId":    "abc123xyz",
      "estado":    "finalizado",
      "servicio":  "ejecutivo",
      "precio":    1475,
      "moneda":    "DOP",
      "origen":    { "address": "Hotel Barceló", "latitude": 18.568, "longitude": -68.373 },
      "destino":   { "address": "Aeropuerto PUJ", "latitude": 18.567, "longitude": -68.363 },
      "timestamp": "2026-06-25T14:30:00.000Z"
    }
  ]
}

Scopes disponibles

Cada API key tiene uno o más scopes que definen qué endpoints puede usar.

Tipos de servicio

* Los precios mostrados son tarifas base. El precio final incluye ITBIS 18% y el surge factor vigente al momento del viaje.

Estados de un viaje