Su API Documentation
  • Su Overview
    • Su API Introduction
  • Su Channel Manager
    • Getting Started
      • Certification
      • Authentication
    • Content
      • Property
      • Room Type
      • Rate Plan
      • Listing
        • Property Listing
        • Room Type Listing
        • Rate Plan Listing
        • Delete Property Listing
      • Image API
        • Create Images
        • Retrieve Images
        • Associate Images
    • Booking.com Content API
      • Booking.com
        • Contract - Introduction
          • Create Contract
          • Link/Retrieve Contract
          • Update Contract
          • Resend Contract
        • Property Management
          • Property Statuses
          • Property Detail
            • Create Property
            • Retrieve Property
            • Update Property
          • Contact Details
            • Set Contact
            • Retrieve Contact
            • Contact Profile Types
          • Property Settings
            • Retrieve Property Settings
            • Retrieve Property Settings Damage Programme
            • Retrieve City Tax Category For Property Settings
            • Create / Update Property Settings
            • Create / Update Property Settings - Specific Setting
          • Property Profile
            • Set Profile
            • Retrieve Property Profile
            • Set Hotelier Message
            • Retrieve Hotelier Message
            • Remove Hotelier-Message
          • Booking.com Property Status
            • Property Status Check
            • Property Status Open
            • Property Status Closed
          • Property Key Collection
            • Set CheckIn Methods
            • Retrieve CheckIn Method
            • Retrieve All Stream Variation
        • Images
          • Create Image
          • Retrieve All Images
          • Update Image Tags
          • Delete Image
          • Retrieve Associate Images
          • Associate Image
          • Unassociate Image
          • Ordering Image
          • Smart Ordering Image
          • Show Image
          • Retrieve Property Pending Photos based on photo-batch-id
          • Retrieve Image Tags
        • Facilities
          • Create/Update Facility
          • Retrieve Set Facility of Property and Room
          • Retrieve Supported Facilities
        • Property/Room Charges
          • Retrieve Property Charge Meta
          • Retrieve Property Charges
          • Retrieve Room Charges
          • Create Property Charges
        • Rate Plan
          • Set Rateplan
          • Retrieve Rateplan
      • Room API
        • Room Meta API
        • Room Set (Create/Update) API
        • Room Retrieve API
        • Room Deactivate API
      • Policies API
        • Create/Update Policies
        • Retrieve Policies
      • Bathroom API
        • Set Bathroom (Create and Update)
        • Remove/Disable Bathroom
        • Retrieve Bathroom
      • Product API
        • Product Meta
        • Product List
        • Product Create
        • Product Modify
        • Product Remove
        • Product Map Create (Room Based)
        • Product Map Modify (Room Based)
        • Product Map Create (Occupancy Based)
        • Product Map Modify (Occupancy Based)
        • Product Unmap
      • Property and Room License
        • Property License Retrieve All Rule (Without property id)
        • Property License Retrieve Rule (With property id)
        • Sending License Information of Property
        • Retrieve License Information of Property
        • Sending License Information of Room
        • Retrieve License Information of Room
      • BCIO (Booking.com Check-In / Check-Out Times)
      • PCT (Property Class Type Codes)
      • BCJT (Booking.com Job Titles)
      • PTT (Phone Technology Type Codes)
      • BCL (Booking.com Language Codes)
      • Currency Codes/Names
      • Country Codes/Names
      • BCPT (Booking.com Payment Type Codes)
    • Rates and Availability
    • Inventory Control
    • Reservations
      • New/Modified/Requested/Cancelled Retrievals
        • Request for Reservation Information
        • Response of Reservation Information
      • Reservation Using Push API
        • Reservations Notification Push
        • PUSH API Method
      • Reservation Notification
      • Request Booking
        • Accept/Confirm Request Booking
        • Deny/Cancel Request Booking
      • Booking Repull
        • List of Bookings
        • Refetch Booking
    • Logs
      • Update Logs
      • Failed Channel Logs
      • Rates & Inventory Logs (Future Date)
      • Bulk Rates & Inventory Logs (Future Date)
      • Resync OTA Updates (Failed)
      • OTA Rateplan Pull API
    • Users
      • Global Users
      • Chain Users
    • Channel Mapping Widget API
      • Generate a Token
      • Mapping Script
    • Reviews
    • Messaging
    • Reporting
      • Reporting - No Show (Booking.com & Goibibo)
      • Reporting - Invalid CC (Booking.com)
      • Reporting - Cancellation Due to Invalid CC (Booking.com)
      • Bulk ARI Update
      • Marketing Insight API - Booking.com
    • AirBnB
      • Cancel Reservation
        • Retrieve AirBnB Cancel Reservation Details API
        • Final AirBnB Cancel Reservation API
      • Notification
      • Trip Issue
    • My Booking Site
      • Confirm Reservation
      • Cancel Reservation
  • Su Token
    • Su Token - Introduction
    • Su Token - Authentication
    • Partner
    • Card
      • Card API
      • Card View API
      • Charge API
      • Card Collection
        • Get CC Collection (Generate Link)
        • Check Status of CC Collection
      • WIDGET
        • CC Collection Using Widget
  • Codes
    • Room Type Codes
    • Language Codes
    • Country Codes
    • Phone Technology Type Codes
    • Meal Plan Codes
    • Currency Codes
    • Channel or OTA Codes
    • Credit Card Type Codes
    • Time Zones
    • Error Codes
  • Versioning
  • Glossary of Terms
Powered by GitBook

STAAH Limited. 2024 © All Rights Reserved.

On this page

Was this helpful?

Export as PDF
  1. Codes

Error Codes

Su uses conventional HTTP response codes to indicate the failure of an API request. In general: Codes in the 4xx range indicate an error that failed given the information provided.


Su General Error Codes

Su general errors include an error code, error Id, and a short string with a brief explanation. These codes play a role in our recommended error handling techniques.

This section lists all the possible error codes, along with additional information and the quick process to resolve them.

The table below explains all the possible error codes you may encounter after requests to our API.

Code
Description

15

'Invalid date'

244

'Email [ ]: Value is not an email (a valid email (example@ex.com)), found 'Some Value' '

283

'RatePlan [ ]: Name: Value is not a name (a non-negative string) and maximum 100 characters, found 'Some Value' '

356

'HotelDescriptiveContentNotifType: Value should be one of [New, Overlay], found 'Some Value' '

367

'xml parse error'

400

'Invalid HotelCode ('code')'

497

'Authorization Required'

730

'RoomType: RoomType ('type') is not defined or is not known'

850

'can not create hotel with same (name, lon/lat, address)'

851

'ContactInfo [ ]: Property ContactProfileType is required'

853

'HotelCode: Value is not an id (an alpha-numeric) and maximum 15 characters, found 'Some Value' '

854

'Required data missing: Sellable Product'

855

'RoomRate: Value is not a nonnegative (a non-negative integer) and maximum 10 digits, found 'Some Value' '

856

'Required data missing: Room name'

857

'RatePlan [ ]: Value is not an id (an alpha-numeric) and maximum 15 characters, found 'Some Value' '

859

'no room_id's specified'

860

'room_id is inactive()'

861

'date has passed('value')'

862

'roomstosell: Value is not a nonnegative (a non-negative integer), found 'Some Value' '

863

'no rate_id's specified'

864

'rate_id is inactive('value')'

865

'closed: Value is not a extended_boolean (Extended boolean: "1", "0"), found 'Some Value' '

866

'closedonarrival: Value is not a extended_boolean (Extended boolean: "1", "0"), found 'Some Value' '

867

'closedondeparture: Value is not a extended_boolean (Extended boolean: "1", "0"), found 'Some Value' '

868

'minimumstay: Value is not a nonnegative (a non-negative integer), found 'Some Value' '

869

'maximumstay: Value is not a nonnegative (a non-negative integer), found 'Some Value' '

870

'extraadultrate: Value is not a nonnegative (a non-negative number), found 'Some Value' '

871

'extrachildrate: Value is not a nonnegative (a non-negative number), found 'Some Value' '

872

'NumberOfGuests: Value is not a nonnegative (a non-negative integer) or is greater than 20, found 'Some Value' '

873

'price: Value is not a nonnegative (a non-negative number), found 'Some Value' '

874

'MaxOccupancy: Value is not a nonnegative (a non-negative integer) and maximum 20, found 'Some Value' '

875

'Quantity: Value is not a nonnegative (a non-negative integer) and maximum 100, found 'Some Value' '

876

'NonSmoking: Value is not a extended_boolean (Extended boolean: "1", "0"), found 'Some Value' '

877

'SizeMeasurement: Value is not a room_square_decimal (there must be both at least one digit before and one after the decimal place. Accepts values bigger than 1.0), found 'Some Value' '

878

'SizeMeasurementUnit: Value is not a room_square_unit (unit must be either sqm or sqft), found 'Some Value' '

879

'Something Went Wrong'

880

'InvStatusType: Value should be one of [Active, Deactivated] with InvNotifType, found 'Some Value' '

891

'Bad Request'

892

'missing room object(s)'

893

'missing date element ( room id : ' ')'

894

'RoomID: Value is not a id (a non-negative alpha-numeric and maximum 15 characters), found 'Some Value' '

895

'Property : Property content is required'

896

'Requested rate does not qualify. Rate with id '' already exists'

897

'Authorization error. Access denied while trying to update '' '

898

'Latitude: Value is not a latitude (a valid latitude (-90 to 90)), found 'Some Value' '

899

'Longitude: Value is not a longitude (a valid longitude (-180 to 180)), found 'Some Value' '

900

'InvStatusType: Value should be 'Initial' with no InvNotifType found 'Some Value' '

901

'ContactProfileType: Value is not a contact_type (Type of hotel contact), found 'Some Value' '

902

'Value is required'

903

'Authorization error. Access denied while trying to update hotel value'

904

'Phone [ ]: PhoneNumber: Property PhoneNumber is required OR PhoneNumber: Value did match more than one schemas AND PhoneNumber: Value is not a number (a non-negative integer with + prefix and not more than 15 numbers) AND PhoneTechType: Value should be one of [1, 3, 5]'

905

'RatePlan [ ]: RatePlanNotifType: Value should be one of [New, Activate, Overlay, Remove]'

906

'Requested room does not qualify. Room with id 'value' already exists'

907

'value : missing content element'

908

'content: Value is not a countrycode (ISO 3166 countrycode: two lowercase characters), found 'value' '

909

'value: is not a valid add (an alpha-numeric more than 4 and less than 300 characters)'

910

'value: is not a valid code (a numeric value less than 10 characters), found 'pc' '

911

'value: Value is not a Text (a valid room name) and maximum 100 characters, found 'txt' '

912

'InvCode: Value is not a id (a non-negative integer), found 'value' '

913

'Property is inactive'

914

'LanguageCode: Value is not a languagecode (ISO 639 languagecode: two lowercase characters), found 'value' '

915

'Phone: Array should have a maximum of 5 items'

916

'value: Value is not an object'

917

'PhoneTechType[^value_replace]: Value can not have more than 2 PhoneNumbers'

918

'PhoneTechType[1]: Value should have at least one PhoneNumber'

919

'Room SizeMeasurementUnit attribute cannot be defined without SizeMeasurement'

920

'SellableProduct: Maximum 10 Roomtype creation at a time'

938

'No rooms found'

939

'No rates found'

940

'No property found'

941

'Invalid Room Id'

942

'Invalid Rate Id'

943

'Enter From Date'

944

'Enter To Date'

945

'Date must be present or future'

946

'To date must be greater then from date'

947

'Property is inactive'

948

'json parse error'

949

'Invalid Authorization Key'

950

'Reservation Not Found'

951

'no updates found'

952

'Inventory not found'

953

'This Property Have Mapping With Channels'

954

'^value_replace is already mapped'

955

'Invalid reservation_notif_id'

956

'Either use HotelCode or ClientID'

957

'Either use RoomID or ListingID'

958

'Either use hotelid or ClientID'

959

'Required data missing: pg_code'

960

'Unauthrized access'

961

'Required data missing: pg_status'

962

'pg_status:Value should be one of [ live, inactive ], found ^value_replace'

963

'Required data missing: param1'

964

'Required data missing: param2'

965

'Required data missing: action'

966

'action: Value should be 1, found ^value_replace'

PreviousTime ZonesNextVersioning

Last updated 29 days ago

Was this helpful?