peddler 3.0.0.beta1 → 4.0.0

data/lib/peddler/{api → apis}/services_v1.rb

@@ -3,7 +3,13 @@
 require "peddler/api"
 
 module Peddler
-  class API
+  class << self
+    def services_v1(...)
+      APIs::ServicesV1.new(...)
+    end
+  end
+
+  module APIs
     # Selling Partner API for Services
     #
     # With the Services API, you can build applications that help service providers get and modify their service orders
@@ -11,78 +17,84 @@ module Peddler
     class ServicesV1 < API
       # Gets details of service job indicated by the provided `serviceJobID`.
       #
-      # @param [String] service_job_id A service job identifier.
-      # @return [Hash] The API response
-      def get_service_job_by_service_job_id(service_job_id)
+      # @note This operation can make a static sandbox call.
+      # @param service_job_id [String] A service job identifier.
+      # @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}"
 
-        rate_limit(20.0).get(path)
+        meter(rate_limit).get(path)
       end
 
       # Cancels the service job indicated by the service job identifier specified.
       #
-      # @param [String] service_job_id An Amazon defined service job identifier.
-      # @param [String] cancellation_reason_code A cancel reason code that specifies the reason for cancelling a service
+      # @note This operation can make a static sandbox call.
+      # @param service_job_id [String] An Amazon defined service job identifier.
+      # @param cancellation_reason_code [String] A cancel reason code that specifies the reason for cancelling a service
       #   job.
-      # @return [Hash] The API response
-      def cancel_service_job_by_service_job_id(service_job_id, cancellation_reason_code)
+      # @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"
         params = {
           "cancellationReasonCode" => cancellation_reason_code,
         }.compact
 
-        rate_limit(5.0).put(path, params:)
+        meter(rate_limit).put(path, params:)
       end
 
       # Completes the service job indicated by the service job identifier specified.
       #
-      # @param [String] service_job_id An Amazon defined service job identifier.
-      # @return [Hash] The API response
-      def complete_service_job_by_service_job_id(service_job_id)
+      # @note This operation can make a static sandbox call.
+      # @param service_job_id [String] An Amazon defined service job identifier.
+      # @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"
 
-        rate_limit(5.0).put(path)
+        meter(rate_limit).put(path)
       end
 
       # Gets service job details for the specified filter query.
       #
-      # @param [Array<String>] service_order_ids List of service order ids for the query you want to perform.Max values
+      # @note This operation can make a static sandbox call.
+      # @param service_order_ids [Array<String>] List of service order ids for the query you want to perform.Max values
       #   supported 20.
-      # @param [Array<String>] service_job_status A list of one or more job status by which to filter the list of jobs.
-      # @param [String] page_token String returned in the response of your previous request.
-      # @param [Integer] page_size A non-negative integer that indicates the maximum number of jobs to return in the
+      # @param service_job_status [Array<String>] A list of one or more job status by which to filter the list of jobs.
+      # @param page_token [String] String returned in the response of your previous request.
+      # @param page_size [Integer] A non-negative integer that indicates the maximum number of jobs to return in the
       #   list, Value must be 1 - 20. Default 20.
-      # @param [String] sort_field Sort fields on which you want to sort the output.
-      # @param [String] sort_order Sort order for the query you want to perform.
-      # @param [String] created_after A date used for selecting jobs created at or after a specified time. Must be in
+      # @param sort_field [String] Sort fields on which you want to sort the output.
+      # @param sort_order [String] Sort order for the query you want to perform.
+      # @param created_after [String] A date used for selecting jobs created at or after a specified time. Must be in
       #   ISO 8601 format. Required if `LastUpdatedAfter` is not specified. Specifying both `CreatedAfter` and
       #   `LastUpdatedAfter` returns an error.
-      # @param [String] created_before A date used for selecting jobs created at or before a specified time. Must be in
+      # @param created_before [String] A date used for selecting jobs created at or before a specified time. Must be in
       #   ISO 8601 format.
-      # @param [String] last_updated_after A date used for selecting jobs updated at or after a specified time. Must be
+      # @param last_updated_after [String] A date used for selecting jobs updated at or after a specified time. Must be
       #   in ISO 8601 format. Required if `createdAfter` is not specified. Specifying both `CreatedAfter` and
       #   `LastUpdatedAfter` returns an error.
-      # @param [String] last_updated_before A date used for selecting jobs updated at or before a specified time. Must
+      # @param last_updated_before [String] A date used for selecting jobs updated at or before a specified time. Must
       #   be in ISO 8601 format.
-      # @param [String] schedule_start_date A date used for filtering jobs schedules at or after a specified time. Must
+      # @param schedule_start_date [String] A date used for filtering jobs schedules at or after a specified time. Must
       #   be in ISO 8601 format. Schedule end date should not be earlier than schedule start date.
-      # @param [String] schedule_end_date A date used for filtering jobs schedules at or before a specified time. Must
+      # @param schedule_end_date [String] A date used for filtering jobs schedules at or before a specified time. Must
       #   be in ISO 8601 format. Schedule end date should not be earlier than schedule start date.
-      # @param [Array<String>] marketplace_ids Used to select jobs that were placed in the specified marketplaces.
-      # @param [Array<String>] asins List of Amazon Standard Identification Numbers (ASIN) of the items. Max values
+      # @param marketplace_ids [Array<String>] Used to select jobs that were placed in the specified marketplaces.
+      # @param asins [Array<String>] List of Amazon Standard Identification Numbers (ASIN) of the items. Max values
       #   supported is 20.
-      # @param [Array<String>] required_skills A defined set of related knowledge, skills, experience, tools, materials,
+      # @param required_skills [Array<String>] A defined set of related knowledge, skills, experience, tools, materials,
       #   and work processes common to service delivery for a set of products and/or service scenarios. Max values
       #   supported is 20.
-      # @param [Array<String>] store_ids List of Amazon-defined identifiers for the region scope. Max values supported
+      # @param store_ids [Array<String>] List of Amazon-defined identifiers for the region scope. Max values supported
       #   is 50.
-      # @return [Hash] The API response
-      def get_service_jobs(
-        marketplace_ids, service_order_ids: nil, service_job_status: nil, page_token: nil, page_size: nil,
-        sort_field: nil, sort_order: nil, created_after: nil, created_before: nil, last_updated_after: nil,
-        last_updated_before: nil, schedule_start_date: nil, schedule_end_date: nil, asins: nil, required_skills: nil,
-        store_ids: nil
-      )
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_service_jobs(marketplace_ids, service_order_ids: nil, service_job_status: nil, page_token: nil,
+        page_size: 20, sort_field: nil, sort_order: nil, created_after: nil, created_before: nil,
+        last_updated_after: nil, last_updated_before: nil, schedule_start_date: nil, schedule_end_date: nil, asins: nil,
+        required_skills: nil, store_ids: nil, rate_limit: 10.0)
         path = "/service/v1/serviceJobs"
         params = {
           "serviceOrderIds" => service_order_ids,
@@ -103,162 +115,186 @@ module Peddler
           "storeIds" => store_ids,
         }.compact
 
-        rate_limit(10.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Adds an appointment to the service job indicated by the service job identifier specified.
       #
-      # @param [String] service_job_id An Amazon defined service job identifier.
-      # @param [Hash] body Add appointment operation input details.
-      # @return [Hash] The API response
-      def add_appointment_for_service_job_by_service_job_id(service_job_id, body)
+      # @note This operation can make a static sandbox call.
+      # @param service_job_id [String] An Amazon defined service job identifier.
+      # @param body [Hash] Add appointment operation input details.
+      # @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"
 
-        rate_limit(5.0).post(path, body:)
+        meter(rate_limit).post(path, body:)
       end
 
       # Reschedules an appointment for the service job indicated by the service job identifier specified.
       #
-      # @param [String] service_job_id An Amazon defined service job identifier.
-      # @param [String] appointment_id An existing appointment identifier for the Service Job.
-      # @param [Hash] body Reschedule appointment operation input details.
-      # @return [Hash] The API response
-      def reschedule_appointment_for_service_job_by_service_job_id(service_job_id, appointment_id, body)
+      # @note This operation can make a static sandbox call.
+      # @param service_job_id [String] An Amazon defined service job identifier.
+      # @param appointment_id [String] An existing appointment identifier for the Service Job.
+      # @param body [Hash] Reschedule appointment operation input details.
+      # @param rate_limit [Float] Requests per second
+      # @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}"
 
-        rate_limit(5.0).post(path, body:)
+        meter(rate_limit).post(path, body:)
       end
 
       # Assigns new resource(s) or overwrite/update the existing one(s) to a service job appointment.
       #
-      # @param [String] service_job_id An Amazon-defined service job identifier. Get this value by calling the
+      # @note This operation can make a static sandbox call.
+      # @param service_job_id [String] An Amazon-defined service job identifier. Get this value by calling the
       #   `getServiceJobs` operation of the Services API.
-      # @param [String] appointment_id An Amazon-defined identifier of active service job appointment.
-      # @param [Hash] body
-      # @return [Hash] The API response
-      def assign_appointment_resources(service_job_id, appointment_id, body)
+      # @param appointment_id [String] An Amazon-defined identifier of active service job appointment.
+      # @param body [Hash]
+      # @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"
 
-        rate_limit(1.0).put(path, body:)
+        meter(rate_limit).put(path, body:)
       end
 
       # Updates the appointment fulfillment data related to a given `jobID` and `appointmentID`.
       #
-      # @param [String] service_job_id An Amazon-defined service job identifier. Get this value by calling the
+      # @note This operation can make a static sandbox call.
+      # @param service_job_id [String] An Amazon-defined service job identifier. Get this value by calling the
       #   `getServiceJobs` operation of the Services API.
-      # @param [String] appointment_id An Amazon-defined identifier of active service job appointment.
-      # @param [Hash] body Appointment fulfillment data collection details.
-      # @return [Hash] The API response
-      def set_appointment_fulfillment_data(service_job_id, appointment_id, body)
+      # @param appointment_id [String] An Amazon-defined identifier of active service job appointment.
+      # @param body [Hash] Appointment fulfillment data collection details.
+      # @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"
 
-        rate_limit(5.0).put(path, body:)
+        meter(rate_limit).put(path, body:)
       end
 
       # Provides capacity slots in a format similar to availability records.
       #
-      # @param [String] resource_id Resource Identifier.
-      # @param [Hash] body Request body.
-      # @param [Array<String>] marketplace_ids An identifier for the marketplace in which the resource operates.
-      # @param [String] next_page_token Next page token returned in the response of your previous request.
-      # @return [Hash] The API response
-      def get_range_slot_capacity(resource_id, body, marketplace_ids, next_page_token: nil)
+      # @note This operation can make a static sandbox call.
+      # @param resource_id [String] Resource Identifier.
+      # @param body [Hash] Request body.
+      # @param marketplace_ids [Array<String>] An identifier for the marketplace in which the resource operates.
+      # @param next_page_token [String] Next page token returned in the response of your previous request.
+      # @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"
         params = {
           "marketplaceIds" => marketplace_ids,
           "nextPageToken" => next_page_token,
         }.compact
 
-        rate_limit(5.0).post(path, body:, params:)
+        meter(rate_limit).post(path, body:, params:)
       end
 
       # Provides capacity in fixed-size slots.
       #
-      # @param [String] resource_id Resource Identifier.
-      # @param [Hash] body Request body.
-      # @param [Array<String>] marketplace_ids An identifier for the marketplace in which the resource operates.
-      # @param [String] next_page_token Next page token returned in the response of your previous request.
-      # @return [Hash] The API response
-      def get_fixed_slot_capacity(resource_id, body, marketplace_ids, next_page_token: nil)
+      # @note This operation can make a static sandbox call.
+      # @param resource_id [String] Resource Identifier.
+      # @param body [Hash] Request body.
+      # @param marketplace_ids [Array<String>] An identifier for the marketplace in which the resource operates.
+      # @param next_page_token [String] Next page token returned in the response of your previous request.
+      # @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"
         params = {
           "marketplaceIds" => marketplace_ids,
           "nextPageToken" => next_page_token,
         }.compact
 
-        rate_limit(5.0).post(path, body:, params:)
+        meter(rate_limit).post(path, body:, params:)
       end
 
       # Update the schedule of the given resource.
       #
-      # @param [String] resource_id Resource (store) Identifier
-      # @param [Hash] body Schedule details
-      # @param [Array<String>] marketplace_ids An identifier for the marketplace in which the resource operates.
-      # @return [Hash] The API response
-      def update_schedule(resource_id, body, marketplace_ids)
+      # @note This operation can make a static sandbox call.
+      # @param resource_id [String] Resource (store) Identifier
+      # @param body [Hash] Schedule details
+      # @param marketplace_ids [Array<String>] An identifier for the marketplace in which the resource operates.
+      # @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"
         params = {
           "marketplaceIds" => marketplace_ids,
         }.compact
 
-        rate_limit(5.0).put(path, body:, params:)
+        meter(rate_limit).put(path, body:, params:)
       end
 
       # Create a reservation.
       #
-      # @param [Hash] body Reservation details
-      # @param [Array<String>] marketplace_ids An identifier for the marketplace in which the resource operates.
-      # @return [Hash] The API response
-      def create_reservation(body, marketplace_ids)
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash] Reservation details
+      # @param marketplace_ids [Array<String>] An identifier for the marketplace in which the resource operates.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_reservation(body, marketplace_ids, rate_limit: 5.0)
         path = "/service/v1/reservation"
         params = {
           "marketplaceIds" => marketplace_ids,
         }.compact
 
-        rate_limit(5.0).post(path, body:, params:)
+        meter(rate_limit).post(path, body:, params:)
       end
 
       # Update a reservation.
       #
-      # @param [String] reservation_id Reservation Identifier
-      # @param [Hash] body Reservation details
-      # @param [Array<String>] marketplace_ids An identifier for the marketplace in which the resource operates.
-      # @return [Hash] The API response
-      def update_reservation(reservation_id, body, marketplace_ids)
+      # @note This operation can make a static sandbox call.
+      # @param reservation_id [String] Reservation Identifier
+      # @param body [Hash] Reservation details
+      # @param marketplace_ids [Array<String>] An identifier for the marketplace in which the resource operates.
+      # @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}"
         params = {
           "marketplaceIds" => marketplace_ids,
         }.compact
 
-        rate_limit(5.0).put(path, body:, params:)
+        meter(rate_limit).put(path, body:, params:)
       end
 
       # Cancel a reservation.
       #
-      # @param [String] reservation_id Reservation Identifier
-      # @param [Array<String>] marketplace_ids An identifier for the marketplace in which the resource operates.
-      # @return [Hash] The API response
-      def cancel_reservation(reservation_id, marketplace_ids)
+      # @note This operation can make a static sandbox call.
+      # @param reservation_id [String] Reservation Identifier
+      # @param marketplace_ids [Array<String>] An identifier for the marketplace in which the resource operates.
+      # @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}"
         params = {
           "marketplaceIds" => marketplace_ids,
         }.compact
 
-        rate_limit(5.0).delete(path, params:)
+        meter(rate_limit).delete(path, params:)
       end
 
       # Gets appointment slots for the service associated with the service job id specified.
       #
-      # @param [String] service_job_id A service job identifier to retrive appointment slots for associated service.
-      # @param [Array<String>] marketplace_ids An identifier for the marketplace in which the resource operates.
-      # @param [String] start_time A time from which the appointment slots will be retrieved. The specified time must be
+      # @note This operation can make a static sandbox call.
+      # @param service_job_id [String] A service job identifier to retrive appointment slots for associated service.
+      # @param marketplace_ids [Array<String>] An identifier for the marketplace in which the resource operates.
+      # @param start_time [String] A time from which the appointment slots will be retrieved. The specified time must be
       #   in ISO 8601 format. If `startTime` is provided, `endTime` should also be provided. Default value is as per
       #   business configuration.
-      # @param [String] end_time A time up to which the appointment slots will be retrieved. The specified time must be
+      # @param end_time [String] A time up to which the appointment slots will be retrieved. The specified time must be
       #   in ISO 8601 format. If `endTime` is provided, `startTime` should also be provided. Default value is as per
       #   business configuration. Maximum range of appointment slots can be 90 days.
-      # @return [Hash] The API response
-      def get_appointmment_slots_by_job_id(service_job_id, marketplace_ids, start_time: nil, end_time: nil)
+      # @param rate_limit [Float] Requests per second
+      # @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"
         params = {
           "marketplaceIds" => marketplace_ids,
@@ -266,22 +302,24 @@ module Peddler
           "endTime" => end_time,
         }.compact
 
-        rate_limit(5.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Gets appointment slots as per the service context specified.
       #
-      # @param [String] asin ASIN associated with the service.
-      # @param [String] store_id Store identifier defining the region scope to retrive appointment slots.
-      # @param [Array<String>] marketplace_ids An identifier for the marketplace for which appointment slots are queried
-      # @param [String] start_time A time from which the appointment slots will be retrieved. The specified time must be
+      # @note This operation can make a static sandbox call.
+      # @param asin [String] ASIN associated with the service.
+      # @param store_id [String] Store identifier defining the region scope to retrive appointment slots.
+      # @param marketplace_ids [Array<String>] An identifier for the marketplace for which appointment slots are queried
+      # @param start_time [String] A time from which the appointment slots will be retrieved. The specified time must be
       #   in ISO 8601 format. If `startTime` is provided, `endTime` should also be provided. Default value is as per
       #   business configuration.
-      # @param [String] end_time A time up to which the appointment slots will be retrieved. The specified time must be
+      # @param end_time [String] A time up to which the appointment slots will be retrieved. The specified time must be
       #   in ISO 8601 format. If `endTime` is provided, `startTime` should also be provided. Default value is as per
       #   business configuration. Maximum range of appointment slots can be 90 days.
-      # @return [Hash] The API response
-      def get_appointment_slots(asin, store_id, marketplace_ids, start_time: nil, end_time: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_appointment_slots(asin, store_id, marketplace_ids, start_time: nil, end_time: nil, rate_limit: 20.0)
         path = "/service/v1/appointmentSlots"
         params = {
           "asin" => asin,
@@ -291,17 +329,19 @@ module Peddler
           "endTime" => end_time,
         }.compact
 
-        rate_limit(20.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Creates an upload destination.
       #
-      # @param [Hash] body Upload document operation input details.
-      # @return [Hash] The API response
-      def create_service_document_upload_destination(body)
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash] Upload document operation input details.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_service_document_upload_destination(body, rate_limit: 5.0)
         path = "/service/v1/documents"
 
-        rate_limit(5.0).post(path, body:)
+        meter(rate_limit).post(path, body:)
       end
     end
   end

data/lib/peddler/apis/shipment_invoicing_v0.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def shipment_invoicing_v0(...)
+      APIs::ShipmentInvoicingV0.new(...)
+    end
+  end
+
+  module APIs
+    # Selling Partner API for Shipment Invoicing
+    #
+    # The Selling Partner API for Shipment Invoicing helps you programmatically retrieve shipment invoice information in
+    # the Brazil marketplace for a selling partner’s Fulfillment by Amazon (FBA) orders.
+    class ShipmentInvoicingV0 < API
+      # Returns the shipment details required to issue an invoice for the specified shipment.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param shipment_id [String] The identifier for the shipment. Get this value from the FBAOutboundShipmentStatus
+      #   notification. For information about subscribing to notifications, see the
+      #   {https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-use-case-guide Notifications API Use Case
+      #   Guide}.
+      # @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}"
+
+        meter(rate_limit).get(path)
+      end
+
+      # Submits a shipment invoice document for a given shipment.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param shipment_id [String] The identifier for the shipment.
+      # @param body [Hash]
+      # @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"
+
+        meter(rate_limit).post(path, body:)
+      end
+
+      # Returns the invoice status for the shipment you specify.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param shipment_id [String] The shipment identifier for the shipment.
+      # @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"
+
+        meter(rate_limit).get(path)
+      end
+    end
+  end
+end

data/lib/peddler/apis/shipping_v1.rb

@@ -0,0 +1,132 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def shipping_v1(...)
+      APIs::ShippingV1.new(...)
+    end
+  end
+
+  module APIs
+    # Selling Partner API for Shipping
+    #
+    # Provides programmatic access to Amazon Shipping APIs. **Note:** If you are new to the Amazon Shipping API, refer
+    # to the latest version of <a
+    # href="https://developer-docs.amazon.com/amazon-shipping/docs/shipping-api-v2-reference">Amazon Shipping API
+    # (v2)</a> on the <a href="https://developer-docs.amazon.com/amazon-shipping/">Amazon Shipping Developer
+    # Documentation</a> site.
+    class ShippingV1 < API
+      # Create a new shipment.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash]
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_shipment(body, rate_limit: 5.0)
+        path = "/shipping/v1/shipments"
+
+        meter(rate_limit).post(path, body:)
+      end
+
+      # Return the entire shipment object for the shipmentId.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param shipment_id [String]
+      # @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}"
+
+        meter(rate_limit).get(path)
+      end
+
+      # Cancel a shipment by the given shipmentId.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param shipment_id [String]
+      # @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"
+
+        meter(rate_limit).post(path)
+      end
+
+      # Purchase shipping labels based on a given rate.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param shipment_id [String]
+      # @param body [Hash]
+      # @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"
+
+        meter(rate_limit).post(path, body:)
+      end
+
+      # Retrieve shipping label based on the shipment id and tracking id.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param shipment_id [String]
+      # @param tracking_id [String]
+      # @param body [Hash]
+      # @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"
+
+        meter(rate_limit).post(path, body:)
+      end
+
+      # Purchase shipping labels.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash]
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def purchase_shipment(body, rate_limit: 5.0)
+        path = "/shipping/v1/purchaseShipment"
+
+        meter(rate_limit).post(path, body:)
+      end
+
+      # Get service rates.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash]
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_rates(body, rate_limit: 5.0)
+        path = "/shipping/v1/rates"
+
+        meter(rate_limit).post(path, body:)
+      end
+
+      # Verify if the current account is valid.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_account(rate_limit: 5.0)
+        path = "/shipping/v1/account"
+
+        meter(rate_limit).get(path)
+      end
+
+      # Return the tracking information of a shipment.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param tracking_id [String]
+      # @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}"
+
+        meter(rate_limit).get(path)
+      end
+    end
+  end
+end