From 095e0b39df2b4ea1897446030390775136d2c630 Mon Sep 17 00:00:00 2001 From: LoredanaLrpz Date: Tue, 19 May 2026 12:35:07 +0200 Subject: [PATCH] [IMP] pos: add locations to urbanpiper providers task-6045375 --- .../sales/point_of_sale/extra/presets.rst | 2 +- .../sales/point_of_sale/payment_methods.rst | 2 +- .../sales/point_of_sale/restaurant.rst | 6 +- ...line_food_delivery.rst => urban_piper.rst} | 167 +++++++++++++----- .../cart-button.png | Bin .../create-store.png | Bin .../go-live-parameters.png | Bin .../go-live.png | Bin .../product-form.png | Bin .../product-list.png | Bin .../reject-order.png | Bin .../urban-piper-api.png | Bin .../applications/sales/point_of_sale/use.rst | 2 +- redirects/19.0.txt | 1 + 14 files changed, 132 insertions(+), 48 deletions(-) rename content/applications/sales/point_of_sale/restaurant/{online_food_delivery.rst => urban_piper.rst} (59%) rename content/applications/sales/point_of_sale/restaurant/{online_food_delivery => urban_piper}/cart-button.png (100%) rename content/applications/sales/point_of_sale/restaurant/{online_food_delivery => urban_piper}/create-store.png (100%) rename content/applications/sales/point_of_sale/restaurant/{online_food_delivery => urban_piper}/go-live-parameters.png (100%) rename content/applications/sales/point_of_sale/restaurant/{online_food_delivery => urban_piper}/go-live.png (100%) rename content/applications/sales/point_of_sale/restaurant/{online_food_delivery => urban_piper}/product-form.png (100%) rename content/applications/sales/point_of_sale/restaurant/{online_food_delivery => urban_piper}/product-list.png (100%) rename content/applications/sales/point_of_sale/restaurant/{online_food_delivery => urban_piper}/reject-order.png (100%) rename content/applications/sales/point_of_sale/restaurant/{online_food_delivery => urban_piper}/urban-piper-api.png (100%) diff --git a/content/applications/sales/point_of_sale/extra/presets.rst b/content/applications/sales/point_of_sale/extra/presets.rst index 5f4d1788e38..9c7d584823d 100644 --- a/content/applications/sales/point_of_sale/extra/presets.rst +++ b/content/applications/sales/point_of_sale/extra/presets.rst @@ -181,4 +181,4 @@ Presets are available in both the :ref:`POS register ` an .. seealso:: - :doc:`preparation` - - :doc:`../restaurant/online_food_delivery` + - :doc:`UrbanPiper order management for food delivery <../restaurant/urban_piper>` diff --git a/content/applications/sales/point_of_sale/payment_methods.rst b/content/applications/sales/point_of_sale/payment_methods.rst index 07db750c100..2fb37d5f113 100644 --- a/content/applications/sales/point_of_sale/payment_methods.rst +++ b/content/applications/sales/point_of_sale/payment_methods.rst @@ -68,7 +68,7 @@ Methods`, click :guilabel:`New`, and follow the next steps: .. note:: - The :guilabel:`Delivery Payment` option links a payment method to online orders placed through - :doc:`Urban Piper `. Select the appropriate + :doc:`Urban Piper `. Select the appropriate :guilabel:`Delivery Provider` to associate with the payment method. - If the Accounting app is installed, use the :guilabel:`Intermediary Account` field, if needed, to record transactions for this payment method in a specific receivable account for diff --git a/content/applications/sales/point_of_sale/restaurant.rst b/content/applications/sales/point_of_sale/restaurant.rst index 8a1cab36e93..c72cf9ad065 100644 --- a/content/applications/sales/point_of_sale/restaurant.rst +++ b/content/applications/sales/point_of_sale/restaurant.rst @@ -33,7 +33,7 @@ orders: .. cards:: .. card:: Online food delivery - :target: restaurant/online_food_delivery + :target: restaurant/urban_piper :large: Integrate third-party delivery platforms via UrbanPiper to centralize and manage external @@ -264,7 +264,7 @@ To process an order from the POS register, follow these steps: .. seealso:: - :doc:`extra/preparation` - - :doc:`restaurant/online_food_delivery` + - :doc:`UrbanPiper order management for food delivery ` .. _pos/restaurant/floors/transfer: @@ -478,4 +478,4 @@ after payment, follow these steps: .. toctree:: :titlesonly: - restaurant/online_food_delivery + restaurant/urban_piper diff --git a/content/applications/sales/point_of_sale/restaurant/online_food_delivery.rst b/content/applications/sales/point_of_sale/restaurant/urban_piper.rst similarity index 59% rename from content/applications/sales/point_of_sale/restaurant/online_food_delivery.rst rename to content/applications/sales/point_of_sale/restaurant/urban_piper.rst index a1fe5e5b32e..d11e9feb6bb 100644 --- a/content/applications/sales/point_of_sale/restaurant/online_food_delivery.rst +++ b/content/applications/sales/point_of_sale/restaurant/urban_piper.rst @@ -1,40 +1,123 @@ -==================== -Online food delivery -==================== +========== +UrbanPiper +========== **UrbanPiper** is an order management system that integrates with multiple food delivery platforms. It consolidates orders from all connected platforms into a single interface, simplifying the delivery process. -Supported providers: - -- `Careem `_ -- `Cari `_ -- `ChowNow `_ -- `Deliveroo `_ -- `DoorDash `_ -- `EatEasy `_ -- `Glovo `_ -- `Grubhub `_ -- `HungryPanda `_ -- `HungerStation `_ -- `Jahez `_ -- `Just Eat `_ -- `Keeta `_ -- `Mrsool `_ -- `Ninja `_ -- `NoonFood `_ -- `Postmates `_ -- `Rafeeq `_ -- `Rappi `_ -- `SkipTheDishes `_ -- `Swiggy `_ -- `Talabat `_ -- `UberEats `_ -- `Wolt `_ -- `Zomato `_ - -.. _pos/online_food_delivery/configuration: +Supported providers and locations: + +.. tabs:: + + .. tab:: Global and multi-region providers + + .. list-table:: + :header-rows: 1 + :stub-columns: 1 + :widths: 25 75 + :class: table-striped + + * - Providers + - Locations + * - `Deliveroo `_ + - Belgium, France, Ireland, Italy, Kuwait, United Arab Emirates, United Kingdom + * - `DoorDash `_ + - Australia, Canada, United States + * - `Glovo `_ + - Armenia, Bosnia and Herzegovina, Bulgaria, Croatia, Côte d'Ivoire, Georgia, Italy, + Kazakhstan, Kenya, Kyrgyzstan, Moldova, Montenegro, Morocco, Nigeria, Poland, Portugal, + Romania, Serbia, Spain, Tunisia, Uganda, Ukraine + * - `HungryPanda `_ + - Australia, Canada, France, Italy, Japan, New Zealand, Singapore, South Korea, United + Kingdom, United States + * - `Just Eat `_ + - Austria, Belgium, Bulgaria, Canada, Denmark, Germany, Ireland, Israel, Italy, + Luxembourg, Poland, Slovakia, Spain, Switzerland, Netherlands, United Kingdom + * - `Keeta `_ + - Bahrain, Brazil, Hong Kong (China), Kuwait, Qatar, Saudi Arabia, United Arab Emirates + * - `UberEats `_ + - Argentina, Australia, Belgium, Canada, Chile, Costa Rica, Denmark, Dominican Republic, + Ecuador, El Salvador, Finland, France, Germany, Guatemala, Ireland, Italy, Japan, + Kenya, Luxembourg, Mexico, Netherlands, New Zealand, Norway, Panama, Poland, Portugal, + South Africa, Spain, Sri Lanka, Sweden, Switzerland, Taiwan (ROC), United Kingdom, + United States + * - `Wolt `_ + - Albania, Austria, Azerbaijan, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, + Estonia, Finland, Georgia, Germany, Greece, Hungary, Iceland, Israel, Japan, Kazakhstan, + Kosovo, Latvia, Lithuania, Luxembourg, Malta, North Macedonia, Norway, Poland, Romania, + Serbia, Slovakia, Slovenia, Sweden, Uzbekistan + + .. tab:: Regional and national providers: Americas + + .. list-table:: + :header-rows: 1 + :stub-columns: 1 + :widths: 25 75 + :class: table-striped + + * - Providers + - Locations + * - `Grubhub `_ + - United States + * - `Postmates `_ + - Puerto Rico, United States + * - `ChowNow `_ + - Canada, United States + * - `Rappi `_ + - Argentina, Brazil, Chile, Colombia, Costa Rica, Ecuador, Mexico, Peru, Uruguay + * - `SkipTheDishes `_ + - Canada (Alberta, British Columbia, Manitoba, New Brunswick, Newfoundland and Labrador, + Northwest Territories, Nova Scotia, Ontario, Prince Edward Island, Quebec, + Saskatchewan, Yukon) + + .. tab:: Regional and national providers: Middle East and North Africa + + .. list-table:: + :header-rows: 1 + :stub-columns: 1 + :widths: 25 75 + :class: table-striped + + * - Providers + - Locations + * - `Careem `_ + - Egypt, Kuwait, Morocco, United Arab Emirates + * - `Cari `_ + - Kuwait, Saudi Arabia, United Arab Emirates + * - `EatEasy `_ + - United Arab Emirates + * - `HungerStation `_ + - Saudi Arabia (115+ regions) + * - `Jahez `_ + - Bahrain, Kuwait, Saudi Arabia + * - `Mrsool `_ + - Bahrain, Egypt, Saudi Arabia + * - `Ninja `_ + - Bahrain, Kuwait, Qatar + * - `NoonFood `_ + - Saudi Arabia, United Arab Emirates + * - `Rafeeq `_ + - Qatar + * - `Talabat `_ + - Bahrain, Egypt, Iraq, Jordan, Kuwait, Oman, Qatar, Saudi Arabia, United Arab Emirates + + .. tab:: Regional and national providers: Asia and Oceania + + .. list-table:: + :header-rows: 1 + :stub-columns: 1 + :widths: 25 75 + :class: table-striped + + * - Providers + - Locations + * - `Swiggy `_ + - India + * - `Zomato `_ + - India + +.. _pos/urban_piper/configuration: Configuration ============= @@ -62,7 +145,7 @@ requirements are satisfied: - **Delivery platform reseller account:** A registered reseller account is required with each delivery platform to be integrated (e.g., Uber Eats, DoorDash, Careem, Deliveroo, Zomato). -.. _online_food_delivery/credentials: +.. _pos/urban_piper/credentials: UrbanPiper credentials ---------------------- @@ -75,7 +158,7 @@ UrbanPiper credentials #. `Go to your Atlas account `_ and retrieve your API key and username by navigating to :menuselection:`Settings --> API Access`. -.. image:: online_food_delivery/urban-piper-api.png +.. image:: urban_piper/urban-piper-api.png :alt: Atlas API access Point of Sale @@ -90,7 +173,7 @@ Point of Sale #. Set up UrbanPiper: #. Fill in the :guilabel:`Username` and :guilabel:`Api Key` fields with your :ref:`UrbanPiper - credentials `. + credentials `. #. Select the desired delivery providers in the :guilabel:`Food Delivery Platforms` field under the :guilabel:`Urban Piper Location` section (i.e., Zomato, Uber Eats). #. Save the settings. @@ -105,7 +188,7 @@ Point of Sale platform. - The store is automatically named after your point of sale name. -.. image:: online_food_delivery/create-store.png +.. image:: urban_piper/create-store.png :alt: Food delivery connector settings Store timings @@ -132,7 +215,7 @@ To make products available individually, - Optionally, set up the :guilabel:`Meal Type` field and enable the :guilabel:`Is Recommended` and :guilabel:`Is Alcoholic` buttons. -.. image:: online_food_delivery/product-form.png +.. image:: urban_piper/product-form.png :alt: where to make a single product available for delivery To make multiple products available for food delivery at once, @@ -142,7 +225,7 @@ To make multiple products available for food delivery at once, #. Select the products. #. Enter the desired POS in the :guilabel:`Available on Food Delivery` column. -.. image:: online_food_delivery/product-list.png +.. image:: urban_piper/product-list.png :alt: Product list .. note:: @@ -173,7 +256,7 @@ Go live #. `Go to the Locations tab `_ of your Atlas account. #. Select the location to activate, then click :guilabel:`Request to go Live`. - .. image:: online_food_delivery/go-live.png + .. image:: urban_piper/go-live.png :alt: Request to go live button in the locations tab of the Atlas account #. In the popup window: @@ -183,7 +266,7 @@ Go live establish the connection between the platform and UrbanPiper. #. Click the :guilabel:`Request to Go Live` button. - .. image:: online_food_delivery/go-live-parameters.png + .. image:: urban_piper/go-live-parameters.png :alt: Go live parameters .. note:: @@ -206,7 +289,7 @@ orders, open the orders' list view by: #. Clicking :guilabel:`Review Orders` on the notification popup. #. Clicking the bag-shaped icon for online orders and :guilabel:`New`. - .. image:: online_food_delivery/cart-button.png + .. image:: urban_piper/cart-button.png :alt: Cart button .. note:: @@ -240,7 +323,7 @@ list view, #. Click the :guilabel:`Reject` button. #. Select one of the reasons from the popup window. -.. image:: online_food_delivery/reject-order.png +.. image:: urban_piper/reject-order.png :alt: Reject order pop-up .. important:: diff --git a/content/applications/sales/point_of_sale/restaurant/online_food_delivery/cart-button.png b/content/applications/sales/point_of_sale/restaurant/urban_piper/cart-button.png similarity index 100% rename from content/applications/sales/point_of_sale/restaurant/online_food_delivery/cart-button.png rename to content/applications/sales/point_of_sale/restaurant/urban_piper/cart-button.png diff --git a/content/applications/sales/point_of_sale/restaurant/online_food_delivery/create-store.png b/content/applications/sales/point_of_sale/restaurant/urban_piper/create-store.png similarity index 100% rename from content/applications/sales/point_of_sale/restaurant/online_food_delivery/create-store.png rename to content/applications/sales/point_of_sale/restaurant/urban_piper/create-store.png diff --git a/content/applications/sales/point_of_sale/restaurant/online_food_delivery/go-live-parameters.png b/content/applications/sales/point_of_sale/restaurant/urban_piper/go-live-parameters.png similarity index 100% rename from content/applications/sales/point_of_sale/restaurant/online_food_delivery/go-live-parameters.png rename to content/applications/sales/point_of_sale/restaurant/urban_piper/go-live-parameters.png diff --git a/content/applications/sales/point_of_sale/restaurant/online_food_delivery/go-live.png b/content/applications/sales/point_of_sale/restaurant/urban_piper/go-live.png similarity index 100% rename from content/applications/sales/point_of_sale/restaurant/online_food_delivery/go-live.png rename to content/applications/sales/point_of_sale/restaurant/urban_piper/go-live.png diff --git a/content/applications/sales/point_of_sale/restaurant/online_food_delivery/product-form.png b/content/applications/sales/point_of_sale/restaurant/urban_piper/product-form.png similarity index 100% rename from content/applications/sales/point_of_sale/restaurant/online_food_delivery/product-form.png rename to content/applications/sales/point_of_sale/restaurant/urban_piper/product-form.png diff --git a/content/applications/sales/point_of_sale/restaurant/online_food_delivery/product-list.png b/content/applications/sales/point_of_sale/restaurant/urban_piper/product-list.png similarity index 100% rename from content/applications/sales/point_of_sale/restaurant/online_food_delivery/product-list.png rename to content/applications/sales/point_of_sale/restaurant/urban_piper/product-list.png diff --git a/content/applications/sales/point_of_sale/restaurant/online_food_delivery/reject-order.png b/content/applications/sales/point_of_sale/restaurant/urban_piper/reject-order.png similarity index 100% rename from content/applications/sales/point_of_sale/restaurant/online_food_delivery/reject-order.png rename to content/applications/sales/point_of_sale/restaurant/urban_piper/reject-order.png diff --git a/content/applications/sales/point_of_sale/restaurant/online_food_delivery/urban-piper-api.png b/content/applications/sales/point_of_sale/restaurant/urban_piper/urban-piper-api.png similarity index 100% rename from content/applications/sales/point_of_sale/restaurant/online_food_delivery/urban-piper-api.png rename to content/applications/sales/point_of_sale/restaurant/urban_piper/urban-piper-api.png diff --git a/content/applications/sales/point_of_sale/use.rst b/content/applications/sales/point_of_sale/use.rst index cc0206b7ebb..ab627b01f95 100644 --- a/content/applications/sales/point_of_sale/use.rst +++ b/content/applications/sales/point_of_sale/use.rst @@ -205,7 +205,7 @@ the following options: (i.e., orders for which the receipt has been emailed to the customer). - :guilabel:`Paid`: Paid orders. - :guilabel:`Cancelled`: Orders cancelled on online platforms through :ref:`UrbanPiper - `. + `. It is also possible to search for orders based on, for example, the :guilabel:`Receipt Number`, :guilabel:`Date`, or :guilabel:`Customer`. diff --git a/redirects/19.0.txt b/redirects/19.0.txt index c328b29b9d4..ee6a62e3d9b 100644 --- a/redirects/19.0.txt +++ b/redirects/19.0.txt @@ -143,6 +143,7 @@ applications/sales/point_of_sale/employee_login.rst applications/sales/point_of_ applications/sales/point_of_sale/preparation.rst applications/sales/point_of_sale/extra/preparation.rst applications/sales/point_of_sale/self_order.rst applications/sales/point_of_sale/extra/self_order.rst applications/sales/point_of_sale/online_food_delivery.rst applications/sales/point_of_sale/restaurant/online_food_delivery.rst +applications/sales/point_of_sale/restaurant/online_food_delivery.rst applications/sales/point_of_sale/restaurant/urban_piper.rst # application/sales/rental