repull 0.2.15 → 0.2.17

data/lib/repull/models/booking_pricing_rate_update.rb

@@ -14,25 +14,29 @@ require 'date'
 require 'time'
 
 module Repull
-  # A single (room, rate-plan, date-range) update pushed to Booking.com via the rates API.
+  # A single (room, rate-plan, date-range) price update. The amount is written against the party size in `occupancy`, for every night from `dateRange.start` to `dateRange.end` inclusive.
   class BookingPricingRateUpdate < ApiModelBase
-    # Booking.com room ID for the rate plan. Comes from `listings_booking_rooms` mapping.
+    # Booking.com room id the rate plan sells. `GET /v1/channels/booking/properties/{id}/rooms` lists them.
     attr_accessor :room_id
 
-    # Booking.com rate-plan ID.
+    # Booking.com rate-plan id.
     attr_accessor :rate_id
 
     attr_accessor :date_range
 
+    # Nightly amount, in `currency`, for a party of `occupancy`.
     attr_accessor :price
 
+    # Currency the rate plan is sold in.
     attr_accessor :currency
 
+    # Optional single-occupancy amount, written alongside the main amount.
     attr_accessor :single_price
 
+    # The party size this rate plan prices — a key, not a preference. Booking.com stores the amount against this number: above the rate plan's own maximum it declines the price in silence and the night keeps its old value; below it, it answers 400 and the old price stays published. Omit it and Repull resolves it from Booking.com's own data for this (room, rate plan) and echoes the value and its source back in `occupancy[]`. When it cannot be resolved the write is refused with `422` naming `updates[N].occupancy` — a price is never sent at a guessed party size.
     attr_accessor :occupancy
 
-    # Rooms to sell for the date range. Set to `0` to stop-sell this room/rate on the rates endpoint (Booking's dedicated `<closed>` stop-sell flag lives on the availability endpoint — see `BookingAvailabilityUpdate.closed`).
+    # Refused. A rate update carries prices only; sending this returns `422 inventory_not_in_rate_update` naming `updates[N].roomsToSell`. Write inventory with `type: \"availability\"` and `availableRooms` (plus `closed: true` for a stop-sell).
     attr_accessor :rooms_to_sell
 
     attr_accessor :restrictions
@@ -170,10 +174,18 @@ module Repull
         invalid_properties.push('invalid value for "price", price cannot be nil.')
       end
 
+      if @price < 0
+        invalid_properties.push('invalid value for "price", must be greater than or equal to 0.')
+      end
+
       if @currency.nil?
         invalid_properties.push('invalid value for "currency", currency cannot be nil.')
       end
 
+      if !@occupancy.nil? && @occupancy < 1
+        invalid_properties.push('invalid value for "occupancy", must be greater than or equal to 1.')
+      end
+
       invalid_properties
     end
 
@@ -185,7 +197,9 @@ module Repull
       return false if @rate_id.nil?
       return false if @date_range.nil?
       return false if @price.nil?
+      return false if @price < 0
       return false if @currency.nil?
+      return false if !@occupancy.nil? && @occupancy < 1
       true
     end
 
@@ -226,6 +240,10 @@ module Repull
         fail ArgumentError, 'price cannot be nil'
       end
 
+      if price < 0
+        fail ArgumentError, 'invalid value for "price", must be greater than or equal to 0.'
+      end
+
       @price = price
     end
 
@@ -239,6 +257,16 @@ module Repull
       @currency = currency
     end
 
+    # Custom attribute writer method with validation
+    # @param [Object] occupancy Value to be assigned
+    def occupancy=(occupancy)
+      if !occupancy.nil? && occupancy < 1
+        fail ArgumentError, 'invalid value for "occupancy", must be greater than or equal to 1.'
+      end
+
+      @occupancy = occupancy
+    end
+
     # Checks equality by comparing each attribute.
     # @param [Object] Object to be compared
     def ==(o)

data/lib/repull/models/booking_pricing_rate_update_date_range.rb

@@ -14,9 +14,12 @@ require 'date'
 require 'time'
 
 module Repull
+  # The nights this update applies to. **Both ends are inclusive**: `{ \"start\": \"2026-11-04\", \"end\": \"2026-11-04\" }` writes exactly one night.
   class BookingPricingRateUpdateDateRange < ApiModelBase
+    # First night, YYYY-MM-DD.
     attr_accessor :start
 
+    # Last night, YYYY-MM-DD, inclusive — the same date as `start` for a single night.
     attr_accessor :_end
 
     # Attribute mapping from ruby-style variable name to JSON key.

data/lib/repull/models/booking_pricing_rate_update_restrictions.rb

@@ -14,33 +14,33 @@ require 'date'
 require 'time'
 
 module Repull
-  # Optional length-of-stay / availability restrictions for one rate update. Every field here is forwarded verbatim into Booking.com's rates XML (`minimumstay`, `maximumstay`, `closedonarrival`, `closedondeparture`, …) — omit a field to leave that restriction untouched.
+  # Length-of-stay and arrival restrictions for the nights in this update. Omit a field to leave that restriction untouched — nothing you do not state is changed.  These are written on Booking.com's availability notification, which is the wire that carries a restriction when no inventory changes hands. Sending them alongside a price is supported: the prices and the restrictions are two writes, and the response reports each one separately (`price` and `restrictions`), so a half that lands is never reported as a failure and a half that is refused is never reported as applied.  Three restrictions are refused with `422 restriction_not_supported` naming the field: Booking.com's notification has no element for them, and dropping a restriction you stated would be worse than refusing it. Set those on the rate plan in the Booking.com Extranet.
   class BookingPricingRateUpdateRestrictions < ApiModelBase
-    # Minimum length of stay (`minimumstay`).
+    # Minimum length of stay. Booking.com stores a 1-night minimum as no minimum at all, so `minStay: 1` reads back as `0` and is reported as applied.
     attr_accessor :min_stay
 
-    # Maximum length of stay (`maximumstay`).
+    # Maximum length of stay.
     attr_accessor :max_stay
 
-    # Closed-to-arrival — guests may not check in on the affected dates (`closedonarrival`).
+    # Closed-to-arrival — guests may not check in on these nights. `false` clears the flag; omit the field to leave it as it is.
     attr_accessor :closed_to_arrival
 
-    # Closed-to-departure — guests may not check out on the affected dates (`closedondeparture`).
+    # Closed-to-departure — guests may not check out on these nights. `false` clears the flag; omit the field to leave it as it is.
     attr_accessor :closed_to_departure
 
-    # Arrival-based minimum length of stay (`minimumstay_arrival`).
+    # Arrival-based minimum length of stay — applies to stays that START on these nights, rather than any stay covering them.
     attr_accessor :min_stay_arrival
 
-    # Arrival-based maximum length of stay (`maximumstay_arrival`).
+    # Arrival-based maximum length of stay.
     attr_accessor :max_stay_arrival
 
-    # Arrival-based exact length of stay (`exactstay_arrival`).
+    # Refused. Booking.com's restriction notification has no element for an exact arrival-based stay length, so it cannot be written through the API; sending it returns `422 restriction_not_supported` naming `updates[N].restrictions.exactStayArrival`. Set it on the rate plan in the Booking.com Extranet.
     attr_accessor :exact_stay_arrival
 
-    # Minimum advance-reservation window, format `XDY` (X days Y hours) — `min_advance_res`.
+    # Refused, for the same reason as `exactStayArrival` — returns `422 restriction_not_supported`. Set the minimum advance-reservation window on the rate plan in the Booking.com Extranet.
     attr_accessor :min_advance_res
 
-    # Maximum advance-reservation window, format `XDY` (X days Y hours) — `max_advance_res`.
+    # Refused, for the same reason as `exactStayArrival` — returns `422 restriction_not_supported`. Set the maximum advance-reservation window on the rate plan in the Booking.com Extranet.
     attr_accessor :max_advance_res
 
     # Attribute mapping from ruby-style variable name to JSON key.

data/lib/repull/models/booking_pricing_response.rb

@@ -20,11 +20,15 @@ module Repull
 
     attr_accessor :listing_id
 
+    # Other Booking.com properties this listing is also published under. Empty in the normal case. Pass one as `?hotel_id=` to read its pricing instead.
+    attr_accessor :other_hotel_ids
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
         :'hotel_id' => :'hotelId',
-        :'listing_id' => :'listingId'
+        :'listing_id' => :'listingId',
+        :'other_hotel_ids' => :'otherHotelIds'
       }
     end
 
@@ -42,7 +46,8 @@ module Repull
     def self.openapi_types
       {
         :'hotel_id' => :'String',
-        :'listing_id' => :'String'
+        :'listing_id' => :'String',
+        :'other_hotel_ids' => :'Array<String>'
       }
     end
 
@@ -75,6 +80,12 @@ module Repull
       if attributes.key?(:'listing_id')
         self.listing_id = attributes[:'listing_id']
       end
+
+      if attributes.key?(:'other_hotel_ids')
+        if (value = attributes[:'other_hotel_ids']).is_a?(Array)
+          self.other_hotel_ids = value
+        end
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -98,7 +109,8 @@ module Repull
       return true if self.equal?(o)
       self.class == o.class &&
           hotel_id == o.hotel_id &&
-          listing_id == o.listing_id
+          listing_id == o.listing_id &&
+          other_hotel_ids == o.other_hotel_ids
     end
 
     # @see the `==` method
@@ -110,7 +122,7 @@ module Repull
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [hotel_id, listing_id].hash
+      [hotel_id, listing_id, other_hotel_ids].hash
     end
 
     # Builds the object from hash

data/lib/repull/models/booking_pricing_update_response.rb

@@ -14,31 +14,53 @@ require 'date'
 require 'time'
 
 module Repull
+  # What a Booking.com rate write actually did. Returned by `PUT /v1/channels/booking/listings/{id}/pricing` and by `PUT /v1/channels/booking/availability` with `type: \"rates\"`.  Prices and restrictions are two writes on two of Booking.com's wires, and Booking.com can take one and refuse the other. The response says so: `price` and `restrictions` each carry their own state, their own read-back and — when refused — Booking.com's own reason. The top-level `applied` summarises them, and is `partial` when they disagree. A half that landed is never reported as a failure.
   class BookingPricingUpdateResponse < ApiModelBase
     attr_accessor :hotel_id
 
     attr_accessor :listing_id
 
-    # Number of updates Booking.com accepted as `success`. Falls back to total update count when Booking omits per-update status on full success.
-    attr_accessor :pushed
+    # Echoed back by `PUT /v1/channels/booking/availability`.
+    attr_accessor :property_id
 
+    # How many updates were sent.
     attr_accessor :requested
 
-    # Per-update failure rows from Booking — shape mirrors the Booking rates API response.
+    attr_accessor :occupancy
+
+    # What is known about the nights now. `verified` — read back, every night carries what was sent. `mismatch` — read back, some do not (`verification.rows` / `restrictions.verification.rows` name them). `rejected` — Booking.com refused everything that was sent. `partial` — one half landed and the other did not; read `price.applied` and `restrictions.applied` to see which, and `restrictions.rejection.message` for Booking.com's reason. `unverified` — Booking.com acknowledged the request and no read-back ran: an unknown, not a success. A bare acknowledgement is never reported as \"all applied\".
+    attr_accessor :applied
+
+    attr_accessor :price
+
+    attr_accessor :restrictions
+
+    attr_accessor :verification
+
+    # Booking.com's own answers, verbatim: `rates` (the rate-amount notification) and `restrictions` (the availability notification, when the updates carried any restriction).
+    attr_accessor :booking
+
+    # Failures Booking.com named, across both wires. Empty means Booking.com named none — not that the nights changed; that is what `applied` is for.
     attr_accessor :errors
 
-    # Verbatim Booking response envelope for debugging.
-    attr_accessor :raw
+    # Present when Booking.com's rate-plan read did not complete, so an occupancy fell back to the room definition.
+    attr_accessor :rate_plan_read_error
 
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
         :'hotel_id' => :'hotelId',
         :'listing_id' => :'listingId',
-        :'pushed' => :'pushed',
+        :'property_id' => :'propertyId',
         :'requested' => :'requested',
+        :'occupancy' => :'occupancy',
+        :'applied' => :'applied',
+        :'price' => :'price',
+        :'restrictions' => :'restrictions',
+        :'verification' => :'verification',
+        :'booking' => :'booking',
         :'errors' => :'errors',
-        :'raw' => :'raw'
+        :'rate_plan_read_error' => :'ratePlanReadError'
       }
     end
 
@@ -57,16 +79,26 @@ module Repull
       {
         :'hotel_id' => :'String',
         :'listing_id' => :'String',
-        :'pushed' => :'Integer',
+        :'property_id' => :'String',
         :'requested' => :'Integer',
+        :'occupancy' => :'Array<BookingRateWriteOccupancy>',
+        :'applied' => :'String',
+        :'price' => :'BookingRateWritePriceHalf',
+        :'restrictions' => :'BookingRateWriteRestrictionHalf',
+        :'verification' => :'BookingRateWriteVerification',
+        :'booking' => :'Hash<String, Object>',
         :'errors' => :'Array<Hash<String, Object>>',
-        :'raw' => :'Hash<String, Object>'
+        :'rate_plan_read_error' => :'String'
       }
     end
 
     # List of attributes with nullable: true
     def self.openapi_nullable
       Set.new([
+        :'hotel_id',
+        :'listing_id',
+        :'property_id',
+        :'rate_plan_read_error'
       ])
     end
 
@@ -94,24 +126,50 @@ module Repull
         self.listing_id = attributes[:'listing_id']
       end
 
-      if attributes.key?(:'pushed')
-        self.pushed = attributes[:'pushed']
+      if attributes.key?(:'property_id')
+        self.property_id = attributes[:'property_id']
       end
 
       if attributes.key?(:'requested')
         self.requested = attributes[:'requested']
       end
 
+      if attributes.key?(:'occupancy')
+        if (value = attributes[:'occupancy']).is_a?(Array)
+          self.occupancy = value
+        end
+      end
+
+      if attributes.key?(:'applied')
+        self.applied = attributes[:'applied']
+      end
+
+      if attributes.key?(:'price')
+        self.price = attributes[:'price']
+      end
+
+      if attributes.key?(:'restrictions')
+        self.restrictions = attributes[:'restrictions']
+      end
+
+      if attributes.key?(:'verification')
+        self.verification = attributes[:'verification']
+      end
+
+      if attributes.key?(:'booking')
+        if (value = attributes[:'booking']).is_a?(Hash)
+          self.booking = value
+        end
+      end
+
       if attributes.key?(:'errors')
         if (value = attributes[:'errors']).is_a?(Array)
           self.errors = value
         end
       end
 
-      if attributes.key?(:'raw')
-        if (value = attributes[:'raw']).is_a?(Hash)
-          self.raw = value
-        end
+      if attributes.key?(:'rate_plan_read_error')
+        self.rate_plan_read_error = attributes[:'rate_plan_read_error']
       end
     end
 
@@ -137,10 +195,16 @@ module Repull
       self.class == o.class &&
           hotel_id == o.hotel_id &&
           listing_id == o.listing_id &&
-          pushed == o.pushed &&
+          property_id == o.property_id &&
           requested == o.requested &&
+          occupancy == o.occupancy &&
+          applied == o.applied &&
+          price == o.price &&
+          restrictions == o.restrictions &&
+          verification == o.verification &&
+          booking == o.booking &&
           errors == o.errors &&
-          raw == o.raw
+          rate_plan_read_error == o.rate_plan_read_error
     end
 
     # @see the `==` method
@@ -152,7 +216,7 @@ module Repull
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [hotel_id, listing_id, pushed, requested, errors, raw].hash
+      [hotel_id, listing_id, property_id, requested, occupancy, applied, price, restrictions, verification, booking, errors, rate_plan_read_error].hash
     end
 
     # Builds the object from hash

data/lib/repull/models/booking_property.rb

@@ -14,27 +14,51 @@ require 'date'
 require 'time'
 
 module Repull
-  # A property registered in the Booking.com extranet for the connected hotel ID.
+  # A Booking.com property this workspace holds, with the Repull listings mapped under it. A property is a building; its rooms are what guests book, and each room maps to one Repull listing — so one property commonly carries many listings.
   class BookingProperty < ApiModelBase
-    # Booking.com hotel/property ID
-    attr_accessor :id
+    # Repull-side id for this Booking.com connection.
+    attr_accessor :connection_id
 
-    attr_accessor :name
+    # Booking.com hotel/property id. This is what `/v1/channels/booking/availability` takes as `property_id`.
+    attr_accessor :hotel_id
 
-    attr_accessor :status
+    attr_accessor :active
 
-    attr_accessor :country
+    attr_accessor :sync_enabled
 
-    attr_accessor :city
+    attr_accessor :booking_url
+
+    attr_accessor :markup
+
+    attr_accessor :sync_category
+
+    attr_accessor :suspended_at
+
+    attr_accessor :suspension_reason
+
+    attr_accessor :created_at
+
+    # `mapped` — at least one room points at a listing. `unmapped` — the property is claimed but its rooms are not mapped yet, so `listings` is empty; finish `POST /v1/connect/booking/map-rooms`. An unmapped property is listed rather than hidden, so a half-finished connection is visible instead of looking like no connection at all.
+    attr_accessor :mapping_status
+
+    # The Repull listings mapped under this property. Empty when `mappingStatus` is `unmapped`. Inactive listings are left out.
+    attr_accessor :listings
 
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
-        :'id' => :'id',
-        :'name' => :'name',
-        :'status' => :'status',
-        :'country' => :'country',
-        :'city' => :'city'
+        :'connection_id' => :'connectionId',
+        :'hotel_id' => :'hotelId',
+        :'active' => :'active',
+        :'sync_enabled' => :'syncEnabled',
+        :'booking_url' => :'bookingUrl',
+        :'markup' => :'markup',
+        :'sync_category' => :'syncCategory',
+        :'suspended_at' => :'suspendedAt',
+        :'suspension_reason' => :'suspensionReason',
+        :'created_at' => :'createdAt',
+        :'mapping_status' => :'mappingStatus',
+        :'listings' => :'listings'
       }
     end
 
@@ -51,20 +75,30 @@ module Repull
     # Attribute type mapping.
     def self.openapi_types
       {
-        :'id' => :'String',
-        :'name' => :'String',
-        :'status' => :'String',
-        :'country' => :'String',
-        :'city' => :'String'
+        :'connection_id' => :'String',
+        :'hotel_id' => :'String',
+        :'active' => :'Boolean',
+        :'sync_enabled' => :'Boolean',
+        :'booking_url' => :'String',
+        :'markup' => :'String',
+        :'sync_category' => :'String',
+        :'suspended_at' => :'Time',
+        :'suspension_reason' => :'String',
+        :'created_at' => :'Time',
+        :'mapping_status' => :'String',
+        :'listings' => :'Array<BookingPropertyListingsInner>'
       }
     end
 
     # List of attributes with nullable: true
     def self.openapi_nullable
       Set.new([
-        :'status',
-        :'country',
-        :'city'
+        :'booking_url',
+        :'markup',
+        :'sync_category',
+        :'suspended_at',
+        :'suspension_reason',
+        :'created_at',
       ])
     end
 
@@ -84,24 +118,54 @@ module Repull
         h[k.to_sym] = v
       }
 
-      if attributes.key?(:'id')
-        self.id = attributes[:'id']
+      if attributes.key?(:'connection_id')
+        self.connection_id = attributes[:'connection_id']
+      end
+
+      if attributes.key?(:'hotel_id')
+        self.hotel_id = attributes[:'hotel_id']
+      end
+
+      if attributes.key?(:'active')
+        self.active = attributes[:'active']
       end
 
-      if attributes.key?(:'name')
-        self.name = attributes[:'name']
+      if attributes.key?(:'sync_enabled')
+        self.sync_enabled = attributes[:'sync_enabled']
       end
 
-      if attributes.key?(:'status')
-        self.status = attributes[:'status']
+      if attributes.key?(:'booking_url')
+        self.booking_url = attributes[:'booking_url']
       end
 
-      if attributes.key?(:'country')
-        self.country = attributes[:'country']
+      if attributes.key?(:'markup')
+        self.markup = attributes[:'markup']
       end
 
-      if attributes.key?(:'city')
-        self.city = attributes[:'city']
+      if attributes.key?(:'sync_category')
+        self.sync_category = attributes[:'sync_category']
+      end
+
+      if attributes.key?(:'suspended_at')
+        self.suspended_at = attributes[:'suspended_at']
+      end
+
+      if attributes.key?(:'suspension_reason')
+        self.suspension_reason = attributes[:'suspension_reason']
+      end
+
+      if attributes.key?(:'created_at')
+        self.created_at = attributes[:'created_at']
+      end
+
+      if attributes.key?(:'mapping_status')
+        self.mapping_status = attributes[:'mapping_status']
+      end
+
+      if attributes.key?(:'listings')
+        if (value = attributes[:'listings']).is_a?(Array)
+          self.listings = value
+        end
       end
     end
 
@@ -125,11 +189,18 @@ module Repull
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
-          id == o.id &&
-          name == o.name &&
-          status == o.status &&
-          country == o.country &&
-          city == o.city
+          connection_id == o.connection_id &&
+          hotel_id == o.hotel_id &&
+          active == o.active &&
+          sync_enabled == o.sync_enabled &&
+          booking_url == o.booking_url &&
+          markup == o.markup &&
+          sync_category == o.sync_category &&
+          suspended_at == o.suspended_at &&
+          suspension_reason == o.suspension_reason &&
+          created_at == o.created_at &&
+          mapping_status == o.mapping_status &&
+          listings == o.listings
     end
 
     # @see the `==` method
@@ -141,7 +212,7 @@ module Repull
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [id, name, status, country, city].hash
+      [connection_id, hotel_id, active, sync_enabled, booking_url, markup, sync_category, suspended_at, suspension_reason, created_at, mapping_status, listings].hash
     end
 
     # Builds the object from hash