Instance · Ecommerce
Managing Orders
Last updated 1 November 2026
Insites allows you to create and manage orders for the ecommerce module of your application. The following topics are discussed in detail in this document:
- Updating an order
- Managing contacts
- Managing shipping information
- Managing billing information
- Managing custom fields
- Managing notes
- Viewing the event stream
- Viewing system information
- Deleting an order
- Inventory
- Orders and payments
Updating an order
To update an order:
- Navigate to Ecommerce from the main menu.
- Select Orders.
- Find the order you want to update and select its View row action link.
- Select EDIT to update an order's details. You can also make changes across the following tabs:
- Items
- Discounts
- Payments
- Contacts
- Shipping
- Billing
- Custom Fields
- Notes
- Event Stream
- System Info
- Select SAVE.
Managing contacts
This section includes the following topics:
- Adding a contact
- Updating a contact
Adding a contact
To add a contact:
- Navigate to Ecommerce from the main menu.
- Select Orders.
- Find the order to which you want to add a contact and select its View row action link.
- Navigate to the 'Contacts' tab.
- The Contacts tab has two sections, Company and Contact. In an empty section, select ADD COMPANY or ADD CONTACT. Once a record is set, use its EDIT or REMOVE button. You can add the following to the order:
- Company
- Contact
- Fill out the form for adding a contact to the order. You can refer to the Contacts section in the 'Adding an Order' document for the input requirements.
- Select ADD COMPANY or ADD CONTACT.
Updating a contact
To update a contact:
- Navigate to Ecommerce from the main menu.
- Select Orders.
- Find the order containing the contact you want to update and select its View row action link.
- Navigate to the 'Contacts' tab.
- Find the contact you want to update and select its EDIT link.
- Make your changes.
- Select SAVE.
Managing shipping information
- Adding shipping information
- Updating shipping information
Adding shipping information
To add shipping information:
- Navigate to Ecommerce from the main menu.
- Select Orders.
- Find the order to which you want to add shipping information and select its View row action link.
- Navigate to the 'Shipping' tab.
- Each part of the Shipping tab has its own button: ADD SHIPPING COMPANY, ADD SHIPPING CONTACT and ADD SHIPPING ADDRESS. Shipping packages are added with CREATE SHIPPING PACKAGE, and each package card has a menu with 'Edit Shipping Package' and 'Delete Shipping Package'. You can add the following types of shipping information to the order:
- Shipping Company
- Shipping Contact
- Shipping Address
- Shipping Packages
- Fill out the form for adding shipping information to the order. You can refer to the Shipping section in the 'Adding an Order' document for the input requirements of the company, contact and address. The inputs for a shipping package are listed in the table after this step-by-step guide.
- Select the submit button of the form, for example ADD SHIPPING COMPANY.
The table below displays the input requirements and descriptions for a shipping package:
| Input Label | Type | Required | Description |
|---|---|---|---|
| Package Details | |||
| Package Name | Input Field | Yes | Name of the shipping package. |
| Package Status | Dropdown Field | Yes | Status of the shipping package. |
| Shipping Fee | Number Field | No | Shipping fee of the package. |
| Package Dispatch Date | Date and Time Field | No | Date and time the package was dispatched. |
| Package Delivered Date | Date and Time Field | No | Date and time the package was delivered. |
| Freight Details | |||
| Freight Supplier | Dropdown Field | No | Freight supplier that carries the package. |
| Freight Method | Dropdown Field | No | Freight method of the selected freight supplier. |
| Freight Option | Dropdown Field | No | Freight option of the selected freight supplier. |
| Freight Tracking Code | Input Field | No | Tracking code of the shipment. |
| Package Content | |||
| Items | Multi-Select Dropdown Field | Yes | Order items that are in the package. |
Updating shipping information
To update shipping information:
- Navigate to Ecommerce from the main menu.
- Select Orders.
- Find the order containing the shipping information you want to update and select its View row action link.
- Navigate to the 'Shipping' tab.
- Find the shipping information you want to update and select its EDIT link.
- Make your changes.
- Select SAVE.
Managing billing information
This section includes the following topics:
- Adding billing information
- Updating billing information
Adding billing information
To add billing information:
- Navigate to Ecommerce from the main menu.
- Select Orders.
- Find the order to which you want to add billing information and select its View row action link.
- Navigate to the 'Billing' tab.
- Each part of the Billing tab has its own button: ADD BILLING COMPANY, ADD BILLING CONTACT and ADD BILLING ADDRESS. You can add the following types of billing information to the order:
- Billing Company
- Billing Contact
- Billing Address
- Fill out the form for adding billing information to the order. You can refer to the Billing section in the 'Adding an Order' document for the input requirements.
- Select the submit button of the form, for example ADD BILLING COMPANY.
Updating billing information
To update billing information:
- Navigate to Ecommerce from the main menu.
- Select Orders.
- Find the order containing the billing information you want to update and select its View row action link.
- Navigate to the 'Billing' tab.
- Find the billing information you want to update and select its EDIT link.
- Make your changes.
- Select SAVE.
Managing custom fields
You can use the 'Custom Fields' tab to update the custom fields used by the order. To update custom fields:
- Navigate to Ecommerce from the main menu.
- Select Orders.
- Find the order containing the custom field you want to update and select its View row action link.
- Navigate to the 'Custom Fields' tab.
- Select EDIT.
- Make your changes.
- Select SAVE.
Managing notes
This section includes the following topics:
- Adding a note
- Updating a note
Adding a note
To add a note to the order:
- Navigate to Ecommerce from the main menu.
- Select Orders.
- Find the order to which you want to add notes and select its View row action link.
- Navigate to the 'Notes' tab.
- Select ADD ORDER NOTE
- Fill out the form for adding notes to the order. You can refer to the Notes section in the 'Adding an Order' document for the input requirements
- Select ADD ORDER NOTE.
Updating a note
To update a note:
- Navigate to Ecommerce from the main menu.
- Select Orders.
- Find the order containing the note you want to update and select its View row action link.
- Navigate to the 'Notes' tab.
- Select EDIT.
- Make your changes.
- Select SAVE.
Viewing the event stream
The event stream enables you to review significant events related to the order. To view the order's event stream:
- Navigate to Ecommerce from the main menu.
- Select Orders.
- Find the order whose event stream you want to view and select its View row action link.
- Navigate to the 'Event Stream' tab.
You can view event stream details by selecting VIEW DETAILS. This view enables you to examine previous data stored in the order and compare it with current data.
Viewing system information
System information stored for an order displays basic data such as the date and time when an order was created and the date and time of the latest order update. To view system information:
- Navigate to Ecommerce from the main menu.
- Select Orders.
- Find the order whose system information you want to view and select its View row action link.
- Navigate to the 'System Info' tab.
Deleting an order
To delete an order:
- Navigate to Ecommerce from the main menu.
- Select Orders.
- Find the order you want to delete and select its Delete row action link.
- Complete the order deletion process using the confirmation modal.
Inventory
Take note of the following system behaviors regarding the ecommerce inventory:
- Each product and each variant has a stock level. The Ecommerce module does not change stock levels when an order is placed, paid, failed or refunded. If your project tracks stock, your storefront must update the stock level, for example through the API.
- A cart item stores the product, the variant and the quantity, but not a price. Each order item stores its own name, SKU, quantity and prices, so an order keeps the prices it was placed at.
Orders and payments
The following notes apply to orders and payments:
- Monetary values for orders and payments are stored as decimal numbers in the order's currency. For example, an order amount of $1.00 is saved as 1.0, and $105.55 is saved as 105.55.
- An order can have 0, 1, or multiple payments.
- A cart is not linked to an order. When a customer checks out, your storefront creates the order and adds its order items. The order items show the breakdown of what was bought.
- Orders support multiple payments (e.g., installments or recurring payments). This feature must be managed on the front end, as it meets a project requirement.
- Payments are associated with orders by assigning an order UUID to a payment.
- Orders and payments support partial/multiple payments. Thus, one order can have multiple payments. This feature must be managed on the front end, as suited to the project's requirements.