sp_api_clients 2.0.0

data/lib/amazon_sp_clients/v2/apis/vendor_orders.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+# Generated by lib/generator (bundle exec rake generate). Do not edit.
+
+require 'amazon_sp_clients/v2/api'
+
+module AmazonSpClients
+  module V2
+    # Selling Partner API for Retail Procurement Orders
+    #
+    # The Selling Partner API for Retail Procurement Orders provides programmatic access to vendor orders data.
+    #
+    # OpenAPI spec version: v1
+    class VendorOrders < Api
+      # Returns a purchase order based on the `purchaseOrderNumber` value that you specify. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 10 | 10 | The `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
+      #
+      # @param purchase_order_number [String] The purchase order identifier for the order that you want. Formatting Notes: 8-character alpha-numeric code.
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def get_purchase_order(purchase_order_number, rdt: nil)
+        request(:get, "/vendor/orders/v1/purchaseOrders/#{encode(purchase_order_number)}", rdt: rdt)
+      end
+
+      # Returns a list of purchase orders created or changed during the time frame that you specify. You define the time frame using the `createdAfter`, `createdBefore`, `changedAfter` and `changedBefore` parameters. The date range to search must not be more than 7 days. You can choose to get only the purchase order numbers by setting `includeDetails` to false. You can then use the `getPurchaseOrder` operation to receive details for a specific purchase order. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 10 | 10 | The `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
+      #
+      # @param limit [Integer, nil] The limit to the number of records returned. Default value is 100 records.
+      # @param created_after [String, nil] Purchase orders that became available after this time will be included in the result. Must be in ISO-8601 date/time format.
+      # @param created_before [String, nil] Purchase orders that became available before this time will be included in the result. Must be in ISO-8601 date/time format.
+      # @param sort_order [String, nil] Sort in ascending or descending order by purchase order creation date.
+      # @param next_token [String, nil] Used for pagination when there is more purchase orders than the specified result size limit. The token value is returned in the previous API call
+      # @param include_details [String, nil] When true, returns purchase orders with complete details. Otherwise, only purchase order numbers are returned. Default value is true.
+      # @param changed_after [String, nil] Purchase orders that changed after this timestamp will be included in the result. Must be in ISO-8601 date/time format.
+      # @param changed_before [String, nil] Purchase orders that changed before this timestamp will be included in the result. Must be in ISO-8601 date/time format.
+      # @param po_item_state [String, nil] Current state of the purchase order item. If this value is Cancelled, this API will return purchase orders which have one or more items cancelled by Amazon with updated item quantity as zero.
+      # @param is_po_changed [String, nil] When true, returns purchase orders which were modified after the order was placed. Vendors are required to pull the changed purchase order and fulfill the updated purchase order and not the original one. Default value is false.
+      # @param purchase_order_state [String, nil] Filters purchase orders based on the purchase order state.
+      # @param ordering_vendor_code [String, nil] Filters purchase orders based on the specified ordering vendor code. This value should be same as 'sellingParty.partyId' in the purchase order. If not included in the filter, all purchase orders for all of the vendor codes that exist in the vendor group used to authorize the API client application are returned.
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def get_purchase_orders(limit: nil, created_after: nil, created_before: nil, sort_order: nil, next_token: nil, include_details: nil, changed_after: nil, changed_before: nil, po_item_state: nil, is_po_changed: nil, purchase_order_state: nil, ordering_vendor_code: nil, rdt: nil)
+        query = {
+          'limit' => limit,
+          'createdAfter' => created_after,
+          'createdBefore' => created_before,
+          'sortOrder' => sort_order,
+          'nextToken' => next_token,
+          'includeDetails' => include_details,
+          'changedAfter' => changed_after,
+          'changedBefore' => changed_before,
+          'poItemState' => po_item_state,
+          'isPOChanged' => is_po_changed,
+          'purchaseOrderState' => purchase_order_state,
+          'orderingVendorCode' => ordering_vendor_code
+        }
+
+        request(:get, '/vendor/orders/v1/purchaseOrders', query: query, rdt: rdt)
+      end
+
+      # Returns purchase order statuses based on the filters that you specify. Date range to search must not be more than 7 days. You can return a list of purchase order statuses using the available filters, or a single purchase order status by providing the purchase order number. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 10 | 10 | The `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
+      #
+      # @param limit [Integer, nil] The limit to the number of records returned. Default value is 100 records.
+      # @param sort_order [String, nil] Sort in ascending or descending order by purchase order creation date.
+      # @param next_token [String, nil] Used for pagination when there are more purchase orders than the specified result size limit.
+      # @param created_after [String, nil] Purchase orders that became available after this timestamp will be included in the result. Must be in ISO-8601 date/time format.
+      # @param created_before [String, nil] Purchase orders that became available before this timestamp will be included in the result. Must be in ISO-8601 date/time format.
+      # @param updated_after [String, nil] Purchase orders for which the last purchase order update happened after this timestamp will be included in the result. Must be in ISO-8601 date/time format.
+      # @param updated_before [String, nil] Purchase orders for which the last purchase order update happened before this timestamp will be included in the result. Must be in ISO-8601 date/time format.
+      # @param purchase_order_number [String, nil] Provides purchase order status for the specified purchase order number.
+      # @param purchase_order_status [String, nil] Filters purchase orders based on the specified purchase order status. If not included in filter, this will return purchase orders for all statuses.
+      # @param item_confirmation_status [String, nil] Filters purchase orders based on their item confirmation status. If the item confirmation status is not included in the filter, purchase orders for all confirmation statuses are included.
+      # @param item_receive_status [String, nil] Filters purchase orders based on the purchase order's item receive status. If the item receive status is not included in the filter, purchase orders for all receive statuses are included.
+      # @param ordering_vendor_code [String, nil] Filters purchase orders based on the specified ordering vendor code. This value should be same as 'sellingParty.partyId' in the purchase order. If not included in filter, all purchase orders for all the vendor codes that exist in the vendor group used to authorize API client application are returned.
+      # @param ship_to_party_id [String, nil] Filters purchase orders for a specific buyer's Fulfillment Center/warehouse by providing ship to location id here. This value should be same as 'shipToParty.partyId' in the purchase order. If not included in filter, this will return purchase orders for all the buyer's warehouses used for vendor group purchase orders.
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def get_purchase_orders_status(limit: nil, sort_order: nil, next_token: nil, created_after: nil, created_before: nil, updated_after: nil, updated_before: nil, purchase_order_number: nil, purchase_order_status: nil, item_confirmation_status: nil, item_receive_status: nil, ordering_vendor_code: nil, ship_to_party_id: nil, rdt: nil)
+        query = {
+          'limit' => limit,
+          'sortOrder' => sort_order,
+          'nextToken' => next_token,
+          'createdAfter' => created_after,
+          'createdBefore' => created_before,
+          'updatedAfter' => updated_after,
+          'updatedBefore' => updated_before,
+          'purchaseOrderNumber' => purchase_order_number,
+          'purchaseOrderStatus' => purchase_order_status,
+          'itemConfirmationStatus' => item_confirmation_status,
+          'itemReceiveStatus' => item_receive_status,
+          'orderingVendorCode' => ordering_vendor_code,
+          'shipToPartyId' => ship_to_party_id
+        }
+
+        request(:get, '/vendor/orders/v1/purchaseOrdersStatus', query: query, rdt: rdt)
+      end
+
+      # Submits acknowledgements for one or more purchase orders. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 10 | 10 | The `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
+      #
+      # @param body [Hash] Submits acknowledgements for one or more purchase orders from a vendor. (SubmitAcknowledgementRequest)
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def submit_acknowledgement(body, rdt: nil)
+        request(:post, '/vendor/orders/v1/acknowledgements', body: body, rdt: rdt)
+      end
+    end
+  end
+end

data/lib/amazon_sp_clients/v2/apis/vendor_transaction_status.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+# Generated by lib/generator (bundle exec rake generate). Do not edit.
+
+require 'amazon_sp_clients/v2/api'
+
+module AmazonSpClients
+  module V2
+    # Selling Partner API for Retail Procurement Transaction Status
+    #
+    # The Selling Partner API for Retail Procurement Transaction Status provides programmatic access to status information on specific asynchronous POST transactions for vendors.
+    #
+    # OpenAPI spec version: v1
+    class VendorTransactionStatus < Api
+      # Returns the status of the transaction that you specify. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 10 | 20 | The `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
+      #
+      # @param transaction_id [String] The GUID provided by Amazon in the 'transactionId' field in response to the post request of a specific transaction.
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def get_transaction(transaction_id, rdt: nil)
+        request(:get, "/vendor/transactions/v1/transactions/#{encode(transaction_id)}", rdt: rdt)
+      end
+    end
+  end
+end

data/lib/amazon_sp_clients/v2/apis/vendors_shipments.rb

@@ -0,0 +1,120 @@
+# frozen_string_literal: true
+
+# Generated by lib/generator (bundle exec rake generate). Do not edit.
+
+require 'amazon_sp_clients/v2/api'
+
+module AmazonSpClients
+  module V2
+    # Selling Partner API for Retail Procurement Shipments
+    #
+    # The Selling Partner API for Retail Procurement Shipments provides programmatic access to retail shipping data for vendors.
+    #
+    # OpenAPI spec version: v1
+    class VendorsShipments < Api
+      # GetShipmentDetails
+      #
+      # @param limit [Integer, nil] The limit to the number of records returned. Default value is 50 records.
+      # @param sort_order [String, nil] Sort in ascending or descending order by purchase order creation date.
+      # @param next_token [String, nil] Used for pagination when there are more shipments than the specified result size limit.
+      # @param created_after [String, nil] Get Shipment Details that became available after this timestamp will be included in the result. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+      # @param created_before [String, nil] Get Shipment Details that became available before this timestamp will be included in the result. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+      # @param shipment_confirmed_before [String, nil] Get Shipment Details by passing Shipment confirmed create Date Before. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+      # @param shipment_confirmed_after [String, nil] Get Shipment Details by passing Shipment confirmed create Date After. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+      # @param package_label_created_before [String, nil] Get Shipment Details by passing Package label create Date by buyer. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+      # @param package_label_created_after [String, nil] Get Shipment Details by passing Package label create Date After by buyer. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+      # @param shipped_before [String, nil] Get Shipment Details by passing Shipped Date Before. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+      # @param shipped_after [String, nil] Get Shipment Details by passing Shipped Date After. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+      # @param estimated_delivery_before [String, nil] Get Shipment Details by passing Estimated Delivery Date Before. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+      # @param estimated_delivery_after [String, nil] Get Shipment Details by passing Estimated Delivery Date Before. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+      # @param shipment_delivery_before [String, nil] Get Shipment Details by passing Shipment Delivery Date Before. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+      # @param shipment_delivery_after [String, nil] Get Shipment Details by passing Shipment Delivery Date After. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+      # @param requested_pick_up_before [String, nil] Get Shipment Details by passing Before Requested pickup date. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+      # @param requested_pick_up_after [String, nil] Get Shipment Details by passing After Requested pickup date. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+      # @param scheduled_pick_up_before [String, nil] Get Shipment Details by passing Before scheduled pickup date. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+      # @param scheduled_pick_up_after [String, nil] Get Shipment Details by passing After Scheduled pickup date. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+      # @param current_shipment_status [String, nil] Get Shipment Details by passing Current shipment status.
+      # @param vendor_shipment_identifier [String, nil] Get Shipment Details by passing Vendor Shipment ID
+      # @param buyer_reference_number [String, nil] Get Shipment Details by passing buyer Reference ID
+      # @param buyer_warehouse_code [String, nil] Get Shipping Details based on buyer warehouse code. This value should be same as 'shipToParty.partyId' in the Shipment.
+      # @param seller_warehouse_code [String, nil] Get Shipping Details based on vendor warehouse code. This value should be same as 'sellingParty.partyId' in the Shipment.
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def get_shipment_details(limit: nil, sort_order: nil, next_token: nil, created_after: nil, created_before: nil, shipment_confirmed_before: nil, shipment_confirmed_after: nil, package_label_created_before: nil, package_label_created_after: nil, shipped_before: nil, shipped_after: nil, estimated_delivery_before: nil, estimated_delivery_after: nil, shipment_delivery_before: nil, shipment_delivery_after: nil, requested_pick_up_before: nil, requested_pick_up_after: nil, scheduled_pick_up_before: nil, scheduled_pick_up_after: nil, current_shipment_status: nil, vendor_shipment_identifier: nil, buyer_reference_number: nil, buyer_warehouse_code: nil, seller_warehouse_code: nil, rdt: nil)
+        query = {
+          'limit' => limit,
+          'sortOrder' => sort_order,
+          'nextToken' => next_token,
+          'createdAfter' => created_after,
+          'createdBefore' => created_before,
+          'shipmentConfirmedBefore' => shipment_confirmed_before,
+          'shipmentConfirmedAfter' => shipment_confirmed_after,
+          'packageLabelCreatedBefore' => package_label_created_before,
+          'packageLabelCreatedAfter' => package_label_created_after,
+          'shippedBefore' => shipped_before,
+          'shippedAfter' => shipped_after,
+          'estimatedDeliveryBefore' => estimated_delivery_before,
+          'estimatedDeliveryAfter' => estimated_delivery_after,
+          'shipmentDeliveryBefore' => shipment_delivery_before,
+          'shipmentDeliveryAfter' => shipment_delivery_after,
+          'requestedPickUpBefore' => requested_pick_up_before,
+          'requestedPickUpAfter' => requested_pick_up_after,
+          'scheduledPickUpBefore' => scheduled_pick_up_before,
+          'scheduledPickUpAfter' => scheduled_pick_up_after,
+          'currentShipmentStatus' => current_shipment_status,
+          'vendorShipmentIdentifier' => vendor_shipment_identifier,
+          'buyerReferenceNumber' => buyer_reference_number,
+          'buyerWarehouseCode' => buyer_warehouse_code,
+          'sellerWarehouseCode' => seller_warehouse_code
+        }
+
+        request(:get, '/vendor/shipping/v1/shipments', query: query, rdt: rdt)
+      end
+
+      # Returns small parcel shipment labels based on the filters that you specify. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 10 | 10 | The `x-amzn-RateLimit-Limit` response header contains the usage plan rate limits for the operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput might have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
+      #
+      # @param limit [Integer, nil] The limit to the number of records returned. Default value is 50 records.
+      # @param sort_order [String, nil] Sort the list by shipment label creation date in ascending or descending order.
+      # @param next_token [String, nil] A token that is used 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 return empty pages.
+      # @param label_created_after [String, nil] Shipment labels created after this time will be included in the result. This field must be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) datetime format.
+      # @param label_created_before [String, nil] Shipment labels created before this time will be included in the result. This field must be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) datetime format.
+      # @param buyer_reference_number [String, nil] Get Shipment labels by passing buyer reference number.
+      # @param vendor_shipment_identifier [String, nil] Get Shipment labels by passing vendor shipment identifier.
+      # @param seller_warehouse_code [String, nil] Get Shipping labels based on vendor warehouse code. This value must be same as the `sellingParty.partyId` in the shipment.
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def get_shipment_labels(limit: nil, sort_order: nil, next_token: nil, label_created_after: nil, label_created_before: nil, buyer_reference_number: nil, vendor_shipment_identifier: nil, seller_warehouse_code: nil, rdt: nil)
+        query = {
+          'limit' => limit,
+          'sortOrder' => sort_order,
+          'nextToken' => next_token,
+          'labelCreatedAfter' => label_created_after,
+          'labelCreatedBefore' => label_created_before,
+          'buyerReferenceNumber' => buyer_reference_number,
+          'vendorShipmentIdentifier' => vendor_shipment_identifier,
+          'sellerWarehouseCode' => seller_warehouse_code
+        }
+
+        request(:get, '/vendor/shipping/v1/transportLabels', query: query, rdt: rdt)
+      end
+
+      # SubmitShipmentConfirmations
+      #
+      # @param body [Hash] A request to submit shipment confirmation. (SubmitShipmentConfirmationsRequest)
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def submit_shipment_confirmations(body, rdt: nil)
+        request(:post, '/vendor/shipping/v1/shipmentConfirmations', body: body, rdt: rdt)
+      end
+
+      # SubmitShipments
+      #
+      # @param body [Hash] A request to submit shipment request. (SubmitShipments)
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def submit_shipments(body, rdt: nil)
+        request(:post, '/vendor/shipping/v1/shipments', body: body, rdt: rdt)
+      end
+    end
+  end
+end

data/lib/amazon_sp_clients/v2/apis.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+# Generated by lib/generator (bundle exec rake generate). Do not edit.
+
+require 'amazon_sp_clients/v2/client'
+
+module AmazonSpClients
+  module V2
+    autoload :FbaInventory, 'amazon_sp_clients/v2/apis/fba_inventory'
+    autoload :Feeds2021, 'amazon_sp_clients/v2/apis/feeds_2021'
+    autoload :FulfillmentOutbound2020, 'amazon_sp_clients/v2/apis/fulfillment_outbound_2020'
+    autoload :ListingsItems2021, 'amazon_sp_clients/v2/apis/listings_items_2021'
+    autoload :OrdersV0, 'amazon_sp_clients/v2/apis/orders_v0'
+    autoload :Reports2021, 'amazon_sp_clients/v2/apis/reports_2021'
+    autoload :Tokens2021, 'amazon_sp_clients/v2/apis/tokens_2021'
+    autoload :VdfInventoryV1, 'amazon_sp_clients/v2/apis/vdf_inventory_v1'
+    autoload :VdfOrdersV1, 'amazon_sp_clients/v2/apis/vdf_orders_v1'
+    autoload :VdfShippingV1, 'amazon_sp_clients/v2/apis/vdf_shipping_v1'
+    autoload :VendorInvoices, 'amazon_sp_clients/v2/apis/vendor_invoices'
+    autoload :VendorOrders, 'amazon_sp_clients/v2/apis/vendor_orders'
+    autoload :VendorTransactionStatus, 'amazon_sp_clients/v2/apis/vendor_transaction_status'
+    autoload :VendorsShipments, 'amazon_sp_clients/v2/apis/vendors_shipments'
+
+    class Client
+      # Selling Partner API for FBA Inventory
+      # @return [FbaInventory]
+      def fba_inventory = api(FbaInventory)
+
+      # Selling Partner API for Feeds
+      # @return [Feeds2021]
+      def feeds_2021 = api(Feeds2021)
+
+      # Selling Partner APIs for Fulfillment Outbound
+      # @return [FulfillmentOutbound2020]
+      def fulfillment_outbound_2020 = api(FulfillmentOutbound2020)
+
+      # Selling Partner API for Listings Items
+      # @return [ListingsItems2021]
+      def listings_items_2021 = api(ListingsItems2021)
+
+      # Selling Partner API for Orders
+      # @return [OrdersV0]
+      def orders_v0 = api(OrdersV0)
+
+      # Selling Partner API for Reports
+      # @return [Reports2021]
+      def reports_2021 = api(Reports2021)
+
+      # Selling Partner API for Tokens
+      # @return [Tokens2021]
+      def tokens_2021 = api(Tokens2021)
+
+      # Selling Partner API for Direct Fulfillment Inventory Updates
+      # @return [VdfInventoryV1]
+      def vdf_inventory_v1 = api(VdfInventoryV1)
+
+      # Selling Partner API for Direct Fulfillment Orders
+      # @return [VdfOrdersV1]
+      def vdf_orders_v1 = api(VdfOrdersV1)
+
+      # Selling Partner API for Direct Fulfillment Shipping
+      # @return [VdfShippingV1]
+      def vdf_shipping_v1 = api(VdfShippingV1)
+
+      # Selling Partner API for Retail Procurement Payments
+      # @return [VendorInvoices]
+      def vendor_invoices = api(VendorInvoices)
+
+      # Selling Partner API for Retail Procurement Orders
+      # @return [VendorOrders]
+      def vendor_orders = api(VendorOrders)
+
+      # Selling Partner API for Retail Procurement Transaction Status
+      # @return [VendorTransactionStatus]
+      def vendor_transaction_status = api(VendorTransactionStatus)
+
+      # Selling Partner API for Retail Procurement Shipments
+      # @return [VendorsShipments]
+      def vendors_shipments = api(VendorsShipments)
+    end
+  end
+end

data/lib/amazon_sp_clients/v2/client.rb

@@ -0,0 +1,198 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'faraday'
+require 'amazon_sp_clients/adapter_loader'
+require 'amazon_sp_clients/api_response'
+require 'amazon_sp_clients/v2/config'
+require 'amazon_sp_clients/v2/credentials'
+require 'amazon_sp_clients/v2/documents'
+require 'amazon_sp_clients/v2/errors'
+require 'amazon_sp_clients/v2/error_mapper'
+require 'amazon_sp_clients/v2/lwa'
+require 'amazon_sp_clients/v2/rdt'
+require 'amazon_sp_clients/v2/token'
+
+module AmazonSpClients
+  module V2
+    # One client per merchant. Owns the connection, the token source and
+    # the restricted-token cache, and hands out one instance of each API
+    # class. Safe to share across threads.
+    #
+    #   client = Client.new(config) { store.access_token }
+    #   client.orders_v0.get_orders(marketplace_ids, created_after: since)
+    class Client
+      # Tokens API operation that issues restricted data tokens.
+      TOKENS_PATH = '/tokens/2021-03-01/restrictedDataToken'
+      # Carries the access token (or the restricted data token).
+      ACCESS_TOKEN_HEADER = 'x-amz-access-token'
+      # Request timestamp Amazon asks for on every call.
+      DATE_HEADER = 'x-amz-date'
+      # Format of DATE_HEADER.
+      DATE_FORMAT = '%Y%m%dT%H%M%SZ'
+      # Request and response media type of every SP-API operation.
+      JSON_TYPE = 'application/json'
+
+      # @return [Config]
+      attr_reader :config
+
+      # @param config [Config]
+      # @param credentials [#access_token, nil] the token source; or pass a block
+      # @yieldreturn [String] the current access token (see Credentials::Callback)
+      # @raise [ArgumentError] unless exactly one token source is given
+      def initialize(config, credentials: nil, &token)
+        if credentials.nil? == token.nil?
+          raise ArgumentError, 'give credentials: or a block returning the access token'
+        end
+
+        @config = config
+        @credentials = credentials || Credentials::Callback.new(&token)
+        @errors = ErrorMapper.new(:api)
+        @api = build_connection
+        @documents = Documents.new(config)
+        @rdt = RDT::Cache.new
+        @apis = {}
+        @apis_mutex = Mutex.new
+      end
+
+      # A client that exchanges +refresh_token+ through LWA itself, using
+      # the app credentials on +config+.
+      #
+      # @param config [Config] with client_id and client_secret
+      # @param refresh_token [String]
+      # @return [Client]
+      def self.with_refresh_token(config, refresh_token)
+        new(config, credentials: Credentials::RefreshToken.new(LWA.new(config), refresh_token))
+      end
+
+      # One instance of each API class per client, so they all share the
+      # connection.
+      #
+      # @param klass [Class] an Api subclass
+      # @return [Api]
+      def api(klass)
+        @apis_mutex.synchronize { @apis[klass] ||= klass.new(self) }
+      end
+
+      # Sends one request and returns the parsed response. The generated
+      # API classes call this; consumers use them.
+      #
+      # @param method [Symbol] :get, :post, :put, :patch, :delete
+      # @param path [String] request path, already percent-encoded
+      # @param query [Hash] query parameters; nil values are left out
+      # @param headers [Hash] extra request headers; nil values are left out
+      # @param body [Hash, Array, String, nil] sent through to_json unless already a String
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these
+      #   resources; nil or empty sends the normal access token
+      # @return [AmazonSpClients::ApiResponse]
+      # @raise [Error] a ResponseError subclass on a non-2xx status, ConnectionError or
+      #   TimeoutError when no response arrived, ParseError on a non-JSON body
+      def request(method, path, query: {}, headers: {}, body: nil, rdt: nil)
+        token = restricted?(rdt) ? restricted_token(rdt) : @credentials.access_token
+        all_headers = headers.compact.merge(auth_headers(token))
+        response = send_request(method, path, query, all_headers, body)
+
+        ApiResponse.new(parse(response), response)
+      end
+
+      # Uploads feed content to the presigned url of a feed document.
+      #
+      # @param document [Hash] payload of createFeedDocument
+      # @param content_type [String] the one given to createFeedDocument
+      # @param body [String] feed content
+      # @return [nil]
+      # @see Documents#upload
+      def upload_feed_document(document, content_type, body)
+        @documents.upload(document, content_type, body)
+      end
+
+      # Downloads and parses the processing report of a feed.
+      #
+      # @param document [Hash] payload of getFeedDocument
+      # @return [Hash] string-keyed
+      # @see Documents#download_feed_result
+      def download_feed_result(document)
+        @documents.download_feed_result(document)
+      end
+
+      # Downloads a report document, inflating it when gzipped.
+      #
+      # @param document [Hash] payload of getReportDocument
+      # @return [String]
+      # @see Documents#download_report_document
+      def download_report_document(document)
+        @documents.download_report_document(document)
+      end
+
+      private
+
+      def build_connection
+        options = { timeout: @config.timeout, open_timeout: @config.open_timeout }
+        headers = {
+          'User-Agent' => @config.user_agent, 'Content-Type' => JSON_TYPE, 'Accept' => JSON_TYPE
+        }
+
+        Faraday.new(url: @config.base_url, request: options, headers: headers) do |conn|
+          conn.adapter Faraday::Adapter::HTTPClient
+        end
+      end
+
+      def auth_headers(token)
+        { ACCESS_TOKEN_HEADER => token, DATE_HEADER => Time.now.utc.strftime(DATE_FORMAT) }
+      end
+
+      def send_request(method, path, query, headers, body)
+        response = @api.run_request(method, path, encode(body), headers) do |req|
+          req.params.update(query.compact)
+        end
+
+        @errors.check!(response)
+      rescue *ErrorMapper::TRANSPORT_ERRORS => e
+        raise @errors.transport_error(e, method: method, url: "#{@config.base_url}#{path}")
+      end
+
+      # The body's own to_json, not JSON.generate: ActiveSupport's encoder
+      # (ISO 8601 times) only runs through to_json, and v1 called it too.
+      def encode(body)
+        return body if body.nil? || body.is_a?(String)
+
+        body.to_json
+      end
+
+      def parse(response)
+        body = response.body
+        return {} if body.nil? || body.empty?
+
+        parsed = JSON.parse(body, symbolize_names: true)
+        parsed.is_a?(Hash) ? parsed : { payload: parsed }
+      rescue JSON::ParserError => e
+        raise @errors.parse_error("response body is not JSON: #{e.message}", response)
+      end
+
+      def restricted?(rdt)
+        !(rdt.nil? || rdt.empty?)
+      end
+
+      # The Tokens API call inside the fetch goes out with the normal
+      # access token (no rdt:), so it never comes back to the cache lock
+      # that is held around it. Lock order is cache, then credentials.
+      def restricted_token(resources)
+        @rdt.fetch(resources) { fetch_restricted_token(resources) }
+      end
+
+      def fetch_restricted_token(resources)
+        body = { restrictedResources: Array(resources).map(&:to_request) }
+        response = request(:post, TOKENS_PATH, body: body)
+        payload = response.payload
+        token = payload[:restrictedDataToken]
+        unless token
+          raise @errors.parse_error('token response has no restrictedDataToken', response.response)
+        end
+
+        expires_in = payload[:expiresIn]
+        Token.new(access_token: token, token_type: nil, expires_in: expires_in,
+                  expires_at: expires_in && (Time.now.utc + expires_in), refresh_token: nil)
+      end
+    end
+  end
+end

data/lib/amazon_sp_clients/v2/config.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+require 'amazon_sp_clients/version'
+require 'amazon_sp_clients/marketplaces'
+require 'amazon_sp_clients/v2/errors'
+
+module AmazonSpClients
+  module V2
+    # Per-client settings: which SP-API host to talk to, timeouts, the
+    # user agent, and the LWA app credentials (only needed by clients
+    # that exchange refresh tokens themselves). Frozen; build a variant
+    # with +with+:
+    #
+    #   config = Config.new(endpoint: 'eu', sandbox: true)
+    #   config.with(sandbox: false)
+    Config = Data.define(:endpoint, :sandbox, :timeout, :open_timeout,
+                         :client_id, :client_secret, :user_agent)
+
+    class Config
+      # Endpoint codes consumers store per merchant, mapped to the AWS
+      # region that names the SP-API host. Same table as v1's
+      # Configuration#endpoint=.
+      ENDPOINT_REGIONS = {
+        'na' => REGION_NA, 'br' => REGION_NA, 'ca' => REGION_NA, 'mx' => REGION_NA,
+        'us' => REGION_NA,
+        'fe' => REGION_FE, 'au' => REGION_FE, 'jp' => REGION_FE, 'sg' => REGION_FE,
+        'eu' => REGION_EU, 'ae' => REGION_EU, 'de' => REGION_EU, 'eg' => REGION_EU,
+        'es' => REGION_EU, 'fr' => REGION_EU, 'gb' => REGION_EU, 'in' => REGION_EU,
+        'it' => REGION_EU, 'nl' => REGION_EU, 'pl' => REGION_EU, 'sa' => REGION_EU,
+        'se' => REGION_EU, 'tr' => REGION_EU
+      }.freeze
+
+      # North America, where every consumer started.
+      DEFAULT_ENDPOINT = 'na'
+      # Seconds to read or write on an open connection.
+      DEFAULT_TIMEOUT = 60
+      # Seconds to open a connection.
+      DEFAULT_OPEN_TIMEOUT = 10
+      # Names the gem and Ruby version, as Amazon asks.
+      DEFAULT_USER_AGENT = "sp_api_clients/#{VERSION} (Language=Ruby/#{RUBY_VERSION})".freeze
+      # Host prefix of the SP-API sandbox.
+      SANDBOX_PREFIX = 'sandbox.'
+
+      # @param endpoint [String] region or country code ('na', 'eu', 'fe', 'de', ...)
+      # @param sandbox [Boolean] send requests to the sandbox host
+      # @param timeout [Integer] read/write timeout in seconds
+      # @param open_timeout [Integer] connect timeout in seconds
+      # @param client_id [String, nil] LWA app client id
+      # @param client_secret [String, nil] LWA app client secret
+      # @param user_agent [String, nil] nil selects the default
+      # @raise [ArgumentError] on an unknown endpoint code
+      def initialize(endpoint: DEFAULT_ENDPOINT, sandbox: false, timeout: DEFAULT_TIMEOUT,
+                     open_timeout: DEFAULT_OPEN_TIMEOUT, client_id: nil, client_secret: nil,
+                     user_agent: DEFAULT_USER_AGENT)
+        ENDPOINT_REGIONS.fetch(endpoint) do
+          raise ArgumentError, "unknown endpoint #{endpoint.inspect}"
+        end
+
+        super(endpoint: endpoint, sandbox: sandbox, timeout: timeout, open_timeout: open_timeout,
+              client_id: client_id, client_secret: client_secret,
+              user_agent: user_agent || DEFAULT_USER_AGENT)
+      end
+
+      # @return [String] AWS region of the endpoint, e.g. 'us-east-1'
+      def region = ENDPOINT_REGIONS.fetch(endpoint)
+
+      # @return [String] SP-API host, with the sandbox prefix when enabled
+      def host
+        "#{SANDBOX_PREFIX if sandbox}#{REGIONS.fetch(region)}"
+      end
+
+      # @return [String] base URL of every API request
+      def base_url = "https://#{host}"
+
+      # Consoles and error trackers inspect configs; the secret stays out.
+      #
+      # @return [String]
+      def inspect
+        fields = to_h.merge(client_secret: client_secret && FILTERED)
+
+        "#<#{self.class.name} #{fields.map { |k, v| "#{k}=#{v.inspect}" }.join(' ')}>"
+      end
+    end
+  end
+end