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