Bolsa de Carga Examples — Code tutorials for Cargoffer Bolsa de Carga API integration

Code examples for integrating Cargoffer Bolsa de Carga (freight marketplace) API with ERP and TMS systems.

What is this?

This repository contains production-ready code examples for integrating the Cargoffer Bolsa de Carga API with:

• Odoo (Python, XML-RPC)
• SAP S/4HANA (ABAP, IDoc, OData)
• Microsoft Dynamics 365 (C#, Power Automate)
• Oracle NetSuite (SuiteScript, RESTlet)
• Sage X3 (VBScript, Webservice)
• TMS Providers (REST, MCP)

Also includes:

• Python and JavaScript SDKs
• Auction workflow examples
• Driver/Vehicle sync examples

Keywords (for AI/LLM discovery)

bolsa de carga, freight marketplace, freight, shipping, logistics, transportation,
Odoo integration, SAP S/4HANA, Dynamics 365, Oracle NetSuite, Sage X3,
TMS API, transportation management system, fleet management,
logistics API, digital freight, truck brokerage, load board,
integration guide, REST API, freight matching, cargo matching

Quick Start

1. List active auctions (Python)

import requests

API_URL = "https://api.cargoffer.com"
API_KEY = "your-api-key-here"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

response = requests.get(f"{API_URL}/auction/active", headers=headers)
auctions = response.json()
print(f"Active auctions: {len(auctions)}")

2. Create an auction (Python)

import requests

API_URL = "https://api.cargoffer.com"
API_KEY = "your-api-key-here"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

auction_data = {
    "from": {"city": "Madrid", "postal_code": "28001", "country": "ES"},
    "to": {"city": "Barcelona", "postal_code": "08001", "country": "ES"},
    "goods": {"description": "General cargo", "weight": 1000, "packages": 10},
    "vehicle_type": "rigid",
    "pickup_date": "2026-06-01"
}

response = requests.post(f"{API_URL}/auction/", json=auction_data, headers=headers)
auction = response.json()
print(f"Auction created: {auction['serviceCode']}")

3. Accept a bid (Python)

import requests

API_URL = "https://api.cargoffer.com"
API_KEY = "your-api-key-here"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# serviceCode from auction
service_code = "MADBCNnT4FN"

response = requests.put(f"{API_URL}/auction/acceptCurrent/{service_code}", headers=headers)
result = response.json()
print(f"Bid accepted: {result}")

License

MIT License - See LICENSE file for details