Documentation

🔑 Hermes UK Track & Trace

The action is used to get the tracking information from Hermes UK.

🚧

Credentials

The credentials should be requested from Hermes

Inputs

NameTypeDescription
Tracking NumberStringTracking number
Client IDStringHermes UK client id
Client SecretStringHermes UK client secret
API KeyStringHermes UK api key

Outputs

NameTypeDescription
Tracking Found?BooleanWhether the tracking information was found
True / False
StatusStringTracking status
Status DescriptionStringDetailed description of the tracking status
Ship DateStringThe date of the shipment.
Format:
YYYY-MM-DDThh:mm:ss
Last Event DateStringThe date of the last tracking event.
Format:
YYYY-MM-DDThh:mm:ss
Tracking EventsListList of all the tracking events.
See the example below

Sample Response
Activity History

[
  {
    dateTime: '2021-11-20T12:32:31Z',
    location: { latitude: 0, longitude: 0 },
    links: [],
    trackingPoint: { description: 'Hub Inward Return Scan', trackingPointId: '4274' }
  },
  {
    dateTime: '2021-11-20T12:32:22Z',
    location: { latitude: 52.3949528166667, longitude: -1.26396743333333 },
    links: [],
    trackingPoint: {
      description: 'Return has been processed at the Hermes hub and will be with the retailer shortly',
      trackingPointId: '12'
    }
  },
  {
    dateTime: '2021-11-19T12:01:28Z',
    location: { latitude: 0, longitude: 0 },
    links: [],
    trackingPoint: {
      description: 'Parcel delayed 24hrs at the depot',
      trackingPointId: '9'
    }
  },
  {
    dateTime: '2021-11-18T21:27:35Z',
    location: { latitude: 54.9451598333333, longitude: -1.47141151666667 },
    links: [],
    trackingPoint: {
      description: 'Located at Scan to trailer',
      trackingPointId: '4244'
    }
  },
  {
    dateTime: '2021-11-18T19:49:30Z',
    location: { latitude: 54.94566185, longitude: -1.47134363333333 },
    links: [],
    trackingPoint: {
      description: 'Located In Depot Returns Sort',
      trackingPointId: '4243'
    }
  },
  {
    dateTime: '2021-11-18T19:48:57Z',
    location: { latitude: 54.9451168166667, longitude: -1.47176028333333 },
    links: [],
    trackingPoint: { description: 'Depot Re-induction', trackingPointId: '4196' }
  },
  {
    dateTime: '2021-11-18T19:38:47Z',
    location: { latitude: 54.94566185, longitude: -1.47134363333333 },
    links: [],
    trackingPoint: {
      description: 'Held in UPP - Final Attempt',
      trackingPointId: '1495'
    }
  },
  {
    dateTime: '2021-11-18T19:27:46Z',
    location: { latitude: 0, longitude: 0 },
    links: [],
    trackingPoint: {
      description: 'This parcel is currently being processed to be returned to the retailer',
      trackingPointId: '1021'
    }
  },
  {
    dateTime: '2021-11-18T19:26:00Z',
    location: { latitude: 54.94566185, longitude: -1.47134363333333 },
    links: [],
    trackingPoint: {
      description: 'Located In Depot Returns Sort',
      trackingPointId: '4243'
    }
  },
  {
    dateTime: '2021-11-18T19:17:27Z',
    location: { latitude: 54.9452383333333, longitude: -1.47150551666667 },
    links: [],
    trackingPoint: { description: 'Located in Manual sort', trackingPointId: '4223' }
  },
  {
    dateTime: '2021-11-18T19:01:38Z',
    location: { latitude: 54.9451212833333, longitude: -1.47123468333333 },
    links: [],
    trackingPoint: {
      description: 'Held in UPP - Final Attempt',
      trackingPointId: '1495'
    }
  },
  {
    dateTime: '2021-11-18T09:58:11Z',
    location: { latitude: 54.52525027, longitude: -1.50729999 },
    links: [],
    trackingPoint: {
      description: 'Inbound receipt at Sub Depot',
      trackingPointId: '4043'
    }
  },
  {
    dateTime: '2021-11-17T13:10:09Z',
    location: { latitude: 54.6296212073595, longitude: -1.60951381147925 },
    links: [ [Object] ],
    trackingPoint: {
      description: "Not Del'd - 3rd & Final Attempt",
      trackingPointId: '1269'
    }
  },
  {
    dateTime: '2021-11-17T10:15:51Z',
    location: { latitude: 54.5253278287663, longitude: -1.50669850733629 },
    links: [ [Object] ],
    trackingPoint: { description: 'ETA of delivery', trackingPointId: '2271' }
  },
  {
    dateTime: '2021-11-17T09:40:01Z',
    location: { latitude: 54.5249334079762, longitude: -1.50715901944156 },
    links: [],
    trackingPoint: {
      description: 'The courier has received this parcel for delivery and will set a delivery time shortly',
      trackingPointId: '1256'
    }
  },
  {
    dateTime: '2021-11-17T08:20:00Z',
    location: { latitude: 0, longitude: 0 },
    links: [],
    trackingPoint: { description: 'Manifested for Delivery', trackingPointId: '1022' }
  },
  {
    dateTime: '2021-11-16T11:57:42Z',
    location: { latitude: 54.6291857423823, longitude: -1.60967477396358 },
    links: [],
    trackingPoint: {
      description: "We were unable to deliver this parcel today but we'll attempt on the delivery date shown below",
      trackingPointId: '1259'
    }
  },
  {
    dateTime: '2021-11-16T09:57:16Z',
    location: { latitude: 54.525394168771, longitude: -1.50721781045923 },
    links: [ [Object] ],
    trackingPoint: { description: 'ETA of delivery', trackingPointId: '2270' }
  },
  {
    dateTime: '2021-11-16T09:33:17Z',
    location: { latitude: 54.5254037863866, longitude: -1.50736747645966 },
    links: [],
    trackingPoint: {
      description: 'The courier has received this parcel for delivery and will set a delivery time shortly',
      trackingPointId: '1256'
    }
  },
  {
    dateTime: '2021-11-16T07:16:00Z',
    location: { latitude: 0, longitude: 0 },
    links: [],
    trackingPoint: { description: 'Manifested for Delivery', trackingPointId: '1022' }
  },
  {
    dateTime: '2021-11-15T13:28:02Z',
    location: { latitude: 54.6291608920787, longitude: -1.60957904813132 },
    links: [],
    trackingPoint: {
      description: "We were unable to deliver this parcel today but we'll attempt on the delivery date shown below",
      trackingPointId: '1259'
    }
  },
  {
    dateTime: '2021-11-15T10:46:19Z',
    location: { latitude: 54.5252309741684, longitude: -1.50695891990654 },
    links: [ [Object] ],
    trackingPoint: { description: 'ETA of delivery', trackingPointId: '2272' }
  },
  {
    dateTime: '2021-11-15T10:21:06Z',
    location: { latitude: 54.525224630945, longitude: -1.50699201085193 },
    links: [],
    trackingPoint: {
      description: 'The courier has received this parcel for delivery and will set a delivery time shortly',
      trackingPointId: '1256'
    }
  },
  {
    dateTime: '2021-11-15T08:21:00Z',
    location: { latitude: 0, longitude: 0 },
    links: [],
    trackingPoint: { description: 'Manifested for Delivery', trackingPointId: '1022' }
  },
  {
    dateTime: '2021-11-15T07:15:57Z',
    location: { latitude: 54.5253275333333, longitude: -1.50755798333333 },
    links: [],
    trackingPoint: {
      description: 'Outbound receipt at Sub Depot',
      trackingPointId: '4041'
    }
  },
  {
    dateTime: '2021-11-14T22:49:17Z',
    location: { latitude: 54.9462213666667, longitude: -1.46771646666667 },
    links: [],
    trackingPoint: {
      description: 'Parcel processed at the depot',
      trackingPointId: '22'
    }
  },
  {
    dateTime: '2021-11-13T09:26:32Z',
    location: { latitude: 0, longitude: 0 },
    links: [],
    trackingPoint: {
      description: 'This parcel has been dispatched from the hub',
      trackingPointId: '1835'
    }
  },
  {
    dateTime: '2021-11-13T09:03:30Z',
    location: { latitude: 0, longitude: 0 },
    links: [],
    trackingPoint: { description: 'Hub infeed scan', trackingPointId: '4220' }
  },
  {
    dateTime: '2021-11-13T08:56:49Z',
    location: { latitude: 0, longitude: 0 },
    links: [],
    trackingPoint: {
      description: 'Parcel processed at the hub',
      trackingPointId: '1325'
    }
  },
  {
    dateTime: '2021-11-13T08:55:49Z',
    location: { latitude: 0, longitude: 0 },
    links: [],
    trackingPoint: {
      description: "We've received this parcel at the hub and will be sorted to the customers delivery depot",
      trackingPointId: '1131'
    }
  },
  {
    dateTime: '2021-11-12T18:17:48Z',
    location: { latitude: 51.4801789666667, longitude: 0.270925316666667 },
    links: [],
    trackingPoint: {
      description: 'Parcel processed at the depot',
      trackingPointId: '1253'
    }
  },
  {
    dateTime: '2021-11-12T16:21:34Z',
    location: { latitude: 51.4803266166667, longitude: 0.27113525 },
    links: [],
    trackingPoint: {
      description: 'Inbound Parent Child at Depot',
      trackingPointId: '4201'
    }
  },
  {
    dateTime: '2021-11-11T20:11:56Z',
    links: [],
    trackingPoint: {
      description: 'We have received the details for this parcel and expect it to reach the Hermes network shortly',
      trackingPointId: '1012'
    }
  }
]