Simplified order placement (bestprice)

A simplified order form allows you to place an order without knowing the product ID or country ID.
Using the integration name (integrationName) and country code (ISO code or zone code), the system will automatically select the necessary parameters.
Knowledge of add-on IDs is also not required. Simply provide their categories, and the system will automatically select the required add-ons.

In response, we receive the number, the hash of the placed order and information about the valuation of the placed order or a list of validation errors.

Request

Query Params

Header Params

Body Params application/json

Example

{
    "shipment": {
        "length": 25,
        "width": 18,
        "height": 3,
        "weight": 0.4,
        "quantity": 1,
        "integrationName": "UPS"
    },
    "senderAddress": {
        "name": "Test Sender",
        "city": "Warsaw",
        "street": "Marszałkowska",
        "houseNumber": "1",
        "apartmentNumber": "2A",
        "postCode": "00-001",
        "country": "PL",
        "pointId": "Test-123",
        "phone": "123123123",
        "email": "sender@example.com",
        "contactPerson": "John Smith"
    },
    "receiverAddress": {
        "name": "Test Receiver",
        "city": "Amsterdam",
        "street": "Damrak",
        "houseNumber": "1",
        "apartmentNumber": "2A",
        "postCode": "3372EB",
        "country": "NL",
        "phone": "123123123",
        "email": "receiver@example.com",
        "contactPerson": "Jane Doe"
    },
    "customs": {
        "sender": {
            "eori": "PL1234567890"
        },
        "receiver": {
            "eori": "NL987654321"
        },
        "commodities": [
            {
                "description": "rower ;; bicycle",
                "composition": "metal ;; metal",
                "purpose": "sport ;; sport use",
                "mid": "PLMFR12345",
                "hsCode": "8712.00.2500",
                "countryOfOrigin": "PL",
                "unitOfMeasurement": "EA",
                "quantity": 1,
                "unitValue": 150.00,
                "unitWeightGross": 12.500,
                "unitWeightNet": 11.800,
                "subTotalValue": 150.00
            },
            {
                "description": "zupa ;; canned soup",
                "composition": "woda, warzywa ;; water, vegetables",
                "purpose": "jedzenie ;; food consumption",
                "mid": null,
                "hsCode": "2104.10.0060",
                "countryOfOrigin": "PL",
                "unitOfMeasurement": "EA",
                "quantity": 3,
                "unitValue": 4.50,
                "unitWeightGross": 0.500,
                "unitWeightNet": 0.420,
                "subTotalValue": 13.50
            }
        ],
        "totalWeight": [
            {
                "unit": "EA",
                "weightGross": 13.500,
                "weightNet": 12.660
            }
        ],
        "currency": "EUR",
        "purpose": "SOLD",
        "invoiceNumber": "INV/2026/001",
        "invoiceDate": "2026-04-17",
        "postalCharges": 12.50,
        "vatRegistrationNumber": "PL2220872890",
        "vatRegistrationNumberReceiver": "NL123456789B01"
    },
    "content": "Books",
    "paymentId": 9,
    "agreements": {
        "receiveElectronicBills": true,
        "processingPersonalData": true
    },
    "addons": {
        "INSURANCE": {
            "value": 163.50
        }
    },
    "purpose": "SOLD",
    "collectionType": "PICKUP",
    "referenceNumber": "TEST/2026/001",
    "receiverType": "COMPANY",
    "deliveryType": "PICKUP"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://test.api.globkurier.pl/v1/order/bestPrice?createFully=false&onlyPricing=true' \
--header 'Accept-Language: pl' \
--header 'X-Auth-Token: c4962142d3639293a647ced4f435310a3df3a637b2514d4c55c64c2988befc37' \
--header 'Content-Type: application/json' \
--data-raw '{
    "shipment": {
        "length": 25,
        "width": 18,
        "height": 3,
        "weight": 0.4,
        "quantity": 1,
        "integrationName": "UPS"
    },
    "senderAddress": {
        "name": "Test Sender",
        "city": "Warsaw",
        "street": "Marszałkowska",
        "houseNumber": "1",
        "apartmentNumber": "2A",
        "postCode": "00-001",
        "country": "PL",
        "pointId": "Test-123",
        "phone": "123123123",
        "email": "sender@example.com",
        "contactPerson": "John Smith"
    },
    "receiverAddress": {
        "name": "Test Receiver",
        "city": "Amsterdam",
        "street": "Damrak",
        "houseNumber": "1",
        "apartmentNumber": "2A",
        "postCode": "3372EB",
        "country": "NL",
        "phone": "123123123",
        "email": "receiver@example.com",
        "contactPerson": "Jane Doe"
    },
    "customs": {
        "sender": {
            "eori": "PL1234567890"
        },
        "receiver": {
            "eori": "NL987654321"
        },
        "commodities": [
            {
                "description": "rower ;; bicycle",
                "composition": "metal ;; metal",
                "purpose": "sport ;; sport use",
                "mid": "PLMFR12345",
                "hsCode": "8712.00.2500",
                "countryOfOrigin": "PL",
                "unitOfMeasurement": "EA",
                "quantity": 1,
                "unitValue": 150.00,
                "unitWeightGross": 12.500,
                "unitWeightNet": 11.800,
                "subTotalValue": 150.00
            },
            {
                "description": "zupa ;; canned soup",
                "composition": "woda, warzywa ;; water, vegetables",
                "purpose": "jedzenie ;; food consumption",
                "mid": null,
                "hsCode": "2104.10.0060",
                "countryOfOrigin": "PL",
                "unitOfMeasurement": "EA",
                "quantity": 3,
                "unitValue": 4.50,
                "unitWeightGross": 0.500,
                "unitWeightNet": 0.420,
                "subTotalValue": 13.50
            }
        ],
        "totalWeight": [
            {
                "unit": "EA",
                "weightGross": 13.500,
                "weightNet": 12.660
            }
        ],
        "currency": "EUR",
        "purpose": "SOLD",
        "invoiceNumber": "INV/2026/001",
        "invoiceDate": "2026-04-17",
        "postalCharges": 12.50,
        "vatRegistrationNumber": "PL2220872890",
        "vatRegistrationNumberReceiver": "NL123456789B01"
    },
    "content": "Books",
    "paymentId": 9,
    "agreements": {
        "receiveElectronicBills": true,
        "processingPersonalData": true
    },
    "addons": {
        "INSURANCE": {
            "value": 163.50
        }
    },
    "purpose": "SOLD",
    "collectionType": "PICKUP",
    "referenceNumber": "TEST/2026/001",
    "receiverType": "COMPANY",
    "deliveryType": "PICKUP"
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "currency": "PLN",
    "taxType": "VAT23",
    "vatPercent": 23,
    "totalGrossPrice": 109.52,
    "totalNetPrice": 89.04,
    "netPriceWithoutFuelSurcharge": 68.49,
    "productNetPrice": 67,
    "productsNetPrice": 67,
    "productsGrossPrice": 82.41,
    "productsStockNetPrice": 67,
    "productsStockGrossPrice": 82.41,
    "fuelSurchargeNetPrice": 20.55,
    "fuelSurchargeGrossPrice": 25.28,
    "fuelSurcharge": 25.28,
    "fuelSurchargeStockNetPrice": 20.55,
    "fuelSurchargeStockGrossPrice": 25.28,
    "addonsNetPrice": 1.49,
    "addonsGrossPrice": 1.83,
    "discountNetPrice": 0,
    "packages": [
        {
            "productPrice": 82.41,
            "fuelSurchargePrice": 25.28,
            "fuelSurchargePercent": 30,
            "discountPrice": 0,
            "discountPercent": 0
        }
    ],
    "addons": [
        {
            "id": 2022,
            "addonName": "Ubezpieczenie przesyłki do 5000 PLN",
            "description": "Ubezpieczenie przesyłki do 5000 PLN",
            "attributes": null,
            "addonLogo": null,
            "price": 0.49,
            "priceGross": 0.6,
            "priceDescription": "0,30% wartości kwoty",
            "quantity": 1,
            "currency": "PLN",
            "category": "INSURANCE",
            "isRequired": false,
            "disabled": false,
            "insuranceRequired": false,
            "minValue": 1,
            "maxValue": 5000,
            "valueCurrency": "PLN",
            "daysToReturn": null,
            "verificationRequired": false,
            "inPrice": true,
            "isSelectedByDefault": false
        },
        {
            "id": 1002,
            "addonName": "Zamawiam podjazd kuriera",
            "description": null,
            "attributes": null,
            "addonLogo": null,
            "price": 1,
            "priceGross": 1.23,
            "priceDescription": null,
            "quantity": 1,
            "currency": "PLN",
            "category": "PAID_PICKUP",
            "isRequired": false,
            "disabled": false,
            "insuranceRequired": false,
            "minValue": null,
            "maxValue": null,
            "valueCurrency": null,
            "daysToReturn": null,
            "verificationRequired": false,
            "inPrice": true,
            "isSelectedByDefault": false
        },
        {
            "id": 210,
            "addonName": "Doręczenie do firmy",
            "description": null,
            "attributes": null,
            "addonLogo": null,
            "price": 0,
            "priceGross": 0,
            "priceDescription": null,
            "quantity": 1,
            "currency": "PLN",
            "category": "RECEIVER_TYPE_COMPANY",
            "isRequired": false,
            "disabled": false,
            "insuranceRequired": false,
            "minValue": null,
            "maxValue": null,
            "valueCurrency": null,
            "daysToReturn": null,
            "verificationRequired": false,
            "inPrice": true,
            "isSelectedByDefault": false
        }
    ],
    "product": {
        "id": 1625,
        "name": "koperta do 0,5kg",
        "carrierName": "UPS",
        "serviceCode": "STANDARD",
        "netPrice": 67,
        "grossPrice": 107.13,
        "netPriceStandard": null,
        "grossPriceStandard": null,
        "currency": {},
        "units": 1,
        "protocolAvailable": false,
        "packageType": "PARCEL",
        "packageName": "Paczka",
        "transport": {
            "code": "Road",
            "name": "Drogowy"
        },
        "forCompany": false,
        "carrierLogoLink": "https://stglobkurierprodpublic.blob.core.windows.net/carrier-brands/19.png",
        "discountCodeAllowed": true,
        "averageDelivery": 2,
        "deliveryTimeType": "STANDARD",
        "detailsLink": "https://www.globkurier.pl/cennik/przesylki-miedzynarodowe/ups#price",
        "promo": null,
        "hasCountryZoneRouting": false,
        "onDemandDeliveryPointRequired": false,
        "customDocumentType": null,
        "labels": [
            "Odbiór i doręczenie przez kuriera",
            "Zapakuj przesyłkę w tekturową kopertę",
            "Transport drogowy"
        ],
        "collectionTypes": [
            "PICKUP",
            "POINT"
        ],
        "addonsCategories": [
            "DECLARED_VALUE",
            "CASH_ON_DELIVERY",
            "INSURANCE",
            "RETURN_SHIPMENT",
            "NOT_STANDARD",
            "RETURN_SHIPMENT_ADDRESS",
            "ORDERED_COURIER",
            "ALCOHOL",
            "PAID_PICKUP",
            "RECEIVER_TYPE_COMPANY",
            "RECEIVER_TYPE_PRIVATE_PERSON",
            "SENDER_REMOTE_AREA",
            "RECEIVER_REMOTE_AREA"
        ],
        "deliveryTypes": [
            "PICKUP"
        ],
        "collectionTypeOptions": [
            {
                "key": "PICKUP",
                "trans": "Podjazd kuriera",
                "image": "https://stglobkurierprodpublic.blob.core.windows.net/assets/filters/collection_pickup.svg"
            },
            {
                "key": "POINT",
                "trans": "W punkcie lub oddziale",
                "image": "https://stglobkurierprodpublic.blob.core.windows.net/assets/filters/collection_point.svg"
            }
        ],
        "deliveryTypeOptions": [
            {
                "key": "PICKUP",
                "trans": "Podjazd kuriera",
                "image": "https://stglobkurierprodpublic.blob.core.windows.net/assets/filters/delivery_pickup.svg"
            }
        ],
        "carrierId": null,
        "holidayInfo": []
    }
}

🟢201Created