Akinon Release Notes (05/12/2025) are now live! Click here to learn what's new.
LogoLogo
API Reference
  • Home
  • Quick Start
  • Tutorials
  • Technical Guides
  • Release Notes
  • Glossary
  • Welcome to Akinon Tutorials
  • ACC
    • How to Manage Projects and Services?
    • How to Use Demo Projects with ARC?
    • How to Move Apps into ACC?
    • How To Configure Database Connection in ACC?
    • How to Configure Your ACC Application with akinon.json and Procfile?
    • How to Create, Manage, Build, and Deploy Applications in ACC?
    • How to Install Applications from the App Store in ACC?
    • How to Add and Manage Domains in ACC?
    • How to Generate and Add Public Keys in ACC?
    • How to Monitor Application Resources in ACC?
    • How to Manage Users and Roles in ACC?
    • How to Integrate a BI Tool with Your Project in ACC?
  • Omnitron
    • Products & Catalogs
      • How to Add and Bulk Update Products in Omnitron?
      • How to Create Product Attributes and Attribute Sets in Omnitron?
      • How to Manage Catalogs in Omnitron?
      • How to Create and Update Price Lists in Omnitron?
      • How to Create and Update Stock Lists in Omnitron?
      • How to Create and Manage Collections in Omnitron?
    • Orders
      • How to Manage Orders in Omnitron?
      • How to Manage Cancellation and Return Requests in Omnitron?
    • Sales Channels
      • How to Manage Products in Omnitron?
      • How to Manage Registered Users Based on Sales Channel?
      • How to Create and Update Customer Groups in Omnitron?
      • Marketing
        • How to Create and Manage Campaigns in Omnitron
        • How to Create and Manage Coupons in Omnitron?
        • How to Create and Manage Bulk Coupons in Omnitron?
        • How to Create and Manage Discount Codes in Omnitron?
        • How to Configure SEO Settings in Omnitron?
        • How to Configure URL Redirects and Settings in Omnitron?​
        • How to Manage Promotions in Omnitron?
      • Content Management
        • How to Manage Widgets in Omnitron?
        • How to Manage Widget Schema in Omnitron?
        • How to Manage Flat Pages in Omnitron?
        • How to Manage Custom/Campaign Pages in Omnitron?
        • How to Manage Navigations/Menus in Omnitron?
        • How to Manage Mailing Templates in Omnitron?
      • Store Management
        • How to Manage Stores in Omnitron?
        • How to Manage Instore Store Employees in Omnitron?
        • How to Manage Instore Store from Omnitron?
        • How to Manage Store Delivery Points in Omnitron?
        • How to Manage Slots and Retail Store Groups?
      • Payment Management
        • How to Manage POS Integrations in Omnitron?
        • How to Manage Banks in Omnitron?
        • How to Manage Card Types in Omnitron?
        • How to Manage Card Settings in Omnitron?
        • How to Manage Checkout Providers in Omnitron?
        • How to Manage Payment Options in Omnitron?
      • Category Management
        • How to Automatically Assign Category Mapping Rules in Omnitron?
      • Sales Channel Settings
        • How to Configure Marketplace Attribute Mapping in Omnitron?
        • How to Manage Marketplace Mapping in Omnitron?
        • How to Manage Marketplace Operations?
        • How to Manage Address Mapping in Omnitron?
        • How to Manage Social Accounts in Omnitron?
        • How to Manage Loyalty Integration Settings?
        • How to Manage Store Stock Settings?
        • How to Manage Product List Filter Settings?
        • How to Manage Instore Settings in Omnitron?
        • How to Manage General Sorting Settings?
        • How to Manage Shipping Options in Omnitron?
        • How to Manage Delivery Options in Omnitron?
        • How to Manage Easy Return Shipping Options in Omnitron?
    • Integration
      • How to Manage Pending Products in Omnitron?
      • How to Manage City/District Mapping Error Logs in Omnitron?
    • Reports
      • How to Create and Download Reports in Omnitron?
    • Settings
      • How to Add and Configure a New Sales Channel in Omnitron?
      • How to Add and Configure a Shipping Company in Omnitron?
      • How to Create and Manage Sorting Algorithms in Omnitron?
      • How to Create and Manage Users in Omnitron?
      • How to Manage Reasons for Cancellation and Return in Omnitron?
      • How to Manage Authority Groups in Omnitron?
      • How to Manage Advanced Permission Policies and Items?
      • How to Log in to Omnitron Using OAuth2 (SSO)?
  • OMS
    • How to Set Up and Manage Locations in OMS?
    • How to Set Up Basic Configurations in OMS?
    • How to Manage Application Settings in OMS?
    • How to Add and Edit Stock Locations in OMS?
    • How to Create or Edit Distribution Scenarios in OMS?
    • How to Create or Edit Transfer Scenarios in OMS ?
    • How to Perform a Product Search in OMS?
    • How to Add or Edit a Product Stock Integration Engine in OMS?
    • How to Add or Edit Shipping Details in OMS?
    • How to Add or Edit a Webhook in OMS?
    • How to Add or Edit a State Transition in OMS?
    • How to Add or Edit a Packaging Refusal Reason in OMS?
    • How to Pull Orders from Omnitron to OMS?
    • How to Add or Edit Translatable Models in OMS?
    • How to Manage Scheduled Operations in OMS?
    • Working Logic of Scenarios
  • Instore
    • How to Install the Instore Service on an ACC Project?
    • How to Create Customer Account?
    • How to Manage Store & Staff?
    • How to Manage Instore Settings?
    • How to Create Instore Settings Via Omnitron Panel?
    • How to Customize Instore Widgets?
    • How to Configure Payment Methods in Instore?
    • Instore User Manual
      • Selling Through Instore
      • Order Refund/Cancellation Processes
      • Click & Collect Order Management (For Brands without an OMS)
      • Package Orders
      • Transfer Orders
      • Customer Profile
      • Settings
  • Integrator
    • How to Update S3 Bucket?
    • How to Manage Users in Integrator?
    • How to Create and Manage Integration Flow?
    • How to Monitor Integration Logs in Integrator?
    • How to Use the Flow Testing Screen in Integrator?
    • How to Use Alarm Services in Integrator?
    • How to Monitor Flow Performance in Integrator?
    • How to Create a Version Service in Integrator?
    • Flows
      • Login Flow
      • Product Flow
      • Stock Flow
      • Full Stock Flow
      • Price Flow
      • Full Price Flow
      • Order Flow
      • Order Status Flow
      • Order Cancel Flow
      • OMS Stock Flow
      • Whippy Stock Flow
      • Generic Proxy Flow
      • Image S3 Flow
      • Video S3 Flow
      • JOLT Mapping
      • Scripting in Flows
  • Project Zero
    • How to Configure Mini Basket?
    • How to Optimize Menu Performance?
    • How to Implement the Quickly Add to Cart Feature?
    • How to Implement Product Image Slider?
    • How to Create and Integrate a Custom Payment Option View in Checkout?
  • Marketplace Dashboard
    • How to Monitor Integration Logs in the Marketplace Dashboard?
    • How to Monitor Integration Reports in Marketplace Dashboard?
    • How to Create Alarms and Notifications in Marketplace Dashboard?
  • Akifast
    • Akifast Admin Dashboard
    • Akifast Merchant Dashboard
  • Seller Center
    • Seller
      • Settings
        • How to Manage Users in Seller Center?
        • How to Generate and Revoke Access Tokens in Seller Center?
        • How to Manage Delivery Settings in Seller Center?
      • Products
        • How to Use Offer Actions in Seller Center?
        • How to Add Single Product in Seller Center?
        • How to Add Product Offers Using Bulk Actions in Seller Center?
        • How to Manage Offers via Marketplace Catalog?
        • How to Create Revison Requests?
        • How to Use Bulk Actions in Seller Center?
        • Inventory Management
          • How to Manage Stock List in Seller Center?
          • How to Manage Price List in Seller Center?
      • Orders
        • How to Manage Orders in Seller Center?
        • How to Manage Packages in Seller Center?
        • How to Manage Cancellation & Returns in Seller Center?
      • Finance
        • Account Management
        • How to Manage Reconciliations in Seller Center?
      • Store Management
      • Messages
      • Support
    • Marketplace Owner
      • Settings
        • How to Manage Users in Seller Center?
        • How to Manage Delivery Settings in Seller Center?
        • How to Manage Offer Reject Reasons in Seller Center?
        • How to Manage Attribute Set & Category Mapping?
      • Products
        • How to Manage Offers via Marketplace Catalog?
        • How to Use Offer Actions in Seller Center?
      • Orders
        • How to Manage Orders in Seller Center?
        • How to Manage Packages in Seller Center?
        • How to Cancel or Return an Order in Seller Center?
      • Finance
        • How to Manage Reconciliations?
        • Seller Management
      • Support
      • Messages
  • Whippy Ware
    • Whippy Ware
  • Dynamic Price
    • Dynamic Price
  • How to Use Offer Reject Reasons?
Powered by GitBook

© 2025 Akinon. All rights reserved.

On this page
  • Step 1: The Functioning of an Appropriate Scenario​
  • Step 2: Adding Stock Locations To Rules​
  • Step 3: Stock Location Ranking​
  • OMS Scenario Examples​

Was this helpful?

  1. OMS

Working Logic of Scenarios

PreviousHow to Manage Scheduled Operations in OMS?NextInstore

Last updated 16 days ago

Was this helpful?

Step 1: The Functioning of an Appropriate Scenario​

In OMS, various scenarios can operate based on the order's channel information, shipping details, payment method, and customer type.

For creating a scenario for orders placed through a specific channel:

  • The Channel Condition Type needs to be static, and the required channel information should be included.

To create a scenario for orders from all order channels;

  • Simply select the Channel Condition Type as Dynamic.

For orders from all order channels but with a specific shipping company, you can create a scenario like in the example:

Orders from a specific order channel and with a particular shipping company can have a scenario created as shown below:

Step 2: Adding Stock Locations To Rules​

  • Packages can be created at locations entered in the Stock Location List.

  • Packages can be generated at locations excluding those entered in the “Except Stock Location”.

  • Packages can be created at locations in the same country/state/district/neighborhood as the order address based on the location type.

    • For this option to function correctly, the OMS > Application Settings > GEOLOCATION_DISCOVERY and GEOCODE_PROVIDER_SETTINGS settings need to be included.

  • Packages can be created at locations of the entered type with the Stock Location Type. For instance, when a store is selected, packages will form only at locations classified as stores, and when a warehouse is chosen, packages will form exclusively at locations labeled as warehouses.

Step 3: Stock Location Ranking​

  • It can be sorted in increasing/decreasing order based on importance.

  • It can be sorted in increasing/decreasing order based on the stock amount returned from stores.

  • It can be sorted in increasing/decreasing order based on the package density in stores.

  • It can be sorted in increasing/decreasing order based on the distance from stores to delivery addresses.

    • For this option to function properly, the Application Settings > GEOLOCATION_DISCOVERY and GEOCODE_PROVIDER_SETTINGS settings need to be included.

  • Multiple sorting options can be added here. For instance, in the provided sorting, locations are arranged initially by importance and then by package density.

OMS Scenario Examples​

Creating Single Package in the Warehouse​

  • Rule Name: It could be "Bulk Packaging in the Warehouse" or "Single Package Creation in the Warehouse."

  • The option for Suitable for partial shipment should not be checked.

  • Only the Warehouse location should be added to the stock location list.

  • The Warehouse location should be marked as the Packaging Center on the Stock Location Details page.

  • Even if only one location is added, the location sequence should be selected. It can be sorted in increasing order of importance.

  • After creating the rule, click on Save Rule and then on Save Scenario.

  • The example of the rule can be found below:

Creating Single Package in the Store​

  • Rule Name: It could be "Bulk Packaging in the Store" or "Single Package Creation in the Store."

  • The option for Suitable for partial shipment should not be checked.

  • Only the desired stores where packaging is required should be added to the stock location list.

  • The added stores should be marked as the Packaging Center on the Stock Location Details page.

  • Multiple stores can be added to this list. If the entire stock returns in a package from a specific store, OMS will create the package in that store.

  • Since multiple stores are added, the location sequence should be selected. It can be sorted in increasing order of importance.

  • After creating the rule, click on Save Rule and then on Save Scenario.

  • The example of the rule can be found below:

Creating Partial Packages in the Store/Warehouse

  • Rule Name: It could be Partial Package Creation.

  • The option for Suitable for partial shipment should be checked.

  • The desired stores where packaging is required should be added to the stock location list.

  • The added stores should be checked as the Packaging Center on the Stock Location Details page.

  • Multiple stores can be added to this list. The logic behind this rule works as follows:

    • In a case where, 3 products are in the order.

    • Suppose Warehouse + Store 1 are added to the rule.

    • Consider that for two of the products in the order, stock is available in the warehouse, and for the remaining one, stock is available at Store 1 location.

    • In this scenario, when this rule works during the planning step, it will create Package P1 (2 products) in the warehouse and Package P2 (1 product) at Store 1 location.

  • Since multiple stores are added, the location sequence should be selected. It can be sorted in increasing order of importance.

  • After creating the rule, click on Save Rule and then on Save Scenario.

  • The example of the rule can be found below:

Product/Base Code-based Packaging​

This field is used when running a rule for specific products within an order. First, the condition type needs to be selected. There are two options for the condition type:

  1. SKU: SKU numbers of specific products to be separately planned should be entered. Multiple SKU numbers can be entered.

  2. Product Base Code: Base code numbers of specific products intended for separate planning should be entered. Multiple base code numbers can be entered.

For the rule to function as intended, the Partial Packaging option should also be checked. Additionally, the specific locations where these products are intended to be planned should be added to the stock location list.

Product Preconditions​

This field is used to run a rule for bundle products within an order. There are three options available here:

  1. All Products: This is the default value.

  2. Only Bundled Products: Regardless of whether partial packaging is marked for bundled products within the order, they are still taken out from the same location.

  3. Excluding Bundled Products: Even if partial packaging is marked for non-bundled products within the order, they are still taken out from the same location.

  4. Only Trade-in Products: It excludes products marked for trade-in within the order. To use this condition, the Application Settings > IS_TRADEIN_ENABLED setting must be set to true.

Packing Marketplace Orders​

These rules are established for packaging orders from platforms like Trendyol, Hepsiburada, Amazon, Morhipo, and similar marketplaces.

The same scenario rules can be applied for orders coming from these channels, and the logic remains consistent. There are two key points to be noted:

  1. The scenario should be selected according to the order channel, specifically as the marketplace channel.

  2. The partial packaging process for orders from Hepsiburada and Trendyol needs to be examined. The process here progresses differently from the standard partial packaging process.

Packing Trendyol & Hepsiburada Orders​

For orders from these two channels, a single package can be created either in the warehouse or in the store. There's no difference in the process here. The example scenarios mentioned earlier can be applied.

For orders from these two channels, if multiple packages are desired, there are a few additional steps to be taken:

  1. In the scenario, the Initial Status field is set to Waiting Remote Action.

  2. From the Akinon Settings > Webhooks page, a new webhook is included with the type "order.fulfillment.multiple_packages."

Following these procedures, a partial packaging rule similar to the one in the above example can be entered. The order gets split based not on the status "Waiting" of the resulting packages but on the status entered in the "Initial State" field in the scenario.

To explain the process with example;

  • Consider an order, S1, as a Trendyol order containing three products.

  • The scenario rule added was marked as suitable for Partial Packaging, and the order.fulfillment.multiple_packages webhook was added.

  • Warehouse + Store 1 are added to the rule.

  • Consider that stock is available in the warehouse for two of the products in the order, while the remaining one has stock available at Store 1 location.

  • In this scenario, when this rule works during the planning step, it will create Package P1 (2 products) in the warehouse, and Package P2 (1 product) at Store 1 location in the Waiting Remote Action status.

  • The status of these packages and the information about the products within are communicated to Omnitron through the order.fulfillment.multiple_packages webhook. Omnitron then informs Trendyol about the status of the packages and the product details.

  • Trendyol cancels order S1 and forwards packages P1 and P2 as two new orders (S2, S3) to Omnitron.

  • Omnitron initiates the cancellation of order S1. OMS responds to this cancellation request by canceling packages P1 and P2 associated with order S1.

  • OMS retrieves the two newly sent orders, S2 and S3, from Omnitron and places them back into the planning process. New packages are formed for S2 and S3.

  • The process continues until a single package is created.

Packing for Express Delivery / Same-Day Delivery / Next-Day Delivery Orders​

  • The scenario should include express delivery options!

  • The shipping integrations for these couriers must be set up within the OMS!

  • Rule Name: Packing for Express Delivery Orders

  • The Partial Packaging option should not be selected.

  • Only the stores where packaging is desired should be added to the stock location list.

  • The added stores here should be marked as Express Delivery Available or Eligible for Express Delivery on the "Stock Location Details" page.

  • Multiple stores can be added to this list. If a store has sufficient stock for all items in the package, OMS will create the package at that store.

  • As multiple stores are added, the location sequence should be selected. It can be arranged in increasing order of priority.

  • Once this rule is created, it should be saved by clicking on the Save Rule and Save Scenario buttons.

Transfer Scenario​

  • For the Transfer scenario to function, a rule in the Distribution Scenario needs to be marked as Transferable.

  • A new transfer scenario and transfer rule should be added.

  • Rule Name: Locations Available for Transfer

  • In the Rule's "Prerequisite" section, if chosen According to Package Location, it determines the locations to which the transfer will occur. This is the destination location for the transfer.

  • In the lower section, only stores available for transfers should be added to the Stock Location list. This section represents the source location for the transfer.

  • The added stores here should be marked as Transfer Center on the Stock Location Details page.

  • Multiple stores can be added to the stock location section. OMS will initiate the transfer from the store where there is sufficient stock for the items in the package.

  • As multiple stores have been added, a location hierarchy should be chosen and arranged in ascending order based on priority.

  • After creating the rule in this manner, it's important to click on Save Rule and then on Save Scenario buttons.

Packaging Click & Collect Orders​

Click & Collect orders do not require any specific scenario for planning. OMS assigns the package to the "retail_store" location provided with the order.

The Application Settings > IS_CLICK_AND_COLLECT_ENABLED setting should be set to True.

This process can be examined in more detail in the following document: .

Additionally, there is for further information.

This process can be further explored in detail in the document .

Trendyol - Partial Packaging Workflow
Trendyol - Order Package Distribution Process and Setup Document
Akinon Express Delivery Process