easypost 7.4.0 → 7.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1818317cd00bce2eb87d53600db69d6360f3058f801b468145824588ccd8c3f7
-  data.tar.gz: 5c84f10ef3bbb23b0b27373c6b52dcb5e9578cdf7caed6c1e73736561ad5afe8
+  metadata.gz: 0fea5a7b6c529207dce7950344ebfa7dacab20a5a03b89c20b9204f905226504
+  data.tar.gz: ccd5ee4596fbf4a4f3d52452a93984ed5774ab4b74d76e82c4b4fa8a77a8b836
 SHA512:
-  metadata.gz: 16d6abe782e6607bad93751ec128b8ff536f5286e9311ecefce68eb3b7d5adba14f898ad813df6f2bd8b3a681a9b32a8daf15bad7258aa0cc21dd1540f2b7bd6
-  data.tar.gz: b3bfe47a25eab2732c9cbf80034518c303e788921109f9e7c731e6aecfeeb254fca6d25bbd093d92ec377106c75792d7c372226e16a883d8e78c3ed49428b871
+  metadata.gz: 6a28525b29aed5376549c00422989c6d200d0db98085d0b414f311395c02c8b49ad8bd053d7f10ce02bc2ef2c0d39ecb9b627b2e24062d9c53e33db8033b0251
+  data.tar.gz: 3192c31ca964081536029824c38b5c7d942893a7fb798118495bfec3e616da789950befd5b201f372892af6ef53376408a6c8b965bbf30098b9e5e217c0772de

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # CHANGELOG
 
+## v7.6.0 (2026-02-25)
+
+- Adds generic `make_api_call` function
+
+## v7.5.0 (2026-02-20)
+
+- Adds the following functions:
+  - `fedex_registration.register_address`
+  - `fedex_registration.request_pin`
+  - `fedex_registration.validate_pin`
+  - `fedex_registration.submit_invoice`
+
 ## v7.4.0 (2026-02-02)
 
 - Adds the following functions usable by child and referral customer users:

data/VERSION

@@ -1 +1 @@
-7.4.0
+7.6.0

data/lib/easypost/client.rb

@@ -49,6 +49,7 @@ class EasyPost::Client
     EasyPost::Services::Embeddable,
     EasyPost::Services::EndShipper,
     EasyPost::Services::Event,
+    EasyPost::Services::FedexRegistration,
     EasyPost::Services::Insurance,
     EasyPost::Services::Luma,
     EasyPost::Services::Order,
@@ -143,6 +144,22 @@ class EasyPost::Client
     EasyPost::Hooks.unsubscribe_all(:response)
   end
 
+  # Make an API call to the EasyPost API
+  #
+  # This public, generic interface is useful for making arbitrary API calls to the EasyPost API that
+  # are not yet supported by the client library's services. When possible, the service for your use case
+  # should be used instead as it provides a more convenient and higher-level interface depending on the endpoint.
+  #
+  # @param method [Symbol] the HTTP Verb (get, post, put, patch, delete, etc.)
+  # @param endpoint [String] URI path of the resource
+  # @param params [Object] (nil) object to be used as the request parameters
+  # @return [EasyPost::Models::EasyPostObject] EasyPost object parsed from the response body
+  def make_api_call(method, endpoint, params = nil)
+    response = make_request(method, endpoint, params)
+
+    EasyPost::InternalUtilities::Json.convert_json_to_object(response)
+  end
+
   private
 
   def http_config

data/lib/easypost/services/fedex_registration.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+require 'securerandom'
+
+class EasyPost::Services::FedexRegistration < EasyPost::Services::Service
+  # Register the billing address for a FedEx account.
+  def register_address(fedex_account_number, params = {})
+    wrapped_params = wrap_address_validation(params)
+    endpoint = "fedex_registrations/#{fedex_account_number}/address"
+
+    response = @client.make_request(:post, endpoint, wrapped_params)
+
+    EasyPost::InternalUtilities::Json.convert_json_to_object(response, EasyPost::Models::EasyPostObject)
+  end
+
+  # Request a PIN for FedEx account verification.
+  def request_pin(fedex_account_number, pin_method_option)
+    wrapped_params = {
+      pin_method: {
+        option: pin_method_option,
+      },
+    }
+    endpoint = "fedex_registrations/#{fedex_account_number}/pin"
+
+    response = @client.make_request(:post, endpoint, wrapped_params)
+
+    EasyPost::InternalUtilities::Json.convert_json_to_object(response, EasyPost::Models::EasyPostObject)
+  end
+
+  # Validate the PIN entered by the user for FedEx account verification.
+  def validate_pin(fedex_account_number, params = {})
+    wrapped_params = wrap_pin_validation(params)
+    endpoint = "fedex_registrations/#{fedex_account_number}/pin/validate"
+
+    response = @client.make_request(:post, endpoint, wrapped_params)
+
+    EasyPost::InternalUtilities::Json.convert_json_to_object(response, EasyPost::Models::EasyPostObject)
+  end
+
+  # Submit invoice information to complete FedEx account registration.
+  def submit_invoice(fedex_account_number, params = {})
+    wrapped_params = wrap_invoice_validation(params)
+    endpoint = "fedex_registrations/#{fedex_account_number}/invoice"
+
+    response = @client.make_request(:post, endpoint, wrapped_params)
+
+    EasyPost::InternalUtilities::Json.convert_json_to_object(response, EasyPost::Models::EasyPostObject)
+  end
+
+  private
+
+  # Wraps address validation parameters and ensures the "name" field exists.
+  # If not present, generates a UUID (with hyphens removed) as the name.
+  def wrap_address_validation(params)
+    wrapped_params = {}
+
+    if params.key?(:address_validation)
+      address_validation = params[:address_validation].dup
+      ensure_name_field(address_validation)
+      wrapped_params[:address_validation] = address_validation
+    end
+
+    wrapped_params[:easypost_details] = params[:easypost_details] if params.key?(:easypost_details)
+
+    wrapped_params
+  end
+
+  # Wraps PIN validation parameters and ensures the "name" field exists.
+  # If not present, generates a UUID (with hyphens removed) as the name.
+  def wrap_pin_validation(params)
+    wrapped_params = {}
+
+    if params.key?(:pin_validation)
+      pin_validation = params[:pin_validation].dup
+      ensure_name_field(pin_validation)
+      wrapped_params[:pin_validation] = pin_validation
+    end
+
+    wrapped_params[:easypost_details] = params[:easypost_details] if params.key?(:easypost_details)
+
+    wrapped_params
+  end
+
+  # Wraps invoice validation parameters and ensures the "name" field exists.
+  # If not present, generates a UUID (with hyphens removed) as the name.
+  def wrap_invoice_validation(params)
+    wrapped_params = {}
+
+    if params.key?(:invoice_validation)
+      invoice_validation = params[:invoice_validation].dup
+      ensure_name_field(invoice_validation)
+      wrapped_params[:invoice_validation] = invoice_validation
+    end
+
+    wrapped_params[:easypost_details] = params[:easypost_details] if params.key?(:easypost_details)
+
+    wrapped_params
+  end
+
+  # Ensures the "name" field exists in the provided hash.
+  # If not present, generates a UUID (with hyphens removed) as the name.
+  # This follows the pattern used in the web UI implementation.
+  def ensure_name_field(hash)
+    return if hash.key?(:name) && !hash[:name].nil?
+
+    uuid = SecureRandom.uuid.delete('-')
+    hash[:name] = uuid
+  end
+end

data/lib/easypost/services.rb

@@ -21,6 +21,7 @@ require_relative 'services/customs_item'
 require_relative 'services/embeddable'
 require_relative 'services/end_shipper'
 require_relative 'services/event'
+require_relative 'services/fedex_registration'
 require_relative 'services/insurance'
 require_relative 'services/luma'
 require_relative 'services/order'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: easypost
 version: !ruby/object:Gem::Version
-  version: 7.4.0
+  version: 7.6.0
 platform: ruby
 authors:
 - EasyPost Developers
@@ -356,6 +356,7 @@ files:
 - lib/easypost/services/embeddable.rb
 - lib/easypost/services/end_shipper.rb
 - lib/easypost/services/event.rb
+- lib/easypost/services/fedex_registration.rb
 - lib/easypost/services/insurance.rb
 - lib/easypost/services/luma.rb
 - lib/easypost/services/order.rb