/prices

PROFESSIONAL PLUS ADD-ON

Prices is how you send price enquiries before booking a shipment and retrieve stored prices for follow-up.

The prices are based on your agreement with the carrier. Currently there is support for Bring, DB Schenker, DHL Express, DHL Freight, TNT and UPS.

Notera

The REST API endpoints are only accessible via HTTPS and are located at api.unifaun.com.

https://api.unifaun.com/rs-extapi/v1

Before getting started you need to know your developer ID and create an API key.

Fetch shipment price

POST /prices

Fetches price information about a shipment.

Notera

You can add surcharges in amount, percentage or both.

If you enter both amount and percentage, the amount is added first and then the percentage is calculated.

You write percentage as an integer, for example, '10' means '10 %'

{
    "additionalSurcharges": {
        "percent": 10,
        "amount": null
    },
    "shipment": {
        "sender": {
            "quickId": "SE"
        },
        "senderPartners": [{
            "id": "DHL",
            "custNo": "123456",
            "priceEnquiry": "CARRIER"
        }],
        "parcels": [
            {
                "packageCode": "PC",
                "copies": "1",
                "weight": "2.6",
                "length": "0.2",
                "width": "0.2",
                "height": "0.2",
                "contents": "Stuff",
                "valuePerParcel": true
            }
        ],
        "orderNo": "PRICE-1",
        "senderReference": "AEXref",
        "receiver": {
            "name": "nShift Stockholm",
            "address1": "Tegnérgatan 34",
            "zipcode": "11359",
            "country": "SE",
            "city": "STOCKHOLM",
            "phone": "+45317253500"
        },
        "service": {
            "id": "AEX"
        }
    }
}

Fetch price for printed shipments

POST /prices/history

Fetches price information about a printed shipments.

Notera

Max. 100 prices are returned per call. If more prices are available the done value in the result will be "false" and you should make another call to fetch the remaining prices.

If calls are made too fast the minDelay value in the result will return how many milliseconds you have to wait before calling again. To avoid an uneven call rate, max. one (1) call per five (5) minutes is recommended.

Query parameters

Parameter	Type	Description	Category
fetchId	string	The ID of the next batch of prices to fetch. Save the fetchId returned by a previous call and use it as parameter value for the next call.	Optional

{
    "fetchId": "2",
    "done": true,
    "minDelay": 100,
    "priceHistoryList": [
        {
            "shipmentNo": "4387174669",
            "orderNo": null,
            "reference": "",
            "serviceId": "AEX",
            "partnerId": "DHLROAD",
            "parcelCount": 1,
            "parcelNumbers": [
                "373325382784979088"
            ],
            "printDate": "2021-02-09T10:04:09.896+0000",
            "shipDate": "2021-02-09T10:03:00.000+0000",
            "returnShipment": false,
            "normalShipment": true,
            "consolidated": null,
            "profileGroup": "Grundprofilgrupp",
            "price": {
                "price": 151.12,
                "additionalSurcharges": 15.13,
                "priceWithAdditionalSurcharges": 166.24,
                "totalWeight": null,
                "chargeableWeight": 3.0
            }
        }
    ]
}

Tips

For schema and testing, please refer to https://api.unifaun.com/rs-docs/.

For description of properties, please refer to the Property reference guide.

For information about some crucial objects, please refer to REST API Objects.

I detta avsnitt:

nShift Delivery Help Center

/prices

Notera

Fetch shipment price

Notera

Fetch price for printed shipments

Notera

Query parameters

Tips

Sökresultat