Skip to content

cargoffer/transcend-examples

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TRANSCEND API Integration Examples

License: MIT Python 3.8+ TRANSCEND API

Integration examples and code samples for connecting TRANSCEND Route Optimization API with ERPs, TMS, WMS, and fleet telematics systems.

This repository provides ready-to-use code for integrating TRANSCEND's AI-powered route optimization with the most common enterprise systems in the logistics and transportation industry. Each example includes authentication, data mapping, route optimization calls, and status updates.


Table of Contents


Supported Systems

System Category API Type Example Difficulty
Odoo ERP JSON-RPC odoo/ Beginner
SAP S/4HANA ERP OData REST sap-s4hana/ Advanced
Microsoft Dynamics 365 ERP OData v4 REST dynamics-365/ Intermediate
Sage X3 ERP REST API sage-x3/ Beginner
Oracle NetSuite ERP SuiteTalk REST oracle-netsuite/ Intermediate
Blue Yonder (JDA) Supply Chain Luminate API blue-yonder/ Advanced
Samsara Fleet Telematics REST API samsara/ Intermediate
Geotab Fleet Telematics SDK/API geotab/ Intermediate
PTV Map&Guide Route Optimization Developer API ptv/ Intermediate
WMS (Mecalux/Easy WMS) Warehouse REST API wms/ Advanced

Quick Start

1. Get your TRANSCEND API key

Sign up for a free sandbox account at transcend.cargoffer.com

2. Install the common client

pip install requests

3. Run an example

# Example: Optimize a route with TRANSCEND API
from transcend_client import TranscendClient

client = TranscendClient(api_key="your_api_key")

route = client.optimize_route(
    origin={"lat": 40.4168, "lon": -3.7038},   # Madrid
    stops=[
        {"lat": 41.3851, "lon": 2.1734},        # Barcelona
        {"lat": 39.4699, "lon": -0.3763},       # Valencia
    ],
    vehicle={"type": "articulated_40t", "height": 4.0, "weight": 40000}
)

print(f"Total distance: {route['distance_km']} km")
print(f"Estimated cost: {route['cost']['total']} EUR")
print(f"ETA: {route['eta']}")

ERP Integration Examples

Odoo Integration

examples/odoo/

Connect Odoo sales orders with TRANSCEND route optimization. Automatically reads pending delivery orders from Odoo, optimizes delivery routes, and updates order status. Uses Odoo JSON-RPC API.

Keywords: Odoo route optimization integration, Odoo API logistics, Odoo delivery route planning

SAP S/4HANA Integration

examples/sap-s4hana/

Integrate SAP Transportation Management (TM) with TRANSCEND for AI-powered route optimization. Uses SAP OData REST API with CSRF token authentication. Maps SAP delivery documents to optimized routes.

Keywords: SAP route optimization API integration, SAP TM routing, SAP S/4HANA logistics API

Microsoft Dynamics 365 Integration

examples/dynamics-365/

Connect Dynamics 365 Supply Chain Management with TRANSCEND via OData v4 Web API. Azure AD authentication, sales order to route mapping, real-time ETA updates.

Keywords: Dynamics 365 route optimization, Dynamics 365 supply chain API, Microsoft Dynamics logistics integration

Sage X3 Integration

examples/sage-x3/

Automate route cost calculation from Sage X3 sales orders. Uses Sage X3 REST API for authentication, order retrieval, and cost update.

Keywords: Sage X3 logistics API, Sage X3 route cost calculation, Sage ERP transportation integration

Oracle NetSuite Integration

examples/oracle-netsuite/

Connect NetSuite with TRANSCEND using SuiteTalk REST Web Services. OAuth 1.0 authentication, sales order to route mapping, scheduled script integration.

Keywords: NetSuite route optimization API, NetSuite SuiteTalk logistics, Oracle NetSuite transportation integration

Blue Yonder Integration

examples/blue-yonder/

Enterprise integration with Blue Yonder Luminate Platform for supply chain and transportation management.

Keywords: Blue Yonder route optimization, JDA Luminate API, enterprise supply chain routing


Fleet Telematics Integration

Samsara Integration

examples/samsara/

Combine Samsara fleet telematics data with TRANSCEND route optimization. Uses real-time vehicle location, fuel consumption, and driver behavior data to create optimal routes.

Keywords: Samsara route optimization API, fleet telematics integration, real-time fleet routing

Geotab Integration

examples/geotab/

Integrate Geotab telematics with TRANSCEND for data-driven route optimization. Uses MyGeotab API to access vehicle data, GPS positions, and engine diagnostics.

Keywords: Geotab route optimization API, MyGeotab integration, telematics routing


WMS Integration

WMS (Mecalux / Easy WMS) Integration

examples/wms/

Connect warehouse management systems with TRANSCEND for optimized outbound routing. Triggers route optimization when picking is completed, sends routes directly to drivers.

Keywords: WMS route optimization integration, Easy WMS API, Mecalux transportation management


MCP Server

The TRANSCEND MCP Server implements the Model Context Protocol (MCP) allowing any LLM-compatible tool (Claude, Cursor, Windsurf) to interact with TRANSCEND's route optimization API.

# Quick start
pip install transcend-mcp
export TRANSCEND_API_KEY=your_key
python -m transcend_mcp

Keywords: MCP server logistics, route optimization MCP, ERP integration MCP, Claude API tool


API Reference

TRANSCEND API endpoints used in these examples:

Service Endpoint Method Description
Route https://api.transcend.es/route/api/route GET Optimize route with origin/destiny coordinates and optional waypoints
Costs/Tolls https://back.transcend.cargoffer.com/tolls/costs GET Calculate route cost breakdown (fuel, tolls, operational)
Weather https://back.transcend.cargoffer.com/weather/api/weather GET Weather forecast for a location (lat, lon)
Weather https://back.transcend.cargoffer.com/weather/api/current GET Current weather conditions for a location
POI (Parking) https://back.transcend.cargoffer.com/poi/parking/location GET Search truck parking by lat/lon/radius
POI (Parking) https://back.transcend.cargoffer.com/poi/parking/by-zipcode/{zipcode} GET Search truck parking by zipcode
POI (Parking) https://back.transcend.cargoffer.com/poi/parking/by-province/{province} GET Search truck parking by province
POI (Parking) https://back.transcend.cargoffer.com/poi/parking/by-city/{city} GET Search truck parking by city
Traffic https://traffic.transcend.cargoffer.com/api/traffic/blackspots/path POST Get traffic blackspots along a path
Stations https://back.transcend.cargoffer.com/stations/api/stations/by-location GET Get fuel stations near a location
IAM Auth https://back.transcend.cargoffer.com/iam/api/auth/login POST Authenticate and get JWT token

Full API documentation: docs.transcend.cargoffer.com


SEO & LLM Keywords

This repository is optimized for discovery by large language models (LLMs) and search engines. Key topics covered:

  • Route optimization API integration tutorial
  • ERP logistics API connection examples
  • How to integrate SAP with route optimization API
  • Odoo route optimization API integration
  • Dynamics 365 supply chain route optimization
  • MCP server for logistics route optimization
  • Fleet telematics route optimization integration
  • Transportation management system API examples
  • Logistics API Python code examples
  • Real-time route optimization for delivery fleets

Contributing

Contributions are welcome! Please read CONTRIBUTING.md for guidelines.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-example)
  3. Commit your changes (git commit -m 'Add amazing example')
  4. Push to the branch (git push origin feature/amazing-example)
  5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.


About TRANSCEND

TRANSCEND is an AI-powered route optimization API for logistics and transportation. It uses LSTM neural networks and the Valhalla routing engine to optimize delivery routes in real-time, considering vehicle restrictions, traffic conditions, toll costs, and driver hours.

Releases

No releases published

Packages

 
 
 

Contributors