Scheduling API Specification

Overview

This API allows customers to integrate their systems with Maersk’s systems for scheduling pickups and deliveries electronically.

The following factors determine whether a shipment may or may not be scheduled via this API for outbound deliveries.

  • The distance from Maersk’s nationwide domestic stations: Currently, the application is limited to points within a 65-mile radius from a station.
  • The requested home-delivery service level: Some levels entail resources that cannot be scheduled online such as specialized services, equipment, and personnel.
  • The current location of the freight: Maersk does not allow the scheduling of deliveries until the freight is in one of our stations or beyond the agent’s physical possession

Pickup Business Rules

  • The Pro Number parameter for the GetTimeSlotsForPro and GetTimeSlotsForProXML calls can be an empty string, which automatically triggers time slots for a future pickup to be returned.
  • The first available day for pickups is at least 48 hours from the time of calling the API.
  • Time slots are unavailable for scheduling of pickups on holidays and outside of Mon–Fri.
  • The 4-hour pickup windows are:
    • 10 am–2 pm
    • 11 am–3 pm
    • 12 pm–4 pm
    • 1 pm–5 pm
    • 2 pm–6 pm
    • 3 pm–7 pm

Getting Started

IsSchedulable

This function may be used to determine if a shipment can be scheduled. It takes into consideration different pickup and delivery shipment details (as mentioned in the Overview section). The results are returned as a string array in the format of {true/false, reason if false}

Request example:

POST /scheduling/scheduleservice.asmx HTTP/1.1 
Host: www.pilotssl.com 
Content-Type: text/xml; charset=utf-8 
Content-Length: length 
SOAPAction: "https://www.pilotssl.com/IsSchedulable" 

<?xml version="1.0" encoding="utf-8"?> 
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> 
  <soap:Body> 
    <IsSchedulable xmlns="https://www.pilotssl.com"> 
      <sProNumber>string</sProNumber> 
    </IsSchedulable> 
  </soap:Body> 
</soap:Envelope> 

Return example:

HTTP/1.1 200 OK 
Content-Type: text/xml; charset=utf-8 
Content-Length: length 

<?xml version="1.0" encoding="utf-8"?> 
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> 
  <soap:Body> 
    <IsSchedulableResponse xmlns="https://www.pilotssl.com"> 
      <IsSchedulableResult> 
        <string>string</string> 
        <string>string</string> 
      </IsSchedulableResult> 
    </IsSchedulableResponse> 
  </soap:Body> 
</soap:Envelope> 

Endpoints (SOAP)

Endpoint

https://wsi.pilotdelivers.com/scheduling/scheduleservice.asmx

Dev/Test

https://wsi.pilotdelivers.com/schedulingtest/scheduleservice.asmx

WSDL

https://wsi.pilotdelivers.com/scheduling/scheduleservice.asmx?WSDL