It is important for shippers to preserve agreed dates with the Customer in order to review carrier dates, changes, and build reports. Therefore, we added additional fields like scheduled_at_by_customer and scheduled_ends_at_by_customer which show the dates agreed with the Customer.

Additionally, from now on, carriers cannot change Pickup/Delivery dates set by shippers. Instead, changes to the dates will be stored in the readOnly scheduled_at_by_carrier field.

Please check out order request and response endpoints.

Added a vehicles object into the order's activity payload.

{
  "status": "success",
  "data": {
    "objects": [
      {
        "guid": "ee6a7af7-650d-499b-8e32-58a52ffdb7bc",
        "id": 0,
        "created_at": "2019-11-15T10:33:29.112+0000",
        "action_status": "SUCCESS",
        "carrier_address": "Main street, 5",
        "carrier_city": "Salt Lake City",
        "carrier_contact_name": "John Smith",
        "carrier_email": "example@email.com",
        "carrier_guid": "512cb41f-45f3-4996-83a5-83687bf0cc0b",
        "carrier_name": "string",
        "carrier_phone": "+1 234 5678 910",
        "carrier_state": "UT",
        "carrier_usdot": 123456,
        "carrier_zip": 84199,
        "code": "picked_up",
        "driver_name": "string",
        "driver_phone": "string",
        "error_details": "string",
        "error_message": "string",
        "status": "new",
        "user": {
          "guid": "ee6a7af7-650d-499b-8e32-58a52ffdb7bc",
          "is_active": true,
          "is_superuser": false,
          "created_at": "2019-11-15T10:33:29.112+0000",
          "changed_at": "2019-11-15T10:33:29.112+0000",
          "email": "user@example.com",
          "first_name": "string",
          "last_name": "string",
          "username": "string"
        },
        "vehicles": [
          {
            "guid": "ee6a7af7-650d-499b-8e32-58a52ffdb7bc",
            "lot_number": 1234,
            "make": "BMW",
            "model": "Gran Coupe",
            "vin": "1G8AL52F03Z157046",
            "year": 2012
          }
        ]
      }
    ],
    "pagination": {
      "total_pages": 0,
      "total_objects": 0,
      "limit": 20,
      "page": 0
    }
  }
}

This way it will allow shippers to track each particular vehicle better: when it is picked up or delivered.

Vehicles object is empty unless order is in status Picked up or Delivered.

Please, see the API reference on the per vehicle order activity.

Added new Approved Carrier status which is designed for shippers who want to monitor carrier compliance on their own.

Please, see the API reference how to get the list of Approved carriers.

API reference how to mark a carrier as Approved.

Please, read an article on Approved carriers.

The approved carrier object comes with the following properties:

        ...
    {
            "status": "success",
            "data": {
            "object": {
            "guid": "string",
            "usdot_number": "123456",
            "approved": true,
            "approved_since": "2019-11-15T10:33:29.112+0000",
            "preferred": false,
            "preferred_since": null,
            "in_blacklist": false,
            "in_blacklist_since": null,
            "insurance_certificate_holder": false,
            "insurance_certificate_holder_since": null,
            "insurance_cert_holder_file_url": null,
            "insurance_expires_at": null,
            "custom_external_id": "CARRIER-0098"
            }
        }
    }
        ...

We have added more details for the dispatcher user in the order's response payload.

The dispatcher object comes with the following properties:

        ...
        "dispatcher": 
        {
            "is_active": true,
            "created_at": "2019-11-15T10:33:29.112+0000",
            "changed_at": "2019-11-15T10:33:29.112+0000",
            "guid": "4f797316-63a8-432a-a4ef-2986b8occ89d",
            "username": "ZH058gvXGpyHwHQFbxLH",
            "email": "johndoe@mail.com",
            "first_name": "John",
            "last_name": "Doe"
        },
        ...

Some endpoints of Shipper API returned two fields: active and is_active.

The field active used to be marked as deprecated in the API reference and was removed.

Sometimes, webhook actions may not come through due to server failures.

Therefore, you may need to get the list of failed webhook actions for a particular date range.

The request takes two required parameters:

• start_date
• end_date

API reference: List of failed webhooks.

It is now possible to change some of the order's statuses manually.

Such actions as Mark as Accepted, Mark as Delivered, Mark as Picked Up, and Mark as Carrier Invoiced are available.

The reason behind having these options is because sometimes brokers need to change the order's status independent of the carrier.

• To Manually Mark Order as Accepted, you need to provide:

  carrier_email

  carrier_phone

  Broker primarily may use this option to mark order as accepted by internal carrier.

• To Manually Mark Order as Picked Up:

  The order must be in status accepted and you need to pass adjusted_date to adjust the pickup date.

• To Manually Mark Order as Delivered:

  The order must be in status accepted or picked up. To adjust the pickup and delivery dates, you need to pass adjusted_pickup_date and adjusted_delivery_date if order is in status accepted, and adjusted_delivery_date only if order is in status picked up.

• To Manually Mark Order as Carrier Invoiced:

  You need to pass adjusted_invoice_date to adjust the invoice date.

Deleting Internal Carriers is now available.

Internal carrier is the one created by shipper (please see Create a new internal carrier endpoint) and has carrier_type: "INTERNAL".

API reference: Delete an internal carrier.

Additional webhooks actions have been added.

Now it is possible to subscribe to the following webhooks:

• Event created when carrier sends a load request to shipper: load_request.created

• Carrier updates their own load request: load_request.updated

• Carrier cancels their own load request: load_request.canceled_by_carrier

• Shipper declines carrier's load request: load_request.declined_by_shipper

API reference: Webhooks. Read more on Load Requests Webhooks here.

New endpoint to archive an order is now available. Order in any status can be archived, except for inactive orders.

If an order is posted to SLB, it will be unposted once archived.

Please see archive an order endpoint.