{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"d1e70c2e-3a91-4978-bedb-7e1d6a996977","name":"RON2 JSON Documentation","description":"### Restful API Reference\n\nThe ResPax Operator Network (RON) Restful API is the window into a real-time tour operator portal network connecting in real-time to major Australian and New Zealand tour operators. The ResPax Operator Network enables development of interfaces to directly interact with each operator retrieving tour details with images, checking availability, checking prices and committing bookings directly into the remote operator's system. For a more detailed overview of RON, please check out the RON Introduction page to get started with your interface. You will need to register as a user on ResPax. As part of the registration process, you will be sent an email with your user details.\n\n#### Sandbox Environment\n\nTo set the configuration to reach our sandbox environment, RON2 supports the following domain and parameters\n\nDOMAIN: [https://ron2-sandbox.respax.com](https://ron2.respax.com)\n\nHOST_ID: SALES\n\nCONFIG: live\n\nFor example\n\n[https://ron2-sandbox.respax.com/read-payment-options-SALES.json?mode=live](https://ron2.respax.com/read-payment-options-SALES.json?mode=live)\n\n#### Production Environment\n\nTo set the configuration to reach our production environment, RON2 supports the following domain\n\nDOMAIN: [https://ron2.respax.com](https://ron2.respax.com)\n\nFor example\n\n[https://ron2.respax.com/read-payment-options-SALES.json?mode=live](https://ron2.respax.com/read-payment-options-SALES.json?mode=live)\n\n#### Datetime format\n\nAll date and times follow the ISO_8601 specification. Reference: ISO 8601\n\n#### Boolean fields\n\nJSON true and false. Reference: JSON Schema: A Media Type for Describing JSON Documents\n\n#### HTTP Authorization\n\nThe username and password are combined with a single colon (:). \nThe resulting string is encoded into an octet sequence. \nThe resulting string is encoded using a variant of Base64. \nThe authorization method and a space is then prepended to the encoded string.\n\n#### Authorization: Basic XXXXXXXXXXXXXXX==\n\n[Reference: Basic access authentication](https://en.wikipedia.org/wiki/Basic_access_authentication).\n\n# Common API Connection Issues\n\n### 1\\. Authentication Issues\n\n#### Problem :\n\nInvalid API Authentication\n\n#### Solution\n\nMake sure you are using the correct ResPax API user credentials. If you are getting an error, please contact Respax support with your organization details and API username.\n\n### 2\\. Connection Errors\n\n#### Problem :\n\nUnable to Connect to API\n\n#### Solution\n\nCheck your internet connection and ensure the ResPax API endpoint URL is correct. Verify that your firewall or network settings are not blocking the connection.\n\n### 3\\. Data Retrieval Issues\n\n#### Problem :\n\nNo Data Returned\n\n#### Solution\n\nEnsure your query parameters are correct and match the expected format. Check if the data you are requesting exists in the system.\n\n### 4\\. Responses Codes\n\n
Response CodeDescriptionHandling
400 Bad Request
The server could not understand the request due to invalid syntax.
Check the request parameters and ensure they are correctly formatted.
401 Unauthorized
The request requires user authentication
Ensure that the API key or token or basic auth is included in the request header.
403 Forbidden
The server understood the request but refuses to authorize it.
Verify that the API key has the necessary permissions.
404 Not Found
The server can not find the requested resource.
Check the endpoint URL and ensure it is correct.
500 Internal Server Error
The server encountered an unexpected condition that prevented it from fulfilling the request.
Contact ResPax support if the problem persists.
504/502 Gateway Timeout
timely response from another server while trying to load a response.
This is a server-side issue. Contact ResPax support if the problem persists.
\n\nExcept for 4xx and 5xx response codes, errors usually come with a 200 response code and the payload as shown below:\n\n```\n{\n\"error_message\": \"error reason\",\n\"error\": true\n}\n\n ```\n\nFor response codes 4xx and 5xx, you should contact Respax support.\n\nFor a 200 response code with error: true, you can contact either the supplier or Respax support, depending on the reason\n\n| **Error** | **Discription** | **Handling** |\n| --- | --- | --- |\n| Payment Option Invalid | The payment option used in the endpoints (check-reservation and write-reservation) is incorrect. | You should contact the operators directly for further assistance. |\n| Insufficient pickup information provided for a compulsory pickup tour | If the tour has a mandatory pickup, you should include the pickup details in the payload | You can see it in the read-tours endpoint. The option is under tour_flavours as ‘is_mpup’, which should be true. |\n| Control flags on tour prevent it from being booked through this interface | Tour Code, Basis, SubBasis or Tour Time is web-disabled and cannot create booking | contact Operator or use the read-tours endpoint to update data. |\n| Validation Exception: \"tour_code: '' is not enabled | The tour code is disabled | contact Operator or use the read-tours endpoint to update data |\n| Validation Exception: \"basic_id: '' is not enabled | The Basis set for this tour code is disabled | Contact the Operator or use the read-tours endpoint to update data. |\n| Validation Exception: \"subbasis_id: '' is not enabled | The SubBasis set for this tour code is disabled | contact Operator or use the read-tours endpoint to update data. |\n| Validation Exception: tour_time_id: '' is not enabled | The Tour Time set for this tour code is disabled | contact Operator or use the read-tours endpoint to update data. |\n| Error in pickup: 'pickup_id' and/or 'route_code' are invalid for this tou | The pickup details have invalid information (not linked with your tour code or incorrect data) | contact Operator or use the read-transfer endpoint to update data. |\n| Validation Exception: pickup_id: '' is not enabled | The location is disabled | contact Operator or use the read-transfers endpoint to update data. |\n| Validation Exception: pickup_route_code: '' is not enabled | The route is disabled | contact Operator or use the read-transfers endpoint to update data. |\n\n# Connecting with RON2","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"36208281","team":6280206,"collectionId":"d1e70c2e-3a91-4978-bedb-7e1d6a996977","publishedId":"2sA3XMhNcG","public":true,"publicUrl":"https://developer.respax.com","privateUrl":"https://go.postman.co/documentation/36208281-d1e70c2e-3a91-4978-bedb-7e1d6a996977","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":"The ResPax Operator Network (RON) Restful API is the window into a real-time tour operator portal network connecting in real-time to tour operators."},{"name":"title","value":"ResPax RON2 API"}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/b26abde6-ae06-469e-8c18-500aabfe2799/cmVzcGF4LWxvZ28tYmx1ZS5wbmc=","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":"https://content.pstmn.io/b26abde6-ae06-469e-8c18-500aabfe2799/cmVzcGF4LWxvZ28tYmx1ZS5wbmc=","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.0","publishDate":"2024-06-11T03:18:40.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"ResPax RON2 API","description":"The ResPax Operator Network (RON) Restful API is the window into a real-time tour operator portal network connecting in real-time to tour operators."},"logos":{"logoLight":"https://content.pstmn.io/b26abde6-ae06-469e-8c18-500aabfe2799/cmVzcGF4LWxvZ28tYmx1ZS5wbmc=","logoDark":"https://content.pstmn.io/b26abde6-ae06-469e-8c18-500aabfe2799/cmVzcGF4LWxvZ28tYmx1ZS5wbmc="}},"statusCode":200},"environments":[{"name":"SANDBOX","id":"7739d221-c2bb-4246-8863-a07cf4debff6","owner":"36208281","values":[{"key":"RON_USERNAME","value":"sales_test","enabled":true},{"key":"RON_PASSWORD","value":"sales_test","enabled":true},{"key":"DOMAIN","value":"https://ron2.respax.com","enabled":true},{"key":"DISTRIBUTOR_ID","value":"","enabled":true},{"key":"HOST_ID","value":"SALES","enabled":true},{"key":"TOUR_CODE","value":"CNRCITY","enabled":true},{"key":"TOUR_DATE","value":"2020-01-01","enabled":true},{"key":"TOUR_DATE2","value":"2020-01-02","enabled":true},{"key":"TOUR_DATE3","value":"2020-01-03","enabled":true},{"key":"BASIS_ID","value":"144","enabled":true},{"key":"SUBBASIS_ID","value":"206","enabled":true},{"key":"TIME_ID","value":"149","enabled":true},{"key":"CONFIG","value":"live","enabled":true},{"key":"DATE_2","value":"2018-12-16","enabled":true},{"key":"PROMO_CODE","value":"","enabled":true},{"key":"PAYMENT_OPTION","value":"comm-agent/bal-pob","enabled":true},{"key":"VOUCHER_NUM","value":"TEST BOOKING","enabled":true},{"key":"PICKUP_KEY","value":"BUS2:64:1092","enabled":true},{"key":"ROUTE_CODE","value":"BUS2","enabled":true},{"key":"PICKUP_ID","value":"64","enabled":true},{"key":"PICKUP_TIME_ID","value":"1092","enabled":true},{"key":"PICKUP_ROUTE_CODE","value":"BUS2","enabled":true},{"key":"DROPOFF_ID","value":"64","enabled":true},{"key":"DROPOFF_TIME_ID","value":"408","enabled":true},{"key":"DROPOFF_ROUTE_CODE","value":"BUS2","enabled":true},{"key":"SUPPLIER_ID","value":"","type":"default","enabled":true},{"key":"RESERVATION_ID","value":"","type":"default","enabled":true},{"key":"MAPPS_URL","value":"https://mapps.respax.com","type":"default","enabled":true},{"key":"END_DATE","value":"","type":"default","enabled":true},{"key":"PAYMENT_OPTION_CODE","value":"","type":"any","enabled":true},{"key":"RE_SELLER_ID","value":"","type":"default","enabled":true},{"key":"SUPPLIER_ID","value":"","type":"default","enabled":true}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/62c990ed87a4c17d095871be0a105205f69757b92022345f85ff480f2c04e358","favicon":"https://respax.com/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"SANDBOX","value":"36208281-7739d221-c2bb-4246-8863-a07cf4debff6"}],"canonicalUrl":"https://developer.respax.com/view/metadata/2sA3XMhNcG"}