GlobKurier
  1. Wycena ofertowa
GlobKurier
  • Integracja własna
    • Wstęp
    • Strategia integracji
    • Endpoints
      • Autentyfikacja
        • Generate token
        • Refresh token
        • Remove token
      • Szybka wycena
        • Simplified order placement
        • Simplified order placement - new
      • Użytkownicy
        • AddressBook
          • Edit sender contact in address book
          • Add sender contact in address book
          • Delete sender contact from address book
          • Edit receiver contact in address book
          • Add receiver contact in address book
          • Delete receiver contact from address book
          • Get senders contacts from address book
          • Get receiver contacts from address book
          • Import sender contacts to address book
          • Import receiver contacts to address book
        • get company for user
        • Update user currency
        • User return carrier list
        • Manage user return carrier list
      • Wycena ofertowa
        • Get products
          GET
        • Get addons for product
          GET
        • Get discount code information
          GET
        • Get available courier arrival times to the sender for the shipment
          GET
        • Get payments
          GET
        • Get bank account numbers
          GET
        • Get order price
          GET
        • Get custom required fields
          GET
        • Create order
          POST
        • Partial order validation
          POST
        • Create order for courier pick up
          POST
      • Słowniki
        • Adresy
          • Get list of countries
          • Get states for country
          • Get shipment/receiving points
          • Get Polish addresses
          • Get list of cities
        • Przewoźnicy
          • Get available carrier list
        • Finanse
          • Get available currency list
          • Get available currency list Copy
        • Zamówienia
          • Get available order content
        • Agreements
          • Get agreements
      • Szablon przesyłki
        • Add template
        • Get tempalate list
        • Edit template
        • Delete template
      • Payments
        • Get list of available methods
        • Generate form data for online order payment
        • Prepaid top-up
        • Changing payment method for online order
      • AddressBook
        • Add sender contact to address book
        • Add receiver contact to address book
        • Get senders address book
        • Get receivers address book
        • Edit sender contact into address book
        • Edit receiver contact into address book
        • Delete sender contact from address book
        • Delete receiver contact from address book Copy
      • User
        • Get user data
        • Get user coupon data
        • Register user
        • Edit user
        • Get company information
        • Get user invoice list
        • Get invoice
        • Get compressed list of invoices
        • Get invoice email
        • Get account and payment statistics
        • Get list of payment methods
        • Get selected payment method
        • Create selected payment method
        • Remove selected payment method
        • Get order statistics
        • Get list of customs documents for the order
        • Get list of options for saving user preferences
        • Save user preferences
      • Orders
        • Get order
        • Get list of orders for the protocol
        • Get protocol
        • Get labels
        • Get shipment statuses
  1. Wycena ofertowa

Partial order validation

Developing
Testing Env
https://test.api.globkurier.pl
Testing Env
https://test.api.globkurier.pl
POST
/v1/order/validate

Request

Header Params
Accept-Language
string 
optional
Example:
pl
X-Auth-Token
string 
optional
Body Params application/json
shipment
object 
optional
Shipment details (Shipment)
length
integer 
optional
Shipment length in cm
Example:
1
width
integer 
optional
Shipment width in cm
Example:
1
height
integer 
optional
Shipment height in cm
Example:
1
weight
number 
optional
Shipment weight in kg with a maximum accuracy of 2 decimal placesShipment
Example:
1
quantity
integer 
optional
Number of packages in the shipment
Example:
1
productId
integer 
optional
Product identifier retrieved using /products resource
Example:
605
senderAddress
object 
optional
Sender details (Address)
name
string 
optional
Name.
Can contain the following special characters:
space . , ' ( ) - @
Example:
Testowy Nadawca
city
string 
optional
City.
Can contain the following special characters:
space . ' ( ) - & /
Example:
Testowe Miasto
street
string 
optional
Street.
It can contain the following special characters:
space . ' - & / ,
If we want the address to be broken down by the API system, please do not pass the houseNumber and apartmentNumber parameters
Example:
Testowa Ulica
houseNumber
string 
optional
House number.
May contain the following special characters:
/
Example:
1x
apartmentNumber
string 
optional
Apartment number.
Example:
2a
postCode
string 
optional
Post code.
Depends on the country, it is defined by the "has_post_codes" field in the /countries resource
Example:
01-001
countryId
integer 
optional
Country identifier retrieved using /countries resource.
Example:
1
stateId
string  | null 
optional
State/region identifier retrieved using /states resource.
Can be checked using /order/customRequiredFields resource.
Example:
pointId
string  | null 
optional
Identifier of the drop-off/pick-up point retrieved using /points resource.
Can be checked using /order/customRequiredFields resource.
Example:
phone
string 
optional
Phone number.
Example:
123123123
email
string 
optional
Email address.
Example:
testowy.nadawca@testowy.nadawca.pl
contactPerson
string 
optional
Contact person.
Example:
Testowa Osoba
nip
string 
optional
Tax identification number.
Example:
receiverAddress
object 
required
name
string 
required
Name.
Can contain the following special characters:
space . , ' ( ) - @
Example:
Testowy Odbiorca
city
string 
required
City.
Can contain the following special characters:
space . ' ( ) - & /
Example:
Testowe Miasto
street
string 
required
Street.
It can contain the following special characters:
space . ' - & / ,
If we want the address to be broken down by the API system, please do not pass the houseNumber and apartmentNumber parameters
Example:
Testowa Ulica
houseNumber
string 
required
House number.
May contain the following special characters:
/
Example:
1x
apartmentNumber
string 
optional
Apartment number.
Example:
2a
postCode
string 
required
Post code.
Depends on the country, it is defined by the "has_post_codes" field in the /countries resource
Example:
01-001
countryId
integer 
required
Country identifier retrieved using /countries resource.
Example:
1
stateId
integer  | null 
optional
State/region identifier retrieved using /states resource.
Can be checked using /order/customRequiredFields resource.
pointId
string  | null 
optional
Identifier of the drop-off/pick-up point retrieved using /points resource.
Can be checked using /order/customRequiredFields resource.
Example:
phone
string 
required
Phone number.
Example:
123123123
email
string 
required
Email address.
Example:
testowy.odbiorca@testowy.odbiorca.pl
contactPerson
string 
optional
Contact person.
Example:
Testowa Osoba
nip
string 
optional
Tax identification number.
Example:
2532451081
userAddress
object 
optional
Customer details (UserAddress).
Required if you are placing an order as an unauthorized user.
type
enum<string> 
optional
Customer Type.
Allowed values:
PERSONCOMPANY
Example:
PERSON
nip
string 
optional
Company Tax Identification Number.
Required if the selected customer type is Company.
Example:
6840243162
companyName
string 
optional
Company Name.
Required if the selected customer type is Company.
Example:
Test - Company
name
string 
optional
Name.
Example:
Test
surname
string 
optional
Surname.
Example:
Testowy
city
string 
optional
City.
Example:
Testowo
street
string 
optional
Street.
Example:
Testowa Ulica
houseNumber
string 
optional
House number.
Example:
1x
apartmentNumber
string 
optional
Apartment number.
Example:
2a
postCode
string 
optional
Postal code.
Depends on the country, defined by the "has_post_codes" field in the /countries resource.
Example:
01-001
countryId
integer 
optional
Country identifier retrieved using /countries resource.
Example:
1
phone
string 
optional
Phone number
Example:
48123123123
email
string 
optional
Email address
Example:
testowy.klient@testowy.klient.pl
pickup
object 
optional
Carrier arrival data for the shipment (Pickup).
We get information whether this type of shipment is available by searching for products /products in the "collectionTypePickupAvailable" field.
Required if we passed the "PICKUP" value in the "collectionType" field.
date
string <date>
optional
Estimated date of arrival of the carrier for the shipment
Example:
2060-10-10
timeFrom
string <time>
optional
The time from which the carrier is planned to arrive, retrieved using the /order/pickupRanges resource
Example:
08:00
timeTo
string <time>
optional
The time of the carrier is planned to arrive, retrieved using the /order/pickupRanges resource
Example:
14:00
content
string 
optional
Contents of the shipment.
Example:
Książki
paymentId
integer 
optional
Selected payment method identifier.
Example:
2
agreements
object 
optional
Passed as a hashmap, where the key is the consent code and the value is its status (boolean type). Consent codes required when placing an order can be retrieved using the getAgreements endpoint (Agreements) using the appropriate filter parameter.
receiveElectronicBills
boolean 
optional
Default:
true
processingPersonalData
boolean 
optional
Default:
true
originId
string 
optional
Order Source identifier.
Recommended - please send a request for a personalized source code
Example:
addons
array [object {1}] 
optional
List of selected add-ons (Addon[])
id
integer 
optional
Example:
768
partnerProgramNumber
string 
optional
Affiliate program customer number
Example:
instructions
string 
optional
Carrier instructions (Adding this field increases the order processing time as it requires verification by a customer service employee)
Example:
declaredValue
string 
optional
Declared value of the shipment.
Can be checked using the /order/customRequiredFields resource.
Example:
purpose
enum<string> 
optional
Purpose of the shipment.
Can be checked using the /order/custom Required Fields resource.
Allowed values:
SOLDGIFTSAMPLENOT_SOLDPERSONAL_EFFECTSREPAIR_AND_RETURN
Example:
SOLD
collectionType
enum<string> 
optional
Type of shipment.
Depending on the selected type of shipment, the pickup structure or the sending/receiving point in the address structure should be transferred.
Allowed values:
PICKUPPOINT
Example:
POINT
discountCode
string 
optional
Discount code (you can't combine voucher payments with discount codes).
Example:
referenceNumber
string 
optional
Reference number
Example:
TEST/1234
salesMargin
string 
optional
Partner sales margin
Example:
12.34
customs
object 
optional
Customs declaration data (Customs).
Can be checked using the /order/customRequiredFields or /order/customs/carrier resource
purpose
string 
optional
Purpose of shipment.
Example:
samples
declaredValue
string 
optional
Declared value.
Example:
250
termsOfDelivery
string 
optional
Delivery terms e.g. DDP
Example:
EAP
currency
string 
optional
Currency
Example:
EUR
total
string 
optional
Total value of goods
Example:
244
totalWeight
string 
optional
Total weight of goods
Example:
55
sender
array [object {1}] 
optional
Additional sender data (customs sender)
receiver
array [object {1}] 
optional
Additional recipient data (customs receiver)
commodities
array [object {7}] 
optional
List of goods (Commodity[])
Example
{
    "shipment": {
        "length": 1,
        "width": 1,
        "height": 1,
        "weight": 1,
        "quantity": 1,
        "productId": 2000
    },
    "senderAddress": {
        "name": "Testowy Nadawca",
        "city": "Testowe Miasto",
        "street": "Testowa Ulica",
        "houseNumber": "1x",
        "apartmentNumber": "2a",
        "postCode": "01-001",
        "countryId": 1,
        "pointId": "Test-123",
        "phone": "123123123",
        "email": "testowy.nadawca@testowy.nadawca.pl",
        "contactPerson": "Testowa Osoba"
    },
    "receiverAddress": {
        "name": "Testowy Odbiorca",
        "city": "Testowe Miasto",
        "street": "Testowa Ulica",
        "houseNumber": "1x",
        "apartmentNumber": "2a",
        "postCode": "01-001",
        "countryId": 1,
        "pointId": "Test-123",
        "phone": "123123123",
        "email": "testowy.odbiorca@testowy.odbiorca.pl",
        "contactPerson": "Testowa Osoba"
    },
    "content": "Książki",
    "paymentId": 2,
    "agreements": {
        "receiveElectronicBills": true,
        "processingPersonalData": true
    },
    "addons": [
        {
            "id": 1578,
            "value": 1000
        }
    ],
    "declaredValue": 1000,
    "purpose": "SOLD",
    "collectionType": "POINT",
    "referenceNumber": "TEST/1234"
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://test.api.globkurier.pl/v1/order/validate' \
--header 'Accept-Language: pl' \
--header 'X-Auth-Token;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "shipment": {
        "length": 1,
        "width": 1,
        "height": 1,
        "weight": 1,
        "quantity": 1,
        "productId": 2000
    },
    "senderAddress": {
        "name": "Testowy Nadawca",
        "city": "Testowe Miasto",
        "street": "Testowa Ulica",
        "houseNumber": "1x",
        "apartmentNumber": "2a",
        "postCode": "01-001",
        "countryId": 1,
        "pointId": "Test-123",
        "phone": "123123123",
        "email": "testowy.nadawca@testowy.nadawca.pl",
        "contactPerson": "Testowa Osoba"
    },
    "receiverAddress": {
        "name": "Testowy Odbiorca",
        "city": "Testowe Miasto",
        "street": "Testowa Ulica",
        "houseNumber": "1x",
        "apartmentNumber": "2a",
        "postCode": "01-001",
        "countryId": 1,
        "pointId": "Test-123",
        "phone": "123123123",
        "email": "testowy.odbiorca@testowy.odbiorca.pl",
        "contactPerson": "Testowa Osoba"
    },
    "content": "Książki",
    "paymentId": 2,
    "agreements": {
        "receiveElectronicBills": true,
        "processingPersonalData": true
    },
    "addons": [
        {
            "id": 1578,
            "value": 1000
        }
    ],
    "declaredValue": 1000,
    "purpose": "SOLD",
    "collectionType": "POINT",
    "referenceNumber": "TEST/1234"
}'

Responses

🟢200Success
application/json
Body
object {0}
Example
{}
Modified at 2025-05-22 06:51:28
Previous
Create order
Next
Create order for courier pick up
Built with