Cargobus EE API skjölun

Samþætt REST API

Ítarleg API tilvísun fyrir Cargobus EE sendingarsamþættingu. Aðgangur að bókunum, farmverði, merkjaframleiðslu og rakningu í gegnum sameinað flutningsstjórnunarkerfi Cargoson.

Fáðu API lykilinn þinn

Cargobus EE API yfirlit

Þetta API veitir forritunarlegan aðgang að Cargobus EE flutningsþjónustu í gegnum sameinað flutningsstjórnunarkerfi Cargoson. Samþættið Cargobus EE möguleika þar á meðal sendingabókanir, rakningu, verðtilboð og merkjaframleiðslu í forritin ykkar.

API möguleikar

  • Búa til og stjórna Cargobus EE sendingabókunum
  • Rakning sendinga og stöðuuppfærslur
  • Fá farmverðstilboð og afhendingartíma
  • Búa til sendingarmerki í mörgum sniðum (PDF, PNG, ZPL)
  • Búa til skilamerki fyrir bakflutninga
  • Leita að pakkaskápum og afhendingarstöðum
  • Skoða tiltæka flutningsþjónustu
  • Sjálfvirkar beiðnir um sendiboða

Grunnslóð og auðkenning

Grunnslóð

https://www.cargoson.com/api/v1

Auðkenning

Allar beiðnir verða að innihalda API lykilinn þinn og rétta Accept hausinn:

Authorization: Bearer API_LYKILLINN_ÞINN
Accept: application/vnd.api.v1

Cargobus EE bókunar API

Beint API flutningsaðila

Búðu til Cargobus EE sendingar og fáðu sendingarmerki með því að nota Queries endapunktinn. Bókanir eru sendar í kerfi flutningsaðila í rauntíma og merki eru búin til strax.

Fyrirspurn vs bein bókun

Queries endapunkturinn styður tvær bókunaraðferðir:

  • Fyrirspurnarstilling - Búðu til flutningsbeiðni án þess að tilgreina flutningsaðila (ennþá). Þetta gerir þér kleift að bera saman verð og afhendingartíma flutningsaðila handvirkt, biðja um ný spot-verð, gera breytingar/uppfærslur á sendingunni og framselja val á flutningsaðila til annarra, áður en þú gerir endanlegt val á flutningsaðila í Cargoson.
  • Bein bókun - Tilgreindu þjónustuauðkenni flutningsaðila (frá Rate eða Services API) til að bóka beint hjá Cargobus EE. Þetta tryggir að sendingin þín noti nákvæmlega þá þjónustu sem þú valdir.

Til að bóka beint hjá Cargobus EE, skilgreindu alltaf direct_booking_service_id.

POST /queries

Búðu til sendingafyrirspurn eða beina bókun fyrir Cargobus EE. Láttu direct_booking_service_id fylgja með til að búa til tafarlausa bókun.

Request Parameters

collection_date string required

Sóttdagsetning á sniðinu ÁÁÁÁ-MM-DD

collection_country string required

Sóttkóði lands (ISO 3166-1 alpha-2)

collection_postcode string required

Sóttpóstnúmer

collection_address_row_1 string required

Sóttgötuheimilisfang

collection_city string required

Sóttborg

collection_company_name string required

Nafn sendanda fyrirtækis

collection_contact_name string required

Tengiliður sendanda

collection_contact_phone string required

Símanúmer sendanda

delivery_country string required

Afhendingarkóði lands

delivery_postcode string required

Afhendingarpóstnúmer

delivery_address_row_1 string required

Afhendingargötuheimilisfang

delivery_city string required

Afhendingarborg

delivery_company_name string required

Nafn viðtakanda fyrirtækis

delivery_contact_name string required

Tengiliður viðtakanda

delivery_contact_phone string required

Símanúmer viðtakanda

rows_attributes array required

Fylki af pökkum/vörubretti með magni, pakkagerð, þyngd og lýsingu

options[direct_booking_service_id] integer

Cargobus EE þjónustuauðkenni fyrir beina bókun

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"
}

Merkjaframleiðsla

Cargobus EE sendingarmerki eru sjálfkrafa búin til þegar þú býrð til bókun. Merki eru fáanleg í mörgum sniðum til að styðja mismunandi prentaragerðir.

Studd merkjasnið

a4 - A4 PDF snið fyrir skrifborðsprentara (4 merki á síðu)
label_printer - 4x6in (~10x15cm) PDF snið fyrir hitaprentara

Merki eru innifalin í bókunarsvarinu í gegnum label_url reitinn. Sæktu og prentaðu merkið frá uppgefnu vefslóðinni eftir bókun.

Cargobus EE verð API (farmverð)

Cargoson vél
Cargoson endurbót:

Cargobus EE býður ekki upp á innfædda verð API. Farmverðsvél Cargoson reiknar verð með því að nota hlaðna verðsamninga þína, sem veitir þér sömu API upplifun og flutningsaðilar með innfædd verð API. Þú getur hlaðið upp verðum flutningsaðila á hvaða sniði sem er (Excel, PDF, jafnvel handskrifaða verðlista) og við stafrænum þá.

Fáðu Cargobus EE farmverð í rauntíma áður en þú bókar. Rate API skilar tiltækri þjónustu, verði og áætluðum afhendingartímum.

POST /freightPrices/list

Fáðu farmverðstilboð frá Cargobus EE og öðrum virkjuðum flutningsaðilum á reikningnum þínum.

Request Parameters

collection_date string required

Sóttdagsetning á sniðinu ÁÁÁÁ-MM-DD

collection_country string required

Sóttkóði lands (ISO 3166-1 alpha-2)

collection_postcode string required

Sóttpóstnúmer

delivery_country string required

Afhendingarkóði lands

delivery_postcode string required

Afhendingarpóstnúmer

rows_attributes array required

Fylki af pökkum/vörubretti með magni, pakkagerð, þyngd og lýsingu

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": "T Grupp OÜ (Cargobus)",
        "reg_no": "10056042",
        "id": 19,
        "service": "Main",
        "service_id": 85,
        "price": "19.13",
        "unit": "payable_weight",
        "type": "price_list"
      },
      {
        "carrier": "T Grupp OÜ (Cargobus)",
        "reg_no": "10056042",
        "id": 19,
        "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"
      }
    ]
  }
}

Cargobus EE rakninga API

Beint API flutningsaðila

Raktu Cargobus EE sendingar með Cargoson tilvísunarnúmeri. Fáðu núverandi stöðu, staðsetningaruppfærslur og áætlaðan afhendingartíma.

GET /bookings/{reference}

Sæktu rakningarupplýsingar fyrir Cargobus EE sendingu með Cargoson bókunartilvísun.

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"
}

Cargobus EE skilamerkja API

Keyrt af Cargoson
Cargoson endurbót:

Cargobus EE styður ekki innfædd skilamerki. Cargoson býr til skilamerki og stjórnar skilaflutningaferlinu í gegnum vettvang okkar.

Búðu til skilasendingarmerki fyrir Cargobus EE sendingar. Skilamerki gera viðskiptavinum kleift að senda hluti til baka með fyrirframgreiddum flutningi.

POST /bookings/{reference}/return_labels

Búðu til skilamerki fyrir núverandi Cargobus EE sendingu.

Request Parameters

label_format string

Merkjasnið: a4 eða label_printer (sjálfgefið: 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"
}

Eiginleikar skilamerkja

  • Fyrirframgreidd skilasendingarmerki
  • Sömu sniðvalkostir og útsendingarmerki (A4, hitaprentari)
  • Aðskilin rakningartilvísun fyrir skil
  • Hnökralaus samþætting við Cargobus EE skilaþjónustu

Cargobus EE sendiboðabeiðnir

Cargoson sjálfvirkni

Cargoson gerir sendiboðabeiðnir sjálfvirkar fyrir Cargobus EE sendingar, sem gerir þetta að einu verkefni minna sem þú þarft að hugsa um.

Hvernig Cargoson sér um sendiboðabeiðnir

Margir flutningsaðilar krefjast þess að þú búir til merki sérstaklega og biðjir síðan handvirkt um sendiboða. Aðrir eru ekki með aðskilið merki plús sendiboðakerfi, og hver sending er fullkomin, aðskilin sending. Við trúum því að það ætti að vera einn staðall fyrir API flutningsaðila, en eins og er, býr hver flutningsaðili til sitt einstaka kerfi, sem gerir það erfitt fyrir notendur þeirra að muna sérkennileikar og flækjustig hvers og eins. Cargoson einfaldar sendiboðasímtölin þín með því að meðhöndla hverja sendingu heildrænt: sendiboðabeiðnir eru sjálfkrafa stjórnaðar sem hluti af bókunarferlinu.

Snjöll sóttbesti mun

Cargoson fínstillir sendiboðasímtöl til að draga úr kostnaði og bæta skilvirkni.

  • 1. Samstæðusöfnun - Margar sendingar frá sama stað eru flokkaðar í eina sóttbeiðni
  • 2. Meðhöndlun sérstök fyrir flutningsaðila - Sumir flutningsaðilar innihalda sótt í bókuninni, aðrir krefjast aðskilinna beiðna. Cargoson sér sjálfkrafa um báðar útgáfur fyrir þig
  • 3. Reglulegar sóttáætlanir - Stilltu fyrirfram áætlaðar sóttir á ákveðnum tímabilum (t.d. daglega í aðalvöruhúsið mitt klukkan 15:00) og Cargoson mun sleppa einstökum sendiboðasímtölum alveg

Kostir

  • Engin þörf á að fylgjast með hvaða flutningsaðilar krefjast aðskilinna sendiboðabeiðna
  • Sjálfvirk fínstilling kemur í veg fyrir óþarfa sóttsímtöl
  • Stuðningur við reglulegar sóttáætlanir
  • Einfaldað sendingarferli - búðu bara til bókunina

Stillingar

Sjálfvirkni sendiboðasóttar er sjálfgefið virk fyrir allar Cargobus EE sendingar. Til að stilla reglulegar sóttáætlanir eða sérsniðnar fínstillingarreglur, hafðu samband við [email protected].

Cargobus EE pakkaskápa API

Beint API flutningsaðila

Leitaðu að tiltækum Cargobus EE pakkaskápum og afhendingarstöðum. Notaðu þennan endapunkt til að sýna viðskiptavinum lista yfir nálæga pakkaskápa við afgreiðslu.

GET /parcelMachines

Leitaðu að Cargobus EE pakkaskápum og afhendingarstöðum eftir staðsetningu eða póstnúmeri.

Request Parameters

country string required

Landskóði (ISO 3166-1 alpha-2)

postcode string

Sía eftir póstnúmeri

carrier_id integer

Sía eftir tilteknum flutningsaðila

reference string

Finna tiltekinn pakkaskáp eftir tilvísun

Example Response

{
  "parcel_machines": [
    {
      "id": 123,
      "reference": "PM12345",
      "name": "Parcel Locker - Hauptstraße",
      "carrier_id": 19,
      "carrier_name": "T Grupp OÜ (Cargobus)",
      "address_row_1": "Hauptstraße 123",
      "city": "Berlin",
      "postcode": "10115",
      "country": "DE",
      "latitude": 52.52,
      "longitude": 13.405
    }
  ]
}

Cargobus EE þjónustu API

Cargoson vél
Cargoson endurbót:

Þjónustu API er eiginleiki sem Cargoson veitir sem skilar sameinuðum lista yfir alla tiltæka þjónustu frá Cargobus EE og öðrum flutningsaðilum í netinu þínu. Þetta gerir þér kleift að birta sendingarval á kraftmikinn hátt fyrir viðskiptavini þína án þess að harðkóða þjónustuauðkenni.

Sæktu lista yfir tiltæka Cargobus EE flutningsþjónustu. Notaðu þjónustuauðkenni þegar þú gerir beinar bókanir til að tryggja að þú fáir nákvæmlega þá þjónustu sem þú vilt.

GET /services/list

Skilaðu lista yfir Cargobus EE þjónustu sem er tiltæk á fyrirtækjareikningnum þínum.

Example Response

{
  "services": [
    {
      "carrier": {
        "id": 19,
        "name": "T Grupp OÜ (Cargobus)",
        "short_name": "Cargobus EE",
        "reg_no": "10056042"
      },
      "id": 85,
      "name": "Main",
      "service_type": "road_freight"
    },
    {
      "carrier": {
        "id": 19,
        "name": "T Grupp OÜ (Cargobus)",
        "short_name": "Cargobus EE",
        "reg_no": "10056042"
      },
      "id": 123,
      "name": "Express Service",
      "service_type": "express"
    }
  ]
}

Notkun þjónustuauðkenna

Þjónustuauðkenni frá þessum endapunkti er hægt að nota með direct_booking_service_id færibreytunni þegar bókanir eru búnar til til að velja rétta þjónustu og senda sendinguna í Cargobus EE kerfið.

Fullkomin kóðadæmi

Hér að neðan eru fullkomin vinnandi dæmi sem sýna allt vinnuflæðið: fá verð, velja þjónustu, bóka sendingu og draga út rakningarupplýsingar.

# Define the service ID you want to use
CARRIER_SERVICE_ID=85

# Step 1: Get freight prices for Cargobus EE
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 bookToCargobusEE() {
  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
bookToCargobusEE();
import requests

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

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

define('CARRIER_SERVICE_ID', 85);

function bookToCargobusEE($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
bookToCargobusEE($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_cargobus_ee
  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_cargobus_ee

Af hverju að nota Cargoson API fyrir Cargobus EE samþættingu

Að samþætta beint við innfædda API Cargobus EE þýðir að glíma við sérstaka skjölun flutningsaðila, meðhöndla einstök gagnaskjöl og viðhalda aðskildum kóða fyrir hvern þjónustuaðila. Cargoson býður upp á eitt sameinað RESTful API sem styður Cargobus EE og 2.000+ flutningsaðila á evrópskum og norður-amerískum mörkuðum, með nýjum samþættingum bætt við vikulega. Við minnkum þróunartíma úr mánuðum í daga, meðhöndlum uppfærslur flutningsaðila sjálfkrafa og stjórnum svæðisbundnum undantekningum. Með Cargoson einbeitir þú þér að því að auka viðskiptin þín í stað þess að stjórna tæknilegum flækjustigum flutningsaðila.

Kostir þess að samþætta Cargobus EE í gegnum Cargoson API

Eitt API fyrir alla flutningsaðila

Skiptu út tugum aðskilinna samþættinga flutningsaðila með einni tengingu við Cargobus EE og 2.000+ aðra þjónustuaðila í gegnum Cargoson API. Ekki þarf lengur að viðhalda mörgum auðkenningarkerfum, meðhöndla mismunandi gagnaskjöl eða uppfæra kóða þegar flutningsaðilar breyta endapunktum sínum.

Skýr skjölun og stuðningur

Fáðu aðgang að einfaldri API skjölun með vinnandi kóðadæmum, ítarlegum færibreytulýsingum og skýrt skilgreindum endapunktum. Stuðningsteymið okkar þekkir flutningaiðnaðinn og getur hjálpað þér aðleysa samþættingaráskoranir hratt.

Kóðadæmi á mörgum tungumálum

Byrjaðu strax með tilbúin kóðadæmi í cURL, JavaScript, Python, PHP og Ruby. Afritaðu, límdu og aðlagaðu þau að tæknistafla þínum, engin þörf á að reikna út auðkenningu, beiðnissnið eða villumeðhöndlun frá grunni.

Raunverulegur stuðningur frá flutningasérfræðingum

Fáðu hjálp frá fólki sem skilur sendingar, ekki bara API. Hvort sem þú ert að leysa samþættingarvandamál eða þarft ráðgjöf um bestu leiðina til að meðhöndla alþjóðlegar sendingar, er teymið okkar hér til að hjálpa.

Öflugasta farmverðsvél heims

Farmverðs API Cargoson gengur langt út fyrir einfaldar verðuppflettingar. Vélin okkar getur lesið, greint og stafrænt hvaða verðlista flutningsaðila sem er óháð sniði eða uppbyggingu, sem gerir hana að öflugasta farmverðsstjórnunarlausn flutningaiðnaðarins.

Alhliða sniðstuðningur

Farmverðsvél okkar meðhöndlar hvaða snið sem er: skipulagðar Excel skrár, flóknar PDF skrár, frjálsan texta eða jafnvel handskrifaða verðlista. Hladdu upp flutningasamningum þínum á hvaða sniði sem er og farmverðsvélin okkar mun þátta verðreglur, aukagjöld og skilyrði sjálfkrafa.

Bein API samþætting flutningsaðila

Fyrir flutningsaðila með nútímaleg kerfi (venjulega alþjóðlegir pakkasendingar og tækniframfarir flutningafyrirtæki), sækjum við verð beint úr API þeirra í rauntíma. Þetta tryggir að þú fáir alltaf nýjasta verðið án handvirkra uppfærslna.

Opinber netverð

Ertu ekki með samning við flutningsaðila ennþá? Ekkert mál. Cargoson getur sótt opinber netverð frá flutningsaðilum, sem gerir þér kleift að bera saman valkosti jafnvel áður en formlegir samningar eru gerðir.

Spot-verðsbeiðnir

Fyrir flóknar sendingar eða sértilfelli, biddu um spot-verð þar sem flutningsaðilar fara yfir sérstakar kröfur þínar og veita sérsniðið tilboð. Allt stjórnað í gegnum sama sameinaða API.

Cargobus EE sendinga API: Einfölduð flutningasjálfvirkni

Gera uppfyllingarferlið þitt sjálfvirkt með því að samþætta sendinga API Cargoson við Cargobus EE og 2.000+ flutningsaðila um allan heim. Búðu til sendingarmerki, bókaðu sóttir og stjórnaðu öllum flutningsaðilum þínum frá einum vettvangi á meðan þú heldur samningsbundnum verðum þínum hjá hverjum þjónustuaðila.

Sjálfvirk merkjaframleiðsla

Búðu til sendingarmerki sem flutningsaðili samþykkir í einni API beiðni. Stuðningur við mörg merkjasnið (A4, hitaprentari) og sjálfvirk tollskjöl fyrir alþjóðlegar sendingar þýðir minna handvirkt verk og færri sendingarvillur.

Rauntíma verðsamanburður

Berðu saman lifandi verð á milli Cargobus EE og annarra virkjaðra flutningsaðila þinna til að velja besta kostinn út frá kostnaði, hraða og þjónustustigi.

Haltu samningsbundnum verðum þínum

Tengdu núverandi Cargobus EE reikning þinn til að halda samningsbundnum sendingarverðum þínum. Cargoson veitir einfaldlega tæknilega samþættingu: þú heldur beinum samböndum við flutningsaðila og sérsniðnum verðsamningum.

Fyrirtækjagæða öryggi fyrir Cargobus EE API samþættingu

API innviðir Cargoson uppfylla evrópska reglufylgnistaðla, sem tryggja örugga, endurskoðunartilbúna Cargobus EE samþættingu fyrir fyrirtækið þitt:

  • GDPR samhæfð gagnameðhöndlun og geymsla um alla Evrópu
  • ISO 27001 vottað upplýsingaöryggistjórnunarkerfi
  • Dulkóðun frá enda til enda fyrir alla API samskipti

Tilbúinn að samþætta Cargobus EE sendingar í vettvanginn þinn?

Bókaðu kynningu til að sjá hvernig sameinað API Cargoson getur einfaldað flutningaaðgerðir þínar

Bóka kynningu

Algengar spurningar

Cargoson er flutningsstjórnunarkerfi fyrir evrópska og norður-ameríska framleiðendur. Aðalsýn okkar er einfaldleiki: samþætta alla flutningsaðila og flutningaham (vegur, pakki, loft, sjór, járnbraut) í einn glugga og eitt API. Hvort sem þú ert að senda vörubretti um Evrópu eða gáma yfir höf, stjórnaðu öllu frá einum vettvangi.

Að byrja er einfalt. Fyrst, skráðu þig fyrir Cargoson reikning og fáðu API lykilinn þinn. Tengdu síðan Cargobus EE reikninginn þinn í Cargoson stjórnborðinu. Þegar það er gert geturðu byrjað að gera API beiðnir með skjöluninni okkar og kóðadæmum. Öll uppsetningin tekur venjulega minna en klukkustund.

Já, þú þarft þinn eigin Cargobus EE reikning til að nota Cargobus EE þjónustu í gegnum Cargoson. Þetta tryggir að þú haldur samningsbundnum verðum þínum og viðheldur beinu sambandi þínu við Cargobus EE. Cargoson veitir einfaldlega tæknilega samþættingarlagið sem gerir það auðveldara að vinna með Cargobus EE og aðra flutningsaðila í gegnum eitt sameinað API.

Cargoson starfar á gagnsæju mánaðarlegu áskriftarlíkani án sendingargjalda eða þóknunar, aldrei. Áætlunin þín inniheldur API aðgang, skjölun, stuðning og sjálfvirkar uppfærslur þegar flutningsaðilar breyta kerfum sínum. Þú borgar Cargobus EE beint fyrir sendingar á samningsbundnum verðum þínum. Engin falin gjöld, engar óvæntar uppákomur.

Alveg! Það er helsti ávinningurinn af því að nota Cargoson. Þegar þú hefur samþætt API okkar geturðu unnið með Cargobus EE og 2.000+ aðra flutningsaðila með sömu endapunktum, auðkenningu og gagnasniðum. Bættu við nýjum flutningsaðilum án þess að skrifa nýjan samþættingarkóða, virkjaðu þá bara í Cargoson stjórnborðinu þínu.

Já! Við samþættum hvaða flutningsaðila sem þú þarft án aukakostnaðar. Þetta er innifalið í Cargoson áskriftinni þinni. Kynntu okkur bara fyrir tengiliðum flutningsaðila þíns og við sjáum um tæknilega samþættingu. Nýjum samþættingum er bætt við daglega út frá beiðnum viðskiptavina.

Já, við getum sett upp webhooks til að tilkynna kerfinu þínu út frá atburðum og kveikjum í Cargoson, svo sem stöðuuppfærslum sendinga, bókunarstaðfestingum eða breytingum á sendingum þínum. Hafðu samband við stuðningsteymið okkar eða bókaðu kynningu til að ræða webhook kröfur þínar og uppsetningu.

Cargoson gæti verið of mikið ef þú ert lítið fyrirtæki sem sendir aðeins nokkrum sinnum á mánuði með einum flutningsaðila. Þú getur líklega stjórnað þessum sendingum vel án flutningsstjórnunarkerfis. Við erum heldur ekki rétti kosturinn ef þú ert flutningsaðili eða farmflytjandi. Cargoson er smíðað sérstaklega fyrir eigendur vöru (BCO) eins og framleiðendur og dreifingaraðila sem eiga vörurnar sem verið er að senda. Ef þú ert að leita að flutningsstjórnunarkerfi til að stjórna farmflutningaviðskiptum þínum eða starfsemi flutningsaðila, erum við ekki hönnuð fyrir þá notkun.

API okkar skilar skýrum villuskilaboðum með sérstökum villukóðum og lýsingum. Algeng vandamál eru skjalfest með lausnum í forritaraskjölunum okkar. Ef þú festist, getur stuðningsteymið okkar hjálpað til við að leysa samþættingarvandamál.

Við innleiðum sanngjörn takmörk til að tryggja kerfistöðugleika fyrir alla viðskiptavini. Það eru bæði langtímatakmörk og skynditakmörk, með gildum sem ættu að vera meira en nóg fyrir flest fyrirtæki. Ef þú þarft hærri takmörk fyrir fyrirtækjastærðar starfsemi, hafðu samband við okkur til að ræða sérsniðin takmörk fyrir reikninginn þinn.

Byrjaðu að nota Cargobus EE API

Fáðu API auðkenni þín til að hefja samþættingu

Fáðu API lykilinn þinn