quandoo 1.0.0

data/lib/quandoo/api/menus_api.rb

@@ -0,0 +1,301 @@
+=begin
+#Quandoo API Documentation
+
+#No description provided (generated by Swagger Codegen https://github.com/swagger-api/swagger-codegen)
+
+OpenAPI spec version: 1.0.0
+
+Generated by: https://github.com/swagger-api/swagger-codegen.git
+Swagger Codegen version: 2.4.5
+
+=end
+
+require 'uri'
+
+module Quandoo
+  class MenusApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Add/remove menu items to/from a reservation's preorders
+    # This endpoint will add/remove menu items to/from preorders of a reservation.   If an item already exists, the quantitiy specified for the item will be added to the existing quantity.  For example, if an item has a quantity of 2, and a PATCH request specifies the same item with a quantity of 1, the result will be a quantity of 3 for that item.  This can be also used to remove items, by specifying a negative quantity. For example, if an item has a quantity of 2, and a PATCH request specifies the same item with a quantity of -1, the result will be a quantity of 1.  No item can have a negative quantity in the end, which means a PATCH request with a quantity of -5 for an item that currently has a quantity of 2, will result in that item to be simply deleted from the preorder, instead of having a final quantity of -3.  If an item does not exist in the current preorders, it will be added, provided it has a positive quantity.   The reservation ID in the request is the public ID of the reservation and **not** agent-specific.  This endpoint requires user to be logged in.  The endpoint will return `HTTP 404 - Not Found` if the reservation with the specified id could not be found. It will return `HTTP 403 - Forbidden` if the user is not authenticated or the reservation doesn't belong to the customer associated with the user.  ####Request: * **reservationId**: Public ID of the reservation. Path parameter.  Request body has the same structure as Get Preorder response, except not having the `href` field. * **items**: List of menu items to be edited. Each menu item will have the fields explained below.   * **menuId**: The Id of the menu that this item belongs to. **Required**.   * **itemId**: The Id of the menu item. **Required**.   * **quantity**: Change in quantity to be applied to the existing item's quantity. See above for explanation. **Required**.   * **guestPublicId**: The ID of the guest for whom this item is being preordered. Optional. Format: UUID.  ####Response: * **items**: The response will be a _list_ of successfully preordered menu items. Each menu item has the fields explained below:   * **menuId**: The Id of the menu that this item belongs to   * **itemId**: The Id of the menu item   * **quantity**: Quantity of this menu item selected for the reservation   * **guestPublicId**: The ID of the guest for whom this item has been preordered, if any.   * **href**: Link that can be followed to get information about the menu and its available items  Example curl: ``` curl -H \"Content Type: application/json\" -X PATCH -d ' {   \"items\": [     {       \"menuId\": 1846,       \"itemId\": 1477,       \"quantity\": 1,       \"guestPublicId\": \"a8a66a11-446a-443b-8834-591742825ad4\"     },     {       \"menuId\": 1846,       \"itemId\": 1478,       \"quantity\": -1     }   ] } ' https://{host}/v{X}/reservations/ce0706ff-a95d-4229-a220-d21dcd175342/preorders ```  Example response:  ``` {   \"items\": [     {       \"menuId\": 1846,       \"itemId\": 1477,       \"quantity\": 2,       \"guestPublicId\": \"a8a66a11-446a-443b-8834-591742825ad4\",       \"href\": \"https://{host}/v{X}/reservations/ce0706ff-a95d-4229-a220-d21dcd175342/menus/1846\"     },     {       \"menuId\": 1846,       \"itemId\": 1478,       \"quantity\": 1,       \"guestPublicId\": \"f871d6d7-e92e-4672-b24a-edb76963073b\",       \"href\": \"https://{host}/v{X}/reservations/ce0706ff-a95d-4229-a220-d21dcd175342/menus/1846\"     }   ] } ``` 
+    # @param reservation_id Public Id of the reservation
+    # @param body Menu items to add
+    # @param [Hash] opts the optional parameters
+    # @return [ReservationMenuData]
+    def add_preordered_items1(reservation_id, body, opts = {})
+      data, _status_code, _headers = add_preordered_items1_with_http_info(reservation_id, body, opts)
+      data
+    end
+
+    # Add/remove menu items to/from a reservation's preorders
+    # This endpoint will add/remove menu items to/from preorders of a reservation.   If an item already exists, the quantitiy specified for the item will be added to the existing quantity.  For example, if an item has a quantity of 2, and a PATCH request specifies the same item with a quantity of 1, the result will be a quantity of 3 for that item.  This can be also used to remove items, by specifying a negative quantity. For example, if an item has a quantity of 2, and a PATCH request specifies the same item with a quantity of -1, the result will be a quantity of 1.  No item can have a negative quantity in the end, which means a PATCH request with a quantity of -5 for an item that currently has a quantity of 2, will result in that item to be simply deleted from the preorder, instead of having a final quantity of -3.  If an item does not exist in the current preorders, it will be added, provided it has a positive quantity.   The reservation ID in the request is the public ID of the reservation and **not** agent-specific.  This endpoint requires user to be logged in.  The endpoint will return `HTTP 404 - Not Found` if the reservation with the specified id could not be found. It will return `HTTP 403 - Forbidden` if the user is not authenticated or the reservation doesn't belong to the customer associated with the user.  ####Request: * **reservationId**: Public ID of the reservation. Path parameter.  Request body has the same structure as Get Preorder response, except not having the `href` field. * **items**: List of menu items to be edited. Each menu item will have the fields explained below.   * **menuId**: The Id of the menu that this item belongs to. **Required**.   * **itemId**: The Id of the menu item. **Required**.   * **quantity**: Change in quantity to be applied to the existing item's quantity. See above for explanation. **Required**.   * **guestPublicId**: The ID of the guest for whom this item is being preordered. Optional. Format: UUID.  ####Response: * **items**: The response will be a _list_ of successfully preordered menu items. Each menu item has the fields explained below:   * **menuId**: The Id of the menu that this item belongs to   * **itemId**: The Id of the menu item   * **quantity**: Quantity of this menu item selected for the reservation   * **guestPublicId**: The ID of the guest for whom this item has been preordered, if any.   * **href**: Link that can be followed to get information about the menu and its available items  Example curl: ``` curl -H \"Content Type: application/json\" -X PATCH -d ' {   \"items\": [     {       \"menuId\": 1846,       \"itemId\": 1477,       \"quantity\": 1,       \"guestPublicId\": \"a8a66a11-446a-443b-8834-591742825ad4\"     },     {       \"menuId\": 1846,       \"itemId\": 1478,       \"quantity\": -1     }   ] } ' https://{host}/v{X}/reservations/ce0706ff-a95d-4229-a220-d21dcd175342/preorders ```  Example response:  ``` {   \"items\": [     {       \"menuId\": 1846,       \"itemId\": 1477,       \"quantity\": 2,       \"guestPublicId\": \"a8a66a11-446a-443b-8834-591742825ad4\",       \"href\": \"https://{host}/v{X}/reservations/ce0706ff-a95d-4229-a220-d21dcd175342/menus/1846\"     },     {       \"menuId\": 1846,       \"itemId\": 1478,       \"quantity\": 1,       \"guestPublicId\": \"f871d6d7-e92e-4672-b24a-edb76963073b\",       \"href\": \"https://{host}/v{X}/reservations/ce0706ff-a95d-4229-a220-d21dcd175342/menus/1846\"     }   ] } ``` 
+    # @param reservation_id Public Id of the reservation
+    # @param body Menu items to add
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ReservationMenuData, Fixnum, Hash)>] ReservationMenuData data, response status code and response headers
+    def add_preordered_items1_with_http_info(reservation_id, body, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MenusApi.add_preordered_items1 ...'
+      end
+      # verify the required parameter 'reservation_id' is set
+      if @api_client.config.client_side_validation && reservation_id.nil?
+        fail ArgumentError, "Missing the required parameter 'reservation_id' when calling MenusApi.add_preordered_items1"
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling MenusApi.add_preordered_items1"
+      end
+      # resource path
+      local_var_path = '/v1/reservations/{reservationId}/preorders'.sub('{' + 'reservationId' + '}', reservation_id.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = @api_client.object_to_http_body(body)
+      auth_names = ['CUSTOMER_SESSION']
+      data, status_code, headers = @api_client.call_api(:PATCH, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'ReservationMenuData')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: MenusApi#add_preordered_items1\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    # Get all available menus for a reservation
+    # This endpoint will return the available menus for a reservation.  The reservation ID in the request is the public ID of the reservation and **not** agent-specific.  This endpoint requires user to be logged in.  The endpoint will return `HTTP 404 - Not Found` if the reservation with the specified id could not be found. It will return `HTTP 403 - Forbidden` if the user is not authenticated or the reservation doesn't belong to the customer associated with the user.  ####Request: * **reservationId**: Public Id of the reservation * **locale**: Locale for translated info. Default: _en_  ####Response: The response will be a _list_ of available menus. Each menu has the fields explained below: * **id**: The unique id of the menu * **name**: The name or title of the menu * **description**: Menu description * **price**: Total price for the menu * **sortOrder**: The order in which this menu should be displayed * **categories**: Categories of the menu   * **id**: The Id of the menu category   * **name**: Name or title of the menu category   * **items**: Items inside the menu category     * **id**: Id of the menu item     * **name**: Name of menu item     * **description**: Menu item description     * **price**: Item price  Example curl: ``` curl https://{host}/v{X}/reservations/ce0706ff-a95d-4229-a220-d21dcd175342/menus?locale=en ```  Example response:  ``` {   \"menus\": [     {       \"id\": 1836,       \"name\": \"special menu 1\",       \"price\": \"100.00\",       \"sortOrder\": 0,       \"categories\": [         {           \"id\": 1109,           \"name\": \"starters\",           \"items\": [             {               \"id\": 1469,               \"name\": \"fries\",               \"price\": \"20.00\"             }           ]         },         {           \"id\": 1110,           \"name\": \"fish\",           \"items\": [             {               \"id\": 1470,               \"name\": \"salmon\",               \"price\": \"60.00\"             }           ]         },         {           \"id\": 1111,           \"name\": \"dessert\",           \"items\": [             {               \"id\": 1471,               \"name\": \"sundae\",               \"price\": \"20.00\"             }           ]         }       ]     }   ] } ``` 
+    # @param reservation_id Public Id of the reservation
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :locale Locale for translated info (default to en)
+    # @return [MerchantMenusDto]
+    def find_menus_for_reservation1(reservation_id, opts = {})
+      data, _status_code, _headers = find_menus_for_reservation1_with_http_info(reservation_id, opts)
+      data
+    end
+
+    # Get all available menus for a reservation
+    # This endpoint will return the available menus for a reservation.  The reservation ID in the request is the public ID of the reservation and **not** agent-specific.  This endpoint requires user to be logged in.  The endpoint will return &#x60;HTTP 404 - Not Found&#x60; if the reservation with the specified id could not be found. It will return &#x60;HTTP 403 - Forbidden&#x60; if the user is not authenticated or the reservation doesn&#39;t belong to the customer associated with the user.  ####Request: * **reservationId**: Public Id of the reservation * **locale**: Locale for translated info. Default: _en_  ####Response: The response will be a _list_ of available menus. Each menu has the fields explained below: * **id**: The unique id of the menu * **name**: The name or title of the menu * **description**: Menu description * **price**: Total price for the menu * **sortOrder**: The order in which this menu should be displayed * **categories**: Categories of the menu   * **id**: The Id of the menu category   * **name**: Name or title of the menu category   * **items**: Items inside the menu category     * **id**: Id of the menu item     * **name**: Name of menu item     * **description**: Menu item description     * **price**: Item price  Example curl: &#x60;&#x60;&#x60; curl https://{host}/v{X}/reservations/ce0706ff-a95d-4229-a220-d21dcd175342/menus?locale&#x3D;en &#x60;&#x60;&#x60;  Example response:  &#x60;&#x60;&#x60; {   \&quot;menus\&quot;: [     {       \&quot;id\&quot;: 1836,       \&quot;name\&quot;: \&quot;special menu 1\&quot;,       \&quot;price\&quot;: \&quot;100.00\&quot;,       \&quot;sortOrder\&quot;: 0,       \&quot;categories\&quot;: [         {           \&quot;id\&quot;: 1109,           \&quot;name\&quot;: \&quot;starters\&quot;,           \&quot;items\&quot;: [             {               \&quot;id\&quot;: 1469,               \&quot;name\&quot;: \&quot;fries\&quot;,               \&quot;price\&quot;: \&quot;20.00\&quot;             }           ]         },         {           \&quot;id\&quot;: 1110,           \&quot;name\&quot;: \&quot;fish\&quot;,           \&quot;items\&quot;: [             {               \&quot;id\&quot;: 1470,               \&quot;name\&quot;: \&quot;salmon\&quot;,               \&quot;price\&quot;: \&quot;60.00\&quot;             }           ]         },         {           \&quot;id\&quot;: 1111,           \&quot;name\&quot;: \&quot;dessert\&quot;,           \&quot;items\&quot;: [             {               \&quot;id\&quot;: 1471,               \&quot;name\&quot;: \&quot;sundae\&quot;,               \&quot;price\&quot;: \&quot;20.00\&quot;             }           ]         }       ]     }   ] } &#x60;&#x60;&#x60; 
+    # @param reservation_id Public Id of the reservation
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :locale Locale for translated info
+    # @return [Array<(MerchantMenusDto, Fixnum, Hash)>] MerchantMenusDto data, response status code and response headers
+    def find_menus_for_reservation1_with_http_info(reservation_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MenusApi.find_menus_for_reservation1 ...'
+      end
+      # verify the required parameter 'reservation_id' is set
+      if @api_client.config.client_side_validation && reservation_id.nil?
+        fail ArgumentError, "Missing the required parameter 'reservation_id' when calling MenusApi.find_menus_for_reservation1"
+      end
+      # resource path
+      local_var_path = '/v1/reservations/{reservationId}/menus'.sub('{' + 'reservationId' + '}', reservation_id.to_s)
+
+      # query parameters
+      query_params = {}
+      query_params[:'locale'] = opts[:'locale'] if !opts[:'locale'].nil?
+
+      # header parameters
+      header_params = {}
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['CUSTOMER_SESSION']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'MerchantMenusDto')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: MenusApi#find_menus_for_reservation1\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    # Get information about an available reservation menu
+    # This endpoint will return details for a single available menu.  The reservation ID in the request is the public ID of the reservation and **not** agent-specific.  This endpoint requires user to be logged in.  The endpoint will return `HTTP 404 - Not Found` if the reservation or menu with the specified id could not be found. It will return `HTTP 403 - Forbidden` if the user is not authenticated or the reservation doesn't belong to the customer associated with the user.  ####Request: * **reservationId**: Public id of the reservation * **menuId**: Id of the menu * **locale**: Locale for translated info. Default: _en_  ####Response: The response will be a menu with each field as explained below: * **id**: The unique id of the menu * **name**: The name or title of the menu * **description**: Menu description * **price**: Total price for the menu * **sortOrder**: The order in which this menu should be displayed * **categories**: Categories of the menu   * **id**: The id of the menu category   * **name**: Name or title of the menu category   * **items**: Items inside the menu category     * **id**: Id of the menu item     * **name**: Name of menu item     * **description**: Menu item description     * **price**: Item price  Example curl: ``` curl https://{host}/v{X}/reservations/ce0706ff-a95d-4229-a220-d21dcd175342/menus/1836?locale=en ```  Example response:  ``` {   \"id\": 1836,   \"name\": \"special menu 1\",   \"price\": \"100.00\",   \"sortOrder\": 0,   \"categories\": [     {       \"id\": 1109,       \"name\": \"starters\",       \"items\": [         {           \"id\": 1469,           \"name\": \"fries\",           \"price\": \"20.00\"         }       ]     },     {       \"id\": 1110,       \"name\": \"fish\",       \"items\": [         {           \"id\": 1470,           \"name\": \"salmon\",           \"price\": \"60.00\"         }       ]     },     {       \"id\": 1111,       \"name\": \"dessert\",       \"items\": [         {           \"id\": 1471,           \"name\": \"sundae\",           \"price\": \"20.00\"         }       ]     }   ] } ``` 
+    # @param reservation_id Public Id of the reservation
+    # @param menu_id Id of the menu
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :locale Locale for translated info (default to en)
+    # @return [MerchantMenuDto]
+    def get_menu_for_reservation1(reservation_id, menu_id, opts = {})
+      data, _status_code, _headers = get_menu_for_reservation1_with_http_info(reservation_id, menu_id, opts)
+      data
+    end
+
+    # Get information about an available reservation menu
+    # This endpoint will return details for a single available menu.  The reservation ID in the request is the public ID of the reservation and **not** agent-specific.  This endpoint requires user to be logged in.  The endpoint will return &#x60;HTTP 404 - Not Found&#x60; if the reservation or menu with the specified id could not be found. It will return &#x60;HTTP 403 - Forbidden&#x60; if the user is not authenticated or the reservation doesn&#39;t belong to the customer associated with the user.  ####Request: * **reservationId**: Public id of the reservation * **menuId**: Id of the menu * **locale**: Locale for translated info. Default: _en_  ####Response: The response will be a menu with each field as explained below: * **id**: The unique id of the menu * **name**: The name or title of the menu * **description**: Menu description * **price**: Total price for the menu * **sortOrder**: The order in which this menu should be displayed * **categories**: Categories of the menu   * **id**: The id of the menu category   * **name**: Name or title of the menu category   * **items**: Items inside the menu category     * **id**: Id of the menu item     * **name**: Name of menu item     * **description**: Menu item description     * **price**: Item price  Example curl: &#x60;&#x60;&#x60; curl https://{host}/v{X}/reservations/ce0706ff-a95d-4229-a220-d21dcd175342/menus/1836?locale&#x3D;en &#x60;&#x60;&#x60;  Example response:  &#x60;&#x60;&#x60; {   \&quot;id\&quot;: 1836,   \&quot;name\&quot;: \&quot;special menu 1\&quot;,   \&quot;price\&quot;: \&quot;100.00\&quot;,   \&quot;sortOrder\&quot;: 0,   \&quot;categories\&quot;: [     {       \&quot;id\&quot;: 1109,       \&quot;name\&quot;: \&quot;starters\&quot;,       \&quot;items\&quot;: [         {           \&quot;id\&quot;: 1469,           \&quot;name\&quot;: \&quot;fries\&quot;,           \&quot;price\&quot;: \&quot;20.00\&quot;         }       ]     },     {       \&quot;id\&quot;: 1110,       \&quot;name\&quot;: \&quot;fish\&quot;,       \&quot;items\&quot;: [         {           \&quot;id\&quot;: 1470,           \&quot;name\&quot;: \&quot;salmon\&quot;,           \&quot;price\&quot;: \&quot;60.00\&quot;         }       ]     },     {       \&quot;id\&quot;: 1111,       \&quot;name\&quot;: \&quot;dessert\&quot;,       \&quot;items\&quot;: [         {           \&quot;id\&quot;: 1471,           \&quot;name\&quot;: \&quot;sundae\&quot;,           \&quot;price\&quot;: \&quot;20.00\&quot;         }       ]     }   ] } &#x60;&#x60;&#x60; 
+    # @param reservation_id Public Id of the reservation
+    # @param menu_id Id of the menu
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :locale Locale for translated info
+    # @return [Array<(MerchantMenuDto, Fixnum, Hash)>] MerchantMenuDto data, response status code and response headers
+    def get_menu_for_reservation1_with_http_info(reservation_id, menu_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MenusApi.get_menu_for_reservation1 ...'
+      end
+      # verify the required parameter 'reservation_id' is set
+      if @api_client.config.client_side_validation && reservation_id.nil?
+        fail ArgumentError, "Missing the required parameter 'reservation_id' when calling MenusApi.get_menu_for_reservation1"
+      end
+      # verify the required parameter 'menu_id' is set
+      if @api_client.config.client_side_validation && menu_id.nil?
+        fail ArgumentError, "Missing the required parameter 'menu_id' when calling MenusApi.get_menu_for_reservation1"
+      end
+      # resource path
+      local_var_path = '/v1/reservations/{reservationId}/menus/{menuId}'.sub('{' + 'reservationId' + '}', reservation_id.to_s).sub('{' + 'menuId' + '}', menu_id.to_s)
+
+      # query parameters
+      query_params = {}
+      query_params[:'locale'] = opts[:'locale'] if !opts[:'locale'].nil?
+
+      # header parameters
+      header_params = {}
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['CUSTOMER_SESSION']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'MerchantMenuDto')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: MenusApi#get_menu_for_reservation1\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    # Get preorders of a reservation
+    # This endpoint will return the preordered menu items of a reservation.   The reservation ID in the request is the public ID of the reservation and **not** agent-specific.  This endpoint requires user to be logged in.  The endpoint will return `HTTP 404 - Not Found` if the reservation with the specified id could not be found. It will return `HTTP 403 - Forbidden` if the user is not authenticated or the reservation doesn't belong to the customer associated with the user.  ####Request: * **reservationId**: Public ID of the reservation  ####Response: The response will be a _list_ of menu items. Each menu item has the fields explained below: * **menuId**: The Id of the menu that this item belongs to * **itemId**: The Id of the menu item * **quantity**: Quantity of this menu item selected for the reservation * **guestPublicId**: The ID of the guest for whom this item has been preordered, if any. * **href**: Link that can be followed to get information about the menu and its available items  Example curl: ``` curl https://{host}/v{X}/reservations/ce0706ff-a95d-4229-a220-d21dcd175342/preorders ```  Example response:  ``` {   \"items\": [     {       \"menuId\": 1846,       \"itemId\": 1477,       \"quantity\": 1,       \"guestPublicId\": \"a8a66a11-446a-443b-8834-591742825ad4\",       \"href\": \"https://{host}/v{X}/reservations/ce0706ff-a95d-4229-a220-d21dcd175342/menus/1846\"     },     {       \"menuId\": 1846,       \"itemId\": 1478,       \"quantity\": 2,       \"guestPublicId\": \"a8a66a11-446a-443b-8834-591742825ad4\",       \"href\": \"https://{host}/v{X}/reservations/ce0706ff-a95d-4229-a220-d21dcd175342/menus/1846\"     }   ] } ``` 
+    # @param reservation_id Public Id of the reservation
+    # @param [Hash] opts the optional parameters
+    # @return [ReservationMenuData]
+    def get_preordered_items1(reservation_id, opts = {})
+      data, _status_code, _headers = get_preordered_items1_with_http_info(reservation_id, opts)
+      data
+    end
+
+    # Get preorders of a reservation
+    # This endpoint will return the preordered menu items of a reservation.   The reservation ID in the request is the public ID of the reservation and **not** agent-specific.  This endpoint requires user to be logged in.  The endpoint will return &#x60;HTTP 404 - Not Found&#x60; if the reservation with the specified id could not be found. It will return &#x60;HTTP 403 - Forbidden&#x60; if the user is not authenticated or the reservation doesn&#39;t belong to the customer associated with the user.  ####Request: * **reservationId**: Public ID of the reservation  ####Response: The response will be a _list_ of menu items. Each menu item has the fields explained below: * **menuId**: The Id of the menu that this item belongs to * **itemId**: The Id of the menu item * **quantity**: Quantity of this menu item selected for the reservation * **guestPublicId**: The ID of the guest for whom this item has been preordered, if any. * **href**: Link that can be followed to get information about the menu and its available items  Example curl: &#x60;&#x60;&#x60; curl https://{host}/v{X}/reservations/ce0706ff-a95d-4229-a220-d21dcd175342/preorders &#x60;&#x60;&#x60;  Example response:  &#x60;&#x60;&#x60; {   \&quot;items\&quot;: [     {       \&quot;menuId\&quot;: 1846,       \&quot;itemId\&quot;: 1477,       \&quot;quantity\&quot;: 1,       \&quot;guestPublicId\&quot;: \&quot;a8a66a11-446a-443b-8834-591742825ad4\&quot;,       \&quot;href\&quot;: \&quot;https://{host}/v{X}/reservations/ce0706ff-a95d-4229-a220-d21dcd175342/menus/1846\&quot;     },     {       \&quot;menuId\&quot;: 1846,       \&quot;itemId\&quot;: 1478,       \&quot;quantity\&quot;: 2,       \&quot;guestPublicId\&quot;: \&quot;a8a66a11-446a-443b-8834-591742825ad4\&quot;,       \&quot;href\&quot;: \&quot;https://{host}/v{X}/reservations/ce0706ff-a95d-4229-a220-d21dcd175342/menus/1846\&quot;     }   ] } &#x60;&#x60;&#x60; 
+    # @param reservation_id Public Id of the reservation
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ReservationMenuData, Fixnum, Hash)>] ReservationMenuData data, response status code and response headers
+    def get_preordered_items1_with_http_info(reservation_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MenusApi.get_preordered_items1 ...'
+      end
+      # verify the required parameter 'reservation_id' is set
+      if @api_client.config.client_side_validation && reservation_id.nil?
+        fail ArgumentError, "Missing the required parameter 'reservation_id' when calling MenusApi.get_preordered_items1"
+      end
+      # resource path
+      local_var_path = '/v1/reservations/{reservationId}/preorders'.sub('{' + 'reservationId' + '}', reservation_id.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['CUSTOMER_SESSION']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'ReservationMenuData')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: MenusApi#get_preordered_items1\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    # Preorder menu items for a reservation
+    # This endpoint will preorder menu items for a reservation.   The reservation ID in the request is the public ID of the reservation and **not** agent-specific.  This endpoint requires user to be logged in.  The endpoint will return `HTTP 404 - Not Found` if the reservation with the specified id could not be found. It will return `HTTP 403 - Forbidden` if the user is not authenticated or the reservation doesn't belong to the customer associated with the user.  ####Request: * **reservationId**: Public ID of the reservation. Path parameter.  Request body has the same structure as Get Preorder response, except not having the `href` field. * **items**: List of menu items to be preordered. Each menu item will have the fields explained below.   * **menuId**: The Id of the menu that this item belongs to. **Required**.   * **itemId**: The Id of the menu item. **Required**.   * **quantity**: Number of specified items to be preordered. **Required**.   * **guestPublicId**: The ID of the guest for whom this item is being preordered. Optional. Format: UUID.  ####Response: * **items**: The response will be a _list_ of successfully preordered menu items. Each menu item has the fields explained below:   * **menuId**: The Id of the menu that this item belongs to   * **itemId**: The Id of the menu item   * **quantity**: Quantity of this menu item selected for the reservation   * **guestPublicId**: The ID of the guest for whom this item has been preordered, if any.   * **href**: Link that can be followed to get information about the menu and its available items  Example curl: ``` curl -H \"Content Type: application/json\" -X PUT -d ' {   \"items\": [     {       \"menuId\": 1846,       \"itemId\": 1477,       \"quantity\": 1,       \"guestPublicId\": \"a8a66a11-446a-443b-8834-591742825ad4\"     },     {       \"menuId\": 1846,       \"itemId\": 1478,       \"quantity\": 2     }   ] } ' https://{host}/v{X}/reservations/ce0706ff-a95d-4229-a220-d21dcd175342/preorders ```  Example response:  ``` {   \"items\": [     {       \"menuId\": 1846,       \"itemId\": 1477,       \"quantity\": 1,       \"guestPublicId\": \"a8a66a11-446a-443b-8834-591742825ad4\",       \"href\": \"https://{host}/v{X}/reservations/ce0706ff-a95d-4229-a220-d21dcd175342/menus/1846\"     },     {       \"menuId\": 1846,       \"itemId\": 1478,       \"quantity\": 2,       \"href\": \"https://{host}/v{X}/reservations/ce0706ff-a95d-4229-a220-d21dcd175342/menus/1846\"     }   ] } ``` 
+    # @param reservation_id Public Id of the reservation
+    # @param body Menu items for this reservation
+    # @param [Hash] opts the optional parameters
+    # @return [ReservationMenuData]
+    def save_preordered_items1(reservation_id, body, opts = {})
+      data, _status_code, _headers = save_preordered_items1_with_http_info(reservation_id, body, opts)
+      data
+    end
+
+    # Preorder menu items for a reservation
+    # This endpoint will preorder menu items for a reservation.   The reservation ID in the request is the public ID of the reservation and **not** agent-specific.  This endpoint requires user to be logged in.  The endpoint will return &#x60;HTTP 404 - Not Found&#x60; if the reservation with the specified id could not be found. It will return &#x60;HTTP 403 - Forbidden&#x60; if the user is not authenticated or the reservation doesn&#39;t belong to the customer associated with the user.  ####Request: * **reservationId**: Public ID of the reservation. Path parameter.  Request body has the same structure as Get Preorder response, except not having the &#x60;href&#x60; field. * **items**: List of menu items to be preordered. Each menu item will have the fields explained below.   * **menuId**: The Id of the menu that this item belongs to. **Required**.   * **itemId**: The Id of the menu item. **Required**.   * **quantity**: Number of specified items to be preordered. **Required**.   * **guestPublicId**: The ID of the guest for whom this item is being preordered. Optional. Format: UUID.  ####Response: * **items**: The response will be a _list_ of successfully preordered menu items. Each menu item has the fields explained below:   * **menuId**: The Id of the menu that this item belongs to   * **itemId**: The Id of the menu item   * **quantity**: Quantity of this menu item selected for the reservation   * **guestPublicId**: The ID of the guest for whom this item has been preordered, if any.   * **href**: Link that can be followed to get information about the menu and its available items  Example curl: &#x60;&#x60;&#x60; curl -H \&quot;Content Type: application/json\&quot; -X PUT -d &#39; {   \&quot;items\&quot;: [     {       \&quot;menuId\&quot;: 1846,       \&quot;itemId\&quot;: 1477,       \&quot;quantity\&quot;: 1,       \&quot;guestPublicId\&quot;: \&quot;a8a66a11-446a-443b-8834-591742825ad4\&quot;     },     {       \&quot;menuId\&quot;: 1846,       \&quot;itemId\&quot;: 1478,       \&quot;quantity\&quot;: 2     }   ] } &#39; https://{host}/v{X}/reservations/ce0706ff-a95d-4229-a220-d21dcd175342/preorders &#x60;&#x60;&#x60;  Example response:  &#x60;&#x60;&#x60; {   \&quot;items\&quot;: [     {       \&quot;menuId\&quot;: 1846,       \&quot;itemId\&quot;: 1477,       \&quot;quantity\&quot;: 1,       \&quot;guestPublicId\&quot;: \&quot;a8a66a11-446a-443b-8834-591742825ad4\&quot;,       \&quot;href\&quot;: \&quot;https://{host}/v{X}/reservations/ce0706ff-a95d-4229-a220-d21dcd175342/menus/1846\&quot;     },     {       \&quot;menuId\&quot;: 1846,       \&quot;itemId\&quot;: 1478,       \&quot;quantity\&quot;: 2,       \&quot;href\&quot;: \&quot;https://{host}/v{X}/reservations/ce0706ff-a95d-4229-a220-d21dcd175342/menus/1846\&quot;     }   ] } &#x60;&#x60;&#x60; 
+    # @param reservation_id Public Id of the reservation
+    # @param body Menu items for this reservation
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ReservationMenuData, Fixnum, Hash)>] ReservationMenuData data, response status code and response headers
+    def save_preordered_items1_with_http_info(reservation_id, body, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MenusApi.save_preordered_items1 ...'
+      end
+      # verify the required parameter 'reservation_id' is set
+      if @api_client.config.client_side_validation && reservation_id.nil?
+        fail ArgumentError, "Missing the required parameter 'reservation_id' when calling MenusApi.save_preordered_items1"
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling MenusApi.save_preordered_items1"
+      end
+      # resource path
+      local_var_path = '/v1/reservations/{reservationId}/preorders'.sub('{' + 'reservationId' + '}', reservation_id.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = @api_client.object_to_http_body(body)
+      auth_names = ['CUSTOMER_SESSION']
+      data, status_code, headers = @api_client.call_api(:PUT, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'ReservationMenuData')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: MenusApi#save_preordered_items1\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/quandoo/api/merchants_api.rb

@@ -0,0 +1,357 @@
+=begin
+#Quandoo API Documentation
+
+#No description provided (generated by Swagger Codegen https://github.com/swagger-api/swagger-codegen)
+
+OpenAPI spec version: 1.0.0
+
+Generated by: https://github.com/swagger-api/swagger-codegen.git
+Swagger Codegen version: 2.4.5
+
+=end
+
+require 'uri'
+
+module Quandoo
+  class MerchantsApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Get merchant reservations
+    # This endpoint allows an agent to get reservations of a merchant. The results will be filtered by agent id.  Reservation IDs in response are agent-specific. The agent needs to be authenticated.  The endpoint will return `HTTP 404 - Not Found` if the merchant with the specified id could not be found. It will return `HTTP 403 - Forbidden` if the agent is not authenticated or the agent doesn't have permissions.  ####Request: * **merchantId**: ID of the merchant * **offset**: sets the starting element to be returned. Defaults to 0 when unset or malformed. * **limit**: maximum number of results to be returned. Value must be between 1 and 100. Defaults to 100 when unset, malformed or outside bounds. * **earliest**: earliest date time of time window in UTC. Format: yyyy-MM-dd HH:mm:ss * **latest**: latest date time of time window in UTC. Format: yyyy-MM-dd HH:mm:ss   ####Response: The response will be a _list_ of reservations. Each reservation has the fields explained below: * **id**: The public id of the reservation * **number**: Quandoo internal identifier of the reservation. * **quandooId**: The public id of this reservation on quandoo system. * **status**: The status of the reservation eg. CREATED, CONFIRMED, CUSTOMER CANCELED etc. * **startTime**: The start time of the reservation. Format: `yyyy-MM-ddTHH:mm:ssZ` * **endTime**: The end time of the reservation. Format: `yyyy-MM-ddTHH:mm:ssZ` * **capacity**: The capacity (people count) of the reservation * **merchantId**: The ID of the merchant at which this reservation was made. * **customerId**: The public ID of the customer to which this reservation belongs * **promoCode**: The promotion code associated with this reservation. Optional. * **extraInfo**: extra information that the customer provided for the reservation. Optional. * **links**: Related links that can be followed based on this response. * **createdAt**: The date the reservation was created. Format: `yyyy-MM-ddTHH:mm:ssZ` * **updatedAt**: The date the reservation was last updated. Format: `yyyy-MM-ddTHH:mm:ssZ`  Example curl: ``` curl https://{host}/v{X}/merchants/32489/reservations ```  Example response:  ``` {   \"reservations\": [     {       \"id\": \"07f53b36-3f48-11e5-a151-feff819cdc9f\",       \"number\": 8734957,       \"quandooId\": \"07f53b36-3f48-11e5-a151-feff819cdc9f\",       \"status\": \"CREATED\",       \"startTime\": \"2015-06-22T12:00:00+00:00\",       \"endTime\": \"2015-06-22T13:00:00+00:00\",       \"capacity\": 4,       \"merchantId\": 1384,       \"customerId\": \"ce0706ff-a95d-4229-a220-d21dcd175342\",       \"promocode\": \"SOME_CAMPAIGN_CODE\",       \"extraInfo\": \"request for baby chair\",       \"links\": [         {           \"href\": \"https://{host}/v{X}/reservations/07f53b36-3f48-11e5-a151-feff819cdc9f\",           \"method\": \"GET\",           \"rel\": \"self\"         },         {           \"href\": \"https://{host}/v{X}/reservations/07f53b36-3f48-11e5-a151-feff819cdc9f\",           \"method\": \"PATCH\",           \"rel\": \"update\"         }       ],       \"createdAt\": \"2015-06-01T15:21:54Z\",       \"updatedAt\": \"2015-06-01T18:45:30Z\"     },     {       \"id\": \"d8f53b36-3f48-11e5-a151-feff819cdc7a\",       \"number\": 8734958,       \"quandooId\": \"d8f53b36-3f48-11e5-a151-feff819cdc7a\",       \"status\": \"CONFIRMED\",       \"startTime\": \"2015-06-22T12:00:00+00:00\",       \"endTime\": \"2015-06-22T13:00:00+00:00\",       \"capacity\": 3,       \"merchantId\": 1384,       \"customerId\": \"ce0706ff-a95d-4229-a220-d21dcd175342\",       \"promocode\": \"SOME_CAMPAIGN_CODE\",       \"links\": [         {           \"href\": \"https://{host}/v{X}/reservations/d8f53b36-3f48-11e5-a151-feff819cdc7a\",           \"method\": \"GET\",           \"rel\": \"self\"         },         {           \"href\": \"https://{host}/v{X}/reservations/d8f53b36-3f48-11e5-a151-feff819cdc7a\",           \"method\": \"PATCH\",           \"rel\": \"update\"         }       ],       \"createdAt\": \"2015-06-01T15:21:54Z\",       \"updatedAt\": \"2015-06-01T18:45:30Z\"     }   ] } ``` 
+    # @param merchant_id Id of the merchant
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :offset Skip first n reservations (default to 0)
+    # @option opts [Integer] :limit limit (default to 100)
+    # @option opts [DateTime] :earliest earliest date time of time window in UTC. Format: yyyy-MM-dd HH:mm:ss
+    # @option opts [DateTime] :latest latest date time of time window in UTC. Format: yyyy-MM-dd HH:mm:ss
+    # @return [ReservationDataList]
+    def get_reservations2(merchant_id, opts = {})
+      data, _status_code, _headers = get_reservations2_with_http_info(merchant_id, opts)
+      data
+    end
+
+    # Get merchant reservations
+    # This endpoint allows an agent to get reservations of a merchant. The results will be filtered by agent id.  Reservation IDs in response are agent-specific. The agent needs to be authenticated.  The endpoint will return `HTTP 404 - Not Found` if the merchant with the specified id could not be found. It will return `HTTP 403 - Forbidden` if the agent is not authenticated or the agent doesn't have permissions.  ####Request: * **merchantId**: ID of the merchant * **offset**: sets the starting element to be returned. Defaults to 0 when unset or malformed. * **limit**: maximum number of results to be returned. Value must be between 1 and 100. Defaults to 100 when unset, malformed or outside bounds. * **earliest**: earliest date time of time window in UTC. Format: yyyy-MM-dd HH:mm:ss * **latest**: latest date time of time window in UTC. Format: yyyy-MM-dd HH:mm:ss   ####Response: The response will be a _list_ of reservations. Each reservation has the fields explained below: * **id**: The public id of the reservation * **number**: Quandoo internal identifier of the reservation. * **quandooId**: The public id of this reservation on quandoo system. * **status**: The status of the reservation eg. CREATED, CONFIRMED, CUSTOMER CANCELED etc. * **startTime**: The start time of the reservation. Format: `yyyy-MM-ddTHH:mm:ssZ` * **endTime**: The end time of the reservation. Format: `yyyy-MM-ddTHH:mm:ssZ` * **capacity**: The capacity (people count) of the reservation * **merchantId**: The ID of the merchant at which this reservation was made. * **customerId**: The public ID of the customer to which this reservation belongs * **promoCode**: The promotion code associated with this reservation. Optional. * **extraInfo**: extra information that the customer provided for the reservation. Optional. * **links**: Related links that can be followed based on this response. * **createdAt**: The date the reservation was created. Format: `yyyy-MM-ddTHH:mm:ssZ` * **updatedAt**: The date the reservation was last updated. Format: `yyyy-MM-ddTHH:mm:ssZ`  Example curl: ``` curl https://{host}/v{X}/merchants/32489/reservations ```  Example response:  ``` {   \"reservations\": [     {       \"id\": \"07f53b36-3f48-11e5-a151-feff819cdc9f\",       \"number\": 8734957,       \"quandooId\": \"07f53b36-3f48-11e5-a151-feff819cdc9f\",       \"status\": \"CREATED\",       \"startTime\": \"2015-06-22T12:00:00+00:00\",       \"endTime\": \"2015-06-22T13:00:00+00:00\",       \"capacity\": 4,       \"merchantId\": 1384,       \"customerId\": \"ce0706ff-a95d-4229-a220-d21dcd175342\",       \"promocode\": \"SOME_CAMPAIGN_CODE\",       \"extraInfo\": \"request for baby chair\",       \"links\": [         {           \"href\": \"https://{host}/v{X}/reservations/07f53b36-3f48-11e5-a151-feff819cdc9f\",           \"method\": \"GET\",           \"rel\": \"self\"         },         {           \"href\": \"https://{host}/v{X}/reservations/07f53b36-3f48-11e5-a151-feff819cdc9f\",           \"method\": \"PATCH\",           \"rel\": \"update\"         }       ],       \"createdAt\": \"2015-06-01T15:21:54Z\",       \"updatedAt\": \"2015-06-01T18:45:30Z\"     },     {       \"id\": \"d8f53b36-3f48-11e5-a151-feff819cdc7a\",       \"number\": 8734958,       \"quandooId\": \"d8f53b36-3f48-11e5-a151-feff819cdc7a\",       \"status\": \"CONFIRMED\",       \"startTime\": \"2015-06-22T12:00:00+00:00\",       \"endTime\": \"2015-06-22T13:00:00+00:00\",       \"capacity\": 3,       \"merchantId\": 1384,       \"customerId\": \"ce0706ff-a95d-4229-a220-d21dcd175342\",       \"promocode\": \"SOME_CAMPAIGN_CODE\",       \"links\": [         {           \"href\": \"https://{host}/v{X}/reservations/d8f53b36-3f48-11e5-a151-feff819cdc7a\",           \"method\": \"GET\",           \"rel\": \"self\"         },         {           \"href\": \"https://{host}/v{X}/reservations/d8f53b36-3f48-11e5-a151-feff819cdc7a\",           \"method\": \"PATCH\",           \"rel\": \"update\"         }       ],       \"createdAt\": \"2015-06-01T15:21:54Z\",       \"updatedAt\": \"2015-06-01T18:45:30Z\"     }   ] } ``` 
+    # @param merchant_id Id of the merchant
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :offset Skip first n reservations
+    # @option opts [Integer] :limit limit
+    # @option opts [DateTime] :earliest earliest date time of time window in UTC. Format: yyyy-MM-dd HH:mm:ss
+    # @option opts [DateTime] :latest latest date time of time window in UTC. Format: yyyy-MM-dd HH:mm:ss
+    # @return [Array<(ReservationDataList, Fixnum, Hash)>] ReservationDataList data, response status code and response headers
+    def get_reservations2_with_http_info(merchant_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MerchantsApi.get_reservations2 ...'
+      end
+      # verify the required parameter 'merchant_id' is set
+      if @api_client.config.client_side_validation && merchant_id.nil?
+        fail ArgumentError, "Missing the required parameter 'merchant_id' when calling MerchantsApi.get_reservations2"
+      end
+      # resource path
+      local_var_path = '/v1/merchants/{merchantId}/reservations'.sub('{' + 'merchantId' + '}', merchant_id.to_s)
+
+      # query parameters
+      query_params = {}
+      query_params[:'offset'] = opts[:'offset'] if !opts[:'offset'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'earliest'] = opts[:'earliest'] if !opts[:'earliest'].nil?
+      query_params[:'latest'] = opts[:'latest'] if !opts[:'latest'].nil?
+
+      # header parameters
+      header_params = {}
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['API_TOKEN']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'ReservationDataList')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: MerchantsApi#get_reservations2\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    # Retrieves customer reviews for a merchant, specified by reviewId
+    # This endpoint retrieves customer reviews for a particular merchant with rating, description, locale, date & the customer's information.This merchant should be specified by their identifier **merchantId**, which is mandatory.  Supports pagination via offset & limit parameters in the request.  `offset` allows skipping the first n reviews. `limit` makes sure the response contains a maximum of n reviews.  If not supplied, offset will be 0 and limit will be 10  ####Response:  * **customer**: block contains link to customer's profile image, customer's first name & first letter of customer's last name. * **rating**: a value between 1 and 6, where 1 represents the worst rating and 6 represents the best. * **description**: the review description entered by the customer. * **locale**: represents the language settings of the customer, in the format: <language code>_<country code> * **date**: represents the date of the review, with the format: yyyy-MM-dd  Example curl: ``` curl https://{host}/v{X}/merchants/15/reviews?offset=10&limit=5 ```  Example response: ``` {    reviews: [      {            customer: {                 firstName: \"Hans\",                 lastName: \"W\",                 profileImage: {                     url: \"https://www...\"                 },            },            rating: 1,            description: \"Foo bar\",                            locale: \"de_DE\",            date: \"2017-07-21\"      }    ],    offset: 10,    limit: 5,    size: 1 } ```
+    # @param merchant_id 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :offset Skip first n reviews (default to 0)
+    # @option opts [Integer] :limit Max number of reviews to be retrieved (default to 10)
+    # @return [ReviewDtoList]
+    def get_reviews1(merchant_id, opts = {})
+      data, _status_code, _headers = get_reviews1_with_http_info(merchant_id, opts)
+      data
+    end
+
+    # Retrieves customer reviews for a merchant, specified by reviewId
+    # This endpoint retrieves customer reviews for a particular merchant with rating, description, locale, date &amp; the customer&#39;s information.This merchant should be specified by their identifier **merchantId**, which is mandatory.  Supports pagination via offset &amp; limit parameters in the request.  &#x60;offset&#x60; allows skipping the first n reviews. &#x60;limit&#x60; makes sure the response contains a maximum of n reviews.  If not supplied, offset will be 0 and limit will be 10  ####Response:  * **customer**: block contains link to customer&#39;s profile image, customer&#39;s first name &amp; first letter of customer&#39;s last name. * **rating**: a value between 1 and 6, where 1 represents the worst rating and 6 represents the best. * **description**: the review description entered by the customer. * **locale**: represents the language settings of the customer, in the format: &lt;language code&gt;_&lt;country code&gt; * **date**: represents the date of the review, with the format: yyyy-MM-dd  Example curl: &#x60;&#x60;&#x60; curl https://{host}/v{X}/merchants/15/reviews?offset&#x3D;10&amp;limit&#x3D;5 &#x60;&#x60;&#x60;  Example response: &#x60;&#x60;&#x60; {    reviews: [      {            customer: {                 firstName: \&quot;Hans\&quot;,                 lastName: \&quot;W\&quot;,                 profileImage: {                     url: \&quot;https://www...\&quot;                 },            },            rating: 1,            description: \&quot;Foo bar\&quot;,                            locale: \&quot;de_DE\&quot;,            date: \&quot;2017-07-21\&quot;      }    ],    offset: 10,    limit: 5,    size: 1 } &#x60;&#x60;&#x60;
+    # @param merchant_id 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :offset Skip first n reviews
+    # @option opts [Integer] :limit Max number of reviews to be retrieved
+    # @return [Array<(ReviewDtoList, Fixnum, Hash)>] ReviewDtoList data, response status code and response headers
+    def get_reviews1_with_http_info(merchant_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MerchantsApi.get_reviews1 ...'
+      end
+      # verify the required parameter 'merchant_id' is set
+      if @api_client.config.client_side_validation && merchant_id.nil?
+        fail ArgumentError, "Missing the required parameter 'merchant_id' when calling MerchantsApi.get_reviews1"
+      end
+      # resource path
+      local_var_path = '/v1/merchants/{merchantId}/reviews'.sub('{' + 'merchantId' + '}', merchant_id.to_s)
+
+      # query parameters
+      query_params = {}
+      query_params[:'offset'] = opts[:'offset'] if !opts[:'offset'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = []
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'ReviewDtoList')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: MerchantsApi#get_reviews1\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    # Allows to get merchant information by parameters
+    # ###Description  This endpoint is used to search merchants by a set of parameters. For each merchant in the result there is information about location, language and tags that describe this merchant's basic characteristics, there is also a set of images selected by the merchant.  ####Possible query parameters:  * **query**: Filter merchants using text similarity on a number of merchant fields like name, description, categories and tags * **place**: Filter for merchant on a country, city or district whose name matches the parameter. (if the parameter does not match any city or district on the system it is ignored) * **centerPoint**: Filter merchants within the circle defined by center on centerPoint and radius defined by radius parameter (if not informed defaults to 10). Center point has the format LATITUDE,LONGITUDE with both parameters as numbers with . as decimal separator (e.g `centerPoint=52.547928,13.4085728`) * **radius**: The radius of the circle to filter merchants in **kilometers**. Defaults to 10 and is only used if *centerPoint* is also informed * **bookable**: Boolean value, if informed true means that only merchants that are online bookable will be returned and false means that only merchants that are NOT online bookable will be returned * **tags**: Filter out merchants with the selected tags text. Semicolon separated text value. All or nothing field: if a tag is not found, the query will fail. Cannot be used in conjunction with 'tagIds' parameter. * **tagIds**: Filter out merchants with the selected tag ids. Semicolon separated text value. All or nothing field: if a tag is not found, the query will fail. Cannot be used in conjunction with 'tags' parameter. * **reviewScoreMax**: Filter out merchants with review score higher than the one informed. * **onlyWithAttributes**: This field only accepts the value **documents** for now. If informed only merchants with documents will be returned. You need to be **authenticated** to use this filter * **capacity**: Number of people. In order to be effective, \"place\", \"date\" and \"fromTime\" must also be set. * **date**: Date of the desired reservation in merchants' time zone. Format: yyyy-MM-dd. Availability search is only activated if \"place\" is specified. * **fromTime**: Beginning of the desired reservation time frame in merchants' time zone. Format: HH:mm. Consider a 3h buffer for the time (0.5h before the given time and 2.5h after) * **offset**: Number of merchants to skip on the result. Defaults to 0 * **limit**: Maximum number of merchants to return. Defaults to 100 and cannot be more than 100. * **bookable**: This flag indicates whether the merchant is bookable or not.    ####Result fields for Merchant object:  * **id**: Id of the merchant * **name**: Name of the merchant * **phoneNumber**: The phone number of the merchant * **currency**: Currency of the merchant in the ISO 4217 letter format * **locale**: Locale used to communicate with this merchant * **timezone**: Canonical Timezone name * **location**: Location of the merchant, contains both an geo located point and an address if available * **reviewScore**: Review score of the merchant * **tagGroups**: Tags (grouped) about relevant merchant characteristics * **images**: Group of images selected by the merchant * **documents**: Group of documents released by this merchant (e.g seasonal menus ) * **links**: Links for other pages or api operations for this merchant * **openingTimes**: Group of opening times: restaurant opening times for this merchant. Time range beginning may be greater than the end time of the range, when this range goes beyond the day when it was started, e.g. 19:00:00 - 02:00:00 * **ccvEnabled**: If true, credit card information is required when creating a reservation * **chain**: Merchant chain information, if any   ###Authenticated use of the api: * Field `documents` is only accessible for authorized callers and will be empty otherwise. * Queries with parameter `onlyWithAttributes` are only allowed for authorized callers and will return `HTTP 403` for unauthorized requests  #####How? In order to make an authenticated call the caller must send a header name `X-Quandoo-AuthToken` with the token obtained from contact with Quandoo.  ###Pagination of the result:  The result contains the fields `size` with the number of all merchants that matched the informed parameters, `offset` and `limit` defining which merchants from the complete list are on this response, and the caller can use query parameters `offset` and `limit` to get different merchants on the result list  ###Examples:  Example curl: ``` curl -H 'X-Quandoo-AuthToken: INSERT_KEY_HERE' 'https://{host}/v{X}/merchants?query=Zim&place=Berlin&amp;centerPoint=52.5479288%2C13.4085728&radius=10&bookable=true&reviewScoreMax=200&onlyWithAttributes=documents&offset=0&limit=100' ```  Example response: ``` {   \"merchants\": [     {       \"id\": 215,       \"name\": \"a-merchant-Zim\",       \"phoneNumber\": \"+49153153153\",       \"currency\": \"EUR\",       \"locale\": \"de_DE\",       \"timezone\": \"Europe/Berlin\",       \"location\": {         \"coordinates\": {           \"latitude\": 55,           \"longitude\": 12         },         \"address\": {}       },       \"reviewScore\": \"5.3\",       \"tagGroups\": [         {           \"type\": \"CUISINE\",           \"tags\": [             {               \"id\": 63,               \"name\": \"Testküche Hauptkategorie\"             },             {               \"id\": 66,               \"name\": \"Test cuisine\"             }           ]         }       ],       \"images\": [],       \"documents\": [         {           \"name\": \"Main Menu\",           \"url\": \"https://d2s6u6f7snurg9.cloudfront.net/partner/uploads/MD-document-3ec1dc15-1b69-463f-bdd2-c060b9bf844d.pdf\",           \"format\": \"pdf\",           \"description\": \"Seasonal Main Menu\"         }       ],       \"links\": [         {           \"href\": \"https://{host}/{path}?aid=16\",           \"method\": \"GET\",           \"rel\": \"DETAILS\"         },         {           \"href\": \"https://{host}/{path}?aid=16&countryId=NLD\",           \"method\": \"GET\",           \"rel\": \"WIDGET\"         },         {           \"href\": \"https://{host}/{path}/details?aid=16&countryId=NLD\",           \"method\": \"GET\",           \"rel\": \"WIDGET_DETAILS\"         }       ],       \"bookable\": true,       \"ccvEnabled\": true,       \"chain\": {         \"id\": 1,         \"name\": \"Test chain\"       }     },     {       \"id\": 219,       \"name\": \"another merchants Zim\",       \"phoneNumber\": \"+49154154154\",       \"currency\": \"EUR\",       \"locale\": \"de_DE\",       \"timezone\": \"Europe/Berlin\",       \"location\": {         \"coordinates\": {           \"latitude\": 52,           \"longitude\": 13         },         \"address\": {           \"street\": \"Wintersteinstr.\",           \"number\": \"15\",           \"zipcode\": \"10587\",           \"city\": \"Berlin\",           \"country\": \"DEU\"         }       },       \"reviewScore\": \"4.7\",             \"tagGroups\": [         {           \"type\": \"CUISINE\",           \"tags\": [             {               \"id\": 79,               \"name\": \"Testküche Hauptkategorie\"             },             {               \"id\": 82,               \"name\": \"Test Japanese\"             }           ]         },         {           \"type\": \"PRICE\",           \"tags\": [             {               \"id\": 84,               \"name\": \"Test expensive\"             }           ]         }       ],       \"images\": [         {           \"url\": \"https://dci5ez2ey8tr9.cloudfront.net/1482eec7-e585-4821-b096-8a9941e0d2eb/25_sld.jpg\"         }       ],       \"documents\": [],       \"links\": [         {           \"href\": \"https://{host}/{path}?aid=16\",           \"method\": \"GET\",           \"rel\": \"DETAILS\"         },         {           \"href\": \"https://{host}/{path}?aid=16&countryId=NLD\",           \"method\": \"GET\",           \"rel\": \"WIDGET\"         },         {           \"href\": \"https://{host}/{path}/details?aid=16&countryId=NLD\",           \"method\": \"GET\",           \"rel\": \"WIDGET_DETAILS\"         }       ],       \"bookable\": true,       \"openingTimes\": {         \"standardOpeningTimes\": {           \"SATURDAY\": [             {               \"start\": \"09:00:00\",               \"end\": \"20:00:00\"             }           ],           \"SUNDAY\": [             {               \"start\": \"09:00:00\",               \"end\": \"18:00:00\"             }           ]         }       },       \"ccvEnabled\": true,       \"chain\": {         \"id\": 1,         \"name\": \"Test chain\"       }     }   ],   \"size\": 2,   \"offset\": 0,   \"limit\": 100 } ```
+    # @param capacity Number of people. In order to be effective, \&quot;date\&quot; and \&quot;fromTime\&quot; must also be set.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :query Search query for a merchant name
+    # @option opts [String] :place Search query for a place (country, city or district) name: the most relevant places, if any, are taken as a filter
+    # @option opts [String] :center_point Search with coordinates and radius. \&quot;radius\&quot; argument can be set, otherwise default value of 10 km will be used.&lt;br&gt;Format:&lt;br&gt;53.1222,13.0303&lt;br&gt;where latitude&#x3D;53.1222, longitude&#x3D;13.0303
+    # @option opts [Integer] :radius Radius for coordinate-based search (default to 10)
+    # @option opts [BOOLEAN] :bookable Filter only bookable merchants
+    # @option opts [String] :tags Filter by tags found by text. The value can be either in English or in the specific locale. Semicolon separated. All or nothing behaviour: if one single tag is not found, the whole request fails. Cannot be used in combination with &#39;groupedTagIds&#39; parameter.
+    # @option opts [String] :tag_ids Filter by tags found by id. Semicolon separated. All or nothing behaviour: if one single tag id is not found, the whole request fails. Cannot be used in combination with &#39;tags&#39; parameter.
+    # @option opts [Integer] :review_score_max Filter by max review score (100 - 600)
+    # @option opts [String] :only_with_attributes Search with attributes specified only. Attribute \&quot;documents\&quot; is currently supported
+    # @option opts [Date] :date Date of the desired reservation in merchants&#39; time zone. Format: yyyy-MM-dd. Availability search is only activated if \&quot;place\&quot; is specified.
+    # @option opts [String] :from_time Beginning of the desired reservation time frame in merchants&#39; time zone. Format: HH:mm. Consider a 3h buffer for the time (0.5h before the given time and 2.5h after)
+    # @option opts [Integer] :offset offset (default to 0)
+    # @option opts [Integer] :limit limit (default to 100)
+    # @option opts [String] :accept_language language
+    # @return [MerchantDetailsDtoList]
+    def search(capacity, opts = {})
+      data, _status_code, _headers = search_with_http_info(capacity, opts)
+      data
+    end
+
+    # Allows to get merchant information by parameters
+    # ###Description  This endpoint is used to search merchants by a set of parameters. For each merchant in the result there is information about location, language and tags that describe this merchant&#39;s basic characteristics, there is also a set of images selected by the merchant.  ####Possible query parameters:  * **query**: Filter merchants using text similarity on a number of merchant fields like name, description, categories and tags * **place**: Filter for merchant on a country, city or district whose name matches the parameter. (if the parameter does not match any city or district on the system it is ignored) * **centerPoint**: Filter merchants within the circle defined by center on centerPoint and radius defined by radius parameter (if not informed defaults to 10). Center point has the format LATITUDE,LONGITUDE with both parameters as numbers with . as decimal separator (e.g &#x60;centerPoint&#x3D;52.547928,13.4085728&#x60;) * **radius**: The radius of the circle to filter merchants in **kilometers**. Defaults to 10 and is only used if *centerPoint* is also informed * **bookable**: Boolean value, if informed true means that only merchants that are online bookable will be returned and false means that only merchants that are NOT online bookable will be returned * **tags**: Filter out merchants with the selected tags text. Semicolon separated text value. All or nothing field: if a tag is not found, the query will fail. Cannot be used in conjunction with &#39;tagIds&#39; parameter. * **tagIds**: Filter out merchants with the selected tag ids. Semicolon separated text value. All or nothing field: if a tag is not found, the query will fail. Cannot be used in conjunction with &#39;tags&#39; parameter. * **reviewScoreMax**: Filter out merchants with review score higher than the one informed. * **onlyWithAttributes**: This field only accepts the value **documents** for now. If informed only merchants with documents will be returned. You need to be **authenticated** to use this filter * **capacity**: Number of people. In order to be effective, \&quot;place\&quot;, \&quot;date\&quot; and \&quot;fromTime\&quot; must also be set. * **date**: Date of the desired reservation in merchants&#39; time zone. Format: yyyy-MM-dd. Availability search is only activated if \&quot;place\&quot; is specified. * **fromTime**: Beginning of the desired reservation time frame in merchants&#39; time zone. Format: HH:mm. Consider a 3h buffer for the time (0.5h before the given time and 2.5h after) * **offset**: Number of merchants to skip on the result. Defaults to 0 * **limit**: Maximum number of merchants to return. Defaults to 100 and cannot be more than 100. * **bookable**: This flag indicates whether the merchant is bookable or not.    ####Result fields for Merchant object:  * **id**: Id of the merchant * **name**: Name of the merchant * **phoneNumber**: The phone number of the merchant * **currency**: Currency of the merchant in the ISO 4217 letter format * **locale**: Locale used to communicate with this merchant * **timezone**: Canonical Timezone name * **location**: Location of the merchant, contains both an geo located point and an address if available * **reviewScore**: Review score of the merchant * **tagGroups**: Tags (grouped) about relevant merchant characteristics * **images**: Group of images selected by the merchant * **documents**: Group of documents released by this merchant (e.g seasonal menus ) * **links**: Links for other pages or api operations for this merchant * **openingTimes**: Group of opening times: restaurant opening times for this merchant. Time range beginning may be greater than the end time of the range, when this range goes beyond the day when it was started, e.g. 19:00:00 - 02:00:00 * **ccvEnabled**: If true, credit card information is required when creating a reservation * **chain**: Merchant chain information, if any   ###Authenticated use of the api: * Field &#x60;documents&#x60; is only accessible for authorized callers and will be empty otherwise. * Queries with parameter &#x60;onlyWithAttributes&#x60; are only allowed for authorized callers and will return &#x60;HTTP 403&#x60; for unauthorized requests  #####How? In order to make an authenticated call the caller must send a header name &#x60;X-Quandoo-AuthToken&#x60; with the token obtained from contact with Quandoo.  ###Pagination of the result:  The result contains the fields &#x60;size&#x60; with the number of all merchants that matched the informed parameters, &#x60;offset&#x60; and &#x60;limit&#x60; defining which merchants from the complete list are on this response, and the caller can use query parameters &#x60;offset&#x60; and &#x60;limit&#x60; to get different merchants on the result list  ###Examples:  Example curl: &#x60;&#x60;&#x60; curl -H &#39;X-Quandoo-AuthToken: INSERT_KEY_HERE&#39; &#39;https://{host}/v{X}/merchants?query&#x3D;Zim&amp;place&#x3D;Berlin&amp;amp;centerPoint&#x3D;52.5479288%2C13.4085728&amp;radius&#x3D;10&amp;bookable&#x3D;true&amp;reviewScoreMax&#x3D;200&amp;onlyWithAttributes&#x3D;documents&amp;offset&#x3D;0&amp;limit&#x3D;100&#39; &#x60;&#x60;&#x60;  Example response: &#x60;&#x60;&#x60; {   \&quot;merchants\&quot;: [     {       \&quot;id\&quot;: 215,       \&quot;name\&quot;: \&quot;a-merchant-Zim\&quot;,       \&quot;phoneNumber\&quot;: \&quot;+49153153153\&quot;,       \&quot;currency\&quot;: \&quot;EUR\&quot;,       \&quot;locale\&quot;: \&quot;de_DE\&quot;,       \&quot;timezone\&quot;: \&quot;Europe/Berlin\&quot;,       \&quot;location\&quot;: {         \&quot;coordinates\&quot;: {           \&quot;latitude\&quot;: 55,           \&quot;longitude\&quot;: 12         },         \&quot;address\&quot;: {}       },       \&quot;reviewScore\&quot;: \&quot;5.3\&quot;,       \&quot;tagGroups\&quot;: [         {           \&quot;type\&quot;: \&quot;CUISINE\&quot;,           \&quot;tags\&quot;: [             {               \&quot;id\&quot;: 63,               \&quot;name\&quot;: \&quot;Testküche Hauptkategorie\&quot;             },             {               \&quot;id\&quot;: 66,               \&quot;name\&quot;: \&quot;Test cuisine\&quot;             }           ]         }       ],       \&quot;images\&quot;: [],       \&quot;documents\&quot;: [         {           \&quot;name\&quot;: \&quot;Main Menu\&quot;,           \&quot;url\&quot;: \&quot;https://d2s6u6f7snurg9.cloudfront.net/partner/uploads/MD-document-3ec1dc15-1b69-463f-bdd2-c060b9bf844d.pdf\&quot;,           \&quot;format\&quot;: \&quot;pdf\&quot;,           \&quot;description\&quot;: \&quot;Seasonal Main Menu\&quot;         }       ],       \&quot;links\&quot;: [         {           \&quot;href\&quot;: \&quot;https://{host}/{path}?aid&#x3D;16\&quot;,           \&quot;method\&quot;: \&quot;GET\&quot;,           \&quot;rel\&quot;: \&quot;DETAILS\&quot;         },         {           \&quot;href\&quot;: \&quot;https://{host}/{path}?aid&#x3D;16&amp;countryId&#x3D;NLD\&quot;,           \&quot;method\&quot;: \&quot;GET\&quot;,           \&quot;rel\&quot;: \&quot;WIDGET\&quot;         },         {           \&quot;href\&quot;: \&quot;https://{host}/{path}/details?aid&#x3D;16&amp;countryId&#x3D;NLD\&quot;,           \&quot;method\&quot;: \&quot;GET\&quot;,           \&quot;rel\&quot;: \&quot;WIDGET_DETAILS\&quot;         }       ],       \&quot;bookable\&quot;: true,       \&quot;ccvEnabled\&quot;: true,       \&quot;chain\&quot;: {         \&quot;id\&quot;: 1,         \&quot;name\&quot;: \&quot;Test chain\&quot;       }     },     {       \&quot;id\&quot;: 219,       \&quot;name\&quot;: \&quot;another merchants Zim\&quot;,       \&quot;phoneNumber\&quot;: \&quot;+49154154154\&quot;,       \&quot;currency\&quot;: \&quot;EUR\&quot;,       \&quot;locale\&quot;: \&quot;de_DE\&quot;,       \&quot;timezone\&quot;: \&quot;Europe/Berlin\&quot;,       \&quot;location\&quot;: {         \&quot;coordinates\&quot;: {           \&quot;latitude\&quot;: 52,           \&quot;longitude\&quot;: 13         },         \&quot;address\&quot;: {           \&quot;street\&quot;: \&quot;Wintersteinstr.\&quot;,           \&quot;number\&quot;: \&quot;15\&quot;,           \&quot;zipcode\&quot;: \&quot;10587\&quot;,           \&quot;city\&quot;: \&quot;Berlin\&quot;,           \&quot;country\&quot;: \&quot;DEU\&quot;         }       },       \&quot;reviewScore\&quot;: \&quot;4.7\&quot;,             \&quot;tagGroups\&quot;: [         {           \&quot;type\&quot;: \&quot;CUISINE\&quot;,           \&quot;tags\&quot;: [             {               \&quot;id\&quot;: 79,               \&quot;name\&quot;: \&quot;Testküche Hauptkategorie\&quot;             },             {               \&quot;id\&quot;: 82,               \&quot;name\&quot;: \&quot;Test Japanese\&quot;             }           ]         },         {           \&quot;type\&quot;: \&quot;PRICE\&quot;,           \&quot;tags\&quot;: [             {               \&quot;id\&quot;: 84,               \&quot;name\&quot;: \&quot;Test expensive\&quot;             }           ]         }       ],       \&quot;images\&quot;: [         {           \&quot;url\&quot;: \&quot;https://dci5ez2ey8tr9.cloudfront.net/1482eec7-e585-4821-b096-8a9941e0d2eb/25_sld.jpg\&quot;         }       ],       \&quot;documents\&quot;: [],       \&quot;links\&quot;: [         {           \&quot;href\&quot;: \&quot;https://{host}/{path}?aid&#x3D;16\&quot;,           \&quot;method\&quot;: \&quot;GET\&quot;,           \&quot;rel\&quot;: \&quot;DETAILS\&quot;         },         {           \&quot;href\&quot;: \&quot;https://{host}/{path}?aid&#x3D;16&amp;countryId&#x3D;NLD\&quot;,           \&quot;method\&quot;: \&quot;GET\&quot;,           \&quot;rel\&quot;: \&quot;WIDGET\&quot;         },         {           \&quot;href\&quot;: \&quot;https://{host}/{path}/details?aid&#x3D;16&amp;countryId&#x3D;NLD\&quot;,           \&quot;method\&quot;: \&quot;GET\&quot;,           \&quot;rel\&quot;: \&quot;WIDGET_DETAILS\&quot;         }       ],       \&quot;bookable\&quot;: true,       \&quot;openingTimes\&quot;: {         \&quot;standardOpeningTimes\&quot;: {           \&quot;SATURDAY\&quot;: [             {               \&quot;start\&quot;: \&quot;09:00:00\&quot;,               \&quot;end\&quot;: \&quot;20:00:00\&quot;             }           ],           \&quot;SUNDAY\&quot;: [             {               \&quot;start\&quot;: \&quot;09:00:00\&quot;,               \&quot;end\&quot;: \&quot;18:00:00\&quot;             }           ]         }       },       \&quot;ccvEnabled\&quot;: true,       \&quot;chain\&quot;: {         \&quot;id\&quot;: 1,         \&quot;name\&quot;: \&quot;Test chain\&quot;       }     }   ],   \&quot;size\&quot;: 2,   \&quot;offset\&quot;: 0,   \&quot;limit\&quot;: 100 } &#x60;&#x60;&#x60;
+    # @param capacity Number of people. In order to be effective, \&quot;date\&quot; and \&quot;fromTime\&quot; must also be set.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :query Search query for a merchant name
+    # @option opts [String] :place Search query for a place (country, city or district) name: the most relevant places, if any, are taken as a filter
+    # @option opts [String] :center_point Search with coordinates and radius. \&quot;radius\&quot; argument can be set, otherwise default value of 10 km will be used.&lt;br&gt;Format:&lt;br&gt;53.1222,13.0303&lt;br&gt;where latitude&#x3D;53.1222, longitude&#x3D;13.0303
+    # @option opts [Integer] :radius Radius for coordinate-based search
+    # @option opts [BOOLEAN] :bookable Filter only bookable merchants
+    # @option opts [String] :tags Filter by tags found by text. The value can be either in English or in the specific locale. Semicolon separated. All or nothing behaviour: if one single tag is not found, the whole request fails. Cannot be used in combination with &#39;groupedTagIds&#39; parameter.
+    # @option opts [String] :tag_ids Filter by tags found by id. Semicolon separated. All or nothing behaviour: if one single tag id is not found, the whole request fails. Cannot be used in combination with &#39;tags&#39; parameter.
+    # @option opts [Integer] :review_score_max Filter by max review score (100 - 600)
+    # @option opts [String] :only_with_attributes Search with attributes specified only. Attribute \&quot;documents\&quot; is currently supported
+    # @option opts [Date] :date Date of the desired reservation in merchants&#39; time zone. Format: yyyy-MM-dd. Availability search is only activated if \&quot;place\&quot; is specified.
+    # @option opts [String] :from_time Beginning of the desired reservation time frame in merchants&#39; time zone. Format: HH:mm. Consider a 3h buffer for the time (0.5h before the given time and 2.5h after)
+    # @option opts [Integer] :offset offset
+    # @option opts [Integer] :limit limit
+    # @option opts [String] :accept_language language
+    # @return [Array<(MerchantDetailsDtoList, Fixnum, Hash)>] MerchantDetailsDtoList data, response status code and response headers
+    def search_with_http_info(capacity, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MerchantsApi.search ...'
+      end
+      # verify the required parameter 'capacity' is set
+      if @api_client.config.client_side_validation && capacity.nil?
+        fail ArgumentError, "Missing the required parameter 'capacity' when calling MerchantsApi.search"
+      end
+      # resource path
+      local_var_path = '/v1/merchants'
+
+      # query parameters
+      query_params = {}
+      query_params[:'capacity'] = capacity
+      query_params[:'query'] = opts[:'query'] if !opts[:'query'].nil?
+      query_params[:'place'] = opts[:'place'] if !opts[:'place'].nil?
+      query_params[:'centerPoint'] = opts[:'center_point'] if !opts[:'center_point'].nil?
+      query_params[:'radius'] = opts[:'radius'] if !opts[:'radius'].nil?
+      query_params[:'bookable'] = opts[:'bookable'] if !opts[:'bookable'].nil?
+      query_params[:'tags'] = opts[:'tags'] if !opts[:'tags'].nil?
+      query_params[:'tagIds'] = opts[:'tag_ids'] if !opts[:'tag_ids'].nil?
+      query_params[:'reviewScoreMax'] = opts[:'review_score_max'] if !opts[:'review_score_max'].nil?
+      query_params[:'onlyWithAttributes'] = opts[:'only_with_attributes'] if !opts[:'only_with_attributes'].nil?
+      query_params[:'date'] = opts[:'date'] if !opts[:'date'].nil?
+      query_params[:'fromTime'] = opts[:'from_time'] if !opts[:'from_time'].nil?
+      query_params[:'offset'] = opts[:'offset'] if !opts[:'offset'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params[:'Accept-Language'] = opts[:'accept_language'] if !opts[:'accept_language'].nil?
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['API_TOKEN']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'MerchantDetailsDtoList')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: MerchantsApi#search\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    # Allows to get a merchant by id
+    # This endpoint allows to receive detailed information on a particular merchant in the system. This merchant should be specified by their identifier **merchantId**, which is mandatory. The endpoint can take optional request header **Accept-Language**. This header is used to determine correct locale and has an effect on translation of merchant's entity fields, that may be omitted.  The expected value of the header **Accept-Language** should contain language and can contain country, e.g. \"de_DE\" or \"de\". Locale by default is \"en_GB\".  The endpoint returns status `HTTP 200` if the request is successful. The endpoint will return status `HTTP 404` if the merchant, specified by identifier, was not found or has no products, allowed for a web search.   Example curl: ``` curl  -H 'X-Quandoo-AuthToken: {INSERT_KEY_HERE}' -H 'Accept-Language: de_DE' 'https://{host}/v{X}/merchants/11' ```  Example response: ``` {     \"id\":11,     \"name\":\"Test merchant\",     \"phoneNumber\":\"+27113901837\",     \"currency\":\"ZAR\",     \"locale\":\"en_ZA\",     \"timezone\":\"Africa/Johannesburg\",     \"location\":{         \"coordinates\":{             \"latitude\":33.9,             \"longitude\":18.4         },         \"address\":{             \"street\":\"Tamerlan street\",             \"number\":\"6A\",             \"zipcode\":\"10787\",             \"city\":\"Cape Town\",             \"country\":\"ZAF\"         }     },     \"reviewScore\": \"5.3\",     \"tagGroups\":[         {             \"type\":\"CUISINE\",             \"tags\":[                 {                     \"id\":25,                     \"name\":\"Testküche Hauptkategorie\"                 },                 {                     \"id\":28,                     \"name\":\"Test cuisine\"                 }             ]         }     ],     \"images\":[         {             \"url\":\"https://dci5ez2ey8tr9.cloudfront.net/8e4d1063-9171-40b1-94b7-5e9337591a90/7_sld.jpg\"         }     ],     \"documents\":[],     \"links\":[         {             \"href\":\"https://{host}/{path}?aid=16\",             \"method\":\"GET\",             \"rel\":\"DETAILS\"         },         {             \"href\":\"https://{host}/{path}?aid=16&countryId=NLD\",             \"method\":\"GET\",             \"rel\":\"WIDGET\"         },         {             \"href\":\"https://{host}/{path}/details?aid=16&countryId=NLD\",             \"method\":\"GET\",             \"rel\":\"WIDGET_DETAILS\"         }     ],     \"bookable\": true,     \"openingTimes\": {       \"standardOpeningTimes\": {         \"SATURDAY\": [           {             \"start\": \"09:00:00\",             \"end\": \"20:00:00\"           }         ],         \"SUNDAY\": [           {             \"start\": \"09:00:00\",             \"end\": \"18:00:00\"           }         ]       }     },     \"ccvEnabled\": true,     \"chain\": {        \"id\": 1,        \"name\": \"Test chain\"     } } ```
+    # @param merchant_id merchantId
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :accept_language Locale.&lt;br&gt;Format:&lt;br&gt;&amp;lt;language code&amp;gt;[_&amp;lt;country code&amp;gt;] (default to en_GB)
+    # @return [MerchantDetailsDto]
+    def search2(merchant_id, opts = {})
+      data, _status_code, _headers = search2_with_http_info(merchant_id, opts)
+      data
+    end
+
+    # Allows to get a merchant by id
+    # This endpoint allows to receive detailed information on a particular merchant in the system. This merchant should be specified by their identifier **merchantId**, which is mandatory. The endpoint can take optional request header **Accept-Language**. This header is used to determine correct locale and has an effect on translation of merchant&#39;s entity fields, that may be omitted.  The expected value of the header **Accept-Language** should contain language and can contain country, e.g. \&quot;de_DE\&quot; or \&quot;de\&quot;. Locale by default is \&quot;en_GB\&quot;.  The endpoint returns status &#x60;HTTP 200&#x60; if the request is successful. The endpoint will return status &#x60;HTTP 404&#x60; if the merchant, specified by identifier, was not found or has no products, allowed for a web search.   Example curl: &#x60;&#x60;&#x60; curl  -H &#39;X-Quandoo-AuthToken: {INSERT_KEY_HERE}&#39; -H &#39;Accept-Language: de_DE&#39; &#39;https://{host}/v{X}/merchants/11&#39; &#x60;&#x60;&#x60;  Example response: &#x60;&#x60;&#x60; {     \&quot;id\&quot;:11,     \&quot;name\&quot;:\&quot;Test merchant\&quot;,     \&quot;phoneNumber\&quot;:\&quot;+27113901837\&quot;,     \&quot;currency\&quot;:\&quot;ZAR\&quot;,     \&quot;locale\&quot;:\&quot;en_ZA\&quot;,     \&quot;timezone\&quot;:\&quot;Africa/Johannesburg\&quot;,     \&quot;location\&quot;:{         \&quot;coordinates\&quot;:{             \&quot;latitude\&quot;:33.9,             \&quot;longitude\&quot;:18.4         },         \&quot;address\&quot;:{             \&quot;street\&quot;:\&quot;Tamerlan street\&quot;,             \&quot;number\&quot;:\&quot;6A\&quot;,             \&quot;zipcode\&quot;:\&quot;10787\&quot;,             \&quot;city\&quot;:\&quot;Cape Town\&quot;,             \&quot;country\&quot;:\&quot;ZAF\&quot;         }     },     \&quot;reviewScore\&quot;: \&quot;5.3\&quot;,     \&quot;tagGroups\&quot;:[         {             \&quot;type\&quot;:\&quot;CUISINE\&quot;,             \&quot;tags\&quot;:[                 {                     \&quot;id\&quot;:25,                     \&quot;name\&quot;:\&quot;Testküche Hauptkategorie\&quot;                 },                 {                     \&quot;id\&quot;:28,                     \&quot;name\&quot;:\&quot;Test cuisine\&quot;                 }             ]         }     ],     \&quot;images\&quot;:[         {             \&quot;url\&quot;:\&quot;https://dci5ez2ey8tr9.cloudfront.net/8e4d1063-9171-40b1-94b7-5e9337591a90/7_sld.jpg\&quot;         }     ],     \&quot;documents\&quot;:[],     \&quot;links\&quot;:[         {             \&quot;href\&quot;:\&quot;https://{host}/{path}?aid&#x3D;16\&quot;,             \&quot;method\&quot;:\&quot;GET\&quot;,             \&quot;rel\&quot;:\&quot;DETAILS\&quot;         },         {             \&quot;href\&quot;:\&quot;https://{host}/{path}?aid&#x3D;16&amp;countryId&#x3D;NLD\&quot;,             \&quot;method\&quot;:\&quot;GET\&quot;,             \&quot;rel\&quot;:\&quot;WIDGET\&quot;         },         {             \&quot;href\&quot;:\&quot;https://{host}/{path}/details?aid&#x3D;16&amp;countryId&#x3D;NLD\&quot;,             \&quot;method\&quot;:\&quot;GET\&quot;,             \&quot;rel\&quot;:\&quot;WIDGET_DETAILS\&quot;         }     ],     \&quot;bookable\&quot;: true,     \&quot;openingTimes\&quot;: {       \&quot;standardOpeningTimes\&quot;: {         \&quot;SATURDAY\&quot;: [           {             \&quot;start\&quot;: \&quot;09:00:00\&quot;,             \&quot;end\&quot;: \&quot;20:00:00\&quot;           }         ],         \&quot;SUNDAY\&quot;: [           {             \&quot;start\&quot;: \&quot;09:00:00\&quot;,             \&quot;end\&quot;: \&quot;18:00:00\&quot;           }         ]       }     },     \&quot;ccvEnabled\&quot;: true,     \&quot;chain\&quot;: {        \&quot;id\&quot;: 1,        \&quot;name\&quot;: \&quot;Test chain\&quot;     } } &#x60;&#x60;&#x60;
+    # @param merchant_id merchantId
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :accept_language Locale.&lt;br&gt;Format:&lt;br&gt;&amp;lt;language code&amp;gt;[_&amp;lt;country code&amp;gt;]
+    # @return [Array<(MerchantDetailsDto, Fixnum, Hash)>] MerchantDetailsDto data, response status code and response headers
+    def search2_with_http_info(merchant_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MerchantsApi.search2 ...'
+      end
+      # verify the required parameter 'merchant_id' is set
+      if @api_client.config.client_side_validation && merchant_id.nil?
+        fail ArgumentError, "Missing the required parameter 'merchant_id' when calling MerchantsApi.search2"
+      end
+      # resource path
+      local_var_path = '/v1/merchants/{merchantId}'.sub('{' + 'merchantId' + '}', merchant_id.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params[:'Accept-Language'] = opts[:'accept_language'] if !opts[:'accept_language'].nil?
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['API_TOKEN']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'MerchantDetailsDto')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: MerchantsApi#search2\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    # Allows to get a merchant by id and find similar merchants
+    # This endpoint allows to receive detailed information for a particular merchant in the system and for restaurants that are similar to this one. A merchant is similar if all the following conditions are met: 1. Location: the recommended merchants are within 30 km radius from the main merchant 2. The similar merchants are bookable online 3. The similar merchants have the main cuisine in common  This merchant should be specified by their identifier **merchantId**, which is mandatory. The endpoint can take optional request header **Accept-Language**. This header is used to determine correct locale and has an effect on translation of merchant's entity fields, that may be omitted.  The expected value of the header **Accept-Language** should contain language and can contain country, e.g. \"de_DE\" or \"de\". Locale by default is \"en_GB\".  The endpoint returns status `HTTP 200` if the request is successful. In a successful requests the specified merchant was found.  If the merchant has no products allowed for a web search, i.e. is not bookable, response data with `HTTP 200` is returned, but the field `merchant` is not set. Instead, the merchant search message is set.  The endpoint will return status `HTTP 404` if the merchant, specified by identifier, was not found.  Example curl: ``` curl  -H 'X-Quandoo-AuthToken: {INSERT_KEY_HERE}' -H 'Accept-Language: de_DE' 'https://{host}/v{X}/merchants/11/similar' ```  Example responses: `merchant bookable` ``` {     \"merchant\": {         \"id\":11,         \"name\":\"Test merchant\",         \"phoneNumber\":\"+27113901837\",         \"currency\":\"ZAR\",         \"locale\":\"en_ZA\",         \"timezone\":\"Africa/Johannesburg\",         \"location\":{             \"coordinates\":{                 \"latitude\":33.9,                 \"longitude\":18.4             },             \"address\":{                 \"street\":\"Tamerlan street\",                 \"number\":\"6A\",                 \"zipcode\":\"10787\",                 \"city\":\"Cape Town\",                 \"country\":\"ZAF\"             }         },         \"reviewScore\": \"5.3\",         \"tagGroups\":[             {                 \"type\":\"CUISINE\",                 \"tags\":[                     {                         \"id\":25,                         \"name\":\"Testküche Hauptkategorie\"                     },                     {                         \"id\":28,                         \"name\":\"Test cuisine\"                     }                 ]             }         ],         \"images\":[             {                 \"url\":\"https://dci5ez2ey8tr9.cloudfront.net/8e4d1063-9171-40b1-94b7-5e9337591a90/7_sld.jpg\"             }         ],         \"documents\":[],         \"links\":[             {                 \"href\":\"https://{host}/{path}?aid=16\",                 \"method\":\"GET\",                 \"rel\":\"DETAILS\"             },             {                 \"href\":\"https://{host}/{path}?aid=16&countryId=NLD\",                 \"method\":\"GET\",                 \"rel\":\"WIDGET\"             },             {                 \"href\":\"https://{host}/{path}/details?aid=16&countryId=NLD\",                 \"method\":\"GET\",                 \"rel\":\"WIDGET_DETAILS\"             }         ],         \"bookable\": true,         \"openingTimes\": {           \"standardOpeningTimes\": {             \"SATURDAY\": [               {                 \"start\": \"09:00:00\",                 \"end\": \"20:00:00\"               }             ],             \"SUNDAY\": [               {                 \"start\": \"09:00:00\",                 \"end\": \"18:00:00\"               }             ]           }         },         \"ccvEnabled\": true,         \"chain\": {            \"id\": 1,            \"name\": \"Test chain\"         }     },    \"recommendedMerchants\": {         \"merchants\": [             {                 \"id\":12,                 \"name\":\"similar merchant\",                 \"phoneNumber\":\"+27113901838\",                 \"currency\":\"ZAR\",                 \"locale\":\"en_ZA\",                 \"timezone\":\"Africa/Johannesburg\",                 \"location\":{                     \"coordinates\":{                         \"latitude\":33.8,                         \"longitude\":18.4                     },                     \"address\":{                         \"street\":\"Tamerlan street\",                         \"number\":\"5A\",                         \"zipcode\":\"10787\",                         \"city\":\"Cape Town\",                         \"country\":\"ZAF\"                     }                 },                 \"reviewScore\": \"5.3\",                 \"tagGroups\":[                     {                         \"type\":\"CUISINE\",                         \"tags\":[                             {                                 \"id\":25,                                 \"name\":\"Testküche Hauptkategorie\"                             },                             {                                 \"id\":28,                                 \"name\":\"Test cuisine\"                             }                         ]                     }                 ],                 \"images\":[                     {                         \"url\":\"https://dci5ez2ey8tr9.cloudfront.net/8e4d1063-9171-40b1-94b7-5e9337591a90/7_sld.jpg\"                     }                 ],                 \"documents\":[],                 \"links\":[                     {                         \"href\":\"https://{host}/{path}?aid=16\",                         \"method\":\"GET\",                         \"rel\":\"DETAILS\"                     },                     {                         \"href\":\"https://{host}/{path}?aid=16&countryId=NLD\",                         \"method\":\"GET\",                         \"rel\":\"WIDGET\"                     },                     {                         \"href\":\"https://{host}/{path}/details?aid=16&countryId=NLD\",                         \"method\":\"GET\",                         \"rel\":\"WIDGET_DETAILS\"                     }                 ],                 \"bookable\": true,                 \"openingTimes\": {                   \"standardOpeningTimes\": {                     \"SATURDAY\": [                       {                         \"start\": \"09:00:00\",                         \"end\": \"20:00:00\"                       }                     ],                     \"SUNDAY\": [                       {                         \"start\": \"09:00:00\",                         \"end\": \"18:00:00\"                       }                     ]                   }                 },                 \"ccvEnabled\": true,                 \"chain\": {                    \"id\": 1,                    \"name\": \"Test chain\"                 }             }         ],         \"size\": 1,         \"offset\": 0,         \"limit\": 10     } } ```  `merchant not bookable` ``` {     \"merchantSearchMessage\": \"MERCHANT_NOT_BOOKABLE\",     \"recommendedMerchants\": {         \"limit\": 10,         \"merchants\": [...],         \"offset\": 0,         \"size\": 0     } } ```
+    # @param merchant_id merchantId
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sort Sort order. Default sorting will be by proximity. (default to CLOSEST)
+    # @option opts [Integer] :limit Max number of merchant recommendations to return. (default to 10)
+    # @option opts [String] :accept_language Locale.&lt;br&gt;Format:&lt;br&gt;&amp;lt;language code&amp;gt;[_&amp;lt;country code&amp;gt;] (default to en_GB)
+    # @return [MerchantWithRecommendationsDto]
+    def search_similar1(merchant_id, opts = {})
+      data, _status_code, _headers = search_similar1_with_http_info(merchant_id, opts)
+      data
+    end
+
+    # Allows to get a merchant by id and find similar merchants
+    # This endpoint allows to receive detailed information for a particular merchant in the system and for restaurants that are similar to this one. A merchant is similar if all the following conditions are met: 1. Location: the recommended merchants are within 30 km radius from the main merchant 2. The similar merchants are bookable online 3. The similar merchants have the main cuisine in common  This merchant should be specified by their identifier **merchantId**, which is mandatory. The endpoint can take optional request header **Accept-Language**. This header is used to determine correct locale and has an effect on translation of merchant&#39;s entity fields, that may be omitted.  The expected value of the header **Accept-Language** should contain language and can contain country, e.g. \&quot;de_DE\&quot; or \&quot;de\&quot;. Locale by default is \&quot;en_GB\&quot;.  The endpoint returns status &#x60;HTTP 200&#x60; if the request is successful. In a successful requests the specified merchant was found.  If the merchant has no products allowed for a web search, i.e. is not bookable, response data with &#x60;HTTP 200&#x60; is returned, but the field &#x60;merchant&#x60; is not set. Instead, the merchant search message is set.  The endpoint will return status &#x60;HTTP 404&#x60; if the merchant, specified by identifier, was not found.  Example curl: &#x60;&#x60;&#x60; curl  -H &#39;X-Quandoo-AuthToken: {INSERT_KEY_HERE}&#39; -H &#39;Accept-Language: de_DE&#39; &#39;https://{host}/v{X}/merchants/11/similar&#39; &#x60;&#x60;&#x60;  Example responses: &#x60;merchant bookable&#x60; &#x60;&#x60;&#x60; {     \&quot;merchant\&quot;: {         \&quot;id\&quot;:11,         \&quot;name\&quot;:\&quot;Test merchant\&quot;,         \&quot;phoneNumber\&quot;:\&quot;+27113901837\&quot;,         \&quot;currency\&quot;:\&quot;ZAR\&quot;,         \&quot;locale\&quot;:\&quot;en_ZA\&quot;,         \&quot;timezone\&quot;:\&quot;Africa/Johannesburg\&quot;,         \&quot;location\&quot;:{             \&quot;coordinates\&quot;:{                 \&quot;latitude\&quot;:33.9,                 \&quot;longitude\&quot;:18.4             },             \&quot;address\&quot;:{                 \&quot;street\&quot;:\&quot;Tamerlan street\&quot;,                 \&quot;number\&quot;:\&quot;6A\&quot;,                 \&quot;zipcode\&quot;:\&quot;10787\&quot;,                 \&quot;city\&quot;:\&quot;Cape Town\&quot;,                 \&quot;country\&quot;:\&quot;ZAF\&quot;             }         },         \&quot;reviewScore\&quot;: \&quot;5.3\&quot;,         \&quot;tagGroups\&quot;:[             {                 \&quot;type\&quot;:\&quot;CUISINE\&quot;,                 \&quot;tags\&quot;:[                     {                         \&quot;id\&quot;:25,                         \&quot;name\&quot;:\&quot;Testküche Hauptkategorie\&quot;                     },                     {                         \&quot;id\&quot;:28,                         \&quot;name\&quot;:\&quot;Test cuisine\&quot;                     }                 ]             }         ],         \&quot;images\&quot;:[             {                 \&quot;url\&quot;:\&quot;https://dci5ez2ey8tr9.cloudfront.net/8e4d1063-9171-40b1-94b7-5e9337591a90/7_sld.jpg\&quot;             }         ],         \&quot;documents\&quot;:[],         \&quot;links\&quot;:[             {                 \&quot;href\&quot;:\&quot;https://{host}/{path}?aid&#x3D;16\&quot;,                 \&quot;method\&quot;:\&quot;GET\&quot;,                 \&quot;rel\&quot;:\&quot;DETAILS\&quot;             },             {                 \&quot;href\&quot;:\&quot;https://{host}/{path}?aid&#x3D;16&amp;countryId&#x3D;NLD\&quot;,                 \&quot;method\&quot;:\&quot;GET\&quot;,                 \&quot;rel\&quot;:\&quot;WIDGET\&quot;             },             {                 \&quot;href\&quot;:\&quot;https://{host}/{path}/details?aid&#x3D;16&amp;countryId&#x3D;NLD\&quot;,                 \&quot;method\&quot;:\&quot;GET\&quot;,                 \&quot;rel\&quot;:\&quot;WIDGET_DETAILS\&quot;             }         ],         \&quot;bookable\&quot;: true,         \&quot;openingTimes\&quot;: {           \&quot;standardOpeningTimes\&quot;: {             \&quot;SATURDAY\&quot;: [               {                 \&quot;start\&quot;: \&quot;09:00:00\&quot;,                 \&quot;end\&quot;: \&quot;20:00:00\&quot;               }             ],             \&quot;SUNDAY\&quot;: [               {                 \&quot;start\&quot;: \&quot;09:00:00\&quot;,                 \&quot;end\&quot;: \&quot;18:00:00\&quot;               }             ]           }         },         \&quot;ccvEnabled\&quot;: true,         \&quot;chain\&quot;: {            \&quot;id\&quot;: 1,            \&quot;name\&quot;: \&quot;Test chain\&quot;         }     },    \&quot;recommendedMerchants\&quot;: {         \&quot;merchants\&quot;: [             {                 \&quot;id\&quot;:12,                 \&quot;name\&quot;:\&quot;similar merchant\&quot;,                 \&quot;phoneNumber\&quot;:\&quot;+27113901838\&quot;,                 \&quot;currency\&quot;:\&quot;ZAR\&quot;,                 \&quot;locale\&quot;:\&quot;en_ZA\&quot;,                 \&quot;timezone\&quot;:\&quot;Africa/Johannesburg\&quot;,                 \&quot;location\&quot;:{                     \&quot;coordinates\&quot;:{                         \&quot;latitude\&quot;:33.8,                         \&quot;longitude\&quot;:18.4                     },                     \&quot;address\&quot;:{                         \&quot;street\&quot;:\&quot;Tamerlan street\&quot;,                         \&quot;number\&quot;:\&quot;5A\&quot;,                         \&quot;zipcode\&quot;:\&quot;10787\&quot;,                         \&quot;city\&quot;:\&quot;Cape Town\&quot;,                         \&quot;country\&quot;:\&quot;ZAF\&quot;                     }                 },                 \&quot;reviewScore\&quot;: \&quot;5.3\&quot;,                 \&quot;tagGroups\&quot;:[                     {                         \&quot;type\&quot;:\&quot;CUISINE\&quot;,                         \&quot;tags\&quot;:[                             {                                 \&quot;id\&quot;:25,                                 \&quot;name\&quot;:\&quot;Testküche Hauptkategorie\&quot;                             },                             {                                 \&quot;id\&quot;:28,                                 \&quot;name\&quot;:\&quot;Test cuisine\&quot;                             }                         ]                     }                 ],                 \&quot;images\&quot;:[                     {                         \&quot;url\&quot;:\&quot;https://dci5ez2ey8tr9.cloudfront.net/8e4d1063-9171-40b1-94b7-5e9337591a90/7_sld.jpg\&quot;                     }                 ],                 \&quot;documents\&quot;:[],                 \&quot;links\&quot;:[                     {                         \&quot;href\&quot;:\&quot;https://{host}/{path}?aid&#x3D;16\&quot;,                         \&quot;method\&quot;:\&quot;GET\&quot;,                         \&quot;rel\&quot;:\&quot;DETAILS\&quot;                     },                     {                         \&quot;href\&quot;:\&quot;https://{host}/{path}?aid&#x3D;16&amp;countryId&#x3D;NLD\&quot;,                         \&quot;method\&quot;:\&quot;GET\&quot;,                         \&quot;rel\&quot;:\&quot;WIDGET\&quot;                     },                     {                         \&quot;href\&quot;:\&quot;https://{host}/{path}/details?aid&#x3D;16&amp;countryId&#x3D;NLD\&quot;,                         \&quot;method\&quot;:\&quot;GET\&quot;,                         \&quot;rel\&quot;:\&quot;WIDGET_DETAILS\&quot;                     }                 ],                 \&quot;bookable\&quot;: true,                 \&quot;openingTimes\&quot;: {                   \&quot;standardOpeningTimes\&quot;: {                     \&quot;SATURDAY\&quot;: [                       {                         \&quot;start\&quot;: \&quot;09:00:00\&quot;,                         \&quot;end\&quot;: \&quot;20:00:00\&quot;                       }                     ],                     \&quot;SUNDAY\&quot;: [                       {                         \&quot;start\&quot;: \&quot;09:00:00\&quot;,                         \&quot;end\&quot;: \&quot;18:00:00\&quot;                       }                     ]                   }                 },                 \&quot;ccvEnabled\&quot;: true,                 \&quot;chain\&quot;: {                    \&quot;id\&quot;: 1,                    \&quot;name\&quot;: \&quot;Test chain\&quot;                 }             }         ],         \&quot;size\&quot;: 1,         \&quot;offset\&quot;: 0,         \&quot;limit\&quot;: 10     } } &#x60;&#x60;&#x60;  &#x60;merchant not bookable&#x60; &#x60;&#x60;&#x60; {     \&quot;merchantSearchMessage\&quot;: \&quot;MERCHANT_NOT_BOOKABLE\&quot;,     \&quot;recommendedMerchants\&quot;: {         \&quot;limit\&quot;: 10,         \&quot;merchants\&quot;: [...],         \&quot;offset\&quot;: 0,         \&quot;size\&quot;: 0     } } &#x60;&#x60;&#x60;
+    # @param merchant_id merchantId
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sort Sort order. Default sorting will be by proximity.
+    # @option opts [Integer] :limit Max number of merchant recommendations to return.
+    # @option opts [String] :accept_language Locale.&lt;br&gt;Format:&lt;br&gt;&amp;lt;language code&amp;gt;[_&amp;lt;country code&amp;gt;]
+    # @return [Array<(MerchantWithRecommendationsDto, Fixnum, Hash)>] MerchantWithRecommendationsDto data, response status code and response headers
+    def search_similar1_with_http_info(merchant_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MerchantsApi.search_similar1 ...'
+      end
+      # verify the required parameter 'merchant_id' is set
+      if @api_client.config.client_side_validation && merchant_id.nil?
+        fail ArgumentError, "Missing the required parameter 'merchant_id' when calling MerchantsApi.search_similar1"
+      end
+      if @api_client.config.client_side_validation && opts[:'sort'] && !['CLOSEST'].include?(opts[:'sort'])
+        fail ArgumentError, 'invalid value for "sort", must be one of CLOSEST'
+      end
+      # resource path
+      local_var_path = '/v1/merchants/{merchantId}/similar'.sub('{' + 'merchantId' + '}', merchant_id.to_s)
+
+      # query parameters
+      query_params = {}
+      query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params[:'Accept-Language'] = opts[:'accept_language'] if !opts[:'accept_language'].nil?
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['API_TOKEN']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'MerchantWithRecommendationsDto')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: MerchantsApi#search_similar1\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end