peddler 4.3.1 → 4.5.0

data/lib/peddler/apis/sales_v1.rb

@@ -53,13 +53,17 @@ module Peddler
       # @param sku [String] Filters the results by the SKU that you specify. Specifying both ASIN and SKU returns an
       #   error. Do not include this filter if you want the response to include order metrics for all SKUs. Example:
       #   TestSKU, if you want the response to include order metrics for only SKU TestSKU.
+      # @param amazon_program [String] Filters the results by the Amazon program that you specify. Do not include this
+      #   filter if you want the response to include order metrics for all programs. **Example:** `AmazonHaul` returns
+      #   order metrics for the Amazon Haul program only.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_order_metrics(marketplace_ids, interval, granularity, granularity_time_zone: nil, buyer_type: "All",
-        fulfillment_network: nil, first_day_of_week: "Monday", asin: nil, sku: nil, rate_limit: 0.5)
+        fulfillment_network: nil, first_day_of_week: "Monday", asin: nil, sku: nil, amazon_program: nil,
+        rate_limit: 0.5)
         path = "/sales/v1/orderMetrics"
         params = {
-          "marketplaceIds" => marketplace_ids,
+          "marketplaceIds" => stringify_array(marketplace_ids),
           "interval" => interval,
           "granularityTimeZone" => granularity_time_zone,
           "granularity" => granularity,
@@ -68,6 +72,7 @@ module Peddler
           "firstDayOfWeek" => first_day_of_week,
           "asin" => asin,
           "sku" => sku,
+          "amazonProgram" => amazon_program,
         }.compact
 
         meter(rate_limit).get(path, params:)

data/lib/peddler/apis/seller_wallet_2024_03_01.rb

@@ -38,7 +38,7 @@ module Peddler
       # @param account_id [String] The ID of the Amazon Seller Wallet account.
       # @return [Peddler::Response] The API response
       def get_account(account_id)
-        path = "/finances/transfers/wallet/2024-03-01/accounts/#{account_id}"
+        path = "/finances/transfers/wallet/2024-03-01/accounts/#{percent_encode(account_id)}"
 
         get(path)
       end
@@ -49,7 +49,7 @@ module Peddler
       # @param account_id [String] The ID of the Amazon Seller Wallet account.
       # @return [Peddler::Response] The API response
       def list_account_balances(account_id)
-        path = "/finances/transfers/wallet/2024-03-01/accounts/#{account_id}/balance"
+        path = "/finances/transfers/wallet/2024-03-01/accounts/#{percent_encode(account_id)}/balance"
 
         get(path)
       end
@@ -116,7 +116,7 @@ module Peddler
       # @param transaction_id [String] The ID of the Amazon Seller Wallet transaction.
       # @return [Peddler::Response] The API response
       def get_transaction(transaction_id)
-        path = "/finances/transfers/wallet/2024-03-01/transactions/#{transaction_id}"
+        path = "/finances/transfers/wallet/2024-03-01/transactions/#{percent_encode(transaction_id)}"
 
         get(path)
       end
@@ -174,7 +174,7 @@ module Peddler
       # @param transfer_schedule_id [String] The schedule ID of the Amazon Seller Wallet transfer.
       # @return [Peddler::Response] The API response
       def get_transfer_schedule(transfer_schedule_id)
-        path = "/finances/transfers/wallet/2024-03-01/transferSchedules/#{transfer_schedule_id}"
+        path = "/finances/transfers/wallet/2024-03-01/transferSchedules/#{percent_encode(transfer_schedule_id)}"
 
         get(path)
       end
@@ -186,7 +186,7 @@ module Peddler
       # @param transfer_schedule_id [String] A unique reference ID for a scheduled transfer.
       # @return [Peddler::Response] The API response
       def delete_schedule_transaction(transfer_schedule_id)
-        path = "/finances/transfers/wallet/2024-03-01/transferSchedules/#{transfer_schedule_id}"
+        path = "/finances/transfers/wallet/2024-03-01/transferSchedules/#{percent_encode(transfer_schedule_id)}"
 
         delete(path)
       end

data/lib/peddler/apis/services_v1.rb

@@ -22,7 +22,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_service_job_by_service_job_id(service_job_id, rate_limit: 20.0)
-        path = "/service/v1/serviceJobs/#{service_job_id}"
+        path = "/service/v1/serviceJobs/#{percent_encode(service_job_id)}"
 
         meter(rate_limit).get(path)
       end
@@ -36,7 +36,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def cancel_service_job_by_service_job_id(service_job_id, cancellation_reason_code, rate_limit: 5.0)
-        path = "/service/v1/serviceJobs/#{service_job_id}/cancellations"
+        path = "/service/v1/serviceJobs/#{percent_encode(service_job_id)}/cancellations"
         params = {
           "cancellationReasonCode" => cancellation_reason_code,
         }.compact
@@ -51,7 +51,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def complete_service_job_by_service_job_id(service_job_id, rate_limit: 5.0)
-        path = "/service/v1/serviceJobs/#{service_job_id}/completions"
+        path = "/service/v1/serviceJobs/#{percent_encode(service_job_id)}/completions"
 
         meter(rate_limit).put(path)
       end
@@ -97,8 +97,8 @@ module Peddler
         required_skills: nil, store_ids: nil, rate_limit: 10.0)
         path = "/service/v1/serviceJobs"
         params = {
-          "serviceOrderIds" => service_order_ids,
-          "serviceJobStatus" => service_job_status,
+          "serviceOrderIds" => stringify_array(service_order_ids),
+          "serviceJobStatus" => stringify_array(service_job_status),
           "pageToken" => page_token,
           "pageSize" => page_size,
           "sortField" => sort_field,
@@ -109,10 +109,10 @@ module Peddler
           "lastUpdatedBefore" => last_updated_before,
           "scheduleStartDate" => schedule_start_date,
           "scheduleEndDate" => schedule_end_date,
-          "marketplaceIds" => marketplace_ids,
-          "asins" => asins,
-          "requiredSkills" => required_skills,
-          "storeIds" => store_ids,
+          "marketplaceIds" => stringify_array(marketplace_ids),
+          "asins" => stringify_array(asins),
+          "requiredSkills" => stringify_array(required_skills),
+          "storeIds" => stringify_array(store_ids),
         }.compact
 
         meter(rate_limit).get(path, params:)
@@ -126,7 +126,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def add_appointment_for_service_job_by_service_job_id(service_job_id, body, rate_limit: 5.0)
-        path = "/service/v1/serviceJobs/#{service_job_id}/appointments"
+        path = "/service/v1/serviceJobs/#{percent_encode(service_job_id)}/appointments"
 
         meter(rate_limit).post(path, body:)
       end
@@ -141,7 +141,7 @@ module Peddler
       # @return [Peddler::Response] The API response
       def reschedule_appointment_for_service_job_by_service_job_id(service_job_id, appointment_id, body,
         rate_limit: 5.0)
-        path = "/service/v1/serviceJobs/#{service_job_id}/appointments/#{appointment_id}"
+        path = "/service/v1/serviceJobs/#{percent_encode(service_job_id)}/appointments/#{percent_encode(appointment_id)}"
 
         meter(rate_limit).post(path, body:)
       end
@@ -156,7 +156,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def assign_appointment_resources(service_job_id, appointment_id, body, rate_limit: 1.0)
-        path = "/service/v1/serviceJobs/#{service_job_id}/appointments/#{appointment_id}/resources"
+        path = "/service/v1/serviceJobs/#{percent_encode(service_job_id)}/appointments/#{percent_encode(appointment_id)}/resources"
 
         meter(rate_limit).put(path, body:)
       end
@@ -171,7 +171,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def set_appointment_fulfillment_data(service_job_id, appointment_id, body, rate_limit: 5.0)
-        path = "/service/v1/serviceJobs/#{service_job_id}/appointments/#{appointment_id}/fulfillment"
+        path = "/service/v1/serviceJobs/#{percent_encode(service_job_id)}/appointments/#{percent_encode(appointment_id)}/fulfillment"
 
         meter(rate_limit).put(path, body:)
       end
@@ -186,9 +186,9 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_range_slot_capacity(resource_id, body, marketplace_ids, next_page_token: nil, rate_limit: 5.0)
-        path = "/service/v1/serviceResources/#{resource_id}/capacity/range"
+        path = "/service/v1/serviceResources/#{percent_encode(resource_id)}/capacity/range"
         params = {
-          "marketplaceIds" => marketplace_ids,
+          "marketplaceIds" => stringify_array(marketplace_ids),
           "nextPageToken" => next_page_token,
         }.compact
 
@@ -205,9 +205,9 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_fixed_slot_capacity(resource_id, body, marketplace_ids, next_page_token: nil, rate_limit: 5.0)
-        path = "/service/v1/serviceResources/#{resource_id}/capacity/fixed"
+        path = "/service/v1/serviceResources/#{percent_encode(resource_id)}/capacity/fixed"
         params = {
-          "marketplaceIds" => marketplace_ids,
+          "marketplaceIds" => stringify_array(marketplace_ids),
           "nextPageToken" => next_page_token,
         }.compact
 
@@ -223,9 +223,9 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def update_schedule(resource_id, body, marketplace_ids, rate_limit: 5.0)
-        path = "/service/v1/serviceResources/#{resource_id}/schedules"
+        path = "/service/v1/serviceResources/#{percent_encode(resource_id)}/schedules"
         params = {
-          "marketplaceIds" => marketplace_ids,
+          "marketplaceIds" => stringify_array(marketplace_ids),
         }.compact
 
         meter(rate_limit).put(path, body:, params:)
@@ -241,7 +241,7 @@ module Peddler
       def create_reservation(body, marketplace_ids, rate_limit: 5.0)
         path = "/service/v1/reservation"
         params = {
-          "marketplaceIds" => marketplace_ids,
+          "marketplaceIds" => stringify_array(marketplace_ids),
         }.compact
 
         meter(rate_limit).post(path, body:, params:)
@@ -256,9 +256,9 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def update_reservation(reservation_id, body, marketplace_ids, rate_limit: 5.0)
-        path = "/service/v1/reservation/#{reservation_id}"
+        path = "/service/v1/reservation/#{percent_encode(reservation_id)}"
         params = {
-          "marketplaceIds" => marketplace_ids,
+          "marketplaceIds" => stringify_array(marketplace_ids),
         }.compact
 
         meter(rate_limit).put(path, body:, params:)
@@ -272,9 +272,9 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def cancel_reservation(reservation_id, marketplace_ids, rate_limit: 5.0)
-        path = "/service/v1/reservation/#{reservation_id}"
+        path = "/service/v1/reservation/#{percent_encode(reservation_id)}"
         params = {
-          "marketplaceIds" => marketplace_ids,
+          "marketplaceIds" => stringify_array(marketplace_ids),
         }.compact
 
         meter(rate_limit).delete(path, params:)
@@ -295,9 +295,9 @@ module Peddler
       # @return [Peddler::Response] The API response
       def get_appointmment_slots_by_job_id(service_job_id, marketplace_ids, start_time: nil, end_time: nil,
         rate_limit: 5.0)
-        path = "/service/v1/serviceJobs/#{service_job_id}/appointmentSlots"
+        path = "/service/v1/serviceJobs/#{percent_encode(service_job_id)}/appointmentSlots"
         params = {
-          "marketplaceIds" => marketplace_ids,
+          "marketplaceIds" => stringify_array(marketplace_ids),
           "startTime" => start_time,
           "endTime" => end_time,
         }.compact
@@ -324,7 +324,7 @@ module Peddler
         params = {
           "asin" => asin,
           "storeId" => store_id,
-          "marketplaceIds" => marketplace_ids,
+          "marketplaceIds" => stringify_array(marketplace_ids),
           "startTime" => start_time,
           "endTime" => end_time,
         }.compact

data/lib/peddler/apis/shipment_invoicing_v0.rb

@@ -25,7 +25,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_shipment_details(shipment_id, rate_limit: 1.133)
-        path = "/fba/outbound/brazil/v0/shipments/#{shipment_id}"
+        path = "/fba/outbound/brazil/v0/shipments/#{percent_encode(shipment_id)}"
 
         meter(rate_limit).get(path)
       end
@@ -38,7 +38,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def submit_invoice(shipment_id, body, rate_limit: 1.133)
-        path = "/fba/outbound/brazil/v0/shipments/#{shipment_id}/invoice"
+        path = "/fba/outbound/brazil/v0/shipments/#{percent_encode(shipment_id)}/invoice"
 
         meter(rate_limit).post(path, body:)
       end
@@ -50,7 +50,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_invoice_status(shipment_id, rate_limit: 1.133)
-        path = "/fba/outbound/brazil/v0/shipments/#{shipment_id}/invoice/status"
+        path = "/fba/outbound/brazil/v0/shipments/#{percent_encode(shipment_id)}/invoice/status"
 
         meter(rate_limit).get(path)
       end

data/lib/peddler/apis/shipping_v1.rb

@@ -37,7 +37,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_shipment(shipment_id, rate_limit: 5.0)
-        path = "/shipping/v1/shipments/#{shipment_id}"
+        path = "/shipping/v1/shipments/#{percent_encode(shipment_id)}"
 
         meter(rate_limit).get(path)
       end
@@ -49,7 +49,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def cancel_shipment(shipment_id, rate_limit: 5.0)
-        path = "/shipping/v1/shipments/#{shipment_id}/cancel"
+        path = "/shipping/v1/shipments/#{percent_encode(shipment_id)}/cancel"
 
         meter(rate_limit).post(path)
       end
@@ -62,7 +62,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def purchase_labels(shipment_id, body, rate_limit: 5.0)
-        path = "/shipping/v1/shipments/#{shipment_id}/purchaseLabels"
+        path = "/shipping/v1/shipments/#{percent_encode(shipment_id)}/purchaseLabels"
 
         meter(rate_limit).post(path, body:)
       end
@@ -76,7 +76,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def retrieve_shipping_label(shipment_id, tracking_id, body, rate_limit: 5.0)
-        path = "/shipping/v1/shipments/#{shipment_id}/containers/#{tracking_id}/label"
+        path = "/shipping/v1/shipments/#{percent_encode(shipment_id)}/containers/#{percent_encode(tracking_id)}/label"
 
         meter(rate_limit).post(path, body:)
       end
@@ -123,7 +123,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_tracking_information(tracking_id, rate_limit: 1.0)
-        path = "/shipping/v1/tracking/#{tracking_id}"
+        path = "/shipping/v1/tracking/#{percent_encode(tracking_id)}"
 
         meter(rate_limit).get(path)
       end

data/lib/peddler/apis/shipping_v2.rb

@@ -121,7 +121,7 @@ module Peddler
       # @return [Peddler::Response] The API response
       def get_shipment_documents(shipment_id, package_client_reference_id, format: nil, dpi: nil,
         x_amzn_shipping_business_id: nil, rate_limit: 80.0)
-        path = "/shipping/v2/shipments/#{shipment_id}/documents"
+        path = "/shipping/v2/shipments/#{percent_encode(shipment_id)}/documents"
         params = {
           "packageClientReferenceId" => package_client_reference_id,
           "format" => format,
@@ -140,7 +140,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def cancel_shipment(shipment_id, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
-        path = "/shipping/v2/shipments/#{shipment_id}/cancel"
+        path = "/shipping/v2/shipments/#{percent_encode(shipment_id)}/cancel"
 
         meter(rate_limit).put(path)
       end
@@ -206,7 +206,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def link_carrier_account(carrier_id, body, x_amzn_shipping_business_id: nil, rate_limit: 5.0)
-        path = "/shipping/v2/carrierAccounts/#{carrier_id}"
+        path = "/shipping/v2/carrierAccounts/#{percent_encode(carrier_id)}"
 
         meter(rate_limit).post(path, body:)
       end
@@ -222,7 +222,7 @@ module Peddler
       def unlink_carrier_account(carrier_id, body, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
         cannot_sandbox!
 
-        path = "/shipping/v2/carrierAccounts/#{carrier_id}/unlink"
+        path = "/shipping/v2/carrierAccounts/#{percent_encode(carrier_id)}/unlink"
 
         meter(rate_limit).put(path, body:)
       end
@@ -286,7 +286,7 @@ module Peddler
       def get_collection_form(collection_form_id, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
         cannot_sandbox!
 
-        path = "/shipping/v2/collectionForms/#{collection_form_id}"
+        path = "/shipping/v2/collectionForms/#{percent_encode(collection_form_id)}"
 
         meter(rate_limit).get(path)
       end
@@ -305,7 +305,7 @@ module Peddler
         rate_limit: 80.0)
         path = "/shipping/v2/accessPoints"
         params = {
-          "accessPointTypes" => access_point_types,
+          "accessPointTypes" => stringify_array(access_point_types),
           "countryCode" => country_code,
           "postalCode" => postal_code,
         }.compact

data/lib/peddler/apis/solicitations_v1.rb

@@ -32,9 +32,9 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_solicitation_actions_for_order(amazon_order_id, marketplace_ids, rate_limit: 1.0)
-        path = "/solicitations/v1/orders/#{amazon_order_id}"
+        path = "/solicitations/v1/orders/#{percent_encode(amazon_order_id)}"
         params = {
-          "marketplaceIds" => marketplace_ids,
+          "marketplaceIds" => stringify_array(marketplace_ids),
         }.compact
 
         meter(rate_limit).get(path, params:)
@@ -51,9 +51,9 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def create_product_review_and_seller_feedback_solicitation(amazon_order_id, marketplace_ids, rate_limit: 1.0)
-        path = "/solicitations/v1/orders/#{amazon_order_id}/solicitations/productReviewAndSellerFeedback"
+        path = "/solicitations/v1/orders/#{percent_encode(amazon_order_id)}/solicitations/productReviewAndSellerFeedback"
         params = {
-          "marketplaceIds" => marketplace_ids,
+          "marketplaceIds" => stringify_array(marketplace_ids),
         }.compact
 
         meter(rate_limit).post(path, params:)

data/lib/peddler/apis/supply_sources_2020_07_01.rb

@@ -48,7 +48,7 @@ module Peddler
       # @param supply_source_id [String] The unique identifier of a supply source.
       # @return [Peddler::Response] The API response
       def get_supply_source(supply_source_id)
-        path = "/supplySources/2020-07-01/supplySources/#{supply_source_id}"
+        path = "/supplySources/2020-07-01/supplySources/#{percent_encode(supply_source_id)}"
 
         get(path)
       end
@@ -60,7 +60,7 @@ module Peddler
       # @param payload [Hash]
       # @return [Peddler::Response] The API response
       def update_supply_source(supply_source_id, payload: nil)
-        path = "/supplySources/2020-07-01/supplySources/#{supply_source_id}"
+        path = "/supplySources/2020-07-01/supplySources/#{percent_encode(supply_source_id)}"
         body = payload
 
         put(path, body:)
@@ -72,7 +72,7 @@ module Peddler
       # @param supply_source_id [String] The unique identifier of a supply source.
       # @return [Peddler::Response] The API response
       def archive_supply_source(supply_source_id)
-        path = "/supplySources/2020-07-01/supplySources/#{supply_source_id}"
+        path = "/supplySources/2020-07-01/supplySources/#{percent_encode(supply_source_id)}"
 
         delete(path)
       end
@@ -84,7 +84,7 @@ module Peddler
       # @param payload [Hash]
       # @return [Peddler::Response] The API response
       def update_supply_source_status(supply_source_id, payload: nil)
-        path = "/supplySources/2020-07-01/supplySources/#{supply_source_id}/status"
+        path = "/supplySources/2020-07-01/supplySources/#{percent_encode(supply_source_id)}/status"
         body = payload
 
         put(path, body:)

data/lib/peddler/apis/uploads_2020_11_01.rb

@@ -37,9 +37,9 @@ module Peddler
         rate_limit: 10.0)
         cannot_sandbox!
 
-        path = "/uploads/2020-11-01/uploadDestinations/#{resource}"
+        path = "/uploads/2020-11-01/uploadDestinations/#{percent_encode(resource)}"
         params = {
-          "marketplaceIds" => marketplace_ids,
+          "marketplaceIds" => stringify_array(marketplace_ids),
           "contentMD5" => content_md5,
           "contentType" => content_type,
         }.compact

data/lib/peddler/apis/vendor_direct_fulfillment_inventory_v1.rb

@@ -23,7 +23,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def submit_inventory_update(body, warehouse_id, rate_limit: 10.0)
-        path = "/vendor/directFulfillment/inventory/v1/warehouses/#{warehouse_id}/items"
+        path = "/vendor/directFulfillment/inventory/v1/warehouses/#{percent_encode(warehouse_id)}/items"
 
         meter(rate_limit).post(path, body:)
       end

data/lib/peddler/apis/vendor_direct_fulfillment_orders_2021_12_28.rb

@@ -63,7 +63,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_order(purchase_order_number, rate_limit: 10.0)
-        path = "/vendor/directFulfillment/orders/2021-12-28/purchaseOrders/#{purchase_order_number}"
+        path = "/vendor/directFulfillment/orders/2021-12-28/purchaseOrders/#{percent_encode(purchase_order_number)}"
 
         meter(rate_limit).get(path)
       end

data/lib/peddler/apis/vendor_direct_fulfillment_orders_v1.rb

@@ -63,7 +63,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_order(purchase_order_number, rate_limit: 10.0)
-        path = "/vendor/directFulfillment/orders/v1/purchaseOrders/#{purchase_order_number}"
+        path = "/vendor/directFulfillment/orders/v1/purchaseOrders/#{percent_encode(purchase_order_number)}"
 
         meter(rate_limit).get(path)
       end

data/lib/peddler/apis/vendor_direct_fulfillment_sandbox_test_data_2021_10_28.rb

@@ -34,7 +34,7 @@ module Peddler
       #   operation.
       # @return [Peddler::Response] The API response
       def get_order_scenarios(transaction_id)
-        path = "/vendor/directFulfillment/sandbox/2021-10-28/transactions/#{transaction_id}"
+        path = "/vendor/directFulfillment/sandbox/2021-10-28/transactions/#{percent_encode(transaction_id)}"
 
         get(path)
       end

data/lib/peddler/apis/vendor_direct_fulfillment_shipping_2021_12_28.rb

@@ -68,7 +68,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_shipping_label(purchase_order_number, rate_limit: 10.0)
-        path = "/vendor/directFulfillment/shipping/2021-12-28/shippingLabels/#{purchase_order_number}"
+        path = "/vendor/directFulfillment/shipping/2021-12-28/shippingLabels/#{percent_encode(purchase_order_number)}"
 
         meter(rate_limit).get(path)
       end
@@ -82,7 +82,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def create_shipping_labels(purchase_order_number, body, rate_limit: 10.0)
-        path = "/vendor/directFulfillment/shipping/2021-12-28/shippingLabels/#{purchase_order_number}"
+        path = "/vendor/directFulfillment/shipping/2021-12-28/shippingLabels/#{percent_encode(purchase_order_number)}"
 
         meter(rate_limit).post(path, body:)
       end
@@ -152,7 +152,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_customer_invoice(purchase_order_number, rate_limit: 10.0)
-        path = "/vendor/directFulfillment/shipping/2021-12-28/customerInvoices/#{purchase_order_number}"
+        path = "/vendor/directFulfillment/shipping/2021-12-28/customerInvoices/#{percent_encode(purchase_order_number)}"
 
         meter(rate_limit).get(path)
       end
@@ -195,7 +195,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_packing_slip(purchase_order_number, rate_limit: 10.0)
-        path = "/vendor/directFulfillment/shipping/2021-12-28/packingSlips/#{purchase_order_number}"
+        path = "/vendor/directFulfillment/shipping/2021-12-28/packingSlips/#{percent_encode(purchase_order_number)}"
 
         meter(rate_limit).get(path)
       end

data/lib/peddler/apis/vendor_direct_fulfillment_shipping_v1.rb

@@ -67,7 +67,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_shipping_label(purchase_order_number, rate_limit: 10.0)
-        path = "/vendor/directFulfillment/shipping/v1/shippingLabels/#{purchase_order_number}"
+        path = "/vendor/directFulfillment/shipping/v1/shippingLabels/#{percent_encode(purchase_order_number)}"
 
         meter(rate_limit).get(path)
       end
@@ -137,7 +137,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_customer_invoice(purchase_order_number, rate_limit: 10.0)
-        path = "/vendor/directFulfillment/shipping/v1/customerInvoices/#{purchase_order_number}"
+        path = "/vendor/directFulfillment/shipping/v1/customerInvoices/#{percent_encode(purchase_order_number)}"
 
         meter(rate_limit).get(path)
       end
@@ -180,7 +180,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_packing_slip(purchase_order_number, rate_limit: 10.0)
-        path = "/vendor/directFulfillment/shipping/v1/packingSlips/#{purchase_order_number}"
+        path = "/vendor/directFulfillment/shipping/v1/packingSlips/#{percent_encode(purchase_order_number)}"
 
         meter(rate_limit).get(path)
       end

data/lib/peddler/apis/vendor_direct_fulfillment_transactions_2021_12_28.rb

@@ -23,7 +23,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_transaction_status(transaction_id, rate_limit: 10.0)
-        path = "/vendor/directFulfillment/transactions/2021-12-28/transactions/#{transaction_id}"
+        path = "/vendor/directFulfillment/transactions/2021-12-28/transactions/#{percent_encode(transaction_id)}"
 
         meter(rate_limit).get(path)
       end

data/lib/peddler/apis/vendor_direct_fulfillment_transactions_v1.rb

@@ -23,7 +23,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_transaction_status(transaction_id, rate_limit: 10.0)
-        path = "/vendor/directFulfillment/transactions/v1/transactions/#{transaction_id}"
+        path = "/vendor/directFulfillment/transactions/v1/transactions/#{percent_encode(transaction_id)}"
 
         meter(rate_limit).get(path)
       end

data/lib/peddler/apis/vendor_orders_v1.rb

@@ -78,7 +78,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_purchase_order(purchase_order_number, rate_limit: 10.0)
-        path = "/vendor/orders/v1/purchaseOrders/#{purchase_order_number}"
+        path = "/vendor/orders/v1/purchaseOrders/#{percent_encode(purchase_order_number)}"
 
         meter(rate_limit).get(path)
       end

data/lib/peddler/apis/vendor_shipments_v1.rb

@@ -132,7 +132,7 @@ module Peddler
       #
       # @param limit [Integer] The limit to the number of records returned. Default value is 50 records.
       # @param sort_order [String] Sort the list by shipment label creation date in ascending or descending order.
-      # @param next_token [String] A token that is used to retrieve the next page of results. The response includes
+      # @param next_token [String] A token that you use to retrieve the next page of results. The response includes
       #   `nextToken` when the number of results exceeds the specified `pageSize` value. To get the next page of
       #   results, call the operation with this token and include the same arguments as the call that produced the
       #   token. To get a complete list, call this operation until `nextToken` is null. Note that this operation can

data/lib/peddler/apis/vendor_transaction_status_v1.rb

@@ -24,7 +24,7 @@ module Peddler
       def get_transaction(transaction_id, rate_limit: 10.0)
         cannot_sandbox!
 
-        path = "/vendor/transactions/v1/transactions/#{transaction_id}"
+        path = "/vendor/transactions/v1/transactions/#{percent_encode(transaction_id)}"
 
         meter(rate_limit).get(path)
       end

data/lib/peddler/config.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Peddler
+  class << self
+    attr_writer :raise_on_server_errors
+
+    def raise_on_server_errors
+      return @raise_on_server_errors if defined?(@raise_on_server_errors)
+
+      @raise_on_server_errors = false # Default to v4 behavior
+    end
+
+    def configure
+      yield self
+    end
+  end
+end