Orders

Overview

The Orders Table provides an organized and comprehensive view of all sales orders processed through the Stryde API portal. This table is designed to help users quickly access, monitor, and manage orders, making it easy to track order statuses, delivery details, and synchronization with SAP systems.

Orders can be created in two ways:

Each order is represented in a row with several key fields, ensuring all critical information is displayed at a glance. For more detailed insights into an order, users can click on the Order Number, which serves as a unique link to the order’s details page.

Orders Table

Note: The table might not display all fields for all users; based on the user's role and permissions.

Table Columns

SAP No.

  • Displays the unique identifier assigned to the order in the SAP system once it is successfully synchronized.
  • A value of “-” indicates that the order has not yet been synced with SAP.

Order No.

  • A system-generated unique code assigned to each sales order in the Stryde API portal.

  • This code is clickable, redirecting users to the detailed view of the respective order, which includes additional data like items, delivery breakdowns, and pricing.

Company

  • Shows the name of the company associated with the order. This helps identify the entity responsible for processing the order.

Reference No.

  • A reference number provided for the order, which is the Order no. in the external client system; can be used for cross-checking with external documents or systems.

Customer

  • Displays the customer’s name and account code, providing a quick reference for whom the order is being processed.

Status

  • Indicates the current status of the order, such as:

  • Open

  • Delivered
  • Partially Delivered
  • Canceled

This allows users to quickly understand where the order is in the fulfillment process.

Order Date

  • The date when the order was created in the system. This helps in tracking and filtering orders by creation time.

Delivery Date

  • The expected or scheduled delivery date for the order. It provides clarity on the time frame for fulfillment.

Delivery Type

  • Specifies the delivery method chosen for the order, such as:

  • Same Day - Bulk (0 Day)

  • Standard - Home (2 Day)

This ensures transparency regarding delivery timelines and modes.

Cost

  • Displays the total delivery cost for the order in KWD (Kuwaiti Dinar).

Sync Status (SYNC)

  • Indicates whether the order has been successfully synchronized with our SAP system:
  • ✅ Green Check: Synced successfully.
  • ❌ Red Cross: Not yet synced or failed to sync.

Order Details

The Order Details page provides a comprehensive view of a specific sales order. It displays all relevant information about the order, including customer details, shipping information, pricing, SAP synchronization status, and more. This page is divided into various blocks for better organization and clarity.

Can be accessed by clicking on the Order No. in the Orders Table.

Note: The page might not contain all the information blocks for all users; based on the user's role and permissions.

Basic Order Information

Basic Order Information

Order Information

This block contains general details about the sales order:

  • Company: Name of the company that the order belongs to.
  • Delivery Type: Indicates the selected delivery Type (e.g., Standard - Home, Same Day - Bulk). Delivery Types is set based on the difference between the Delivery Date and Order Date, Along with if the order delivery type is Bulk or Home.
  • Order Status: Current status of the order (e.g., Delivered, Open, Partially Delivered, Canceled).
  • Order Date: Date the order was created.
  • Delivery Date: Scheduled delivery date.
  • Remarks: Additional comments or notes about the order.
  • Price Calculation: Status of the price calculation process (e.g., Completed, Failed).

Customer Information

This block displays information about the customer associated with the order:

  • Name: Customer’s name.
  • Number: Customer’s contact number.
  • Client Ref.: Unique reference code for the customer; which is usually the Customer Code in the external client system.

Billing & Shipping Address

This block contains the billing and shipping addresses for the customer as provided when the order was created.

Order Address Parsing

Order Address Parsing

The Address Parsing block ensures that the Area field is populated for all orders. If the Area field was not provided during order creation, the system automatically attempts to parse and extract the Governorate, Area, Block, and Street from the shipping and billing addresses.

However, if the Area field is already provided, the system will skip the address parsing process.

Note: The parsed results may sometimes require manual correction if the address format is non-standard or contains special cases.

SAP Posting

SAP Posting

The SAP Posting block provides detailed information about the integration status of the order with the SAP system. This block ensures users can track whether the sales order and delivery documents have been successfully posted to SAP and view essential metadata related to the posting process.

Key Details:

  • Status: Indicates whether the SAP posting process was successful (e.g., Synced, Not Synced, or Failed).
  • Sync Date: The date when the sales order or delivery was successfully posted to SAP.
  • Sales Order Document Entry: DocEntry assigned to the sales order in the SAP system.
  • Sales Order Document Number: DocNum assigned to the sales order in the SAP system.

Notes:

  • A Synced status confirms the order and delivery have been successfully integrated into SAP.
  • A Not Synced or Failed status indicates that manual intervention or further investigation may be required.

Order Items

Order Items

Key Fields:

  • Item Code: A unique identifier for the item, used in the inventory, usually the Item Code in the external client system.
  • Description: A brief description of the item for better understanding and identification.
  • Model Code: A code representing the specific model of the item, if applicable.
  • Barcode: The item's barcode for easy scanning and tracking.
  • Item Group: The category or group to which the item belongs in the inventory system.
  • Warehouse: The warehouse from which the item will be dispatched.
  • Qty.: The quantity of the item requested in the order.
  • Delivered Qty.: The quantity of the item already delivered.
  • Is Serialized: Indicates whether the item requires serial number tracking (Yes/No).

Clicking on the arrow icon to the right of the item code will expand the item row, displaying the services associated with the item.

Order Items Expanded

Order Actions

The Order Actions button is located in the top-right corner of the Order Details page, appearing as a dropdown menu that provides access to various order management functions.

Order Actions

Important: The availability of actions and the button itself is determined by user permissions. Not all users will have access to view or execute all options. The actions displayed are filtered based on the user's role and assigned privileges within the system.

The Order Actions dropdown menu provides several options for managing and processing orders:

Sync Order to SAP

  • Manually triggers the synchronization process between the Stryde API portal and SAP system
  • Useful when automatic synchronization has failed or needs to be re-attempted
  • Only available for orders that haven't been synced or had failed sync attempts

Create Delivery

  • Redirects to the Delivery Creation page for the order, refer to Creating Deliveries for more details.
  • Available only for orders with "Open" or "Partially Delivered" status

Re-Calculate Service Charges

  • Triggers a recalculation of delivery and service charges
  • Useful when order details have been modified or when initial calculation failed
  • Updates the total cost based on current delivery parameters and pricing rules

Cancel Order

  • Allows users to cancel an existing order
  • Only available for orders that haven't been delivered or synced with SAP
  • Requires appropriate user permissions to execute

Managing Order Items

The Items section allows authorized users to add or remove products from an order. The system provides an intuitive interface to manage order items while enforcing inventory and company-specific constraints.

Adding Items

To add new items to an order, click the "Add Items" button in the top-right corner of the Items section. This opens a modal form with the following fields:

  1. Item Search

  2. Search for items by code, name, or description

  3. Only items that are:

    • Present in the item master
    • Linked to the same company as the sales order
    • Will appear in search results

  4. Warehouse Selection

  5. Choose the warehouse from which to fulfill the order

  6. Stock availability is checked against the selected warehouse

  7. Quantity

  8. Specify the number of units to order
  9. Must not exceed available stock in the selected warehouse

Add Items Form

Important: The system performs several validations when adding items:

  • Verifies item availability in the selected warehouse
  • Checks if the item belongs to the order's company
  • Ensures requested quantity doesn't exceed available stock

If there's insufficient stock, the system will display an error message:

Add Items Error

Selected Items View

Once items are selected, they appear in a table within the modal showing:

  • Item Name
  • Item Code
  • Warehouse
  • Quantity
  • Action (Remove)

Selected Items

Removing Items

Items can be removed from the order in two ways:

  1. Using the remove button (trash icon) in the main items list
  2. Using the "Remove" action in the Add Items modal for newly selected items

Note: The ability to add or remove items may be restricted based on:

  • User permissions
  • Order status
  • Whether the order has been synced with SAP
  • Whether any deliveries have been created

Managing Services For Order Items

Each item in an order can have associated services. These services can be managed by expanding the item row using the arrow icon, which reveals the Related Services section.

Add Services

View Related Services

  • Click the arrow icon next to an item to expand the row
  • The Related Services section will be displayed below the item details

Add New Service

  • Click the "Add Service" button in the top-right corner of the Related Services section
  • Select the desired service from the available options

Remove Service

  • Click the remove button (trash icon) in the Actions column
  • Service will be immediately removed from the item

Note: The ability to add or remove item services may be restricted based on:

  • User permissions
  • Order status
  • Whether the order has been synced with SAP

Managing Order Service Charges

The Service Charges section allows authorized users to add or modify delivery and additional service charges for an order. While service charges are typically calculated and added automatically based on the system's pricing rules, authorized users can modify these charges when necessary.

Add Service Charges Form

Adding Service Charges

To add new service charges to an order, click the "Add Service Charges" button in the top-right corner of the Service Charges section. This opens a modal form with the following fields:

Selected Services

Service Search

  • Allows searching for available services by name or code
  • Services are predefined in the system

Price

  • The cost per unit of the selected service
  • May be fixed or editable based on service configuration

Quantity

  • Specify the number of units for the service
  • Usually corresponds to delivery units or service instances

Selected Services View

Once services are selected, they appear in a table within the modal showing:

  • Service Name
  • Price per Unit
  • Quantity
  • Total Amount
  • Action (Remove)

Selected Services

After Selecting the services, click the Save Service Charges button to add the charges to the order. This will also update the order total cost.

Removing Service Charges

Service charges can be removed in two ways:

  1. Using the remove button (trash icon) in the main service charges list
  2. Using the "Remove" action in the Add Service Charges modal for newly selected services

Note: The ability to add or modify service charges may be restricted based on:

  • User permissions
  • Order status
  • Whether the order has been synced with SAP

Creating New Sales Order

Sales orders can be created in two ways:

  1. Through the web interface using the order creation form
  2. Through API calls to the Stryde API endpoints

Web Interface

To create a new sales order through the web interface, click the Create New Order button in the top-right corner of the Orders Table. This will open a form with several sections for entering order details.

Note: Fields marked with an asterisk (*) are mandatory.

Order Information

  • Company: Select the company the order is being created for
  • Client Reference Code: Order number in the external client system
  • Order Date: Date when the order is created, defaults to today's date
  • Delivery Date: Expected delivery date, defaults to two days from the today's date
  • Home Delivery: Toggle for home delivery orders
  • Remarks: Additional notes or comments about the order

Customer Information

  • Customer Code: Unique identifier for the customer
  • Name: Customer's name
  • Number: Contact phone number

Address Information

  • Billing Address: Complete billing address
  • Shipping Address: Delivery location details
  • Area: Select the delivery area

Items and Services

The process for adding items and their associated services is identical to the management process described in:

Once all required information is entered, click the Create Sales Order button to submit the order. The system will validate all inputs and create the order if all requirements are met.

API Integration

Orders can also be created programmatically through API calls. This is particularly useful for:

  • Integrating external e-commerce platforms
  • Automating order creation from other systems
  • Bulk order processing

For detailed information about creating orders via API, including endpoints, request/response formats, and authentication, please refer to the API Documentation

Note: Whether created through the web interface or API, all orders follow the same validation rules and business logic.