newstore-apimatic-sdk 0.0.1

data/lib/new_store_api/controllers/inventory_configuration_controller.rb

@@ -0,0 +1,46 @@
+# new_store_api
+#
+# This file was automatically generated for NewStore by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module NewStoreApi
+  # InventoryConfigurationController
+  class InventoryConfigurationController < BaseController
+    # Returns the current inventory configuration.
+    # @param [String] store_id Optional parameter: Store Identifier for store
+    # configuration at store level.
+    # @return [ConfigModelResponse] Response from the API call.
+    def show_inventory_config(store_id: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/inventory/config',
+                                     Server::API)
+                   .query_param(new_parameter(store_id, key: 'store_id'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('oauth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(ConfigModelResponse.method(:from_hash)))
+        .execute
+    end
+
+    # Sets the configuration. Note: you can pass an * to enable store-dependent
+    # features.
+    # @param [ConfigModel] body Required parameter: TODO: type description
+    # here
+    # @return [void] Response from the API call.
+    def replace_inventory_config(body)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::PUT,
+                                     '/inventory/config',
+                                     Server::API)
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('oauth')))
+        .response(new_response_handler
+                    .is_response_void(true))
+        .execute
+    end
+  end
+end

data/lib/new_store_api/controllers/jobs_controller.rb

@@ -0,0 +1,224 @@
+# new_store_api
+#
+# This file was automatically generated for NewStore by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module NewStoreApi
+  # JobsController
+  class JobsController < BaseController
+    # <div style="background-color: rgba(243, 156, 18, 0.15); border: 1px solid
+    # #f39c12; border-left: 4px solid #f39c12; padding: 12px; margin: 10px 0;
+    # border-radius: 4px; color: #f39c12;">
+    #   <strong>🚧 BETA:</strong> This endpoint is in beta and may change.
+    #   <br />
+    #   See <a href="https://docs.newstore.com/docs/api-lifecycle"
+    # target="_blank" style="color: #f39c12; text-decoration: underline;">API
+    # Lifecycle Documentation</a> for details.
+    # </div>
+    # List all export jobs for a tenant with optional filtering by date range,
+    # status, and dataset name
+    # @param [String] x_new_store_tenant Required parameter: Tenant identifier
+    # @param [String | Object | nil] created_after Optional parameter: Filter
+    # jobs created after this date (ISO 8601 format, e.g.,
+    # 2024-01-01T00:00:00Z)
+    # @param [String | Object | nil] created_before Optional parameter: Filter
+    # jobs created before this date (ISO 8601 format, e.g.,
+    # 2024-01-31T23:59:59Z)
+    # @param [String | Object | nil] status Optional parameter: Filter jobs by
+    # status (COMPLETED, RUNNING, FAILED, CANCELLED, PENDING)
+    # @param [String | Object | nil] dataset Optional parameter: Filter jobs by
+    # dataset name (exact match)
+    # @return [JobListResponse] Response from the API call.
+    def list_jobs(x_new_store_tenant,
+                  created_after: nil,
+                  created_before: nil,
+                  status: nil,
+                  dataset: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/data-exports/jobs',
+                                     Server::API)
+                   .header_param(new_parameter(x_new_store_tenant, key: 'X-NewStore-Tenant'))
+                   .query_param(new_parameter(created_after, key: 'created_after')
+                                 .validator(proc do |value|
+                                   UnionTypeLookUp.get(:ListJobsCreatedAfter)
+                                                  .validate(value)
+                                 end))
+                   .query_param(new_parameter(created_before, key: 'created_before')
+                                 .validator(proc do |value|
+                                   UnionTypeLookUp.get(:ListJobsCreatedBefore)
+                                                  .validate(value)
+                                 end))
+                   .query_param(new_parameter(status, key: 'status')
+                                 .validator(proc do |value|
+                                   UnionTypeLookUp.get(:ListJobsStatus)
+                                                  .validate(value)
+                                 end))
+                   .query_param(new_parameter(dataset, key: 'dataset')
+                                 .validator(proc do |value|
+                                   UnionTypeLookUp.get(:ListJobsDataset)
+                                                  .validate(value)
+                                 end))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('oauth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(JobListResponse.method(:from_hash)))
+        .execute
+    end
+
+    # <div style="background-color: rgba(243, 156, 18, 0.15); border: 1px solid
+    # #f39c12; border-left: 4px solid #f39c12; padding: 12px; margin: 10px 0;
+    # border-radius: 4px; color: #f39c12;">
+    #   <strong>🚧 BETA:</strong> This endpoint is in beta and may change.
+    #   <br />
+    #   See <a href="https://docs.newstore.com/docs/api-lifecycle"
+    # target="_blank" style="color: #f39c12; text-decoration: underline;">API
+    # Lifecycle Documentation</a> for details.
+    # </div>
+    # Create a new export job (synchronous or asynchronous)
+    # @param [String] x_new_store_tenant Required parameter: Tenant identifier
+    # @param [CreateJobRequest] body Required parameter: TODO: type description
+    # here
+    # @param [String | Object | nil] store_id Optional parameter: Optional store
+    # ID
+    # @param [String | Object | nil] user_id Optional parameter: Optional user
+    # ID
+    # @param [String] format Optional parameter: Export format for sync jobs:
+    # 'json' or 'csv'
+    # @return [JobIdResponse | SyncJobResponse] Response from the API call.
+    def create_job(x_new_store_tenant,
+                   body,
+                   store_id: nil,
+                   user_id: nil,
+                   format: 'json')
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/data-exports/jobs',
+                                     Server::API)
+                   .header_param(new_parameter(x_new_store_tenant, key: 'X-NewStore-Tenant'))
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .query_param(new_parameter(store_id, key: 'store_id')
+                                 .validator(proc do |value|
+                                   UnionTypeLookUp.get(:CreateJobStoreId)
+                                                  .validate(value)
+                                 end))
+                   .query_param(new_parameter(user_id, key: 'user_id')
+                                 .validator(proc do |value|
+                                   UnionTypeLookUp.get(:CreateJobUserId)
+                                                  .validate(value)
+                                 end))
+                   .query_param(new_parameter(format, key: 'format'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('oauth')))
+        .response(new_response_handler
+                    .deserializer(proc do |response, should_symbolize|
+                      APIHelper.deserialize_union_type(
+                        UnionTypeLookUp.get(:CreateJobResponse),
+                        response, should_symbolize, true
+                      )
+                    end)
+                    .deserialize_into(ResponseCreatejob.method(:from_hash)))
+        .execute
+    end
+
+    # <div style="background-color: rgba(243, 156, 18, 0.15); border: 1px solid
+    # #f39c12; border-left: 4px solid #f39c12; padding: 12px; margin: 10px 0;
+    # border-radius: 4px; color: #f39c12;">
+    #   <strong>🚧 BETA:</strong> This endpoint is in beta and may change.
+    #   <br />
+    #   See <a href="https://docs.newstore.com/docs/api-lifecycle"
+    # target="_blank" style="color: #f39c12; text-decoration: underline;">API
+    # Lifecycle Documentation</a> for details.
+    # </div>
+    # Cancel an export job
+    # @param [String] job_id Required parameter: The unique identifier of the
+    # export job
+    # @param [String] x_new_store_tenant Required parameter: Tenant identifier
+    # @return [JobResponse] Response from the API call.
+    def destroy_job(job_id,
+                    x_new_store_tenant)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::DELETE,
+                                     '/data-exports/jobs/{job_id}',
+                                     Server::API)
+                   .template_param(new_parameter(job_id, key: 'job_id')
+                                    .should_encode(true))
+                   .header_param(new_parameter(x_new_store_tenant, key: 'X-NewStore-Tenant'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('oauth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(JobResponse.method(:from_hash)))
+        .execute
+    end
+
+    # <div style="background-color: rgba(243, 156, 18, 0.15); border: 1px solid
+    # #f39c12; border-left: 4px solid #f39c12; padding: 12px; margin: 10px 0;
+    # border-radius: 4px; color: #f39c12;">
+    #   <strong>🚧 BETA:</strong> This endpoint is in beta and may change.
+    #   <br />
+    #   See <a href="https://docs.newstore.com/docs/api-lifecycle"
+    # target="_blank" style="color: #f39c12; text-decoration: underline;">API
+    # Lifecycle Documentation</a> for details.
+    # </div>
+    # Get the status and details of an export job
+    # @param [String] job_id Required parameter: The unique identifier of the
+    # export job
+    # @param [String] x_new_store_tenant Required parameter: Tenant identifier
+    # @return [JobResponse] Response from the API call.
+    def show_job_status(job_id,
+                        x_new_store_tenant)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/data-exports/jobs/{job_id}',
+                                     Server::API)
+                   .template_param(new_parameter(job_id, key: 'job_id')
+                                    .should_encode(true))
+                   .header_param(new_parameter(x_new_store_tenant, key: 'X-NewStore-Tenant'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('oauth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(JobResponse.method(:from_hash)))
+        .execute
+    end
+
+    # <div style="background-color: rgba(243, 156, 18, 0.15); border: 1px solid
+    # #f39c12; border-left: 4px solid #f39c12; padding: 12px; margin: 10px 0;
+    # border-radius: 4px; color: #f39c12;">
+    #   <strong>🚧 BETA:</strong> This endpoint is in beta and may change.
+    #   <br />
+    #   See <a href="https://docs.newstore.com/docs/api-lifecycle"
+    # target="_blank" style="color: #f39c12; text-decoration: underline;">API
+    # Lifecycle Documentation</a> for details.
+    # </div>
+    # Generate signed URLs for downloading job results
+    # @param [String] job_id Required parameter: The unique identifier of the
+    # export job
+    # @param [String] x_new_store_tenant Required parameter: Tenant identifier
+    # @param [Integer] expiration_minutes Optional parameter: URL expiration
+    # time in minutes
+    # @return [JobDownloadResponse] Response from the API call.
+    def show_download_url(job_id,
+                          x_new_store_tenant,
+                          expiration_minutes: 5)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/data-exports/jobs/{job_id}/downloads',
+                                     Server::API)
+                   .template_param(new_parameter(job_id, key: 'job_id')
+                                    .should_encode(true))
+                   .header_param(new_parameter(x_new_store_tenant, key: 'X-NewStore-Tenant'))
+                   .query_param(new_parameter(expiration_minutes, key: 'expiration_minutes'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('oauth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(JobDownloadResponse.method(:from_hash)))
+        .execute
+    end
+  end
+end

data/lib/new_store_api/controllers/manifests_controller.rb

@@ -0,0 +1,37 @@
+# new_store_api
+#
+# This file was automatically generated for NewStore by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module NewStoreApi
+  # ManifestsController
+  class ManifestsController < BaseController
+    # <div style="background-color: rgba(243, 156, 18, 0.15); border: 1px solid
+    # #f39c12; border-left: 4px solid #f39c12; padding: 12px; margin: 10px 0;
+    # border-radius: 4px; color: #f39c12;">
+    #   <strong>🚧 BETA:</strong> This endpoint is in beta and may change.
+    #   <br />
+    #   See <a href="https://docs.newstore.com/docs/api-lifecycle"
+    # target="_blank" style="color: #f39c12; text-decoration: underline;">API
+    # Lifecycle Documentation</a> for details.
+    # </div>
+    # @param [RequestCreateManifest] body Required parameter: TODO: type
+    # description here
+    # @return [ResponseCreateManifest] Response from the API call.
+    def create_manifests(body)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/fulfillment/manifests',
+                                     Server::API)
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('oauth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(ResponseCreateManifest.method(:from_hash)))
+        .execute
+    end
+  end
+end

data/lib/new_store_api/controllers/notifications_controller.rb

@@ -0,0 +1,50 @@
+# new_store_api
+#
+# This file was automatically generated for NewStore by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module NewStoreApi
+  # NotificationsController
+  class NotificationsController < BaseController
+    # <div style="background-color: rgba(243, 156, 18, 0.15); border: 1px solid
+    # #f39c12; border-left: 4px solid #f39c12; padding: 12px; margin: 10px 0;
+    # border-radius: 4px; color: #f39c12;">
+    #   <strong>🚧 BETA:</strong> This endpoint is in beta and may change.
+    #   <br />
+    #   See <a href="https://docs.newstore.com/docs/api-lifecycle"
+    # target="_blank" style="color: #f39c12; text-decoration: underline;">API
+    # Lifecycle Documentation</a> for details.
+    # </div>
+    # @param [EventNameEnum] event_name Required parameter: Example:
+    # @param [String] x_request_id Required parameter: TODO: type description
+    # here
+    # @param [String] x_new_store_tenant Required parameter: TODO: type
+    # description here
+    # @param [String] idempotency_key Optional parameter: TODO: type description
+    # here
+    # @param [ProfileDeleted] body Optional parameter: TODO: type description
+    # here
+    # @return [void] Response from the API call.
+    def create_notification(event_name,
+                            x_request_id,
+                            x_new_store_tenant,
+                            idempotency_key: nil,
+                            body: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/checkout/rtbf-notifications',
+                                     Server::API)
+                   .header_param(new_parameter(event_name, key: 'Event-Name'))
+                   .header_param(new_parameter(x_request_id, key: 'X-Request-Id'))
+                   .header_param(new_parameter(x_new_store_tenant, key: 'X-NewStore-Tenant'))
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .header_param(new_parameter(idempotency_key, key: 'Idempotency-Key'))
+                   .body_param(new_parameter(body))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('oauth')))
+        .response(new_response_handler
+                    .is_response_void(true))
+        .execute
+    end
+  end
+end

data/lib/new_store_api/controllers/o_auth_authorization_controller.rb

@@ -0,0 +1,42 @@
+# new_store_api
+#
+# This file was automatically generated for NewStore by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module NewStoreApi
+  # OAuthAuthorizationController
+  class OAuthAuthorizationController < BaseController
+    # Create a new OAuth 2 token.
+    # @param [String] authorization Required parameter: Authorization header in
+    # Basic auth format
+    # @param [String] scope Optional parameter: Requested scopes as a
+    # space-delimited list.
+    # @param [Hash] _field_parameters Additional optional form parameters are
+    # supported by this endpoint.
+    # @return [OAuthToken] Response from the API call.
+    def request_token(authorization,
+                      scope: nil,
+                      _field_parameters: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/token',
+                                     Server::ACCESS_TOKEN_SERVER)
+                   .form_param(new_parameter('client_credentials', key: 'grant_type'))
+                   .header_param(new_parameter(authorization, key: 'Authorization'))
+                   .form_param(new_parameter(scope, key: 'scope'))
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'content-type'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .additional_form_params(_field_parameters))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(OAuthToken.method(:from_hash))
+                    .local_error('400',
+                                 'OAuth 2 provider returned an error.',
+                                 OAuthProviderException)
+                    .local_error('401',
+                                 'OAuth 2 provider says client authentication failed.',
+                                 OAuthProviderException))
+        .execute
+    end
+  end
+end

data/lib/new_store_api/controllers/order_injection_config_controller.rb

@@ -0,0 +1,80 @@
+# new_store_api
+#
+# This file was automatically generated for NewStore by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module NewStoreApi
+  # OrderInjectionConfigController
+  class OrderInjectionConfigController < BaseController
+    # Retrieves the current order injection configuration set up for your
+    # business. The response payload
+    # also contains the current version of the configuration, the timestamp when
+    # it was
+    # last updated, and who updated it.
+    # @return [OrderInjectionConfigurationResponse] Response from the API call.
+    def show_order_injection_configuration
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/v1/r/config/order_injection',
+                                     Server::API)
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('oauth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(OrderInjectionConfigurationResponse.method(:from_hash)))
+        .execute
+    end
+
+    # Updates the current order injection configuration for your business. The
+    # version value in the query parameter
+    # must match the latest version returned by the GET endpoint.
+    # @param [String] version Required parameter: TODO: type description here
+    # @param [OrderInjectionTenantConfiguration] body Optional parameter: The
+    # updated config value
+    # @return [OrderInjectionConfigurationResponse] Response from the API call.
+    def update_order_injection_configuration(version,
+                                             body: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::PATCH,
+                                     '/v1/r/config/order_injection',
+                                     Server::API)
+                   .query_param(new_parameter(version, key: 'version'))
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('oauth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(OrderInjectionConfigurationResponse.method(:from_hash)))
+        .execute
+    end
+
+    # Use this method to create a new order injection configuration or
+    # completely replace the current
+    # configuration for your business. The version value in the query parameter
+    # must either be set to 1
+    # or it must match the latest version returned by the GET endpoint.
+    # @param [String] version Required parameter: TODO: type description here
+    # @param [OrderInjectionTenantConfiguration] body Optional parameter: The
+    # updated config value
+    # @return [OrderInjectionConfigurationResponse] Response from the API call.
+    def create_order_injection_configuration(version,
+                                             body: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/v1/r/config/order_injection',
+                                     Server::API)
+                   .query_param(new_parameter(version, key: 'version'))
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('oauth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(OrderInjectionConfigurationResponse.method(:from_hash)))
+        .execute
+    end
+  end
+end

data/lib/new_store_api/controllers/order_injection_controller.rb

@@ -0,0 +1,125 @@
+# new_store_api
+#
+# This file was automatically generated for NewStore by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module NewStoreApi
+  # OrderInjectionController
+  class OrderInjectionController < BaseController
+    # <div style="background-color: rgba(23, 162, 184, 0.15); border: 1px solid
+    # #17a2b8; border-left: 4px solid #17a2b8; padding: 12px; margin: 10px 0;
+    # border-radius: 4px; color: #17a2b8;">
+    #   <strong>ℹ️ Rate Limit:</strong> This endpoint is rate limited to 20
+    # requests per second.
+    # </div>
+    # Creates an order in NewStore by importing an order placed via an external
+    # system.
+    # This is also referred as *injecting an order*.
+    # Each request creates a single order in NewStore.
+    # The request payload depends on the order you are creating. For example:
+    # - A pre-routed order relies on a `routing strategy` defined with the
+    # [fulfillment
+    # configuration](/newstore-cloud/newstore.html#fulfillment-configuration).
+    # - An in-store pickup order relies on the `in-store configuration` defined
+    # with the [in-store pickup config
+    # resource](/newstore-cloud/store_operations/in_store_pickup.html).
+    # This method is idempotent, with regards to the `external_id` property. You
+    # can use the
+    # method multiple times to create the same order in the platform. The order
+    # itself is created
+    # only once, with the same response payload returned every time.
+    # There can be transient errors (`500`) when creating an order, such as a
+    # timeout when communicating
+    # with the shipping provider. To fix these errors, retry the method again
+    # with the same payload.
+    # **Important**:
+    # - Ensure that the request payload is same when creating an order with
+    # several
+    # tries. A retry with the same `external_id` but a different payload will
+    # fail.
+    # - Ensure that there is a small delay between each retry.
+    # - Only the `200` response implies that the order has been created
+    # correctly. Therefore,
+    # ensure that your integration has a retry logic set up.
+    # For more information, see the request examples and
+    # [Importing orders](https://docs.newstore.com/docs/importing-orders).
+    # **Add-ons**
+    # An item can be declared as an add-on of another item by setting
+    # `shipments[].items[].addon_parent_external_item_id` to the
+    # `external_item_id`
+    # of the parent item. The add-on is created as a separate line item linked
+    # to
+    # that parent and carries its own price. The parent must be a non-add-on
+    # item in
+    # the **same shipment**; add-ons cannot be nested (the parent must not
+    # itself be
+    # an add-on) and an item cannot reference itself. A reference that breaks
+    # these
+    # rules is rejected with `400` (error code `addon_invalid_parent_item`).
+    # An add-on's own and its parent's `external_item_id` must be unique across
+    # the
+    # whole order; a duplicate makes the linkage ambiguous and is rejected with
+    # `400`
+    # (error code `addon_duplicate_external_item_id`).
+    # **Configuration**
+    # There are two configuration settings that impact injection flow:
+    # `big_sales_order`
+    # and `skip_soft_routing_on_injection`. For more information, see the page
+    # with all
+    # [order_injection
+    # configuration](https://docs.newstore.net/api/configuration/order-managemen
+    # t/order_injection_admin/#tag/Injection-configuration/operation/updateConfi
+    # g).
+    # **Notes:**
+    # - Ensure that you specify the correct number of decimal places for
+    # monetary values of
+    # prices, according to the specified currency. For example, if the currency
+    # is specified as
+    # ``USD`` and the price has more than 2 decimal places, it is considered as
+    # invalid by the
+    # platform. For more information, see
+    # [pricing dependencies on
+    # currency](https://docs.newstore.com/v1/docs/set-up-payments#managing-produ
+    # ct-pricing-dependencies-on-currency).
+    # - To send payment-related metadata with the order, use the
+    # [Create financial
+    # instrument](https://docs.newstore.net/api/webhooks/fat_psp_hook/#operation
+    # /createFinancialInstrument)
+    # method in the Payment Provider webhooks.
+    # - The validity of a shipping offer token can vary based on the shipping
+    # provider and shipping offer. For `in-store pickup` orders, a shipping
+    # offer
+    # token does not expire.
+    # - If you set `shipments[].shipment_option.routing_strategy` as "external"
+    # and the routing failed to communicate
+    # with shipping provider, the order will be cancelled. Check shipping
+    # provider integration, if you have customer
+    # integration, otherwise contact team delivery for support.
+    # - If the customer's phone number does not have a country calling code, the
+    # platform will attempt to use the
+    # billing address country code to derive the calling code while formatting
+    # the phone number to the E.164
+    # standard. If the phone number cannot be formatted, it will be placed in
+    # the extended attribute
+    # `injected-invalid-phone-number` on customer profile. It can be updated
+    # later, if needed.
+    # @param [InjectedOrderRequest] body Required parameter: TODO: type
+    # description here
+    # @return [InjectedOrderResponse] Response from the API call.
+    def create_injected_order(body)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/v0/d/fulfill_order',
+                                     Server::API)
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('oauth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(InjectedOrderResponse.method(:from_hash)))
+        .execute
+    end
+  end
+end

data/lib/new_store_api/controllers/order_placement_controller.rb

@@ -0,0 +1,48 @@
+# new_store_api
+#
+# This file was automatically generated for NewStore by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module NewStoreApi
+  # OrderPlacementController
+  class OrderPlacementController < BaseController
+    # <div style="background-color: rgba(243, 156, 18, 0.15); border: 1px solid
+    # #f39c12; border-left: 4px solid #f39c12; padding: 12px; margin: 10px 0;
+    # border-radius: 4px; color: #f39c12;">
+    #   <strong>🚧 BETA:</strong> This endpoint is in beta and may change.
+    #   <br />
+    #   See <a href="https://docs.newstore.com/docs/api-lifecycle"
+    # target="_blank" style="color: #f39c12; text-decoration: underline;">API
+    # Lifecycle Documentation</a> for details.
+    # </div>
+    # Place an order for processing in the NewStore platform. A successful
+    # response means the order has been accepted; payment capture, receipt
+    # generation, and downstream processing complete asynchronously.
+    # @param [String] idempotency_key Required parameter: Caller-provided key
+    # used to make order placement safe to retry.
+    # @param [OrderRequest] body Required parameter: The order to place.
+    # @param [String] x_newstore_request_id Optional parameter: Optional
+    # caller-provided request correlation identifier. Generated by the service
+    # when omitted.
+    # @return [OrderResponse] Response from the API call.
+    def create_order_placement(idempotency_key,
+                               body,
+                               x_newstore_request_id: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/orders',
+                                     Server::API)
+                   .header_param(new_parameter(idempotency_key, key: 'idempotency-key'))
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .header_param(new_parameter(x_newstore_request_id, key: 'x-newstore-request-id'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('oauth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(OrderResponse.method(:from_hash)))
+        .execute
+    end
+  end
+end