walmart-apimatic-sdk 0.0.1 → 0.0.5

data/lib/walmart_ap_is/apis/payouts_api.rb

@@ -0,0 +1,161 @@
+# walmart_ap_is
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module WalmartApIs
+  # PayoutsApi
+  class PayoutsApi < BaseApi
+    # Returns the current payout status for the authenticated seller, including
+    # scheduled payout date, amount, and lifecycle state (Pending, Processing,
+    # Completed, Failed, OnHold). Delegates to GMPPaymentsPlatform (Phase 5).
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def get_payment_status
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/disbursements/v4/payment/paymentstatus',
+                                     Server::DEFAULT1)
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('walletAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(PayoutStatusResponse.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Bad Request',
+                                 ErrorListErrorException)
+                    .local_error('401',
+                                 'Unauthorized — missing, expired, or invalid OAuth2 token',
+                                 ErrorListErrorException)
+                    .local_error('500',
+                                 'Internal Server Error',
+                                 ErrorListErrorException))
+        .execute
+    end
+
+    # Returns whether the authenticated seller is eligible for an on-demand
+    # faster payout, along with the approved amount and any ineligibility
+    # reason.
+    # Delegates to GMPPaymentsPlatform GET
+    # /fasterPayout/eligibility/{partnerId}.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def get_faster_payout_eligibility
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/disbursements/v4/payment/fasterPayoutEligibility',
+                                     Server::DEFAULT1)
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('walletAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(FasterPayoutEligibilityResponse.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Bad Request',
+                                 ErrorListErrorException)
+                    .local_error('401',
+                                 'Unauthorized — missing, expired, or invalid OAuth2 token',
+                                 ErrorListErrorException)
+                    .local_error('500',
+                                 'Internal Server Error',
+                                 ErrorListErrorException))
+        .execute
+    end
+
+    # Triggers an immediate on-demand payout for the authenticated seller,
+    # bypassing the standard settlement schedule. Returns the payout ID and
+    # initial status. Requires "disbursements:write" scope.
+    # Delegates to GMPPaymentsPlatform (Phase 5).
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def initiate_faster_payout
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/disbursements/v4/payment/fasterPayout',
+                                     Server::DEFAULT1)
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('walletAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(InitiatePayoutResponse.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Bad Request',
+                                 ErrorListErrorException)
+                    .local_error('401',
+                                 'Unauthorized — missing, expired, or invalid OAuth2 token',
+                                 ErrorListErrorException)
+                    .local_error('409',
+                                 'Conflict — resource state prevents this operation',
+                                 ErrorListErrorException)
+                    .local_error('500',
+                                 'Internal Server Error',
+                                 ErrorListErrorException))
+        .execute
+    end
+
+    # Enables or disables automatic scheduled payouts for the authenticated
+    # seller.
+    # When enabled, payouts are triggered automatically on the standard
+    # settlement
+    # cadence. Returns updated payout status. Requires "disbursements:write"
+    # scope.
+    # Delegates to GMPPaymentsPlatform (Phase 5).
+    # @param [DisbursementsV4PaymentAutoPayoutRequest] body Required parameter:
+    # TODO: type description here
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def configure_auto_payout(body)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::PUT,
+                                     '/disbursements/v4/payment/autoPayout',
+                                     Server::DEFAULT1)
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body)
+                                .is_required(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('walletAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(PayoutStatusResponse.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Bad Request',
+                                 ErrorListErrorException)
+                    .local_error('401',
+                                 'Unauthorized — missing, expired, or invalid OAuth2 token',
+                                 ErrorListErrorException)
+                    .local_error('500',
+                                 'Internal Server Error',
+                                 ErrorListErrorException))
+        .execute
+    end
+
+    # Returns whether the authenticated seller is opted in to annual statement
+    # generation and the current statement year. Delegates to
+    # GMPPaymentsPlatform
+    # GET /annualStatementOpts/{partnerId}.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def get_annual_statement_opts
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/disbursements/v4/payment/annualStatementOpts',
+                                     Server::DEFAULT1)
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('walletAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(AnnualStatementOptsResponse.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Bad Request',
+                                 ErrorListErrorException)
+                    .local_error('401',
+                                 'Unauthorized — missing, expired, or invalid OAuth2 token',
+                                 ErrorListErrorException)
+                    .local_error('500',
+                                 'Internal Server Error',
+                                 ErrorListErrorException))
+        .execute
+    end
+  end
+end

data/lib/walmart_ap_is/apis/product_fees_api.rb

@@ -0,0 +1,140 @@
+# walmart_ap_is
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module WalmartApIs
+  # ProductFeesApi
+  class ProductFeesApi < BaseApi
+    # Returns estimated Walmart fees for a list of items identified by
+    # Walmart Item ID or Seller SKU.
+    # @param [Array[FeesEstimateByIdRequest]] body Required parameter: TODO:
+    # type description here
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def get_my_fees_estimates(body)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/products/fees/v4/feesEstimate',
+                                     Server::DEFAULT1)
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body)
+                                .is_required(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('walletAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(FeesEstimateResult.method(:from_hash))
+                    .is_api_response(true)
+                    .is_response_array(true)
+                    .local_error('400',
+                                 'Bad Request',
+                                 ErrorListErrorException)
+                    .local_error('403',
+                                 'Forbidden',
+                                 ErrorListErrorException)
+                    .local_error('404',
+                                 'Not Found',
+                                 ErrorListErrorException)
+                    .local_error('429',
+                                 'Rate limit exceeded',
+                                 ErrorListErrorException)
+                    .local_error('500',
+                                 'Internal Server Error',
+                                 ErrorListErrorException))
+        .execute
+    end
+
+    # Returns an estimated fee for a single item identified by Walmart Item ID.
+    # Walmart Item ID replaces the SP-API ASIN path parameter per ADR-029.
+    # @param [String] walmart_item_id Required parameter: The Walmart Item ID of
+    # the item. Replaces SP-API ASIN per ADR-029.
+    # @param [GetMyFeesEstimateRequest] body Required parameter: TODO: type
+    # description here
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def get_my_fees_estimate_for_item(walmart_item_id,
+                                      body)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/products/fees/v4/items/{WalmartItemId}/feesEstimate',
+                                     Server::DEFAULT1)
+                   .template_param(new_parameter(walmart_item_id, key: 'WalmartItemId')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body)
+                                .is_required(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('walletAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(GetMyFeesEstimateResponse.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Bad Request',
+                                 ErrorListErrorException)
+                    .local_error('403',
+                                 'Forbidden',
+                                 ErrorListErrorException)
+                    .local_error('404',
+                                 'Not Found',
+                                 ErrorListErrorException)
+                    .local_error('429',
+                                 'Rate limit exceeded',
+                                 ErrorListErrorException)
+                    .local_error('500',
+                                 'Internal Server Error',
+                                 ErrorListErrorException))
+        .execute
+    end
+
+    # Returns an estimated fee for a seller listing identified by Seller SKU.
+    # @param [String] seller_sku Required parameter: The seller's SKU for the
+    # listing. Scoped to the authenticated seller.
+    # @param [MarketplaceId] marketplace_id Required parameter: Marketplace
+    # identifier.
+    # @param [GetMyFeesEstimateRequest] body Required parameter: TODO: type
+    # description here
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def get_my_fees_estimate_for_sku(seller_sku,
+                                     marketplace_id,
+                                     body)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/products/fees/v4/listings/{SellerSKU}/feesEstimate',
+                                     Server::DEFAULT1)
+                   .template_param(new_parameter(seller_sku, key: 'SellerSKU')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .query_param(new_parameter(marketplace_id, key: 'MarketplaceId')
+                                 .is_required(true))
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body)
+                                .is_required(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('walletAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(GetMyFeesEstimateResponse.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Bad Request',
+                                 ErrorListErrorException)
+                    .local_error('403',
+                                 'Forbidden',
+                                 ErrorListErrorException)
+                    .local_error('404',
+                                 'Not Found',
+                                 ErrorListErrorException)
+                    .local_error('429',
+                                 'Rate limit exceeded',
+                                 ErrorListErrorException)
+                    .local_error('500',
+                                 'Internal Server Error',
+                                 ErrorListErrorException))
+        .execute
+    end
+  end
+end