late-sdk 0.0.903 → 0.0.904

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a44c184ab32f70baa94e8c71c5c0624a8c85f15950070dcaf774d6405f2221f
-  data.tar.gz: becc8336d74f782fcaa2c255d7b2c8ee9c7cc1089289eeed7a2582afe10cf69f
+  metadata.gz: c0e7e92a18a0b4ffef10dc9526ff7f50aef4136b4706e646cf50bd57757ec768
+  data.tar.gz: 9a416747623893629b1f70bd2e6bdc0929de2319b915cee948a4b4bf19e729ab
 SHA512:
-  metadata.gz: 658132e4ecf5f3fb0b3030be63856e6f203fd1b2fab6f520600a8a8e19b1e16f6d08466cc94bbde9d184a8a4f973904f9ca41453e873efd47faeac0983bdb9e4
-  data.tar.gz: 52a072a538b01ac58a4cc0aba3d5be383be2ebe3c99e9cb7f216c68ee4772ddadc81c2bb567be596772fc817ad7f8323739d3e48a7506cdb20854980236b5018
+  metadata.gz: 0d39b519f7cd61826546aaf7a9fa41fd4a7540d094da5c179af6448758e89c88bf1530255d1ff47496314957055e8ec80545c6ee60865418a433501e06030b24
+  data.tar.gz: 4133f345fc4e8efb6ea5fa6994d29470dd356371787993cb24d7cd19272df54c4fb0320694e585389d24037f83469f057cc94c27aac8a8c1ed4986f3f6513c58

data/docs/CheckPhoneNumberAvailability200Response.md

@@ -7,6 +7,7 @@
 | **country** | **String** |  | [optional] |
 | **number_type** | **String** |  | [optional] |
 | **available** | **Boolean** | Whether deliverable voice inventory exists right now. | [optional] |
+| **pre_orderable** | **Boolean** | Nothing deliverable now, but this pair can be pre-ordered: submit KYC as usual and the carrier sources the number after review (usually about 3 weeks, never guaranteed). Only document tiers (3/4) qualify. | [optional] |
 | **address_constraint** | **String** |  | [optional] |
 | **areas** | **Array<String>** | For `geo` only: the area(s) the registered address must be in. | [optional] |
 | **area_options** | [**Array<CheckPhoneNumberAvailability200ResponseAreaOptionsInner>**](CheckPhoneNumberAvailability200ResponseAreaOptionsInner.md) | Live inventory grouped by area code. For US and CA this is the full country inventory (every area code with stock, recognizable metros listed first, then alphabetical); other countries are ordered largest stock first; they list the areas in the latest inventory page (up to 500 numbers, which for most countries is the entire pool). Empty when out of stock (or the area lookup failed). Pass a chosen `ndc` as `areaCode` on POST /v1/phone-numbers/purchase (or on the KYC submit for regulated countries) to require that area.  | [optional] |
@@ -20,6 +21,7 @@ instance = Zernio::CheckPhoneNumberAvailability200Response.new(
   country: null,
   number_type: null,
   available: null,
+  pre_orderable: null,
   address_constraint: null,
   areas: null,
   area_options: null

data/docs/ListPhoneNumberCountries200ResponseCountriesInner.md

@@ -13,6 +13,7 @@
 | **sms_available** | **Boolean** | Whether this country's number type can do SMS. Use it to filter the picker when the buyer wants SMS (pair with `wantsSms` on purchase). | [optional] |
 | **outbound_calling_available** | **Boolean** | WhatsApp Business Calling (BIC) outbound availability, a Meta feature blocked in some countries. NOT the PSTN Calls feature (`callsAvailable`). | [optional] |
 | **in_stock** | **Boolean** | Live carrier-stock snapshot (refreshed every 6h + on availability checks): false when NO offered type currently has deliverable inventory, so a purchase would fail. Treat as advisory; the purchase itself re-checks. | [optional] |
+| **pre_orderable** | **Boolean** | At least one out-of-stock type here can be pre-ordered (see `types[].preOrderable`). | [optional] |
 | **types** | [**Array<ListPhoneNumberCountries200ResponseCountriesInnerTypesInner>**](ListPhoneNumberCountries200ResponseCountriesInnerTypesInner.md) | Every number type offered in this country (default first). Capabilities, KYC tier, monthly price, and stock are per type. The country-level fields above mirror the first (default) entry. Pass the chosen `numberType` to POST /v1/phone-numbers/purchase.  | [optional] |
 
 ## Example
@@ -30,6 +31,7 @@ instance = Zernio::ListPhoneNumberCountries200ResponseCountriesInner.new(
   sms_available: null,
   outbound_calling_available: null,
   in_stock: null,
+  pre_orderable: null,
   types: null
 )
 ```

data/docs/ListPhoneNumberCountries200ResponseCountriesInnerTypesInner.md

@@ -5,13 +5,15 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **number_type** | **String** |  | [optional] |
-| **tier** | **Integer** |  | [optional] |
+| **tier** | **Integer** | Null on a `fulfilment: request` type, whose document tier is only known once its requirements are read. | [optional] |
 | **needs_kyc** | **Boolean** |  | [optional] |
 | **monthly_cents** | **Integer** | Price a NEW number of this type costs per month, in cents. | [optional] |
 | **whatsapp_available** | **Boolean** | Always false for toll_free (WhatsApp does not reliably register toll-free numbers). | [optional] |
 | **sms_available** | **Boolean** |  | [optional] |
 | **calls_available** | **Boolean** |  | [optional] |
 | **in_stock** | **Boolean** |  | [optional] |
+| **fulfilment** | **String** | `request`: the carrier stocks this type nowhere and only sources it to order, so it is always a pre-order. | [optional] |
+| **pre_orderable** | **Boolean** | Out of stock but orderable anyway. Submit KYC as usual (POST /v1/phone-numbers/kyc) and the carrier sources the number after review, usually about 3 weeks and never guaranteed. Only document tiers (3/4) qualify, and nothing is billed until the number is active. | [optional] |
 
 ## Example
 
@@ -26,7 +28,9 @@ instance = Zernio::ListPhoneNumberCountries200ResponseCountriesInnerTypesInner.n
   whatsapp_available: null,
   sms_available: null,
   calls_available: null,
-  in_stock: null
+  in_stock: null,
+  fulfilment: null,
+  pre_orderable: null
 )
 ```
 

data/docs/PhoneNumbersApi.md

@@ -391,7 +391,7 @@ end
 
 Watch an out-of-stock country
 
-Get notified the first time an out-of-stock country has deliverable numbers again: an email to the account holder plus the `phone_number.stock_available` webhook. Stock is re-checked every 6h. One watch per country and number type; a repeat request returns the existing watch (200). The watch is consumed when it fires, so re-create it if you miss the stock. Up to 20 watches at once.  Countries and types marked `fulfilment: request` by GET /v1/phone-numbers/countries can also be watched. Those are sourced by a carrier request rather than held in stock, so a watch records interest and no date is implied. 
+Get notified the first time an out-of-stock country has deliverable numbers again: an email to the account holder plus the `phone_number.stock_available` webhook. Stock is re-checked every 6h. One watch per country and number type; a repeat request returns the existing watch (200). The watch is consumed when it fires, so re-create it if you miss the stock. Up to 20 watches at once.  Countries and types marked `fulfilment: request` by GET /v1/phone-numbers/countries can also be watched, but anything with `preOrderable: true` does not need a watch: submit KYC and the carrier sources the number to order. 
 
 ### Examples
 

data/docs/SubmitPhoneNumberKyc200Response.md

@@ -5,6 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **status** | **String** |  | [optional] |
+| **pre_order** | **Boolean** | True when nothing was in stock and this submission placed a pre-order. The number stays `pending_regulatory` until the carrier sources it (usually about 3 weeks) and is not billed until active. A pre-order is one number: `quantity` above 1 is rejected with 400. | [optional] |
 | **phone_number** | [**SubmitPhoneNumberKyc200ResponsePhoneNumber**](SubmitPhoneNumberKyc200ResponsePhoneNumber.md) |  | [optional] |
 | **numbers** | [**Array<SubmitPhoneNumberKyc200ResponseNumbersInner>**](SubmitPhoneNumberKyc200ResponseNumbersInner.md) | Every number provisioned from this submission. Length equals the requested `quantity` on full success (fewer if some orders failed; best-effort). The first element mirrors `phoneNumber`. | [optional] |
 
@@ -15,6 +16,7 @@ require 'zernio-sdk'
 
 instance = Zernio::SubmitPhoneNumberKyc200Response.new(
   status: null,
+  pre_order: null,
   phone_number: null,
   numbers: null
 )

data/lib/zernio-sdk/api/phone_numbers_api.rb

@@ -361,7 +361,7 @@ module Zernio
     end
 
     # Watch an out-of-stock country
-    # Get notified the first time an out-of-stock country has deliverable numbers again: an email to the account holder plus the `phone_number.stock_available` webhook. Stock is re-checked every 6h. One watch per country and number type; a repeat request returns the existing watch (200). The watch is consumed when it fires, so re-create it if you miss the stock. Up to 20 watches at once.  Countries and types marked `fulfilment: request` by GET /v1/phone-numbers/countries can also be watched. Those are sourced by a carrier request rather than held in stock, so a watch records interest and no date is implied. 
+    # Get notified the first time an out-of-stock country has deliverable numbers again: an email to the account holder plus the `phone_number.stock_available` webhook. Stock is re-checked every 6h. One watch per country and number type; a repeat request returns the existing watch (200). The watch is consumed when it fires, so re-create it if you miss the stock. Up to 20 watches at once.  Countries and types marked `fulfilment: request` by GET /v1/phone-numbers/countries can also be watched, but anything with `preOrderable: true` does not need a watch: submit KYC and the carrier sources the number to order. 
     # @param create_phone_number_stock_watch_request [CreatePhoneNumberStockWatchRequest] 
     # @param [Hash] opts the optional parameters
     # @return [PhoneNumberStockWatch]
@@ -371,7 +371,7 @@ module Zernio
     end
 
     # Watch an out-of-stock country
-    # Get notified the first time an out-of-stock country has deliverable numbers again: an email to the account holder plus the `phone_number.stock_available` webhook. Stock is re-checked every 6h. One watch per country and number type; a repeat request returns the existing watch (200). The watch is consumed when it fires, so re-create it if you miss the stock. Up to 20 watches at once.  Countries and types marked `fulfilment: request` by GET /v1/phone-numbers/countries can also be watched. Those are sourced by a carrier request rather than held in stock, so a watch records interest and no date is implied. 
+    # Get notified the first time an out-of-stock country has deliverable numbers again: an email to the account holder plus the `phone_number.stock_available` webhook. Stock is re-checked every 6h. One watch per country and number type; a repeat request returns the existing watch (200). The watch is consumed when it fires, so re-create it if you miss the stock. Up to 20 watches at once.  Countries and types marked `fulfilment: request` by GET /v1/phone-numbers/countries can also be watched, but anything with `preOrderable: true` does not need a watch: submit KYC and the carrier sources the number to order. 
     # @param create_phone_number_stock_watch_request [CreatePhoneNumberStockWatchRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(PhoneNumberStockWatch, Integer, Hash)>] PhoneNumberStockWatch data, response status code and response headers

data/lib/zernio-sdk/models/check_phone_number_availability200_response.rb

@@ -22,6 +22,9 @@ module Zernio
     # Whether deliverable voice inventory exists right now.
     attr_accessor :available
 
+    # Nothing deliverable now, but this pair can be pre-ordered: submit KYC as usual and the carrier sources the number after review (usually about 3 weeks, never guaranteed). Only document tiers (3/4) qualify.
+    attr_accessor :pre_orderable
+
     attr_accessor :address_constraint
 
     # For `geo` only: the area(s) the registered address must be in.
@@ -58,6 +61,7 @@ module Zernio
         :'country' => :'country',
         :'number_type' => :'numberType',
         :'available' => :'available',
+        :'pre_orderable' => :'preOrderable',
         :'address_constraint' => :'addressConstraint',
         :'areas' => :'areas',
         :'area_options' => :'areaOptions'
@@ -80,6 +84,7 @@ module Zernio
         :'country' => :'String',
         :'number_type' => :'String',
         :'available' => :'Boolean',
+        :'pre_orderable' => :'Boolean',
         :'address_constraint' => :'String',
         :'areas' => :'Array<String>',
         :'area_options' => :'Array<CheckPhoneNumberAvailability200ResponseAreaOptionsInner>'
@@ -120,6 +125,10 @@ module Zernio
         self.available = attributes[:'available']
       end
 
+      if attributes.key?(:'pre_orderable')
+        self.pre_orderable = attributes[:'pre_orderable']
+      end
+
       if attributes.key?(:'address_constraint')
         self.address_constraint = attributes[:'address_constraint']
       end
@@ -172,6 +181,7 @@ module Zernio
           country == o.country &&
           number_type == o.number_type &&
           available == o.available &&
+          pre_orderable == o.pre_orderable &&
           address_constraint == o.address_constraint &&
           areas == o.areas &&
           area_options == o.area_options
@@ -186,7 +196,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [country, number_type, available, address_constraint, areas, area_options].hash
+      [country, number_type, available, pre_orderable, address_constraint, areas, area_options].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/models/list_phone_number_countries200_response_countries_inner.rb

@@ -40,6 +40,9 @@ module Zernio
     # Live carrier-stock snapshot (refreshed every 6h + on availability checks): false when NO offered type currently has deliverable inventory, so a purchase would fail. Treat as advisory; the purchase itself re-checks.
     attr_accessor :in_stock
 
+    # At least one out-of-stock type here can be pre-ordered (see `types[].preOrderable`).
+    attr_accessor :pre_orderable
+
     # Every number type offered in this country (default first). Capabilities, KYC tier, monthly price, and stock are per type. The country-level fields above mirror the first (default) entry. Pass the chosen `numberType` to POST /v1/phone-numbers/purchase. 
     attr_accessor :types
 
@@ -77,6 +80,7 @@ module Zernio
         :'sms_available' => :'smsAvailable',
         :'outbound_calling_available' => :'outboundCallingAvailable',
         :'in_stock' => :'inStock',
+        :'pre_orderable' => :'preOrderable',
         :'types' => :'types'
       }
     end
@@ -103,6 +107,7 @@ module Zernio
         :'sms_available' => :'Boolean',
         :'outbound_calling_available' => :'Boolean',
         :'in_stock' => :'Boolean',
+        :'pre_orderable' => :'Boolean',
         :'types' => :'Array<ListPhoneNumberCountries200ResponseCountriesInnerTypesInner>'
       }
     end
@@ -165,6 +170,10 @@ module Zernio
         self.in_stock = attributes[:'in_stock']
       end
 
+      if attributes.key?(:'pre_orderable')
+        self.pre_orderable = attributes[:'pre_orderable']
+      end
+
       if attributes.key?(:'types')
         if (value = attributes[:'types']).is_a?(Array)
           self.types = value
@@ -213,6 +222,7 @@ module Zernio
           sms_available == o.sms_available &&
           outbound_calling_available == o.outbound_calling_available &&
           in_stock == o.in_stock &&
+          pre_orderable == o.pre_orderable &&
           types == o.types
     end
 
@@ -225,7 +235,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [code, tier, monthly_cents, needs_kyc, calls_available, whatsapp_available, sms_available, outbound_calling_available, in_stock, types].hash
+      [code, tier, monthly_cents, needs_kyc, calls_available, whatsapp_available, sms_available, outbound_calling_available, in_stock, pre_orderable, types].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/models/list_phone_number_countries200_response_countries_inner_types_inner.rb

@@ -17,6 +17,7 @@ module Zernio
   class ListPhoneNumberCountries200ResponseCountriesInnerTypesInner < ApiModelBase
     attr_accessor :number_type
 
+    # Null on a `fulfilment: request` type, whose document tier is only known once its requirements are read.
     attr_accessor :tier
 
     attr_accessor :needs_kyc
@@ -33,6 +34,12 @@ module Zernio
 
     attr_accessor :in_stock
 
+    # `request`: the carrier stocks this type nowhere and only sources it to order, so it is always a pre-order.
+    attr_accessor :fulfilment
+
+    # Out of stock but orderable anyway. Submit KYC as usual (POST /v1/phone-numbers/kyc) and the carrier sources the number after review, usually about 3 weeks and never guaranteed. Only document tiers (3/4) qualify, and nothing is billed until the number is active.
+    attr_accessor :pre_orderable
+
     class EnumAttributeValidator
       attr_reader :datatype
       attr_reader :allowable_values
@@ -65,7 +72,9 @@ module Zernio
         :'whatsapp_available' => :'whatsappAvailable',
         :'sms_available' => :'smsAvailable',
         :'calls_available' => :'callsAvailable',
-        :'in_stock' => :'inStock'
+        :'in_stock' => :'inStock',
+        :'fulfilment' => :'fulfilment',
+        :'pre_orderable' => :'preOrderable'
       }
     end
 
@@ -89,13 +98,16 @@ module Zernio
         :'whatsapp_available' => :'Boolean',
         :'sms_available' => :'Boolean',
         :'calls_available' => :'Boolean',
-        :'in_stock' => :'Boolean'
+        :'in_stock' => :'Boolean',
+        :'fulfilment' => :'String',
+        :'pre_orderable' => :'Boolean'
       }
     end
 
     # List of attributes with nullable: true
     def self.openapi_nullable
       Set.new([
+        :'tier',
       ])
     end
 
@@ -146,6 +158,14 @@ module Zernio
       if attributes.key?(:'in_stock')
         self.in_stock = attributes[:'in_stock']
       end
+
+      if attributes.key?(:'fulfilment')
+        self.fulfilment = attributes[:'fulfilment']
+      end
+
+      if attributes.key?(:'pre_orderable')
+        self.pre_orderable = attributes[:'pre_orderable']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -164,6 +184,8 @@ module Zernio
       return false unless number_type_validator.valid?(@number_type)
       tier_validator = EnumAttributeValidator.new('Integer', [1, 2, 3, 4])
       return false unless tier_validator.valid?(@tier)
+      fulfilment_validator = EnumAttributeValidator.new('String', ["instant", "request"])
+      return false unless fulfilment_validator.valid?(@fulfilment)
       true
     end
 
@@ -187,6 +209,16 @@ module Zernio
       @tier = tier
     end
 
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] fulfilment Object to be assigned
+    def fulfilment=(fulfilment)
+      validator = EnumAttributeValidator.new('String', ["instant", "request"])
+      unless validator.valid?(fulfilment)
+        fail ArgumentError, "invalid value for \"fulfilment\", must be one of #{validator.allowable_values}."
+      end
+      @fulfilment = fulfilment
+    end
+
     # Checks equality by comparing each attribute.
     # @param [Object] Object to be compared
     def ==(o)
@@ -199,7 +231,9 @@ module Zernio
           whatsapp_available == o.whatsapp_available &&
           sms_available == o.sms_available &&
           calls_available == o.calls_available &&
-          in_stock == o.in_stock
+          in_stock == o.in_stock &&
+          fulfilment == o.fulfilment &&
+          pre_orderable == o.pre_orderable
     end
 
     # @see the `==` method
@@ -211,7 +245,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [number_type, tier, needs_kyc, monthly_cents, whatsapp_available, sms_available, calls_available, in_stock].hash
+      [number_type, tier, needs_kyc, monthly_cents, whatsapp_available, sms_available, calls_available, in_stock, fulfilment, pre_orderable].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/models/submit_phone_number_kyc200_response.rb

@@ -17,6 +17,9 @@ module Zernio
   class SubmitPhoneNumberKyc200Response < ApiModelBase
     attr_accessor :status
 
+    # True when nothing was in stock and this submission placed a pre-order. The number stays `pending_regulatory` until the carrier sources it (usually about 3 weeks) and is not billed until active. A pre-order is one number: `quantity` above 1 is rejected with 400.
+    attr_accessor :pre_order
+
     attr_accessor :phone_number
 
     # Every number provisioned from this submission. Length equals the requested `quantity` on full success (fewer if some orders failed; best-effort). The first element mirrors `phoneNumber`.
@@ -48,6 +51,7 @@ module Zernio
     def self.attribute_map
       {
         :'status' => :'status',
+        :'pre_order' => :'preOrder',
         :'phone_number' => :'phoneNumber',
         :'numbers' => :'numbers'
       }
@@ -67,6 +71,7 @@ module Zernio
     def self.openapi_types
       {
         :'status' => :'String',
+        :'pre_order' => :'Boolean',
         :'phone_number' => :'SubmitPhoneNumberKyc200ResponsePhoneNumber',
         :'numbers' => :'Array<SubmitPhoneNumberKyc200ResponseNumbersInner>'
       }
@@ -98,6 +103,10 @@ module Zernio
         self.status = attributes[:'status']
       end
 
+      if attributes.key?(:'pre_order')
+        self.pre_order = attributes[:'pre_order']
+      end
+
       if attributes.key?(:'phone_number')
         self.phone_number = attributes[:'phone_number']
       end
@@ -142,6 +151,7 @@ module Zernio
       return true if self.equal?(o)
       self.class == o.class &&
           status == o.status &&
+          pre_order == o.pre_order &&
           phone_number == o.phone_number &&
           numbers == o.numbers
     end
@@ -155,7 +165,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [status, phone_number, numbers].hash
+      [status, pre_order, phone_number, numbers].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/version.rb

@@ -11,5 +11,5 @@ Generator version: 7.19.0
 =end
 
 module Zernio
-  VERSION = '0.0.903'
+  VERSION = '0.0.904'
 end

data/openapi.yaml

@@ -36148,6 +36148,7 @@ paths:
                         smsAvailable: { type: boolean, description: Whether this country's number type can do SMS. Use it to filter the picker when the buyer wants SMS (pair with `wantsSms` on purchase). }
                         outboundCallingAvailable: { type: boolean, description: "WhatsApp Business Calling (BIC) outbound availability, a Meta feature blocked in some countries. NOT the PSTN Calls feature (`callsAvailable`)." }
                         inStock: { type: boolean, description: "Live carrier-stock snapshot (refreshed every 6h + on availability checks): false when NO offered type currently has deliverable inventory, so a purchase would fail. Treat as advisory; the purchase itself re-checks." }
+                        preOrderable: { type: boolean, description: "At least one out-of-stock type here can be pre-ordered (see `types[].preOrderable`)." }
                         types:
                           type: array
                           description: >
@@ -36160,13 +36161,15 @@ paths:
                             type: object
                             properties:
                               numberType: { type: string, enum: [local, mobile, national, toll_free] }
-                              tier: { type: integer, enum: [1, 2, 3, 4] }
+                              tier: { type: [integer, "null"], enum: [1, 2, 3, 4, null], description: "Null on a `fulfilment: request` type, whose document tier is only known once its requirements are read." }
                               needsKyc: { type: boolean }
                               monthlyCents: { type: integer, description: "Price a NEW number of this type costs per month, in cents." }
                               whatsappAvailable: { type: boolean, description: "Always false for toll_free (WhatsApp does not reliably register toll-free numbers)." }
                               smsAvailable: { type: boolean }
                               callsAvailable: { type: boolean }
                               inStock: { type: boolean }
+                              fulfilment: { type: string, enum: [instant, request], description: "`request`: the carrier stocks this type nowhere and only sources it to order, so it is always a pre-order." }
+                              preOrderable: { type: boolean, description: "Out of stock but orderable anyway. Submit KYC as usual (POST /v1/phone-numbers/kyc) and the carrier sources the number after review, usually about 3 weeks and never guaranteed. Only document tiers (3/4) qualify, and nothing is billed until the number is active." }
         '401': { $ref: '#/components/responses/Unauthorized' }
 
   /v1/phone-numbers/available:
@@ -36245,6 +36248,7 @@ paths:
                   country: { type: string }
                   numberType: { type: string }
                   available: { type: boolean, description: Whether deliverable voice inventory exists right now. }
+                  preOrderable: { type: boolean, description: "Nothing deliverable now, but this pair can be pre-ordered: submit KYC as usual and the carrier sources the number after review (usually about 3 weeks, never guaranteed). Only document tiers (3/4) qualify." }
                   addressConstraint: { type: string, enum: [geo, country, none] }
                   areas:
                     type: array
@@ -36630,6 +36634,7 @@ paths:
                   country: { type: string }
                   numberType: { type: string }
                   available: { type: boolean, description: Whether deliverable voice inventory exists right now. }
+                  preOrderable: { type: boolean, description: "Nothing deliverable now, but this pair can be pre-ordered: submit KYC as usual and the carrier sources the number after review (usually about 3 weeks, never guaranteed). Only document tiers (3/4) qualify." }
                   addressConstraint: { type: string, enum: [geo, country, none] }
                   areas:
                     type: array
@@ -36814,6 +36819,7 @@ paths:
                 type: object
                 properties:
                   status: { type: string, enum: [kyc_submitted, kyc_reused, kyc_already_submitted] }
+                  preOrder: { type: boolean, description: "True when nothing was in stock and this submission placed a pre-order. The number stays `pending_regulatory` until the carrier sources it (usually about 3 weeks) and is not billed until active. A pre-order is one number: `quantity` above 1 is rejected with 400." }
                   phoneNumber:
                     type: object
                     description: The first/primary number, kept at the top level for backward compatibility. See `numbers` for the full set when `quantity` > 1.
@@ -37807,6 +37813,7 @@ paths:
                 type: object
                 properties:
                   status: { type: string, enum: [kyc_submitted, kyc_reused, kyc_already_submitted] }
+                  preOrder: { type: boolean, description: "True when nothing was in stock and this submission placed a pre-order. The number stays `pending_regulatory` until the carrier sources it (usually about 3 weeks) and is not billed until active. A pre-order is one number: `quantity` above 1 is rejected with 400." }
                   phoneNumber:
                     type: object
                     description: The first/primary number, kept at the top level for backward compatibility. See `numbers` for the full set when `quantity` > 1.
@@ -38279,9 +38286,9 @@ paths:
         it if you miss the stock. Up to 20 watches at once.
 
         Countries and types marked `fulfilment: request` by
-        GET /v1/phone-numbers/countries can also be watched. Those are sourced
-        by a carrier request rather than held in stock, so a watch records
-        interest and no date is implied.
+        GET /v1/phone-numbers/countries can also be watched, but anything with
+        `preOrderable: true` does not need a watch: submit KYC and the carrier
+        sources the number to order.
       security:
         - bearerAuth: []
       requestBody:

data/spec/api/phone_numbers_api_spec.rb

@@ -96,7 +96,7 @@ describe 'PhoneNumbersApi' do
 
   # unit tests for create_phone_number_stock_watch
   # Watch an out-of-stock country
-  # Get notified the first time an out-of-stock country has deliverable numbers again: an email to the account holder plus the `phone_number.stock_available` webhook. Stock is re-checked every 6h. One watch per country and number type; a repeat request returns the existing watch (200). The watch is consumed when it fires, so re-create it if you miss the stock. Up to 20 watches at once.  Countries and types marked `fulfilment: request` by GET /v1/phone-numbers/countries can also be watched. Those are sourced by a carrier request rather than held in stock, so a watch records interest and no date is implied. 
+  # Get notified the first time an out-of-stock country has deliverable numbers again: an email to the account holder plus the `phone_number.stock_available` webhook. Stock is re-checked every 6h. One watch per country and number type; a repeat request returns the existing watch (200). The watch is consumed when it fires, so re-create it if you miss the stock. Up to 20 watches at once.  Countries and types marked `fulfilment: request` by GET /v1/phone-numbers/countries can also be watched, but anything with `preOrderable: true` does not need a watch: submit KYC and the carrier sources the number to order. 
   # @param create_phone_number_stock_watch_request 
   # @param [Hash] opts the optional parameters
   # @return [PhoneNumberStockWatch]

data/spec/models/check_phone_number_availability200_response_spec.rb

@@ -45,6 +45,12 @@ describe Zernio::CheckPhoneNumberAvailability200Response do
     end
   end
 
+  describe 'test attribute "pre_orderable"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "address_constraint"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/list_phone_number_countries200_response_countries_inner_spec.rb

@@ -85,6 +85,12 @@ describe Zernio::ListPhoneNumberCountries200ResponseCountriesInner do
     end
   end
 
+  describe 'test attribute "pre_orderable"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "types"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/list_phone_number_countries200_response_countries_inner_types_inner_spec.rb

@@ -83,4 +83,20 @@ describe Zernio::ListPhoneNumberCountries200ResponseCountriesInnerTypesInner do
     end
   end
 
+  describe 'test attribute "fulfilment"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+      # validator = Petstore::EnumTest::EnumAttributeValidator.new('String', ["instant", "request"])
+      # validator.allowable_values.each do |value|
+      #   expect { instance.fulfilment = value }.not_to raise_error
+      # end
+    end
+  end
+
+  describe 'test attribute "pre_orderable"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
 end

data/spec/models/submit_phone_number_kyc200_response_spec.rb

@@ -37,6 +37,12 @@ describe Zernio::SubmitPhoneNumberKyc200Response do
     end
   end
 
+  describe 'test attribute "pre_order"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "phone_number"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: late-sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.903
+  version: 0.0.904
 platform: ruby
 authors:
 - OpenAPI-Generator
@@ -6274,7 +6274,7 @@ files:
 - spec/models/you_tube_video_retention_response_retention_curve_inner_spec.rb
 - spec/models/you_tube_video_retention_response_spec.rb
 - spec/spec_helper.rb
-- zernio-sdk-0.0.903.gem
+- zernio-sdk-0.0.904.gem
 - zernio-sdk.gemspec
 homepage: https://openapi-generator.tech
 licenses: