[1.23.0] Dispatch Order price calculation

Warning!

Resource available only in the following countries: PL

Warning Debit clients!

Dispatch order price calculation is available only for prepaid clients. Prices are not returned for postpaid (debit) clients.

On this page

1 Structure
2 Authentication
3 Dispatch Order price calculation

Structure

DispatchOrderPriceList resource has the following attributes:

Attribute	Type	Description	Availability

Attribute	Type	Description	Availability
`total_success_count`	Integer	Amount of correctly processed shipments	PL
`total_error_count`	Integer	Amount of incorrectly processed shipments	PL
`total_price`	Hash	Total price for courier pick-up	PL
`price_list`	Hash	Courier pick-up price list	PL
`invalid_shipments`	Hash	Unprocessed shipment errors	PL

DispatchOrderPriceList resource in JSON format:

{
    "total_success_count": 3,
    "total_error_count": 1,
    "total_price": {
        "amount": 20.3,
        "currency": "PLN"
    },
    "price_list": {
        "courier": {
            "count": 1,
            "price": {
                "amount": "12",
                "currency": "PLN"
            },
            "shipments": [
                24921
            ]
        },
        "locker": {
            "count": 1,
            "price": {
                "amount": "4.30",
                "currency": "PLN"
            },
            "shipments": [
                24907
            ]
        }
        "allegro": {
            "count": 1,
            "price": {
                "amount": "4.30",
                "currency": "PLN"
            },
            "shipments": [
                24908
            ]
        }
    },
    "invalid_shipments": {
        "24906": [
            "already_dispatched"
        ]
    }
}

Authentication

Access to the resource requires a valid access token.

Dispatch Order price calculation

POST /v1/organizations/:organization_id/dispatch_orders/calculate

Parameters

Parameter	Type	Description	Validation	Availability

Parameter

Type

Description

Validation

Availability

dispatch_point_id

Integer

Dispatch Point identifier, from which the shipment is to be collected from (the dispatch point address will become the dispatch order address).

Attribute not required.

PL

shipments

Array[Integer]

List of shipment IDs for which the dispatch order is to be created for.

Required attribute.

Shipments have to be in confirmed status and not belong to another dispatch order in the following statuses new, sent, accepted or done.

PL

Request example

curl -X POST https://api-shipx-pl.easypack24.net/v1/organizations/1/dispatch_orders/calculate -H 'Authorization: Bearer token' -H 'Content-Type: application/json' -d '{
  "dispatch_point_id": 10,
  "shipments": [24907, 24908, 24906, 24918, 24921]
}'

Response

Error Information

validation_failed - validation error
forbidden - user does not have access to the given organization
token_invalid - token is invalid