easypost 7.4.0 → 7.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1818317cd00bce2eb87d53600db69d6360f3058f801b468145824588ccd8c3f7
-  data.tar.gz: 5c84f10ef3bbb23b0b27373c6b52dcb5e9578cdf7caed6c1e73736561ad5afe8
+  metadata.gz: c1c914f092b06f13332e656663b1650c734f8de6509ac8c45fd509900c7db938
+  data.tar.gz: b553d86880fe21e4619f8cb7982f720d9ca3ae646f23b66be5d569fae59fa8dc
 SHA512:
-  metadata.gz: 16d6abe782e6607bad93751ec128b8ff536f5286e9311ecefce68eb3b7d5adba14f898ad813df6f2bd8b3a681a9b32a8daf15bad7258aa0cc21dd1540f2b7bd6
-  data.tar.gz: b3bfe47a25eab2732c9cbf80034518c303e788921109f9e7c731e6aecfeeb254fca6d25bbd093d92ec377106c75792d7c372226e16a883d8e78c3ed49428b871
+  metadata.gz: 5678236ab51f3f63418917820b3ba92e67e7bbefe6cb8d4d312660925d3da8d9d8667ee204fdbffaecb2a283a4ce31433dcd4e92c715be3a69fc96ca77df67cf
+  data.tar.gz: 3e42754c66996261979f938cbed8b8472ce9f9ec8b50407621bbedbf43d3fc565bb6052998570a85509efb0eda981ce7fab80c8f1799c561149d6a7f5eeaf0f7

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # CHANGELOG
 
+## 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.5.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,

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.5.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