peddler 2.4.5 → 3.0.0.beta1

data/lib/peddler/api/reports_2021_06_30.rb

@@ -0,0 +1,139 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class API
+    # Selling Partner API for Reports
+    #
+    # The Selling Partner API for Reports lets you retrieve and manage a variety of reports that can help selling
+    # partners manage their businesses.
+    class Reports20210630 < API
+      # Returns report details for the reports that match the filters that you specify.
+      #
+      # @param [Array<String>] report_types A list of report types used to filter reports. Refer to [Report Type
+      #   Values](https://developer-docs.amazon.com/sp-api/docs/report-type-values) for more information. When
+      #   reportTypes is provided, the other filter parameters (processingStatuses, marketplaceIds, createdSince,
+      #   createdUntil) and pageSize may also be provided. Either reportTypes or nextToken is required.
+      # @param [Array<String>] processing_statuses A list of processing statuses used to filter reports.
+      # @param [Array<String>] marketplace_ids A list of marketplace identifiers used to filter reports. The reports
+      #   returned will match at least one of the marketplaces that you specify.
+      # @param [Integer] page_size The maximum number of reports to return in a single call.
+      # @param [String] created_since The earliest report creation date and time for reports to include in the response,
+      #   in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date time format. The default is 90 days
+      #   ago. Reports are retained for a maximum of 90 days.
+      # @param [String] created_until The latest report creation date and time for reports to include in the response,
+      #   in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date time format. The default is now.
+      # @param [String] next_token A string token returned in the response to your previous request. `nextToken` is
+      #   returned when the number of results exceeds the specified `pageSize` value. To get the next page of results,
+      #   call the `getReports` operation and include this token as the only parameter. Specifying `nextToken` with any
+      #   other parameters will cause the request to fail.
+      # @return [Hash] The API response
+      def get_reports(report_types: nil, processing_statuses: nil, marketplace_ids: nil, page_size: nil,
+        created_since: nil, created_until: nil, next_token: nil)
+        path = "/reports/2021-06-30/reports"
+        params = {
+          "reportTypes" => report_types,
+          "processingStatuses" => processing_statuses,
+          "marketplaceIds" => marketplace_ids,
+          "pageSize" => page_size,
+          "createdSince" => created_since,
+          "createdUntil" => created_until,
+          "nextToken" => next_token,
+        }.compact
+
+        rate_limit(0.0222).get(path, params:)
+      end
+
+      # Creates a report.
+      #
+      # @param [Hash] body Information required to create the report.
+      # @return [Hash] The API response
+      def create_report(body)
+        path = "/reports/2021-06-30/reports"
+
+        rate_limit(0.0167).post(path, body:)
+      end
+
+      # Cancels the report that you specify. Only reports with `processingStatus=IN_QUEUE` can be cancelled. Cancelled
+      # reports are returned in subsequent calls to the `getReport` and `getReports` operations.
+      #
+      # @param [String] report_id The identifier for the report. This identifier is unique only in combination with a
+      #   seller ID.
+      # @return [Hash] The API response
+      def cancel_report(report_id)
+        path = "/reports/2021-06-30/reports/#{report_id}"
+
+        rate_limit(0.0222).delete(path)
+      end
+
+      # Returns report details (including the `reportDocumentId`, if available) for the report that you specify.
+      #
+      # @param [String] report_id The identifier for the report. This identifier is unique only in combination with a
+      #   seller ID.
+      # @return [Hash] The API response
+      def get_report(report_id)
+        path = "/reports/2021-06-30/reports/#{report_id}"
+
+        rate_limit(2.0).get(path)
+      end
+
+      # Returns report schedule details that match the filters that you specify.
+      #
+      # @param [Array<String>] report_types A list of report types used to filter report schedules. Refer to [Report
+      #   Type Values](https://developer-docs.amazon.com/sp-api/docs/report-type-values) for more information.
+      # @return [Hash] The API response
+      def get_report_schedules(report_types)
+        path = "/reports/2021-06-30/schedules"
+        params = {
+          "reportTypes" => report_types,
+        }.compact
+
+        rate_limit(0.0222).get(path, params:)
+      end
+
+      # Creates a report schedule. If a report schedule with the same report type and marketplace IDs already exists, it
+      # will be cancelled and replaced with this one.
+      #
+      # @param [Hash] body Information required to create the report schedule.
+      # @return [Hash] The API response
+      def create_report_schedule(body)
+        path = "/reports/2021-06-30/schedules"
+
+        rate_limit(0.0222).post(path, body:)
+      end
+
+      # Cancels the report schedule that you specify.
+      #
+      # @param [String] report_schedule_id The identifier for the report schedule. This identifier is unique only in
+      #   combination with a seller ID.
+      # @return [Hash] The API response
+      def cancel_report_schedule(report_schedule_id)
+        path = "/reports/2021-06-30/schedules/#{report_schedule_id}"
+
+        rate_limit(0.0222).delete(path)
+      end
+
+      # Returns report schedule details for the report schedule that you specify.
+      #
+      # @param [String] report_schedule_id The identifier for the report schedule. This identifier is unique only in
+      #   combination with a seller ID.
+      # @return [Hash] The API response
+      def get_report_schedule(report_schedule_id)
+        path = "/reports/2021-06-30/schedules/#{report_schedule_id}"
+
+        rate_limit(0.0222).get(path)
+      end
+
+      # Returns the information required for retrieving a report document's contents.
+      #
+      # @param [String] report_document_id The identifier for the report document.
+      # @return [Hash] The API response
+      def get_report_document(report_document_id)
+        path = "/reports/2021-06-30/documents/#{report_document_id}"
+
+        rate_limit(0.0167).get(path)
+      end
+    end
+  end
+end

data/lib/peddler/api/sales_v1.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class API
+    # Selling Partner API for Sales
+    #
+    # The Selling Partner API for Sales provides APIs related to sales performance.
+    class SalesV1 < API
+      # Returns aggregated order metrics for given interval, broken down by granularity, for given buyer type.
+      #
+      # @param [Array<String>] marketplace_ids A marketplace identifier. This specifies the marketplace in which the
+      #   order was placed. Only one marketplace can be specified. For example, ATVPDKIKX0DER indicates the US
+      #   marketplace.
+      # @param [String] interval A time interval used for selecting order metrics. This takes the form of two dates
+      #   separated by two hyphens (first date is inclusive; second date is exclusive). Dates are in ISO8601 format and
+      #   must represent absolute time (either Z notation or offset notation). Example:
+      #   2018-09-01T00:00:00-07:00--2018-09-04T00:00:00-07:00 requests order metrics for Sept 1st, 2nd and 3rd in the
+      #   -07:00 zone.
+      # @param [String] granularity_time_zone An IANA-compatible time zone for determining the day boundary. Required
+      #   when specifying a granularity value greater than Hour. The granularityTimeZone value must align with the
+      #   offset of the specified interval value. For example, if the interval value uses Z notation, then
+      #   granularityTimeZone must be UTC. If the interval value uses an offset, then granularityTimeZone must be an
+      #   IANA-compatible time zone that matches the offset. Example: US/Pacific to compute day boundaries, accounting
+      #   for daylight time savings, for US/Pacific zone.
+      # @param [String] granularity The granularity of the grouping of order metrics, based on a unit of time.
+      #   Specifying granularity=Hour results in a successful request only if the interval specified is less than or
+      #   equal to 30 days from now. For all other granularities, the interval specified must be less or equal to 2
+      #   years from now. Specifying granularity=Total results in order metrics that are aggregated over the entire
+      #   interval that you specify. If the interval start and end date don’t align with the specified granularity, the
+      #   head and tail end of the response interval will contain partial data. Example: Day to get a daily breakdown of
+      #   the request interval, where the day boundary is defined by the granularityTimeZone.
+      # @param [String] buyer_type Filters the results by the buyer type that you specify, B2B (business to business) or
+      #   B2C (business to customer). Example: B2B, if you want the response to include order metrics for only B2B
+      #   buyers.
+      # @param [String] fulfillment_network Filters the results by the fulfillment network that you specify, MFN
+      #   (merchant fulfillment network) or AFN (Amazon fulfillment network). Do not include this filter if you want the
+      #   response to include order metrics for all fulfillment networks. Example: AFN, if you want the response to
+      #   include order metrics for only Amazon fulfillment network.
+      # @param [String] first_day_of_week Specifies the day that the week starts on when granularity=Week, either Monday
+      #   or Sunday. Default: Monday. Example: Sunday, if you want the week to start on a Sunday.
+      # @param [String] asin Filters the results by the ASIN 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 ASINs. Example:
+      #   B0792R1RSN, if you want the response to include order metrics for only ASIN B0792R1RSN.
+      # @param [String] sku 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.
+      # @return [Hash] The API response
+      def get_order_metrics(marketplace_ids, interval, granularity, granularity_time_zone: nil, buyer_type: nil,
+        fulfillment_network: nil, first_day_of_week: nil, asin: nil, sku: nil)
+        path = "/sales/v1/orderMetrics"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+          "interval" => interval,
+          "granularityTimeZone" => granularity_time_zone,
+          "granularity" => granularity,
+          "buyerType" => buyer_type,
+          "fulfillmentNetwork" => fulfillment_network,
+          "firstDayOfWeek" => first_day_of_week,
+          "asin" => asin,
+          "sku" => sku,
+        }.compact
+
+        rate_limit(0.5).get(path, params:)
+      end
+    end
+  end
+end

data/lib/peddler/api/sellers_v1.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class API
+    # Selling Partner API for Sellers
+    #
+    # The [Selling Partner API for Sellers](https://developer-docs.amazon.com/sp-api/docs/sellers-api-v1-reference)
+    # (Sellers API) provides essential information about seller accounts, such as: - The marketplaces a seller can list
+    # in - The default language and currency of a marketplace - Whether the seller has suspended listings Refer to the
+    # [Sellers API reference](https://developer-docs.amazon.com/sp-api/docs/sellers-api-v1-reference) for details about
+    # this API's operations, data types, and schemas.
+    class SellersV1 < API
+      # Returns a list of marketplaces where the seller can list items and information about the seller's participation
+      # in those marketplaces.
+      # @return [Hash] The API response
+      def get_marketplace_participations
+        path = "/sellers/v1/marketplaceParticipations"
+
+        rate_limit(0.016).get(path)
+      end
+
+      # Returns information about a seller account and its marketplaces.
+      # @return [Hash] The API response
+      def get_account
+        path = "/sellers/v1/account"
+
+        rate_limit(0.016).get(path)
+      end
+    end
+  end
+end

data/lib/peddler/api/services_v1.rb

@@ -0,0 +1,308 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class API
+    # Selling Partner API for Services
+    #
+    # With the Services API, you can build applications that help service providers get and modify their service orders
+    # and manage their resources.
+    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)
+        path = "/service/v1/serviceJobs/#{service_job_id}"
+
+        rate_limit(20.0).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
+      #   job.
+      # @return [Hash] The API response
+      def cancel_service_job_by_service_job_id(service_job_id, cancellation_reason_code)
+        path = "/service/v1/serviceJobs/#{service_job_id}/cancellations"
+        params = {
+          "cancellationReasonCode" => cancellation_reason_code,
+        }.compact
+
+        rate_limit(5.0).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)
+        path = "/service/v1/serviceJobs/#{service_job_id}/completions"
+
+        rate_limit(5.0).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
+      #   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
+      #   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
+      #   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
+      #   ISO 8601 format.
+      # @param [String] last_updated_after 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
+      #   be in ISO 8601 format.
+      # @param [String] schedule_start_date 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
+      #   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
+      #   supported is 20.
+      # @param [Array<String>] required_skills 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
+      #   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
+      )
+        path = "/service/v1/serviceJobs"
+        params = {
+          "serviceOrderIds" => service_order_ids,
+          "serviceJobStatus" => service_job_status,
+          "pageToken" => page_token,
+          "pageSize" => page_size,
+          "sortField" => sort_field,
+          "sortOrder" => sort_order,
+          "createdAfter" => created_after,
+          "createdBefore" => created_before,
+          "lastUpdatedAfter" => last_updated_after,
+          "lastUpdatedBefore" => last_updated_before,
+          "scheduleStartDate" => schedule_start_date,
+          "scheduleEndDate" => schedule_end_date,
+          "marketplaceIds" => marketplace_ids,
+          "asins" => asins,
+          "requiredSkills" => required_skills,
+          "storeIds" => store_ids,
+        }.compact
+
+        rate_limit(10.0).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)
+        path = "/service/v1/serviceJobs/#{service_job_id}/appointments"
+
+        rate_limit(5.0).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)
+        path = "/service/v1/serviceJobs/#{service_job_id}/appointments/#{appointment_id}"
+
+        rate_limit(5.0).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
+      #   `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)
+        path = "/service/v1/serviceJobs/#{service_job_id}/appointments/#{appointment_id}/resources"
+
+        rate_limit(1.0).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
+      #   `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)
+        path = "/service/v1/serviceJobs/#{service_job_id}/appointments/#{appointment_id}/fulfillment"
+
+        rate_limit(5.0).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)
+        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:)
+      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)
+        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:)
+      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)
+        path = "/service/v1/serviceResources/#{resource_id}/schedules"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+        }.compact
+
+        rate_limit(5.0).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)
+        path = "/service/v1/reservation"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+        }.compact
+
+        rate_limit(5.0).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)
+        path = "/service/v1/reservation/#{reservation_id}"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+        }.compact
+
+        rate_limit(5.0).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)
+        path = "/service/v1/reservation/#{reservation_id}"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+        }.compact
+
+        rate_limit(5.0).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
+      #   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
+      #   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)
+        path = "/service/v1/serviceJobs/#{service_job_id}/appointmentSlots"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+          "startTime" => start_time,
+          "endTime" => end_time,
+        }.compact
+
+        rate_limit(5.0).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
+      #   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
+      #   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)
+        path = "/service/v1/appointmentSlots"
+        params = {
+          "asin" => asin,
+          "storeId" => store_id,
+          "marketplaceIds" => marketplace_ids,
+          "startTime" => start_time,
+          "endTime" => end_time,
+        }.compact
+
+        rate_limit(20.0).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)
+        path = "/service/v1/documents"
+
+        rate_limit(5.0).post(path, body:)
+      end
+    end
+  end
+end

data/lib/peddler/api/shipment_invoicing_v0.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class API
+    # 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.
+      #
+      # @param [String] shipment_id The identifier for the shipment. Get this value from the FBAOutboundShipmentStatus
+      #   notification. For information about subscribing to notifications, see the [Notifications API Use Case
+      #   Guide](doc:notifications-api-v1-use-case-guide).
+      # @return [Hash] The API response
+      def get_shipment_details(shipment_id)
+        path = "/fba/outbound/brazil/v0/shipments/#{shipment_id}"
+
+        rate_limit(1.133).get(path)
+      end
+
+      # Submits a shipment invoice document for a given shipment.
+      #
+      # @param [String] shipment_id The identifier for the shipment.
+      # @param [Hash] body
+      # @return [Hash] The API response
+      def submit_invoice(shipment_id, body)
+        path = "/fba/outbound/brazil/v0/shipments/#{shipment_id}/invoice"
+
+        rate_limit(1.133).post(path, body:)
+      end
+
+      # Returns the invoice status for the shipment you specify.
+      #
+      # @param [String] shipment_id The shipment identifier for the shipment.
+      # @return [Hash] The API response
+      def get_invoice_status(shipment_id)
+        path = "/fba/outbound/brazil/v0/shipments/#{shipment_id}/invoice/status"
+
+        rate_limit(1.133).get(path)
+      end
+    end
+  end
+end