Skip to main content

Shipping cost calculations

Transport Calculator API Documentation

Welcome to the documentation for the Transport Calculator API. This service computes logistics options for orders, providing data on available warehouses, eligible carriers, palletization details, and precise shipping costs.

General Information

  • Base URL: https://logistics.solsol.cz

  • Version: 1.0.0

  • Protocol: HTTPS

Authentication

This API uses Bearer Token authentication. Include the token in your request header:

Endpoints

Post: Calculate Transport Costs

POST /api/calculate

Computes the most efficient shipping methods, warehouse availability, and estimated delivery dates based on the provided items and destination.

Request Body

The request must be sent as application/json.

Parameter Type Required Description
delivery object Yes Address object containing country, city, street, and zip.
Items array Yes List of objects containing plu (Product ID) and amount.
order_id string No Your internal order reference.
pricing_list string No Pricing tier for margin calculation (e.g., VIP).
off_stock_included boolean No If true, includes items not currently in stock.
best_price boolean No If true, returns only the cheapest carrier per warehouse.
multi_warehouse boolean No If true, evaluates all warehouses rather than just the nearest.
sort_by string No Sort results by price or time.

Example Request

JSON 
{
  "delivery": {
    "country": "CZ",
    "city": "Liberec",
    "street": "Košická 13",
    "zip": "46001"
  },
  "Items": [
    { "plu": "104661", "amount": 5 },
    { "plu": "417021", "amount": 7 }
  ],
  "best_price": true,
  "multi_warehouse": true
}

Response Structure

Success (200 OK)

The response returns a breakdown of physical shipping properties and available logistics routes.

  • Payload Overview:

    • normal_weight: Total weight of the shipment in kg.

    • paletts_count: Total number of pallets required.

    • paletts: Array detailing the dimensions and contents of every individual pallet.

    • warehouses: List of locations capable of fulfilling the order.

  • Warehouse Object Details:

    • distance: Distance from warehouse to destination in km.

    • couriers: List of available shipping services, including price (net) and price_solsol (gross/final).

Error Codes

Code Status Description
400 error Invalid address: The provided delivery details could not be geo-coded.
404 error Stock unavailable: The items requested are not available in any warehouse.

Data Models

Pallet Object

Organizes how items are distributed across physical transport units.

JSON 
{
  "dimensions": { "length": 1.2, "width": 0.8, "height": 0.15 },
  "weight": 1090.99,
  "items": [{ "plu": "104661", "quantity": 31 }]
}

Courier Object

Details regarding the specific carrier and costs.

JSON 
{
  "carrier_code": "HEAVY",
  "unloading": "customer",
  "price": { "CZK": 5612.35, "EUR": 219.96 },
  "delivery_date_estimate": "2025-05-23"
}

Tip: Use the multi_warehouse: true flag if you want to compare shipping costs from different regions, as the nearest warehouse isn't always the cheapest depending on carrier contracts.

Back to top