Skip to content

Onboarding Guide

Before the Offers API can be consumed it is necessary to acquire an API Key, see more in API Security Tokens. The onboarding is restricted and can only start on Maersk approval, please reach out to your Maersk contact to state your interest.

All the questions for consuming the API should be addressed to spotapisupport@maersk.com.

Onboarding steps

  1. Needs assessment (Maersk + Consumer)
  2. Sharing an API key for test environments (Maersk)
  3. UI design (Consumer)
  4. Development (Consumer)
  5. Testing (Consumer)
  6. UI validation (Maersk)
  7. Info about the expected load in production (Consumer)
  8. Sharing an API key for production environment (Maersk subject to UI and load validation)
  9. Go-live (Consumer)

Misuse of the API

Please also make sure to read the API terms and conditions, including what is considered misuse of the API.

THE CONSEQUENCE OF AN API MISUSE IS AN API KEY FREEZE – without an API key you cannot send the requests to us via the API connection.

An overview of the UI requirements:

  1. Product name should be stated as “Maersk Spot” for Maersk
  2. Validity of the rate should be absent as the rate is dynamic and has no validity – must have requirement
  3. Show main product differentiators: “Price and loading guaranteed; two-way commitment”, state close to T&C “Get Guaranteed Slot Upon Booking Confirmation”.
  4. A priceID to be stated close to the total amount area so that customers could use the priceID for the bookings through their direct EDI connection, via INTTRA or using the booking API - must have requirement
  5. Make T&C visible as it contains important info incl penalties and fees
  6. Show import D&D and penalties in the search result as this is a part of the offer
  7. Show export D&D info as a link (see DnD links)
  8. Show all vessel options as this is important for the customers to see the rates in comparison with the vessel departure dates - must have requirement
  9. Deep link can be used to redirect customers to the booking stage at http://www.maersk.com
  10. A flag for rollable to be added to the UI as this is a sub product where customers can pre-agree for the rolling (if it happens) and get compensated afterwards
  11. Inlands is a part of the product, so you will need to have a mode of transport (MOT) and a weight field in UI to let customers look for Spot offer inland rates

Once Ui is finalized and aligned between us, we will need to know your expected load in production to issue a prod apikey.