UNTERER OCR SIA API dokumentáció
Teljes API referencia a UNTERER OCR SIA szállítási integrációhoz. Hozzáférés a foglaláshoz, fuvarozási árakhoz, címkegeneráláshoz és nyomon követéshez a Cargoson egységes szállításkezelő API-ján keresztül.
Szerezze be API kulcsátUNTERER OCR SIA és 2000+ fuvarozó egyetlen API-n keresztül. Ingyenes 30 perces hívás.
UNTERER OCR SIA API áttekintés
Ez az API programozott hozzáférést biztosít a UNTERER OCR SIA szállítási szolgáltatásaihoz a Cargoson egységes szállításkezelő platformján keresztül. Integráld a UNTERER OCR SIA funkcióit – beleértve a küldemény foglalást, nyomkövetést, árajánlatokat és címkegenerálást – az ERP-dbe, WMS-edbe vagy bármely üzleti rendszeredbe egyetlen API-n keresztül, 2000+ további fuvarozó mellett.
API képességek
- UNTERER OCR SIA küldemény foglalások létrehozása és kezelése
- Küldemény nyomon követés és státusz frissítések
- Fuvarozási árajánlatok és szállítási idők lekérése
- Szállítási címkék generálása több formátumban (PDF, PNG, ZPL)
- Visszáru címkék létrehozása visszirányú logisztikához
- Csomagautomata és átvételi pont helyszínek lekérdezése
- Elérhető fuvarozói szolgáltatások listázása
- Automatizált futár átvételi kérések
Alap URL és hitelesítés
Alap URL
https://www.cargoson.com/api/v1
Hitelesítés
Minden kérésnek tartalmaznia kell az API kulcsát és a megfelelő Accept fejlécet:
Authorization: Bearer AZ_ÖN_API_KULCSA
Accept: application/vnd.api.v1
UNTERER OCR SIA foglalási API
Cargoson automatizálásA UNTERER OCR SIA nem biztosít foglalási API-t. A Cargoson automatikusan küld foglalási megerősítéseket e-mailben az Ön nevében, miközben továbbra is ugyanazt az egységes API felületet használja.
UNTERER OCR SIA küldemények létrehozása és szállítási címkék lekérése a Queries végpont használatával. A foglalások valós időben kerülnek elküldésre a fuvarozó rendszerébe, és a címkék azonnal generálódnak.
Lekérdezés vs közvetlen foglalás
A Queries végpont két foglalási módszert támogat:
- Lekérdezési mód - Szállítási kérés létrehozása fuvarozó megadása nélkül (még). Ez lehetővé teszi, hogy manuálisan összehasonlítsa a fuvarozók árait és szállítási idejét, új spot árakat kérjen, módosításokat/frissítéseket végezzen a küldeményen, és delegálja a fuvarozó kiválasztását másoknak, mielőtt meghozza a végső fuvarozó választást a Cargosonban.
- Közvetlen foglalás - Adjon meg egy fuvarozói szolgáltatás azonosítót (a Rate vagy Services API-ból), hogy közvetlenül foglaljon a UNTERER OCR SIA-nél. Ez biztosítja, hogy a küldeménye pontosan a kiválasztott szolgáltatást használja.
A UNTERER OCR SIA-nél történő közvetlen foglaláshoz mindig adja meg a direct_booking_service_id-t.
/queries
Küldemény lekérdezés vagy közvetlen foglalás létrehozása a UNTERER OCR SIA-hez. Adja meg a direct_booking_service_id-t azonnali foglalás létrehozásához.
Request Parameters
collection_date
string
required
Átvételi dátum ÉÉÉÉ-HH-NN formátumban
collection_country
string
required
Átvételi ország kód (ISO 3166-1 alpha-2)
collection_postcode
string
required
Átvételi irányítószám
collection_address_row_1
string
required
Átvételi utca cím
collection_city
string
required
Átvételi város
collection_company_name
string
required
Feladó cég neve
collection_contact_name
string
required
Feladó kapcsolattartó személy
collection_contact_phone
string
required
Feladó telefonszám
delivery_country
string
required
Szállítási ország kód
delivery_postcode
string
required
Szállítási irányítószám
delivery_address_row_1
string
required
Szállítási utca cím
delivery_city
string
required
Szállítási város
delivery_company_name
string
required
Címzett cég neve
delivery_contact_name
string
required
Címzett kapcsolattartó személy
delivery_contact_phone
string
required
Címzett telefonszám
rows_attributes
array
required
Csomagok/raklapok tömbje mennyiséggel, csomag típussal, súllyal és leírással
options[direct_booking_service_id]
integer
UNTERER OCR SIA szolgáltatás azonosító közvetlen foglaláshoz
Example: Direct Booking Request
{
"collection_date": "2026-02-15",
"collection_country": "DE",
"collection_postcode": "10115",
"collection_address_row_1": "Hauptstraße 123",
"collection_city": "Berlin",
"collection_company_name": "Demo GmbH",
"collection_contact_name": "Max Mustermann",
"collection_contact_phone": "+4930123456",
"delivery_country": "SE",
"delivery_postcode": "11122",
"delivery_address_row_1": "Drottninggatan 45",
"delivery_city": "Stockholm",
"delivery_company_name": "Demo Sweden AB",
"delivery_contact_name": "Erik Andersson",
"delivery_contact_phone": "+46812345678",
"rows_attributes": [
{
"quantity": 1,
"package_type": "EUR",
"weight": 100.0,
"description": "Goods on EUR pallet"
}
],
"options": {
"direct_booking_service_id": 1234
}
}
Example Response
{
"id": 12345,
"reference": "CG12345",
"status": "booked",
"latest_status": "confirmed",
"tracking_reference": "ABC1234567890",
"tracking_url": "https://tracking.carrier.com/ABC1234567890",
"label_url": "https://www.cargoson.com/labels/abc123.pdf",
"confirmed_at": "2026-02-15T10:30:00Z"
}
Címke generálás
A UNTERER OCR SIA szállítási címkék automatikusan generálódnak a foglalás létrehozásakor. A címkék több formátumban érhetők el a különböző nyomtatótípusok támogatásához.
Támogatott címke formátumok
a4 - A4 PDF formátum asztali nyomtatókhoz (4 címke oldalanként)label_printer - 4x6 hüvelyk (~10x15cm) PDF formátum termál nyomtatókhoz
A címkék a foglalási válaszban szerepelnek a label_url mezőn keresztül. Töltse le és nyomtassa ki a címkét a megadott URL-ről a foglalás után.
UNTERER OCR SIA árazási API (fuvarozási árazás)
Cargoson motorA UNTERER OCR SIA nem biztosít natív árazási API-t. A Cargoson fuvarozási ár motorja kiszámítja az árakat a feltöltött ármegállapodások használatával, ugyanazt az API élményt nyújtva, mint a natív árazási API-val rendelkező fuvarozók. Feltöltheti a fuvarozói árakat bármilyen formátumban (Excel, PDF, akár kézzel írt árlisták), és mi digitalizáljuk őket.
Valós idejű UNTERER OCR SIA fuvarozási árak lekérése foglalás előtt. A Rate API visszaadja az elérhető szolgáltatásokat, árakat és becsült szállítási időket.
/freightPrices/list
Fuvarozási árajánlatok lekérése a UNTERER OCR SIA-től és más aktivált fuvarozóktól a fiókján.
Request Parameters
collection_date
string
required
Átvételi dátum ÉÉÉÉ-HH-NN formátumban
collection_country
string
required
Átvételi ország kód (ISO 3166-1 alpha-2)
collection_postcode
string
required
Átvételi irányítószám
delivery_country
string
required
Szállítási ország kód
delivery_postcode
string
required
Szállítási irányítószám
rows_attributes
array
required
Csomagok/raklapok tömbje mennyiséggel, csomag típussal, súllyal és leírással
Example Request
{
"collection_date": "2026-02-15",
"collection_postcode": "10115",
"collection_country": "DE",
"collection_with_tail_lift": true,
"collection_prenotification": true,
"delivery_postcode": "11122",
"delivery_country": "SE",
"delivery_with_tail_lift": true,
"delivery_prenotification": true,
"delivery_return_document": true,
"delivery_to_private_person": true,
"frigo": true,
"adr": false,
"rows_attributes": [
{
"quantity": 1,
"package_type": "EUR",
"weight": 100.0,
"description": "Goods on EUR pallet"
},
{
"quantity": 2,
"package_type": "FIN",
"weight": 300.0,
"description": "Goods on two FIN pallets"
}
],
"request_external_partners": false
}
Example Response
{
"status": 200,
"object": {
"prices": [
{
"carrier": "UNTERER GmbH OCR",
"reg_no": "40203441543",
"id": 5403,
"service": "Main",
"service_id": 85,
"price": "19.13",
"unit": "payable_weight",
"type": "price_list"
},
{
"carrier": "UNTERER GmbH OCR",
"reg_no": "40203441543",
"id": 5403,
"service": "Express Service",
"service_id": 123,
"price": "32.50",
"unit": "real_weight",
"type": "online"
},
{
"carrier": "Demo Logistics GmbH",
"reg_no": "87654321",
"id": 456,
"service": "Main",
"service_id": 555,
"price": "20.00",
"unit": "payable_weight",
"type": "price_list"
}
]
}
}
UNTERER OCR SIA nyomon követési API
Cargoson automatizálásA UNTERER OCR SIA nem biztosít nyomon követési eseményeket API-n keresztül. A Cargoson nyomon követési portált biztosít, ahol a fuvarozó manuálisan frissítheti a küldemény státuszát, így Ön és ügyfelei következetes nyomon követési élményt kapnak.
UNTERER OCR SIA küldemények nyomon követése a Cargoson hivatkozási szám használatával. Aktuális státusz, helyszín frissítések és becsült szállítási idő lekérése.
/bookings/{reference}
Nyomon követési részletek lekérése egy UNTERER OCR SIA küldeményhez a Cargoson foglalási hivatkozás használatával.
Example Response
{
"reference": "CG12345",
"status": "in_transit",
"latest_status": "collected",
"tracking_reference": "ABC1234567890",
"tracking_url": "https://tracking.carrier.com/ABC1234567890",
"confirmed_at": "2026-02-15T10:30:00Z",
"collected_at": "2026-02-15T14:20:00Z",
"estimated_delivery": "2026-02-18T16:00:00Z"
}
UNTERER OCR SIA visszáru címkék API
Cargoson technológiávalA UNTERER OCR SIA nem támogatja natívan a visszáru címkéket. A Cargoson generálja a visszáru címkéket és kezeli a visszáru logisztikai folyamatot platformunkon keresztül.
Visszáru szállítási címkék generálása UNTERER OCR SIA küldeményekhez. A visszáru címkék lehetővé teszik az ügyfelek számára, hogy előre fizetett szállítással küldjék vissza a termékeket.
/bookings/{reference}/return_labels
Visszáru címke létrehozása egy meglévő UNTERER OCR SIA küldeményhez.
Request Parameters
label_format
string
Címke formátum: a4 vagy label_printer (alapértelmezett: a4)
Example Request
{
"label_format": "a4"
}
Example Response
{
"return_label_url": "https://www.cargoson.com/labels/return_abc123.pdf",
"tracking_reference": "RETURN9876543210",
"tracking_url": "https://tracking.carrier.com/RETURN9876543210"
}
Visszáru címke funkciók
- Előre fizetett visszáru szállítási címkék
- Ugyanazok a formátum opciók, mint a kimenő címkéknél (A4, termál)
- Külön nyomon követési hivatkozás a visszárukhoz
- Zökkenőmentes integráció a UNTERER OCR SIA visszáru szolgáltatásaival
UNTERER OCR SIA futár kérések
Cargoson automatizálásA Cargoson automatizálja a futár átvételi kéréseket a UNTERER OCR SIA küldeményekhez, ami eggyel kevesebb feladat, amiről gondoskodnia kell.
Hogyan kezeli a Cargoson a futár kéréseket
Sok szállítási fuvarozó megköveteli, hogy külön hozza létre a címkéket, majd manuálisan kérje a futár átvételt. Másoknak nincs külön címke plusz futár hívás rendszere, és minden küldemény egy teljes, különálló küldemény. Úgy gondoljuk, hogy egyetlen szabványnak kellene lennie a fuvarozói API-khoz, de jelenleg minden fuvarozó saját egyedi rendszert hoz létre, ami megnehezíti a felhasználók számára, hogy megjegyezzék az egyes rendszerek sajátosságait és bonyolultságait. A Cargoson leegyszerűsíti a futár hívásokat azáltal, hogy minden küldeményt holisztikusan kezel: a futár kérések automatikusan kezelve vannak a foglalási folyamat részeként.
Intelligens átvétel optimalizálás
A Cargoson optimalizálja a futár hívásokat a költségek csökkentése és a hatékonyság javítása érdekében.
- 1. Köteg konszolidáció - Ugyanarról a helyszínről érkező több küldemény egyetlen átvételi kéréssé csoportosul
- 2. Fuvarozó-specifikus kezelés - Egyes fuvarozók az átvételt a foglalásba foglalják, mások külön kéréseket igényelnek. A Cargoson mindkét változatot automatikusan kezeli Önnek
- 3. Rendszeres átvételi ütemezések - Állítson be előre ütemezett átvételeket meghatározott időközönként (pl. naponta a fő raktáramba délután 3-kor), és a Cargoson teljesen kihagyja az egyedi futár hívásokat
Előnyök
- Nem kell nyomon követni, hogy mely fuvarozók igényelnek külön futár kéréseket
- Az automatikus optimalizálás megakadályozza a szükségtelen átvételi hívásokat
- Rendszeres átvételi ütemezések támogatása
- Egyszerűsített szállítási munkafolyamat - csak hozza létre a foglalást
Konfiguráció
A futár átvétel automatizálás alapértelmezés szerint engedélyezve van minden UNTERER OCR SIA küldeményhez. A rendszeres átvételi ütemezések vagy egyéni átvétel optimalizálási szabályok konfigurálásához vegye fel a kapcsolatot a [email protected] címmel.
UNTERER OCR SIA szolgáltatások API
Cargoson motorA Services API egy Cargoson által biztosított funkció, amely egységes listát ad vissza a UNTERER OCR SIA-től és hálózatában lévő más fuvarozóktól elérhető összes szolgáltatásról. Ez lehetővé teszi, hogy dinamikusan jelenítse meg a szállítási opciókat ügyfeleinek anélkül, hogy hardkódolná a szolgáltatás azonosítókat.
Elérhető UNTERER OCR SIA szállítási szolgáltatások listájának lekérése. Használja a szolgáltatás azonosítókat közvetlen foglalások esetén, hogy biztosítsa a kívánt szolgáltatást.
/services/list
A vállalati fiókján elérhető UNTERER OCR SIA szolgáltatások listájának visszaadása.
Example Response
{
"services": [
{
"carrier": {
"id": 5403,
"name": "UNTERER GmbH OCR",
"short_name": "UNTERER OCR SIA",
"reg_no": "40203441543"
},
"id": 85,
"name": "Main",
"service_type": "road_freight"
},
{
"carrier": {
"id": 5403,
"name": "UNTERER GmbH OCR",
"short_name": "UNTERER OCR SIA",
"reg_no": "40203441543"
},
"id": 123,
"name": "Express Service",
"service_type": "express"
}
]
}
Szolgáltatás azonosítók használata
Ennek a végpontnak a szolgáltatás azonosítói használhatók a direct_booking_service_id paraméterrel foglalások létrehozásakor, hogy kiválassza a megfelelő szolgáltatást és elküldje a küldeményt a UNTERER OCR SIA rendszerbe.
Teljes kódpéldák
Az alábbiakban teljes működő példák találhatók, amelyek a teljes munkafolyamatot mutatják be: árak lekérése, szolgáltatás kiválasztása, küldemény foglalása és nyomon követési információk kinyerése.
# Define the service ID you want to use
CARRIER_SERVICE_ID=85
# Step 1: Get freight prices for UNTERER OCR SIA
curl -X POST https://www.cargoson.com/api/v1/freightPrices/list \
-H "Content-Type: application/json" \
-H "Accept: application/vnd.api.v1" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"collection_date": "2026-02-15",
"collection_country": "DE",
"collection_postcode": "10115",
"delivery_country": "SE",
"delivery_postcode": "11122",
"rows_attributes": [{
"quantity": 1,
"package_type": "EUR",
"weight": 100.0,
"description": "Goods on EUR pallet"
}]
}'
# Extract the price for your service from response:
# transport_price=$(echo "$response" | jq '.object.prices[] | select(.service_id==85) | .price')
# Step 2: Book shipment using the service_id
curl -X POST https://www.cargoson.com/api/v1/queries \
-H "Content-Type: application/json" \
-H "Accept: application/vnd.api.v1" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"collection_date": "2026-02-15",
"collection_country": "DE",
"collection_postcode": "10115",
"collection_address_row_1": "Hauptstraße 123",
"collection_city": "Berlin",
"collection_company_name": "Demo GmbH",
"collection_contact_name": "Max Mustermann",
"collection_contact_phone": "+4930123456",
"delivery_country": "SE",
"delivery_postcode": "11122",
"delivery_address_row_1": "Drottninggatan 45",
"delivery_city": "Stockholm",
"delivery_company_name": "Demo Sweden AB",
"delivery_contact_name": "Erik Andersson",
"delivery_contact_phone": "+46812345678",
"rows_attributes": [{
"quantity": 1,
"package_type": "EUR",
"weight": 100.0,
"description": "Goods on EUR pallet"
}],
"options": {
"direct_booking_service_id": '$CARRIER_SERVICE_ID'
}
}'
# Response contains:
# - reference: "CG12345"
# - tracking_url: "https://tracking.carrier.com/..."
# - label_url: "https://www.cargoson.com/labels/abc123.pdf"
const axios = require('axios');
const API_KEY = 'YOUR_API_KEY';
const BASE_URL = 'https://www.cargoson.com/api/v1';
const CARRIER_SERVICE_ID = 85;
async function bookToUNTEREROCRSIA() {
try {
// Step 1: Get freight prices
const pricesResponse = await axios.post(`${BASE_URL}/freightPrices/list`, {
collection_date: '2026-02-15',
collection_country: 'DE',
collection_postcode: '10115',
delivery_country: 'SE',
delivery_postcode: '11122',
rows_attributes: [{
quantity: 1,
package_type: 'EUR',
weight: 100.0,
description: 'Goods on EUR pallet'
}]
}, {
headers: {
'Content-Type': 'application/json',
'Accept': 'application/vnd.api.v1',
'Authorization': `Bearer ${API_KEY}`
}
});
// Step 2: Find service by ID and extract price
const prices = pricesResponse.data.object.prices;
const selectedService = prices.find(p => p.service_id === CARRIER_SERVICE_ID);
if (!selectedService) {
throw new Error(`Service ID ${CARRIER_SERVICE_ID} not found in prices`);
}
const transportPrice = selectedService.price;
console.log(`Selected service price: €${transportPrice}`);
// Step 3: Book shipment using the service_id
const bookingResponse = await axios.post(`${BASE_URL}/queries`, {
collection_date: '2026-02-15',
collection_country: 'DE',
collection_postcode: '10115',
collection_address_row_1: 'Hauptstraße 123',
collection_city: 'Berlin',
collection_company_name: 'Demo GmbH',
collection_contact_name: 'Max Mustermann',
collection_contact_phone: '+4930123456',
delivery_country: 'SE',
delivery_postcode: '11122',
delivery_address_row_1: 'Drottninggatan 45',
delivery_city: 'Stockholm',
delivery_company_name: 'Demo Sweden AB',
delivery_contact_name: 'Erik Andersson',
delivery_contact_phone: '+46812345678',
rows_attributes: [{
quantity: 1,
package_type: 'EUR',
weight: 100.0,
description: 'Goods on EUR pallet'
}],
options: {
direct_booking_service_id: CARRIER_SERVICE_ID
}
}, {
headers: {
'Content-Type': 'application/json',
'Accept': 'application/vnd.api.v1',
'Authorization': `Bearer ${API_KEY}`
}
});
// Extract important fields
const reference = bookingResponse.data.reference;
const trackingUrl = bookingResponse.data.tracking_url;
const labelUrl = bookingResponse.data.label_url;
console.log('Shipment booked successfully!');
console.log(`Reference: ${reference}`);
console.log(`Tracking: ${trackingUrl}`);
console.log(`Label: ${labelUrl}`);
return { reference, trackingUrl, labelUrl };
} catch (error) {
console.error('Error:', error.response?.data || error.message);
}
}
// Usage
bookToUNTEREROCRSIA();
import requests
API_KEY = 'YOUR_API_KEY'
BASE_URL = 'https://www.cargoson.com/api/v1'
CARRIER_SERVICE_ID = 85
def book_to_unterer_ocr_sia():
headers = {
'Content-Type': 'application/json',
'Accept': 'application/vnd.api.v1',
'Authorization': f'Bearer {API_KEY}'
}
# Step 1: Get freight prices
prices_data = {
'collection_date': '2026-02-15',
'collection_country': 'DE',
'collection_postcode': '10115',
'delivery_country': 'SE',
'delivery_postcode': '11122',
'rows_attributes': [{
'quantity': 1,
'package_type': 'EUR',
'weight': 100.0,
'description': 'Goods on EUR pallet'
}]
}
prices_response = requests.post(
f'{BASE_URL}/freightPrices/list',
headers=headers,
json=prices_data
)
prices_response.raise_for_status()
# Step 2: Find service by ID and extract price
prices = prices_response.json()['object']['prices']
selected_service = next(
(p for p in prices if p['service_id'] == CARRIER_SERVICE_ID),
None
)
if not selected_service:
raise ValueError(f'Service ID {CARRIER_SERVICE_ID} not found in prices')
transport_price = selected_service['price']
print(f'Selected service price: €{transport_price}')
# Step 3: Book shipment using the service_id
booking_data = {
'collection_date': '2026-02-15',
'collection_country': 'DE',
'collection_postcode': '10115',
'collection_address_row_1': 'Hauptstraße 123',
'collection_city': 'Berlin',
'collection_company_name': 'Demo GmbH',
'collection_contact_name': 'Max Mustermann',
'collection_contact_phone': '+4930123456',
'delivery_country': 'SE',
'delivery_postcode': '11122',
'delivery_address_row_1': 'Drottninggatan 45',
'delivery_city': 'Stockholm',
'delivery_company_name': 'Demo Sweden AB',
'delivery_contact_name': 'Erik Andersson',
'delivery_contact_phone': '+46812345678',
'rows_attributes': [{
'quantity': 1,
'package_type': 'EUR',
'weight': 100.0,
'description': 'Goods on EUR pallet'
}],
'options': {
'direct_booking_service_id': CARRIER_SERVICE_ID
}
}
booking_response = requests.post(
f'{BASE_URL}/queries',
headers=headers,
json=booking_data
)
booking_response.raise_for_status()
booking = booking_response.json()
# Extract important fields
reference = booking['reference']
tracking_url = booking['tracking_url']
label_url = booking['label_url']
print('Shipment booked successfully!')
print(f'Reference: {reference}')
print(f'Tracking: {tracking_url}')
print(f'Label: {label_url}')
return {
'reference': reference,
'tracking_url': tracking_url,
'label_url': label_url
}
# Usage
if __name__ == '__main__':
book_to_unterer_ocr_sia()
<?php
$apiKey = 'YOUR_API_KEY';
$baseUrl = 'https://www.cargoson.com/api/v1';
define('CARRIER_SERVICE_ID', 85);
function bookToUNTEREROCRSIA($apiKey, $baseUrl) {
$headers = [
'Content-Type: application/json',
'Accept: application/vnd.api.v1',
'Authorization: Bearer ' . $apiKey
];
// Step 1: Get freight prices
$pricesData = [
'collection_date' => '2026-02-15',
'collection_country' => 'DE',
'collection_postcode' => '10115',
'delivery_country' => 'SE',
'delivery_postcode' => '11122',
'rows_attributes' => [[
'quantity' => 1,
'package_type' => 'EUR',
'weight' => 100.0,
'description' => 'Goods on EUR pallet'
]]
];
$ch = curl_init($baseUrl . '/freightPrices/list');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($pricesData));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$pricesResponse = curl_exec($ch);
curl_close($ch);
$prices = json_decode($pricesResponse, true)['object']['prices'];
// Step 2: Find service by ID and extract price
$selectedService = null;
foreach ($prices as $price) {
if ($price['service_id'] === CARRIER_SERVICE_ID) {
$selectedService = $price;
break;
}
}
if (!$selectedService) {
throw new Exception('Service ID ' . CARRIER_SERVICE_ID . ' not found in prices');
}
$transportPrice = $selectedService['price'];
echo "Selected service price: €$transportPrice
";
// Step 3: Book shipment using the service_id
$bookingData = [
'collection_date' => '2026-02-15',
'collection_country' => 'DE',
'collection_postcode' => '10115',
'collection_address_row_1' => 'Hauptstraße 123',
'collection_city' => 'Berlin',
'collection_company_name' => 'Demo GmbH',
'collection_contact_name' => 'Max Mustermann',
'collection_contact_phone' => '+4930123456',
'delivery_country' => 'SE',
'delivery_postcode' => '11122',
'delivery_address_row_1' => 'Drottninggatan 45',
'delivery_city' => 'Stockholm',
'delivery_company_name' => 'Demo Sweden AB',
'delivery_contact_name' => 'Erik Andersson',
'delivery_contact_phone' => '+46812345678',
'rows_attributes' => [[
'quantity' => 1,
'package_type' => 'EUR',
'weight' => 100.0,
'description' => 'Goods on EUR pallet'
]],
'options' => [
'direct_booking_service_id' => CARRIER_SERVICE_ID
]
];
$ch = curl_init($baseUrl . '/queries');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($bookingData));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$bookingResponse = curl_exec($ch);
curl_close($ch);
$booking = json_decode($bookingResponse, true);
// Extract important fields
$reference = $booking['reference'];
$trackingUrl = $booking['tracking_url'];
$labelUrl = $booking['label_url'];
echo "Shipment booked successfully!
";
echo "Reference: $reference
";
echo "Tracking: $trackingUrl
";
echo "Label: $labelUrl
";
return [
'reference' => $reference,
'tracking_url' => $trackingUrl,
'label_url' => $labelUrl
];
}
// Usage
bookToUNTEREROCRSIA($apiKey, $baseUrl);
?>
require 'net/http'
require 'json'
API_KEY = 'YOUR_API_KEY'
BASE_URL = 'https://www.cargoson.com/api/v1'
CARRIER_SERVICE_ID = 85
def book_to_unterer_ocr_sia
headers = {
'Content-Type' => 'application/json',
'Accept' => 'application/vnd.api.v1',
'Authorization' => "Bearer #{API_KEY}"
}
# Step 1: Get freight prices
prices_uri = URI("#{BASE_URL}/freightPrices/list")
prices_data = {
collection_date: '2026-02-15',
collection_country: 'DE',
collection_postcode: '10115',
delivery_country: 'SE',
delivery_postcode: '11122',
rows_attributes: [{
quantity: 1,
package_type: 'EUR',
weight: 100.0,
description: 'Goods on EUR pallet'
}]
}
http = Net::HTTP.new(prices_uri.host, prices_uri.port)
http.use_ssl = true
prices_request = Net::HTTP::Post.new(prices_uri)
headers.each { |k, v| prices_request[k] = v }
prices_request.body = prices_data.to_json
prices_response = http.request(prices_request)
prices = JSON.parse(prices_response.body)['object']['prices']
# Step 2: Find service by ID and extract price
selected_service = prices.find { |p| p['service_id'] == CARRIER_SERVICE_ID }
raise "Service ID #{CARRIER_SERVICE_ID} not found in prices" unless selected_service
transport_price = selected_service['price']
puts "Selected service price: €#{transport_price}"
# Step 3: Book shipment using the service_id
booking_uri = URI("#{BASE_URL}/queries")
booking_data = {
collection_date: '2026-02-15',
collection_country: 'DE',
collection_postcode: '10115',
collection_address_row_1: 'Hauptstraße 123',
collection_city: 'Berlin',
collection_company_name: 'Demo GmbH',
collection_contact_name: 'Max Mustermann',
collection_contact_phone: '+4930123456',
delivery_country: 'SE',
delivery_postcode: '11122',
delivery_address_row_1: 'Drottninggatan 45',
delivery_city: 'Stockholm',
delivery_company_name: 'Demo Sweden AB',
delivery_contact_name: 'Erik Andersson',
delivery_contact_phone: '+46812345678',
rows_attributes: [{
quantity: 1,
package_type: 'EUR',
weight: 100.0,
description: 'Goods on EUR pallet'
}],
options: {
direct_booking_service_id: CARRIER_SERVICE_ID
}
}
booking_request = Net::HTTP::Post.new(booking_uri)
headers.each { |k, v| booking_request[k] = v }
booking_request.body = booking_data.to_json
booking_response = http.request(booking_request)
booking = JSON.parse(booking_response.body)
# Extract important fields
reference = booking['reference']
tracking_url = booking['tracking_url']
label_url = booking['label_url']
puts 'Shipment booked successfully!'
puts "Reference: #{reference}"
puts "Tracking: #{tracking_url}"
puts "Label: #{label_url}"
{
reference: reference,
tracking_url: tracking_url,
label_url: label_url
}
end
# Usage
book_to_unterer_ocr_sia
Miért használja a Cargoson API-t a UNTERER OCR SIA integrációhoz
A közvetlenül a UNTERER OCR SIA natív API-jával történő integráció azt jelenti, hogy fuvarozó-specifikus dokumentációval kell birkóznia, egyedi adatformátumokat kell kezelnie, és külön kódot kell karbantartania minden szolgáltatóhoz. A Cargoson egyetlen egységes RESTful API-t kínál, amely támogatja a UNTERER OCR SIA-t és 2000+ fuvarozót az európai és észak-amerikai piacokon, hetente új integrációkkal bővülve. Hónapokról napokra csökkentjük a fejlesztési időt, automatikusan kezeljük a fuvarozói frissítéseket, és kezeljük a regionális kivételeket. A Cargosonnal az üzlete növelésére összpontosíthat ahelyett, hogy a fuvarozói technikai bonyolultságokat kezelné.
A UNTERER OCR SIA Cargoson API-n keresztüli integrálásának előnyei
Egy API minden fuvarozóhoz
Cserélje le a tucatnyi külön fuvarozói integrációt egyetlen kapcsolatra a UNTERER OCR SIA-rel és 2000+ más szolgáltatóval a Cargoson API-n keresztül. Nincs több különböző hitelesítési rendszer karbantartása, különböző adatformátumok kezelése, vagy kód frissítése, amikor a fuvarozók megváltoztatják a végpontjaikat.
Világos dokumentáció és támogatás
Hozzáférés egyértelmű API dokumentációhoz működő kódpéldákkal, részletes paraméter leírásokkal és világosan meghatározott végpontokkal. Támogatási csapatunk ismeri a logisztikai iparágat, és gyorsan segíthet megoldani az integrációs kihívásokat.
Kódpéldák több nyelven
Kezdjen el azonnal használatra kész kódpéldákkal cURL, JavaScript, Python, PHP és Ruby nyelven. Másolja, illessze be és alakítsa át őket a saját technológiájához, nem kell a hitelesítést, kérés formázást vagy hibakezelést a nulláról kitalálni.
Valódi támogatás logisztikai szakértőktől
Kapjon segítséget olyan emberektől, akik értik a szállítást, nem csak az API-kat. Akár integrációs problémát old meg, akár tanácsra van szüksége a nemzetközi küldemények legjobb kezeléséhez, csapatunk itt van, hogy segítsen.
A világ legfejlettebb fuvarozási árazó motorja
A Cargoson fuvarozási árazási API-ja messze túlmutat az egyszerű ár lekérdezéseken. Motorunk képes olvasni, elemezni és digitalizálni bármilyen fuvarozói árlistát, függetlenül a formátumtól vagy struktúrától, így a logisztikai iparág legerősebb fuvarozási ár kezelési megoldása.
Univerzális formátum támogatás
Fuvarozási árazó motorunk bármilyen formátumot kezel: strukturált Excel fájlok, összetett PDF-ek, szabad szöveg, vagy akár kézzel írt árlisták. Töltse fel fuvarozói szerződéseit bármilyen formátumban, és fuvarozási ár motorunk automatikusan elemzi az árazási szabályokat, pótdíjakat és feltételeket.
Közvetlen fuvarozói API integráció
Modern rendszerekkel rendelkező fuvarozók esetében (jellemzően globális csomagfuvarozók és technológia-orientált fuvarozó cégek) közvetlenül az API-jukból húzzuk az árakat valós időben. Ez biztosítja, hogy mindig a legfrissebb árazást kapja kézi frissítések nélkül.
Nyilvános online árak
Még nincs szerződése egy fuvarozóval? Nem probléma. A Cargoson képes lekérni a nyilvános online árakat a fuvarozóktól, lehetővé téve az opciók összehasonlítását még a formális megállapodások létrehozása előtt.
Spot ár kérések
Összetett küldemények vagy speciális esetek esetén kérjen spot árakat, ahol a fuvarozók áttekintik az Ön konkrét követelményeit és egyedi árajánlatot adnak. Minden ugyanazon az egységes API-n keresztül kezelhető.
UNTERER OCR SIA szállítási API: Egyszerűsített logisztikai automatizálás
Automatizálja teljesítési folyamatát a Cargoson szállítási API integrálásával a UNTERER OCR SIA-rel és 2000+ fuvarozóval világszerte. Hozzon létre szállítási címkéket, foglaljon átvételeket, és kezelje az összes fuvarozóját egyetlen platformról, miközben megtartja a megtárgyalt árait minden szolgáltatóval.
Automatizált címke generálás
Generáljon fuvarozó által jóváhagyott szállítási címkéket egyetlen API kéréssel. Több címke formátum támogatása (A4, termál nyomtató) és automatikus vámkezelési dokumentáció nemzetközi küldeményekhez kevesebb kézi munkát és kevesebb szállítási hibát jelent.
Valós idejű ár összehasonlítás
Hasonlítsa össze az élő árakat a UNTERER OCR SIA és más aktivált fuvarozói között, hogy a legjobb opciót válassza költség, sebesség és szolgáltatási szint alapján.
Tartsa meg megtárgyalt árait
Csatlakoztassa meglévő UNTERER OCR SIA fiókját, hogy megtartsa megtárgyalt szállítási árait. A Cargoson egyszerűen biztosítja a technikai integrációt: Ön megtartja közvetlen fuvarozói kapcsolatait és egyedi árazási megállapodásait.
Vállalati szintű biztonság a UNTERER OCR SIA API integrációhoz
A Cargoson API infrastruktúrája megfelel az európai megfelelőségi szabványoknak, amelyek biztonságos, audit-kész UNTERER OCR SIA integrációt biztosítanak vállalkozása számára:
- GDPR-kompatibilis adatkezelés és tárolás Európa-szerte
- ISO 27001 tanúsított információbiztonsági menedzsment
- Végponttól végpontig titkosítás minden API kommunikációhoz
Készen áll a UNTERER OCR SIA szállítás integrálására a platformjába?
Akár ERP bővítményt fejlesztesz, fuvarozó integrációt építesz, vagy fuvarozóidat kapcsolod össze üzleti rendszereiddel – beszéljük meg, hogyan illeszkedik a több fuvarozós API a megoldásodhoz.
Ingyenes konzultáció foglalásaTartalomjegyzék
Gyakran ismételt kérdések
Kezdje el használni a UNTERER OCR SIA API-t
Egyetlen API az összes fuvarozódhoz. Ingyenes 30 perces hívás.