SDK de TRANSCEND para Python y JavaScript

TRANSCEND ofrece SDKs oficiales para integrar la API modular (13 módulos: Route, Tolls, POI, Traffic, Weather, Vehicles, Drivers, IAM, Payment, Stations, Profiles, Activity, HS Code) en tu backend sin escribir el cliente HTTP a mano.

SDKs disponibles

SDK	Lenguaje	Repositorio
transcend-sdk	Python	github.com/cargoffer/transcend-sdk
transcend-sdk-js	JavaScript / TypeScript	github.com/cargoffer/transcend-sdk-js

Instalación

pip install transcend-sdk          # Python
npm install @cargoffer/transcend-sdk-js   # JavaScript/TypeScript

Ejemplo en Python

from transcend_sdk import Client

client = Client(token="TU_TRANSCEND_TOKEN")

# Optimizar ruta MAD -> PAR para trailer 44t
route = client.routes.optimize(
    origin="MAD", destination="PAR", vehicle_class="44t"
)
print(route.peaje_por_tramo, route.combustible, route.pois)

# Coste de peaje por tramo
costs = client.tolls.costs(from_="MAD", to="PAR", vehicle_class="44t")
print(costs.with_vat, costs.without_vat)

Ejemplo en JavaScript / TypeScript

import { Transcend } from "@cargoffer/transcend-sdk-js";

const client = new Transcend({ token: process.env.TRANSCEND_TOKEN });

const route = await client.routes.optimize({
  origin: "MAD",
  destination: "PAR",
  vehicleClass: "44t",
});
console.log(route.peajePorTramo, route.combustible, route.pois);

const costs = await client.tolls.costs({ from: "MAD", to: "PAR", vehicleClass: "44t" });
console.log(costs.withVat, costs.withoutVat);

Casos de uso

1. TMS propio: llama client.routes.optimize al cerrar un viaje y guarda el peaje real antes de facturar.
2. App de flota: client.poi.getAlongPath para mostrar parkings y gasolineras en la ruta del conductor.
3. Panel de control: client.weather + client.traffic para anticipar incidencias 72h.

Preguntas frecuentes

¿El SDK es gratuito? Sí, es open source (propiedad de Cargoffer). El uso de la API depende de tu plan TRANSCEND (pay-per-use, 30 rutas/mes gratis).

¿Qué módulos cubre? Los 13 módulos de la API: Route, Tolls, POI, Traffic, Weather, Vehicles, Drivers, IAM, Payment, Stations, Profiles, Activity, HS Code.

¿Y si prefiero la API REST directa? La base es https://back.transcend.cargoffer.com y la especificación completa está en https://docs.transcend.cargoffer.com/openapi/transcend-api.json.