Failed Channel Logs

The Failed Channel Log call is used to retrieve the list of failed channel update logs for property. Log contains details on the updates got failed on Channels connected / integrated for requested property.

Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/FailedUpdates

Sample Request

Please find an example input message below.

{
  "hotelid": "P101"
}

Mandatory elements

Element name - request

Description	The request element is the root of every failed channel update listing call.
Type	structural element
Children	n/a

Attribute Name

Attribute	Description
hotelid / hotel_id / ClientID	IT provider's hotel id for which retrieving failed channel log/s.

Syntax

{
  "hotelid": "P101"
}

Attribute Name - hotelid / hotel_id / ClientID

Description	IT provider's unique hotel id.
Type	alphanumeric
Constraints	needs to be a property registered in the STAAH (Existing)
Amount of elements possible within parent	1

Response

Success Response

{
  "failedupdates": [
    {
      "OTA": "Agoda",
      "OTA_Code": "189",
      "roomtypeid": "R101",
      "rateplanid": "NRF",
      "updates": [
        {
          "URL": "https://otalog.staah.net/?str=new1_R101_Test_189_15458923699234760_154589100-0768533&pmsid=11",
          "channelticketid": "1545892369189234760",
          "pmsticketid": "154589234100058333",
          "update_time": "2018-12-27 12:03:19"
        }
      ]
    }
  ]
}

• Referring to above response, PMS will find essential information (basic) pertaining to the error. A downloadable URL in text format is also provided for full details including error response received from OTA/s (Where available).

Errors Response

{
  "failedupdates": []
}

This notification will be given if there is no failed channel update found for the given values.

Errors due to invalid parameters

{
  "Status": "Fail",
  "Errors": {
    "Code": "400",
    "ShortText": "Invalid HotelCode (ne1)"
  }
}

This error will be received if allocated with incorrect Hotel id / ClientID.