Our Shopify app:
Connects the Shopify store to Onro.
Maps each Shopify location to a pickup address (Shopify address or an Onro address-book address).
Controls which delivery methods are handled by Onro by letting you enable/configure:
Local Delivery
Flat Rate
Dynamic Rates (rate calculated by Onro pricing at checkout page)
Shipping Default (fallback when Shopify merges rates)
Automatically creates a delivery order in Onro when a Shopify customer checks out using an enabled method, and at the Shopify stage you choose.
Pushes fulfillment + tracking back to Shopify (optionally attaches the Onro tracking link when fulfillment happens).
Let you manage the delivery from the app: view statuses, track, cancel, and download shipment label.
Sync cancellations both ways (Onro → Shopify fulfillment cancel, and/or Shopify → Onro delivery cancel).
In this article, we go through every step to help you configure your store settings in our Shopify app.
What we see here:
Connecting a Business to the Shopify App |
Setting Up Pickup Location Settings |
Configuring Local Delivery Settings |
Configuring Flat-rate Delivery Method Settings |
Configuring Dynamic Delivery Method Settings |
Configuring Shipping Default Delivery Method |
Creating Orders Using the Onro Shopify App |
Order Management |
Order Fulfillment Process |
Managing Order Cancellations |
1. Connecting a Business to the Shopify App
Connecting your store to the Onro's Shopify app is the very first step in managing your business's shop on the go. In this guide, we walk you through everything you need to do to start.
First, you need a business customer account.
To do so, navigate to Onro -> Customers tab
Create a business account to connect the Shopify app.
Open the customer account profile in the Customers tab and copy their Client ID and Client Secret, as you will need to insert them into the Shopify app for authentication.
Now, we need to connect your customer account to the Shopify app. To do so, follow the steps below:
Click here to install the Onro app in the store, and click "Install".
After installing, click on "Open" to transfer to the Onro app environment.
In the opened window, paste the Client ID and Client Secret that you have in the business customer account from Onro.
Then, insert your REST(API) domain address. Your address is one of the following:
api.yourdomain or rest.yourdomain
Ex: rest.onro.io
4. Click submit to connect the customer account.
2. Setting Up Pickup Location Settings
You can assign a specific pickup address to stores, which determines the pickup location used for delivery orders when they are created in Onro. This ensures that your orders are automatically assigned the correct pickup location.
To set this up, go to the Shopify account, then from the left menu navigate to Apps → Onro → Settings → Pickup Location.
Here, you will see a list of existing Shopify locations. Click Edit to configure a location.
You have 2 options to choose from:
Shopify location address: which is the address that has been configured in Shopify Locations settings for this shop location.
Address from your delivery address book: Choose from the saved addresses associated with the customer account in Onro, which is the same account used to connect the Shopify app.
You can view and manage saved addresses by going to Onro → Customers → find the account and click the Details button → Addresses tab.
To add a new address to the address book, click the New button, enter the required information, and then click Submit.
3. Configure Shipping Methods
To automatically create orders in Onro from the Shopify app, first set up shipping methods. Onro supports four shipping methods: Local Delivery, Flat Rate, Shipping Default, and Dynamic Rates. Configure at least one method to ensure Shopify orders sync to Onro automatically and are sent for fulfillment.
3.1. Configuring Local Delivery Settings
Local delivery lets you deliver online orders directly to customers within a defined area (instead of using a carrier). When a customer’s shipping address qualifies, “Local Delivery” appears as a checkout option.
After you finish setting up Local Delivery in Shopify, you can activate it inside the Onro Shopify app.
From the left-hand menu, go to Onro → Settings.
Under Delivery Methods, select Local Delivery.
A window will open, displaying all locations in the Shopify store that are eligible for local delivery, based on your Shopify settings.
Only locations that offer delivery in the Shopify settings will be available as an option when creating orders.
If there are multiple locations for local delivery, you don’t manually pick the location at checkout unless you build custom logic. Shopify decides the fulfillment location per order based on inventory and location rules.
To manage how orders are created in Onro from the Shopify app, click "Edit" on any of the listed locations.
In the opened window:
Click the Enable button to activate this delivery method.
Service: Choose the service type from your Onro Management Console that new orders should use.
Vehicle Type: Required only for on-demand services. Select the vehicle that should be assigned.
Payment Method: Choose how the order will be paid: Cash by Sender, Cash by Receiver, or Customer Wallet.
Create delivery order when: Decide at which Shopify stage the order should be created in your Onro Management Console.
Fulfill Shopify order when: Choose the status at which the order should be marked as Fulfilled in Shopify.
(Optional) Attach tracking info: If enabled, the Onro tracking link will be added to the Shopify order when fulfillment occurs.
Click save to apply your changes.
3.2. Configuring Flat-rate Delivery Method Setting
Flat shipping rates let you charge a fixed amount for shipping during checkout. You can set these rates for all orders in a shipping zone, or you can apply them only to orders that fall within a specific weight or price range.
Check this article to learn about how you can set flat-rate shipping prices
Now, to set up your flat rate settings in the Onro app so that orders using the flat rate delivery method are created in Onro, go to your Shopify → Apps → Onro App → Settings and choose Flat rates.
All your existing flat rates are listed here. You can choose to activate or leave them inactive in Onro.
Orders will only be created in Onro when a flat rate is active and the settings are properly configured.
Click Edit to configure the settings:
Click the Enable button to activate this delivery method.
Service: Choose the service type from your Onro Management Console that new orders should use.
Vehicle Type: Required only for on-demand services. Select the vehicle that should be assigned.
Payment Method: Choose how the order will be paid: Cash by Sender, Cash by Receiver, or Customer Wallet.
Create delivery order when: Decide at which Shopify stage the order should be created in your Onro Management Console.
Fulfill Shopify order when: Choose the status at which the order should be marked as Fulfilled in Shopify.
(Optional) Attach tracking info: If enabled, the Onro tracking link will be added to the Shopify order when fulfillment occurs.
Click save to apply your changes.
3.3. Configuring Dynamic Rates Settings
Dynamic rate is another delivery method that can be configured and used. This method receives the order price directly from Onro based on the service and the vehicle type chosen in the Dynamic Rates configurations. The price is calculated based on the pricing settings that you have set in Onro.
If you configure more than one dynamic rate setting, you can see all of them at the checkout form.
In Shopify, from the left-hand menu, go to Onro App → Settings.
Under Delivery Methods, select Dynamic Rates.
A window will open, displaying your dynamic pricing settings. You can edit or delete them here.
To create a new configuration, click Add Dynamic Rate.
In the opened window:
Name: Enter a name that reflects the purpose of this configuration. This cannot be changed later.
Code: Assign a unique code for the dynamic rate. This also cannot be changed later.
Description: Add a clear description for this setting.
Service: Choose the service type from your Onro Management Console that new orders should use.
Vehicle Type: Required only for on-demand services. Select the vehicle that should be assigned.
Payment Method: Choose how the order will be paid: Cash by Sender, Cash by Receiver, or Customer Wallet.
Create a delivery order when: Decide at which Shopify stage the order should be created in your Onro Management Console.
Fulfill Shopify order when: Choose the status at which the order should be marked as Fulfilled in Shopify.
(Optional) Attach tracking info: If enabled, the Onro tracking link will be added to the Shopify order when fulfillment occurs.
Click save to create the dynamic rate.
3.4. Configuring Shipping Default Delivery Method
The Shipping Default setting determines how Onro handles cases where Shopify combines multiple shipping rates into one option at checkout. By enabling and configuring it, you ensure that Onro applies the correct settings whenever Shopify automatically merges rates.
To configure it, go to Shopify → Apps→ Onro App → Settings and choose Shipping Default.
Click the Enable button to activate this delivery method in Onro.
Service: Choose the service type from your Onro Management Console that new orders should use.
Vehicle Type: Required only for on-demand services. Select the vehicle that should be assigned.
Payment Method: Choose how the order will be paid: Cash by Sender, Cash by Receiver, or Customer Wallet.
Create delivery order when: Decide at which Shopify stage the order should be created in your Onro Management Console.
Fulfill Shopify order when: Choose the status at which the order should be marked as Fulfilled in Shopify.
(Optional) Attach tracking info: If enabled, the Onro tracking link will be added to the Shopify order when fulfillment occurs.
Click save to apply your changes.
4. Creating Orders Using the Shopify App
When a customer enters their address at checkout, Shopify displays the available shipment methods for that location. If those shipment methods are already configured and enabled inside the Onro Shopify app settings, the delivery order will be created in Onro automatically after the customer completes the purchase.
The creation of the delivery order in Onro depends on the Create delivery order when setting in the shipment method configuration, which determines at which stage of the Shopify order process the Onro delivery order should be created.
You can view all status updates for your delivery orders instantly by opening the Orders section in the Onro app. This page shows the current stage of the delivery order and gives you the option to cancel the order, track its progress by tracking link or download the shipment label.
Delivery order in Onro
The corresponding order in your Onro management console is created using your default Shopify shop location as the pickup address, and the customer’s address, phone number, and email as the drop-off information.
5. Order Management
You can track and manage your delivery orders in real time directly within the Shopify panel.
To do so, navigate to the orders tab in Shopify.
From the order table, you can download the shipment label, view order statuses, sync orders info from Onro, and access the order tracking.
Each delivery order can be accessed and managed through your Onro management console by searching for the order using the order code shown in the Onro Shopify app’s Orders table.
6. Order Fulfillment Process
Order fulfillment in Shopify means everything you do to get a customer’s order from “Placed” to "Delivered.”
To learn more about the fulfillment process, check here.
7. Managing Order Cancellations
You can sync order cancellations between Onro and Shopify. To configure this, go to Settings → Order Cancellation.
There are 2 Order Cancellation settings, which you can turn on or off by selecting the checkbox:
Cancel fulfillment in Shopify
When enabled, cancelling an order in the Onro system will automatically cancel the corresponding fulfillment for the order in Shopify.
Cancel order in Onro
When enabled, cancelling the fulfillment of the order or the order itself in Shopify will automatically cancel the corresponding delivery order in the Onro system.


















