OTTO Market API documentation



Shipment Interface

This interface should be used to report that shipments have been handed over to the carrier for final delivery to the customer.
At this point, the position items within the shipment are marked with the state ''SENT'' in the OTTO Market. This is the trigger for the generation of a purchase receipt.

You can use the GET endpoints to retrieve information of your shipments in the OTTO Market.

Changelog

This changelog will document all relevant changes in our interface. Kudos to https://keepachangelog.com/de/1.0.0/

Added

Status: Released

  • [14.01.2020] support of utc timestamps with offsets for shipDate

Added

  • [25.10.2019] added new carrier or forwarder - DHL_FREIGHT - HES - HELLMANN - DB_SCHENKER - IDS - EMONS - DACHSER - LOGWIN - KUEHNE_NAGEL - SCHOCKEMOEHLE - KOCH - REITHMEIER - OTHER
  • [12.02.2020] add some examples for CreateShipmentRequest for carrier "OTHER_FORWARDER"
  • [02.07.2020] add new carrier "DHL_HOME_DELIVERY"
  • [02.07.2020] add new optional property jsonPath to ErrorDescription

Removed

  • [25.10.2019] removed carrier OTHERS

Changed

  • [02.07.2020] rework of the validation of the request body for better user experience as version 1.1.0
  • better error messages in title and detail properties of ErrorDescription
  • a new optional property jsonPath in ErrorDescription to imply where the error happened
  • multiple ErrorDescription in BadRequest, BadRequestAddPositionItemByTrackingNumber and BadRequestAddPositionItemByShipmentId possible
  • [31.03.2020] add length restriction to shipFromAddress.city and shipFromAddress.zipCode
  • [07.11.2019] changed carrier OTHER to OTHER_FORWARDER
  • [25.10.2019] added more detailed description
  • [29.08.2019] release version 1.0.0, renamed carrier and returnCarrier 'HERMES_GERMANY' to 'HERMES'
  • [14.08.2019] type of shipmentId changed from integer to string

Deprecated

  • nothing
Imprint | Privacy policy | Datenschutz