@spec retrieve_available_shipping_options(String.t(), nil | String.t()) ::
  {:ok, list()} | {:error, any()}

@spec retrieve_flat_rate_shipping_options(integer(), String.t(), nil | String.t()) ::
  {:ok, map()} | {:error, any()}

@spec retrieve_order_quantity_shipping_options(
  integer(),
  String.t(),
  nil | String.t()
) ::
  {:ok, map()} | {:error, any()}

@spec retrieve_order_shipping_options(integer(), String.t(), nil | String.t()) ::
  {:ok, list()} | {:error, any()}

@spec retrieve_order_shipping_ranges(integer(), String.t(), nil | String.t()) ::
  {:ok, list()} | {:error, any()}

@spec retrieve_product_shipping_options(integer(), String.t(), nil | String.t()) ::
  {:ok, map()} | {:error, any()}

@spec retrieve_ups_shipping_option(integer(), String.t(), nil | String.t()) ::
  {:ok, map()} | {:error, any()}

@spec retrieve_weight_based_shipping_options(integer(), String.t(), nil | String.t()) ::
  {:ok, map()} | {:error, any()}