Price negotiation

Price Negotiation provides Shippers the ability to customize their negotiation strategy with their Preferred Carriers via Super Loadboard. By defining an initial posting price, a negotiation budget, and age-based increase of acceptable bids, Shippers can post to Super Loadboard and Price Negotiation will automatically accept matching bids from their Preferred Carriers.

If your Shipper account has enabled “Instant Booking for Verified Carriers” then Price Negotiation will automatically accept bids from Verified Carriers as well.

Creating a price negotiation

You can create price negotiation using the following endpoint:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
curl -X POST 'https://api.shipper.superdispatch.com/v1/public/orders/price_negotiations' \
-h 'Authorization: Bearer <access_token>' \
-h 'Content-Type: application/json;charset=UTF-8' 
-d '{
    "order_guid": "86c18bc8-7d1f-4b33-aa22-872572744411",
    "negotiation_budget": 100,
    "increase_by_percent": 10,
    "increase_every": {
        "value": 1,
        "unit": "DAYS"
    },
    "start_date" : "2022-11-09T10:34:07.748+0000",
    "acceptable_pickup_days": 2,
    "acceptable_delivery_days": 1
}'

The start_date cannot be earlier than the order creation date. Default value is order creation date.

Acceptable days allow automatically accept bids when carrier requested dates are outside preferred dates. The acceptable_pickup_days and acceptable_delivery_days will extend pickup and delivery dates accordingly. Acceptable days receive only positive integers and maximum value is 3 and default value is 0.

Updating a price negotiation

You can update current fields in price negotiation using the following endpoint:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
curl -X PUT 'https://api.shipper.superdispatch.com/v1/public/orders/price_negotiations/{guid}' \
-h 'Authorization: Bearer <access_token>' \
-h 'Content-Type: application/json;charset=UTF-8' 
-d '{
    "negotiation_budget": 100,
    "increase_by_percent": 15,
    "increase_every": {
        "value": 1,
        "unit": "DAYS"
    },
    "start_date" : "2022-11-09T10:34:07.748+0000",
    "acceptable_pickup_days": 2,
    "acceptable_delivery_days": 1
}'

The start_date cannot be earlier than the order creation date. Default value is order creation date.

Search a price negotiation

You can use two types of queries to search for price negotiations:

By price negotiation GUID

1
2
3
curl -X GET 'https://api.shipper.superdispatch.com/v1/public/orders/price_negotiations/{guid}' \
-h 'Authorization: Bearer <access_token>' \
-h 'Content-Type: application/json;charset=UTF-8' 

By order GUID

1
2
3
curl -X GET 'https://api.shipper.superdispatch.com/v1/public/orders/{order_guid}/price_negotiations' \
-h 'Authorization: Bearer <access_token>' \
-h 'Content-Type: application/json;charset=UTF-8' 

Enable/Disable a price negotiation

You can enable price negotiation using the following endpoint:

1
2
3
curl -X PUT 'https://api.shipper.superdispatch.com/v1/public/orders/price_negotiations/{guid}/enable' \
-h 'Authorization: Bearer <access_token>' \
-h 'Content-Type: application/json;charset=UTF-8' 

and disable:

1
2
3
curl -X PUT 'https://api.shipper.superdispatch.com/v1/public/orders/price_negotiations/{guid}/disable' \
-h 'Authorization: Bearer <access_token>' \
-h 'Content-Type: application/json;charset=UTF-8' 