Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Info

Warning!

Resource available only in the following countries: PL

Info

Warning Debit clients!

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


On this page

Table of Contents


Structure

DispatchOrderPriceList resource has the following attributes:

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:

Code Block
languagejson
{
    "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

Code Block
languagejson
POST /v1/organizations/:organization_id/dispatch_orders/calculate

Parameters

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 newsentaccepted or done.

PL

Request example

Code Block
languagejson
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

Code Block
languagejson
HTTP/1.1 200 OK
Content-Type: application/json
{
    "total_success_count": 3,
    "total_error_count": 2,
    "total_price": {
        "amount": 16.3,
        "currency": "PLN"
    },
    "price_list": {
        "courier": {
            "count": 1,
            "price": {
                "amount": "12",
                "currency": "PLN"
            },
            "shipments": [
                24921
            ]
        },
        "locker": {
            "count": 2,
            "price": {
                "amount": "4.30",
                "currency": "PLN"
            },
            "shipments": [
                24907,
                24908
            ]
        }
    },
    "invalid_shipments": {
        "24906": [
            "already_dispatched"
        ],
        "24918": [
            "invalid_status"
        ]
    }
}

Warning

Error Information

  • validation_failed - validation error

  • forbidden -  user does not have access to the given organization

  • token_invalid - token is invalid