Retrieve point-to-point sailing schedules and book an ocean shipment using the Maersk Schedules and Booking APIs

Steps

1. Authenticate to the Maersk Developer Portal and subscribe your application to the Point-to-Point Schedules and Ocean Booking (DCSA) products.
2. Query the Point-to-Point Schedules API with origin and destination port UN/LOCODEs and a date window; parse the returned sailings for vessel name, voyage number, ETD, ETA, and transit time.
3. Select a sailing and submit a booking request to the Ocean Booking v2 DCSA endpoint; include commodity, container type (e.g., 20GP, 40HC), cargo weight, and the selected vessel/voyage reference.
4. Poll the Booking Status API with the booking reference returned in the submission response; status transitions from RECEIVED to CONFIRMED (or DECLINED) as Maersk processes the request.
5. On CONFIRMED status, retrieve the booking confirmation document; it contains the final vessel, voyage, port cut-off dates, and documentation deadline.
6. Submit shipping instructions (SI) before the SI cut-off date using the Maersk Shipping Instructions API to provide shipper/consignee details and cargo description for bill of lading generation.