DSV Estonia Air Sea API dokumentáció

Integrált REST API

Teljes API referencia a DSV Estonia Air Sea 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át

DSV Estonia Air Sea API áttekintés

Ez az API programozott hozzáférést biztosít a DSV Estonia Air Sea szállítási szolgáltatásaihoz a Cargoson egységes szállításkezelő platformján keresztül. Integrálja a DSV Estonia Air Sea képességeket, beleértve a küldemény foglalást, nyomon követést, árajánlatokat és címkegenerálást az alkalmazásaiba.

API képességek

  • DSV Estonia Air Sea 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

DSV Estonia Air Sea foglalási API

Közvetlen fuvarozói API

DSV Estonia Air Sea 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 DSV Estonia Air Sea-nél. Ez biztosítja, hogy a küldeménye pontosan a kiválasztott szolgáltatást használja.

A DSV Estonia Air Sea-nél történő közvetlen foglaláshoz mindig adja meg a direct_booking_service_id-t.

POST /queries

Küldemény lekérdezés vagy közvetlen foglalás létrehozása a DSV Estonia Air Sea-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

DSV Estonia Air Sea 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 DSV Estonia Air Sea 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.

DSV Estonia Air Sea árazási API (fuvarozási árazás)

Cargoson motor
Cargoson fejlesztés:

A DSV Estonia Air Sea 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ű DSV Estonia Air Sea 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.

POST /freightPrices/list

Fuvarozási árajánlatok lekérése a DSV Estonia Air Sea-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": "DSV Estonia AS (Air/Sea)",
        "reg_no": "10342368",
        "id": 90,
        "service": "Main",
        "service_id": 85,
        "price": "19.13",
        "unit": "payable_weight",
        "type": "price_list"
      },
      {
        "carrier": "DSV Estonia AS (Air/Sea)",
        "reg_no": "10342368",
        "id": 90,
        "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"
      }
    ]
  }
}

DSV Estonia Air Sea nyomon követési API

Közvetlen fuvarozói API

DSV Estonia Air Sea 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.

GET /bookings/{reference}

Nyomon követési részletek lekérése egy DSV Estonia Air Sea 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"
}

DSV Estonia Air Sea visszáru címkék API

Cargoson technológiával
Cargoson fejlesztés:

A DSV Estonia Air Sea 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 DSV Estonia Air Sea 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.

POST /bookings/{reference}/return_labels

Visszáru címke létrehozása egy meglévő DSV Estonia Air Sea 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 DSV Estonia Air Sea visszáru szolgáltatásaival

DSV Estonia Air Sea futár kérések

Cargoson automatizálás

A Cargoson automatizálja a futár átvételi kéréseket a DSV Estonia Air Sea 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 DSV Estonia Air Sea 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.

DSV Estonia Air Sea szolgáltatások API

Cargoson motor
Cargoson fejlesztés:

A Services API egy Cargoson által biztosított funkció, amely egységes listát ad vissza a DSV Estonia Air Sea-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ő DSV Estonia Air Sea 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.

GET /services/list

A vállalati fiókján elérhető DSV Estonia Air Sea szolgáltatások listájának visszaadása.

Example Response

{
  "services": [
    {
      "carrier": {
        "id": 90,
        "name": "DSV Estonia AS (Air/Sea)",
        "short_name": "DSV Estonia Air Sea",
        "reg_no": "10342368"
      },
      "id": 85,
      "name": "Main",
      "service_type": "road_freight"
    },
    {
      "carrier": {
        "id": 90,
        "name": "DSV Estonia AS (Air/Sea)",
        "short_name": "DSV Estonia Air Sea",
        "reg_no": "10342368"
      },
      "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 DSV Estonia Air Sea 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 DSV Estonia Air Sea
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 bookToDSVEstoniaAirSea() {
  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
bookToDSVEstoniaAirSea();
import requests

API_KEY = 'YOUR_API_KEY'
BASE_URL = 'https://www.cargoson.com/api/v1'
CARRIER_SERVICE_ID = 85

def book_to_dsv_estonia_air_sea():
    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_dsv_estonia_air_sea()
<?php
$apiKey = 'YOUR_API_KEY';
$baseUrl = 'https://www.cargoson.com/api/v1';

define('CARRIER_SERVICE_ID', 85);

function bookToDSVEstoniaAirSea($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
bookToDSVEstoniaAirSea($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_dsv_estonia_air_sea
  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_dsv_estonia_air_sea

Miért használja a Cargoson API-t a DSV Estonia Air Sea integrációhoz

A közvetlenül a DSV Estonia Air Sea 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 DSV Estonia Air Sea-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 DSV Estonia Air Sea 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 DSV Estonia Air Sea-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ő.

DSV Estonia Air Sea 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 DSV Estonia Air Sea-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 DSV Estonia Air Sea é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ő DSV Estonia Air Sea 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 DSV Estonia Air Sea 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 DSV Estonia Air Sea 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 DSV Estonia Air Sea szállítás integrálására a platformjába?

Foglaljon demót, hogy lássa, hogyan egyszerűsítheti le a Cargoson egységes API-ja logisztikai műveleteit

Demó foglalása

Gyakran ismételt kérdések

A Cargoson egy szállításkezelő rendszer (TMS) európai és észak-amerikai gyártók számára. Központi víziónk az egyszerűség: integrálja bármely és minden fuvarozót és fuvarozási módot (közúti, csomag, légi, tengeri, vasúti) egy ablakba és egy API-ba. Akár raklapokat szállít Európa-szerte, akár konténereket tengerentúlra, mindent egyetlen platformról kezelhet.

Az indulás egyszerű. Először regisztráljon egy Cargoson fiókot és szerezze be API kulcsát. Ezután csatlakoztassa DSV Estonia Air Sea fiókját a Cargoson irányítópulton. Ha ez megtörtént, elkezdheti az API kérések küldését dokumentációnk és kódpéldáink használatával. A teljes beállítás általában kevesebb mint egy órát vesz igénybe.

Igen, szüksége lesz saját DSV Estonia Air Sea fiókra a DSV Estonia Air Sea szolgáltatások Cargosonon keresztüli használatához. Ez biztosítja, hogy megtartsa megtárgyalt árait és fenntartsa közvetlen kapcsolatát a DSV Estonia Air Sea-rel. A Cargoson egyszerűen biztosítja a technikai integrációs réteget, amely megkönnyíti a DSV Estonia Air Sea-rel és más fuvarozókkal való munkát egyetlen egységes API-n keresztül.

A Cargoson átlátható havi előfizetési modellel működik küldeményenkénti díjak vagy jutalékok nélkül, soha. Csomagja tartalmazza az API hozzáférést, dokumentációt, támogatást és automatikus frissítéseket, amikor a fuvarozók megváltoztatják rendszereiket. Közvetlenül fizet a DSV Estonia Air Sea-nek a szállításért a megtárgyalt árain. Nincsenek rejtett költségek, nincsenek meglepetések.

Természetesen! Ez a Cargoson használatának fő előnye. Miután integrálta API-nkat, dolgozhat a DSV Estonia Air Sea-rel és 2000+ más fuvarozóval ugyanazokat a végpontokat, hitelesítést és adatformátumokat használva. Adjon hozzá új fuvarozókat új integrációs kód írása nélkül, csak aktiválja őket a Cargoson irányítópulton.

Igen! Integrálunk bármilyen fuvarozót, amire szüksége van, külön költség nélkül. Ez benne van a Cargoson előfizetésében. Csak mutasson be minket fuvarozói kapcsolatainak, és mi kezeljük a technikai integrációt. Új integrációk naponta kerülnek hozzáadásra az ügyfelek kérései alapján.

Igen, beállíthatunk webhookokat, hogy értesítsük rendszerét a Cargosonban történő események és triggerek alapján, mint például küldemény státusz frissítések, foglalási megerősítések vagy küldemények változásai. Vegye fel a kapcsolatot támogatási csapatunkkal vagy foglaljon demót, hogy megvitassuk webhook követelményeit és beállítását.

A Cargoson túlzás lehet, ha Ön egy kis cég, amely csak néhányszor szállít havonta egyetlen fuvarozóval. Valószínűleg jól kezelheti ezeket a küldeményeket TMS nélkül is. Nem is vagyunk megfelelő választás, ha Ön fuvarozó vagy fuvarozási ügynök. A Cargoson kifejezetten haszonhúzó árútulajdonosok (BCO-k) számára készült, mint gyártók és forgalmazók, akik birtokolják a szállított árukat. Ha TMS-t keres továbbítási üzlete vagy fuvarozói műveleteinek kezeléséhez, nem erre a felhasználási esetre terveztük.

API-nk világos hibaüzeneteket ad vissza konkrét hibakódokkal és leírásokkal. A gyakori problémák megoldásokkal együtt dokumentálva vannak fejlesztői dokumentációnkban. Ha elakad, támogatási csapatunk segíthet az integrációs problémák elhárításában.

Ésszerű korlátozásokat alkalmazunk a rendszer stabilitásának biztosítása érdekében minden ügyfél számára. Vannak hosszú távú korlátozások és burst korlátozások is, olyan értékekkel, amelyeknek elegendőnek kell lenniük a legtöbb vállalkozás számára. Ha magasabb korlátokra van szüksége vállalati méretű műveletekhez, vegye fel velünk a kapcsolatot, hogy megvitassuk fiókja egyedi korlátait.

Kezdje el használni a DSV Estonia Air Sea API-t

Szerezze be API hitelesítő adatait az integráció megkezdéséhez

Szerezze be API kulcsát