booker_ruby 1.14.0 → 2.0.0

data/lib/booker/v4.1/merchant.rb

@@ -0,0 +1,55 @@
+module Booker
+  module V41
+    class Merchant < Client
+      include Booker::V4::RequestHelper
+
+      API_METHODS = {
+        appointments: '/v4.1/merchant/appointments'.freeze,
+        customers: '/v4.1/merchant/customers'.freeze,
+        create_special: '/v4.1/merchant/special'.freeze
+      }.freeze
+
+      def appointments(location_id:, start_date:, end_date:, fetch_all: true, options: {})
+        additional_params = {
+          LocationID: location_id,
+          FromStartDate: start_date.to_date,
+          ToStartDate: end_date.to_date
+        }
+
+        paginated_request(
+          method: :post,
+          path: API_METHODS[:appointments],
+          params: build_params(additional_params, options, true),
+          model: Booker::V4::Models::Appointment,
+          fetch_all: fetch_all
+        )
+      end
+
+      def customers(location_id:, fetch_all: true, options: {})
+        additional_params = {
+          FilterByExactLocationID: true,
+          LocationID: location_id,
+          CustomerRecordType: 1,
+        }
+
+        paginated_request(
+          method: :post,
+          path: API_METHODS[:customers],
+          params: build_params(additional_params, options, true),
+          model: Booker::V4::Models::Customer,
+          fetch_all: fetch_all
+        )
+      end
+
+      def create_special(location_id:, start_date:, end_date:, coupon_code:, name:, options: {})
+        post(API_METHODS[:create_special], build_params({
+          LocationID: location_id,
+          ApplicableStartDate: start_date.in_time_zone,
+          ApplicableEndDate: end_date.in_time_zone,
+          CouponCode: coupon_code,
+          Name: name
+        }, options))
+      end
+    end
+  end
+end

data/lib/booker/v4/business_client.rb

@@ -0,0 +1,9 @@
+module Booker
+  module V4
+    class BusinessClient < Booker::Client
+      include Booker::V4::BusinessREST
+      ENV_BASE_URL_KEY = 'BOOKER_BUSINESS_SERVICE_URL'.freeze
+      DEFAULT_BASE_URL = 'https://apicurrent-app.booker.ninja/webservice4/json/BusinessService.svc'.freeze
+    end
+  end
+end

data/lib/booker/v4/business_rest.rb

@@ -0,0 +1,88 @@
+module Booker
+  module V4
+    module BusinessREST
+      include Booker::V4::CommonREST
+
+      def get_logged_in_user
+        response = get('/user', build_params)
+        result = Booker::V4::Models::User.from_hash(response['User'])
+        result.LocationID = response['LocationID']
+        result.BrandID = response['BrandID']
+        result
+      end
+
+      def get_location_day_schedules(booker_location_id:, params: {})
+        # Booker requires fromDate and toDate for JSON API, but does not use them when getDefaultDaySchedule is true
+        # So datetime used for these fields does not matter
+        random_datetime = Booker::V4::Models::Model.time_to_booker_datetime(Time.now)
+
+        additional_params = {getDefaultDaySchedule: true, fromDate: random_datetime, toDate: random_datetime}
+        response = get("/location/#{booker_location_id}/schedule", build_params(additional_params, params))
+        response['LocationDaySchedules'].map { |sched| Booker::V4::Models::LocationDaySchedule.from_hash(sched) }
+      end
+
+      def find_locations(options: {})
+        paginated_request(
+            method: :post,
+            path: '/locations',
+            params: build_params({}, options, true),
+            model: Booker::V4::Models::Location
+        )
+      end
+
+      def find_employees(booker_location_id:, fetch_all: true, options: {})
+        paginated_request(
+            method: :post,
+            path: '/employees',
+            params: build_params({LocationID: booker_location_id}, options, true),
+            model: Booker::V4::Models::Employee,
+            fetch_all: fetch_all
+        )
+      end
+
+      def find_treatments(booker_location_id:, fetch_all: true, options: {})
+        paginated_request(
+            method: :post,
+            path: '/treatments',
+            params: build_params({LocationID: booker_location_id}, options, true),
+            model: Booker::V4::Models::Treatment,
+            fetch_all: fetch_all
+        )
+      end
+
+      def find_appointments_partial(booker_location_id:, start_date:, end_date:, fetch_all: true, options: {})
+        additional_params = {
+          LocationID: booker_location_id,
+          FromStartDate: start_date.to_date,
+          ToStartDate: end_date.to_date
+        }
+
+        paginated_request(
+          method: :post,
+          path: '/appointments/partial',
+          params: build_params(additional_params, options, true),
+          model: Booker::V4::Models::Appointment,
+          fetch_all: fetch_all
+        )
+      end
+
+      def get_location_notification_settings(booker_location_id:)
+        response = get "/location/#{booker_location_id}/notification_settings", build_params
+        Booker::V4::Models::NotificationSettings.from_hash response['NotificationSettings']
+      end
+
+      def update_location_notification_settings(booker_location_id:, send_appointment_reminders:)
+        put "/location/#{booker_location_id}/notification_settings", build_params({
+          NotificationSettings: {
+            SendAppointmentReminders: send_appointment_reminders
+          }
+        })
+      end
+
+      def get_location_feature_settings(booker_location_id:)
+        response = get "/location/#{booker_location_id}/feature_settings", build_params
+        Booker::V4::Models::FeatureSettings.from_hash response['FeatureSettings']
+      end
+    end
+  end
+end

data/lib/booker/v4/common_rest.rb

@@ -0,0 +1,21 @@
+module Booker
+  module V4
+    module CommonREST
+      include Booker::V4::RequestHelper
+
+      def get_online_booking_settings(booker_location_id:)
+        response = get("/location/#{booker_location_id}/online_booking_settings", build_params)
+        Booker::V4::Models::OnlineBookingSettings.from_hash(response['OnlineBookingSettings'])
+      end
+
+      def confirm_appointment(appointment_id:)
+        put '/appointment/confirm', build_params(:ID => appointment_id), Booker::V4::Models::Appointment
+      end
+
+      def get_location(booker_location_id:)
+        response = get("/location/#{booker_location_id}", build_params)
+        Booker::V4::Models::Location.from_hash(response)
+      end
+    end
+  end
+end

data/lib/booker/v4/customer_client.rb

@@ -0,0 +1,15 @@
+module Booker
+  module V4
+    class CustomerClient < Client
+      include Booker::V4::CustomerREST
+      ENV_BASE_URL_KEY = 'BOOKER_CUSTOMER_SERVICE_URL'.freeze
+      DEFAULT_BASE_URL = 'https://apicurrent-app.booker.ninja/webservice4/json/CustomerService.svc'.freeze
+
+      def initialize(options={})
+        super
+        self.token_store ||= GenericTokenStore
+        self.token_store_callback_method ||= :update_booker_access_token!
+      end
+    end
+  end
+end

data/lib/booker/v4/customer_rest.rb

@@ -0,0 +1,15 @@
+module Booker
+  module V4
+    module CustomerREST
+      include Booker::V4::CommonREST
+
+      def create_class_appointment(booker_location_id:, class_instance_id:, customer:, options: {})
+        post '/class_appointment/create', build_params({
+          LocationID: booker_location_id,
+          ClassInstanceID: class_instance_id,
+          Customer: customer
+        }, options), Booker::V4::Models::Appointment
+      end
+    end
+  end
+end

data/lib/booker/v4/models/address.rb

@@ -0,0 +1,14 @@
+module Booker
+  module V4
+    module Models
+      class Address < Model
+        attr_accessor 'Street1',
+                      'Street2',
+                      'City',
+                      'State',
+                      'Zip',
+                      'Country'
+      end
+    end
+  end
+end

data/lib/booker/v4/models/appointment.rb

@@ -0,0 +1,79 @@
+module Booker
+  module V4
+    module Models
+      class Appointment < Model
+        attr_accessor 'BookingNumber',
+          'Confirmable',
+          'EndDateTime',
+          'FinalTotal',
+          'ID',
+          'IsCancelled',
+          'IsNoShow',
+          'LocationID',
+          'StartDateTime',
+          'Status',
+          'CanTakePayment',
+          'DateCreated',
+          'BelongsToEnrollment',
+          'Address',
+          'AddressID',
+          'AllowAutoPay',
+          'AppointmentTreatments',
+          'BelongsToGroup',
+          'BelongsToGroupAndGroupOrder',
+          'BelongsToOrder',
+          'CanCancel',
+          'CanCheckin',
+          'CanHaveCustomer2',
+          'CanRevertNoShow',
+          'CanUndoCheckin',
+          'CancellationID',
+          'Customer',
+          'Customer2',
+          'Customer2ID',
+          'CustomerID',
+          'CustomerLastName',
+          'CustomerMobilePhone',
+          'CustomerWorkPhone',
+          'DateBooked',
+          'DateNoShow',
+          'Employee',
+          'EmployeeFirstName',
+          'EmployeeLastName',
+          'GroupID',
+          'GroupName',
+          'GroupNumber',
+          'GroupTypeID',
+          'IsCancelledOrNoShow',
+          'IsCheckedInInService',
+          'IsPartOfClassPackageBooking',
+          'IsPreBookedAtPastCheckout',
+          'IsRecurring',
+          'IsWebBooking',
+          'Notes',
+          'OrderID',
+          'OrderStatusID',
+          'PackageID',
+          'PaymentID',
+          'PaymentItemID',
+          'PrimaryAppointmentTreatmentID',
+          'RecurrenceID',
+          'Room',
+          'Source',
+          'Treatment',
+          'TreatmentName',
+          'Type',
+          'IsHeld',
+          'HoldForMinutes',
+          'HeldSince',
+          'IsServiceComplete',
+          'IsCheckout',
+          'DateCheckIn',
+          'IsFromWaitList',
+          'IsFromClassWaitList',
+          'CustomerRecordTypeID',
+          'CustomerParentID'
+      end
+    end
+  end
+end

data/lib/booker/v4/models/appointment_treatment.rb

@@ -0,0 +1,53 @@
+module Booker
+  module V4
+    module Models
+      class AppointmentTreatment < Model
+        attr_accessor 'AppointmentID',
+          'DynamicPrice',
+          'EndDateTime',
+          'ID',
+          'StartDateTime',
+          'ChildID',
+          'ChildName',
+          'AllowChangeStartTime',
+          'DynamicPriceID',
+          'Employee',
+          'Employee2FullName',
+          'Employee2ID',
+          'EmployeeFirstName',
+          'EmployeeFullName',
+          'EmployeeID',
+          'EmployeeLastName',
+          'EmployeeRecoveryDuration',
+          'EmployeeTypeID',
+          'EmployeeWasRequested',
+          'FinishStartDateTime',
+          'FinishTimeAppliedToEmployee',
+          'FinishTimeAppliedToRoom',
+          'FinishTimeDuration',
+          'FinishTimeOriginalDuration',
+          'ProcessingStartDateTime',
+          'ProcessingTimeAppliedToRoom',
+          'ProcessingTimeAppliedToEmployee',
+          'ProcessingTimeDuration',
+          'ProcessingTimeOriginalDuration',
+          'RequiresProcessingTime',
+          'Room',
+          'RoomID',
+          'RoomName',
+          'RoomRecoveryDuration',
+          'StartTimeDuration',
+          'StartTimeOriginalDuration',
+          'TagPrice',
+          'Treatment',
+          'TreatmentDuration',
+          'TreatmentID',
+          'TreatmentIsForCouples',
+          'TreatmentName',
+          'ClassInstanceID',
+          'IsDurationOverridden'
+      end
+    end
+  end
+end
+

data/lib/booker/v4/models/available_time.rb

@@ -0,0 +1,15 @@
+module Booker
+  module V4
+    module Models
+      class AvailableTime < Model
+        attr_accessor 'CurrentPrice',
+          'Duration',
+          'EmployeeID',
+          'StartDateTime',
+          'TreatmentID',
+          'RoomID',
+          'Employee2ID'
+      end
+    end
+  end
+end

data/lib/booker/v4/models/business_type.rb

@@ -0,0 +1,7 @@
+module Booker
+  module V4
+    module Models
+      class BusinessType < Type; end
+    end
+  end
+end

data/lib/booker/v4/models/category.rb

@@ -0,0 +1,7 @@
+module Booker
+  module V4
+    module Models
+      class Category < Type; end
+    end
+  end
+end

data/lib/booker/v4/models/class_instance.rb

@@ -0,0 +1,27 @@
+module Booker
+  module V4
+    module Models
+      class ClassInstance < Model
+        attr_accessor 'ID',
+          'EndDateTime',
+          'HasClassFilled',
+          'IsForMembersOnly',
+          'IsRecurring',
+          'IsSpecialEvent',
+          'IsWorkshop',
+          'NumReserved',
+          'Price',
+          'RoomName',
+          'StartDateTime',
+          'Teacher',
+          'Teacher2',
+          'TotalCapacity',
+          'TreatmentDuration',
+          'ListAsSubstitute',
+          'IsEnrollable',
+          'SeriesID',
+          'Treatment'
+      end
+    end
+  end
+end

data/lib/booker/v4/models/country.rb

@@ -0,0 +1,21 @@
+module Booker
+  module V4
+    module Models
+      class Country < Type
+        # ISO 3166-1 alpha-2 Codes
+        IDS_TO_ISO_CODES = YAML::load_file(File.join(__dir__, '..', '..', 'config', 'booker_country_ids_to_iso_codes.yml')).freeze
+
+        def country_code; IDS_TO_ISO_CODES[self.ID]; end
+
+        def self.from_country_code(code)
+          country = self.new ID: IDS_TO_ISO_CODES.detect{|k, v| v == code}.try(:[], 0)
+          if country.ID.nil?
+            raise ArgumentError, 'Country code not recognized'
+          else
+            country
+          end
+        end
+      end
+    end
+  end
+end