Wiresk

Wiresk

Youding POS Connection and Settings

Estimated reading time: 19 min
465570820 1330430961607380 8229624277772444772 n Youding POS Connection and Settings

Youding is a robust POS solution created in Cambodia, offering features to improve efficiency for restaurants, hotels, retail stores, and delivery businesses.

Youding pioneered food delivery integration for Cambodian POS systems, partnering with Wiresk to connect with platforms like Nham24, GrabFood, and Foodpanda.

Integrating Youding POS with Wiresk offers significant advantages by automating processes and centralizing business operations. The integration allows businesses to effectively manage orders, inventory, customers, payments, and venues in real-time.

Get in touch with Youding Company to request access and permissions for their POS system. For more details, see Youding Official website.
For Developers, you can refer to the API endpoint documentation here.

A connection to your Youding account is needed so we can sync it with our platform.

There are two ways to connect your app to Wiresk:

▪️ In “My apps” section, where you can manage your connections (select or create your group first to get access to this section, refer to the Group system ).

▪️ While building your Flow, you can easily establish a connection to your app directly within the Flow builder. This can be done during the setup of either a Trigger or a Method.

In this documentation, we will explain how to create a connection in “My apps” section, it is essentially the same as when creating it on-the-go.

  • On the left panel of Wiresk user interface, go to “My apps” and click on the (+) button. 
  • Search “Youding” in the search field or scroll down the list of apps and choose the Youding icon.
Animated GIF showing how to add an app and search for it in Wiresk My Apps tab.
  • In the prompted screen, give a name to your connection, e.g., “Youding Connection”.
  • Enter the URL and the Youding Restaurant Key that is provided by Youding Company.
Screenshot of Wiresk Add Apps screen setting for Youding Connection. Red arrows shows field to populate and a button to Create the App.
  • Then click on “Create App” button.

Voila! Your Youding app connection is ready. You can now use it to build your Flows.

Now that Youding is linked to Wiresk, you’re ready to start building Flows.

How to create a Flow (select to expand ↓ )

Create a Flow

Select your Group, then on the Flow management screen click on “Create Flow”.

Animated image GIF, shows where to click to create a Flow in Wiresk. first select a group then click on create Flow.

A – Select the Trigger

Flows can be executed by multiple Triggers, depending on the desired workflow. For example, you could use scheduled Triggers with different recurrence rules alongside a Webhook Trigger for immediate, event-driven runs of the Flow. If you choose to “Run Once“, the Flow will execute using only one Trigger and its sample data.
  • Name the Flow that you want to create.
  • Add your Trigger by clicking on the red plus (+) Add button.
  • On the Trigger selection screen, search your app or select it from the list below the screen.
Screenshot of Wiresk Trigger setting screen. Red arrows shows that you can wether search your app in the search or or select it in the list below.
  • Select your preferred Trigger on the next screen and customize its settings. For Youding Triggers, refer to the Trigger settings below.

As mentioned in “How to connect your app to Wiresk” above, during your Trigger settings, you can create a new connection to your apps at this stage.

Check here for a detailed Tutorial step-by-step on how to create a Flow.

B – Add an HTTP Trigger to your Flow

An HTTP Trigger allows you to manually activate your Flows.

  • Click on the red plus button (+) again to add a Trigger for testing your Flow, then click on the button “HTTP Trigger”.
Screenshot of Wiresk HTTP Trigger selection. in manual configuration section, an arrow point to HTTP Trigger.
  • Write a description and select your API key or create a new one.
Screenshot of HTTP Trigger setting screen. Arrows shows fields that need to be filled and selected for the settings. User need to add a description, select or create an API key.
  • Click on save. Now you can use your HTTP Trigger to Manually run your Flow.

C – Add a Method to your Flow

The Method will perform a specific task on a particular app or service you’ve connected to Wiresk like get info or send emails.

You can add at least 1 or multiple Methods for complex Flows (a maximum of 255 Methods).

Screenshot of Wiresk Flow Builder, showing Trigger icon and arrow pointing to a plus button. This button is use to add Methods in Wiresk.
  • On the Flow builder screen, click on the plus button (+) next to the Trigger icon.
  • Search or scroll down to select your apps Methods, then configure it settings. For Youding Methods, see Methods list and settings in the step below.

D – Add Wiresk Tools to your Flow

If you want to build a complex Flow, Wiresk offers a selection of tools at your disposal. Refer to Wiresk’s Tools

To add Tools in your Flow, Follow the same step as adding the Methods. On the Flow builder screen, click on the plus button (+) then just click on the “Tool” tab and select the Tool that you want to add.

What will start your automation…

Setting up the recurrence rule or scheduler of your Trigger (if the Trigger is not a Webhook):

  • Regular intervals will monitor your Trigger by intervals in minute
  • Daily recurrence will monitor your Trigger by day and hour
  • Monthly recurrence will monitor your Trigger every month on a defined date and hour
  • Yearly recurrence will monitor your Trigger on a specific date and hour every year
  • Specific dates will start your Trigger on specific dates

After setting up the Trigger parameters (refer to how to define your parameters in the steps below), click on “Get sample”.

The “Get sample” allows you to extract a subset of data for validation. The data will be used to MAP your Method parameters according to your Flow. Refer to FIELD MAPPING documentation.

These Triggers will start your Flow automatically at a specific time or intervals instead of being triggered real-time event (Webhooks).

Youding
This Trigger monitors and retrieves new orders from a venue based on the Scheduler’s interval.

Configuration Table:

Name*Retrieve New Orders
Connection*Select your connection or create one.
Time outYou can additionally set the Trigger duration to limit the information processed per execution to optimize performance and resource usage.
Recurrence rule/scheduler*Set up your recurrence rule.
Parameters
Venue*Select the venue that is linked to Youding POS to retrieve orders.
Include Previous OrdersSelecting Yes retrieve all existing orders. Choosing No shows only orders created since the last time the flow was executed.
Preview DataIn this tab, you can preview the retrieved data.
In specific Trigger instances, data can only be previewed when it is available for retrieval. If no event occurs from the Trigger, a message “No data available”, or “Cannot read properties of null ” will be displayed.

(*) required field

Before saving your Trigger, don’t forget to use “Get Sample”.

This Trigger retrieves orders from a venue based on the specified order date range and order status.

Configuration Table:

Name*Retrieve Orders
Connection*Select your connection or create one.
Time outYou can additionally set the Trigger duration to limit the information processed per execution to optimize performance and resource usage.
Recurrence rule/scheduler*Set up your recurrence rule.
Parameters
Venue*Select the venue that is linked to Youding POS to retrieve orders.
From Date*Retrieve orders from this date, format date "Y-m-d H:i:s".
To Date*Retrieve orders to this Date, format date "Y-m-d H:i:s".
Order StatusSelect a Status:
ALL (by default)
NEW
ORDERED
SENT
CANCELLED
CALLED
RECOOKING
PENDING
COOKING
DISPATCH
DONE
COMPLETED
Include Previous OrdersSelecting Yes retrieve all existing orders. Choosing No shows only orders created since the last time the flow was executed.
Preview DataIn this tab, you can preview the retrieved data.
In specific Trigger instances, data can only be previewed when it is available for retrieval. If no event occurs from the Trigger, a message “No data available”, or “Cannot read properties of null ” will be displayed.

(*) required field

Before saving your Trigger, don’t forget to use “Get Sample”.

Youding
This Trigger monitors and retrieves categories from a venue based on the Scheduler’s interval.

Configuration Table:

Name*Retrieve Categories
Connection*Select your connection or create one.
Time outYou can additionally set the Trigger duration to limit the information processed per execution to optimize performance and resource usage.
Recurrence rule/scheduler*Set up your recurrence rule.
Parameters
Venue*Select the venue that is linked to Youding POS to retrieve categories.
Include Previous DataSelecting Yes retrieve all existing categories. Choosing No shows only categories created since the last time the flow was executed.
Preview DataIn this tab, you can preview the retrieved data.
In specific Trigger instances, data can only be previewed when it is available for retrieval. If no event occurs from the Trigger, a message “No data available”, or “Cannot read properties of null ” will be displayed.

(*) required field

Before saving your Trigger, don’t forget to use “Get Sample”.

Youding
This Trigger monitors and retrieves all products from a venue based on the Scheduler’s interval.

Configuration Table:

Name*Retrieve Products
Connection*Select your connection or create one.
Time outYou can additionally set the Trigger duration to limit the information processed per execution to optimize performance and resource usage.
Recurrence rule/scheduler*Set up your recurrence rule.
Parameters
Venue*Select the venue that is linked to Youding POS to retrieve all products.
Include Previous DataSelecting Yes retrieve all existing products. Choosing No shows only products created since the last time the flow was executed.
Preview DataIn this tab, you can preview the retrieved data.
In specific Trigger instances, data can only be previewed when it is available for retrieval. If no event occurs from the Trigger, a message “No data available”, or “Cannot read properties of null ” will be displayed.

(*) required field

Before saving your Trigger, don’t forget to use “Get Sample”.

Youding
This Trigger monitors and retrieves customers from a venue based on the Scheduler’s interval.

Configuration Table:

Name*Retrieve Customers
Connection*Select your connection or create one.
Time outYou can additionally set the Trigger duration to limit the information processed per execution to optimize performance and resource usage.
Recurrence rule/scheduler*Set up your recurrence rule.
Parameters
Venue*Select the venue that is linked to Youding POS to retrieve customers data.
Include Previous DataSelecting Yes retrieve all existing customers. Choosing No shows only customers created since the last time the flow was executed.
Preview DataIn this tab, you can preview the retrieved data.
In specific Trigger instances, data can only be previewed when it is available for retrieval. If no event occurs from the Trigger, a message “No data available”, or “Cannot read properties of null ” will be displayed.

(*) required field

Before saving your Trigger, don’t forget to use “Get Sample”.

Youding
This Trigger monitors and retrieves a list of venues linked to Youding POS, based on the Scheduler’s interval.

Configuration Table:

Name*Retrieve Venues
Connection*Select your connection or create one.
Time outYou can additionally set the Trigger duration to limit the information processed per execution to optimize performance and resource usage.
Recurrence rule/scheduler*Set up your recurrence rule.
Parameters
Preview DataIn this tab, you can preview the retrieved data.
In specific Trigger instances, data can only be previewed when it is available for retrieval. If no event occurs from the Trigger, a message “No data available”, or “Cannot read properties of null ” will be displayed.

(*) required field

Before saving your Trigger, don’t forget to use “Get Sample”.

Youding
This Trigger retrieves Sales Data from a venue based on date range.

A Z report, also known as a Z ticket, is a detailed printout of a point of sale (POS) register’s transaction history. 
It’s typically generated at the end of a shift or day to summarize the register’s activity. 

Configuration Table:

Name*Retrieve Sale Data (Z Ticket)
Connection*Select your connection or create one.
Time outYou can additionally set the Trigger duration to limit the information processed per execution to optimize performance and resource usage.
Recurrence rule/scheduler*Set up your recurrence rule.
Parameters
Venue*Select the venue that is linked to Youding POS to retrieve sales data from.
Platform*Select the platform that contain the sales data.
Start Date*Retrieve sales data from this date, format date "Y-m-d H:i:s".
End Date*Retrieve sales data to this Date, format date "Y-m-d H:i:s".
Include Previous DataSelecting Yes retrieve all sales data. Choosing No shows only sales data created since the last time the flow was executed.
Preview DataIn this tab, you can preview the retrieved data.
In specific Trigger instances, data can only be previewed when it is available for retrieval. If no event occurs from the Trigger, a message “No data available”, or “Cannot read properties of null ” will be displayed.

(*) required field

Before saving your Trigger, don’t forget to use “Get Sample”.

{
    "venue": {
        "name": "Day",
        "timezone": "Asia/Phnom_Penh",
        "print_by": "Hey Day",
        "start": "2024-05-20 13:29:05",
        "end": "2024-05-23 14:45:19",
        "currency_code": "USD",
        "sub_unit": 100,
        "external_key": "VGKTACDAOUG9"
    },
    "sale_detail_summary": {
        "total_qty": 33,
        "total_gross": "99.00 USD",
        "total_discount": "0.00 USD",
        "total_tax": "0.00 USD",
        "total_net": "99.00 USD",
        "total_refund": 0,
        "total_refund_price": "0.00 USD",
        "total_voided": 0,
        "total_voided_price": "0.00 USD",
        "total_service_charge": "0.00 USD",
        "total_gross_include_vat": "99.00 USD",
        "total_credit_note_quantity": 0,
        "total_credit_note_amount": "0.00 USD"
    },
    "general": {
        "number_of_tickets": 5,
        "total_pay_later_amount": 10300,
        "total_ticket_amount": 9900,
        "number_of_product": 33,
        "total_product_cancel": 0,
        "total_refund_items": 0,
        "total_refund_amount": 0,
        "total_compensate_item": 0,
        "total_compensate_amount": 0,
        "total_credit_note_quantity": 0,
        "total_credit_note_amount": 0,
        "total_booking": 0,
        "total_booking_amount": 0,
        "total_booking_cancel": 0,
        "total_table": 5,
        "total_guest": 9,
        "total_customer": 0,
        "avg_basket": 1100,
        "avg_basket_format": "11.00 USD",
        "total_pay_later_amount_format": "103.00 USD",
        "total_ticket_amount_format": "99.00 USD",
        "total_refund_amount_format": "0.00 USD",
        "total_compensate_amount_format": "0.00 USD",
        "total_credit_note_amount_format": "0.00 USD",
        "total_booking_amount_format": "0.00 USD",
        "total_expense_amount": "0.00 USD",
        "total_expense_count": 0
    },
    "profit": {
        "total_net_amount": 10300,
        "total_net_amount_format": "103.00 USD",
        "amount_by_vat_rate": [],
        "refund_amount": 0,
        "refund_amount_format": "0.00 USD",
        "total_cost": 0,
        "total_cost_format": "0.00 USD",
        "profit": 9900,
        "profit_format": "99.00 USD"
    },
    "payment": [
        {
            "payment_name": "PAY LATER",
            "tip_amount": 0,
            "tip_count": 0,
            "payment_count": 5,
            "refund_count": 0,
            "payment_total": 10300,
            "payment_amount": 10300,
            "payment_refund": 0,
            "payment_amount_format": "103.00 USD",
            "payment_refund_format": "0.00 USD",
            "payment_total_format": "103.00 USD",
            "credit_note_count": 0,
            "credit_note_amount": 0,
            "credit_note_amount_format": "0.00 USD"
        },
        {
            "payment_name": "ROOM",
            "tip_amount": 0,
            "tip_count": 0,
            "payment_count": 4,
            "refund_count": 0,
            "payment_total": 9900,
            "payment_amount": 9900,
            "payment_refund": 0,
            "payment_amount_format": "99.00 USD",
            "payment_refund_format": "0.00 USD",
            "payment_total_format": "99.00 USD",
            "credit_note_count": 0,
            "credit_note_amount": 0,
            "credit_note_amount_format": "0.00 USD"
        }
    ],
    "payment_summary": {
        "total_payment": 9,
        "total_payment_price": 202,
        "total_refund": 0,
        "total_refund_price": "0.00 USD",
        "total_tip": 0,
        "total_tip_price": "0.00 USD",
        "credit_note_amount": "0.00 USD",
        "credit_not_count": 0
    },
    "shift": [
        {
            "init_cash": 0,
            "total_net": 0,
            "close_amount": 0,
            "diff_amount": 0,
            "init_cash_format": "0.00 USD",
            "close_amount_format": "0.00 USD",
            "total_net_format": "0.00 USD",
            "diff_amount_format": "0.00 USD"
        }
    ],
    "discount": [
        {
            "discount_name": "សរុប",
            "discount_count": 0,
            "discounted_price": 0,
            "discounted_price_format": "0.00 USD"
        }
    ],
    "tip": {
        "total_tips": 0,
        "total_tips_price_format": "0.00 USD"
    },
    "expense_details": [],
    "expense_summary": {
        "total_expense_count": 0,
        "total_expense_amount": "0.00 USD"
    }
}

What your automation will do…

You can add at least 1 or multiple Methods for complex Flows (a maximum of 255 Methods).

Youding
Cancel an order from platforms that are linked to Youding.

Configuration Table:

Input Options:

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: You can specify a fixed attribute.
Name*Cancel Order
Connection*Select your connection or create one.
Matching Criteria
Platform*Select the platform’s order.
Order ID*Select the order from a dynamic list or Map it from Triggers or Methods.

(*) required field

Close an order from platforms that are linked to Youding.

Configuration Table:

Input Options:

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: You can specify a fixed attribute.
Name*Close Order
Connection*Select your connection or create one.
Matching Criteria
Platform*Select the platform’s order.
Order ID*Select the order from a dynamic list or Map it from Triggers or Methods.

(*) required field

Create an order in Youding POS from an external platform’s order.

Configuration Table:

Input Options:

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: You can specify a fixed attribute.
Name*Create Order
Connection*Select your connection or create one.
Map Fields
Platform Type*Select the delivery platform connected to Youding.
Order type*Select PICK-UP or DELIVERY.
Order Number*Enter the order number from the delivery platform or Map it from data sources or step responses.
Products*
This section captures product-related details in the order.		[⊕ Element][⊕ Map] Add fields or Map it from a Data Source. See Field Mapping.
Element 1: Represents the first item in the product list. Additional items can be added as elements.

Category Name*: The category of the product (e.g., “Beverages,” “Main Course”).
Name*: The name of the product being ordered.
Unit Price*: The price per unit of the product.
ID*: The unique identifier for the product in Youding’s system.
Quantity*: The number of units of the product being ordered.
Is Product Set: Indicates if the product is part of a set or combo. True – False
Paid Price: The total amount paid for this product.
Remote Code: A unique code linking the product to the external platform.
Comment: Notes or special instructions for the product.
Tax Name: The name of the tax applied to the product. Example: “VAT”
Tax Percent: The percentage of tax applied to the product. Example: “10%” for 10% VAT.
Discount Amount: The monetary discount applied to the product.
Discount Percent: The percentage discount applied to the product.

Selected Options: Additional options chosen for the product (e.g., extra cheese).
[⊕ Element][⊕ Map] Add fields or Map it from a Data Source. See Field Mapping.
Element 1: Represents the first option in the option group. Additional options can be added as elements.

Name*: The name of the selected option.
Price*: The additional price for the selected option, if applicable.
Quantity*: The quantity of the selected option.
ID*: The unique identifier for the selected option in the Youding system.
Key ID*: Identifier to distinguish the option.
Remote Code*: The unique code linking the option to an external platform.
Type*: The type identifier to identify whether the product topping is an
instance of product, extra or variant.
Create at*Time when order was created.
CommentsComment include in the order from delivery platform.
Discount*[⊕ Element][⊕ Map] Add fields or Map it from a Data Source. See Field Mapping.
Element 1: Represents the first discount applied to the order.

Name*: The name or description of the discount.
Discount Type*: Percentage” or “Fixed Amount”.
Value*: The value of the discount (monetary fixed amount or percentage).
Pre OrderIndicates if the order was placed in advance. True – False
CutlerySpecifies whether cutlery is required for the order from the delivery platform.
UtensilIndicates if utensils are included from the delivery platform.
Price Object*
A structured object containing price details like subtotal, discounts, tax, etc.		Commission*: The platform’s commission on the order.
Grand total*: The total amount of the order, including taxes, fees, and discounts.
VAT Total*: The total VAT applied to the order.
Total Net*: The net amount after deductions.

Delivery Fees* [⊕ Element][⊕ Map] Add fields or Map it from a Data Source. See Field Mapping.
Element 1: Represents the first delivery fee.

Name*: The name of the delivery fee.
Value*: The value of the delivery fee.

Packaging Fee: The fee for packaging the order if applicable.

(*) required field

Retrieve all items or products from an order by Platform Type and Order ID.

Configuration Table:

Input Options:

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: You can specify a fixed attribute.
Name*Get Order Items
Connection*Select your connection or create one.
Matching Criteria
Platform Type*Choose the source platform for order item retrieval
Order ID*Select the order from a dynamic list or Map it from Triggers or Methods.
Map Fields
If not Found Consider as:Success – When the record is not found during execution, the system does not treat this as an error. Instead, it considers the operation successful and continues with the workflow.

Failed – Wiresk treats this as an error or failure. The workflow stops or takes a predefined failure action.

(*) required field

Retrieve an order information by Platform Type and Order ID.

Configuration Table:

Input Options:

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: You can specify a fixed attribute.
Name*Get Single Order
Connection*Select your connection or create one.
Matching Criteria
Platform Type*Choose the source platform for order’s information retrieval.
Order ID*Select the order from a dynamic list or Map it from Triggers or Methods.
Map Fields
If not Found Consider as:Success – When the record is not found during execution, the system does not treat this as an error. Instead, it considers the operation successful and continues with the workflow.

Failed – Wiresk treats this as an error or failure. The workflow stops or takes a predefined failure action.

(*) required field

Retrieve a list of all orders from a platform from Youding database.

Configuration Table:

Input Options:

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: You can specify a fixed attribute.
Name*List Orders
Connection*Select your connection or create one.
Map Fields
Platform Type*Choose the source platform for order’s list retrieval.

(*) required field

Update the status of an order in Youding POS this will be reflected to external platforms.

Configuration Table:

Input Options:

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: You can specify a fixed attribute.
Name*Update Status
Connection*Select your connection or create one.
Matching Criteria
Platform Type*Choose the source platform.
Order ID*Select the order from a dynamic list or Map it from Triggers or Methods.
Map Fields
Status*Select:
NEW
ORDERED
SENT
CANCELLED
CALLED
RECOOKING
PENDING
COOKING
DISPATCH
DONE
COMPLETED
Message*Message to customer, especially applicable for rejected orders.
If not Found Consider as:Success – When the record is not found during execution, the system does not treat this as an error. Instead, it considers the operation successful and continues with the workflow.

Failed – Wiresk treats this as an error or failure. The workflow stops or takes a predefined failure action.

(*) required field

Youding
Retrieve category information by Platform Type and Category ID.

Configuration Table:

Input Options:

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: You can specify a fixed attribute.
Name*Get Single Category
Connection*Select your connection or create one.
Matching Criteria
Platform Type*Choose the source platform for category’s information retrieval.
Category ID*Select the category from a dynamic list or Map it from Triggers or Methods (field external_key).
Map Fields
If not Found Consider as:Success – When the record is not found during execution, the system does not treat this as an error. Instead, it considers the operation successful and continues with the workflow.

Failed – Wiresk treats this as an error or failure. The workflow stops or takes a predefined failure action.

(*) required field

{
  "success": true,
  "code": 200,
  "error_code": "",
  "message": "success",
  "delay": 34,
  "data": {
    "external_key": "UTPMUZ1B7FYJ",
    "name": "Appetizers in French restaurant",
    "cat_type": "DRINK",
    "active": 1,
    "color_code": "80CED7",
    "created_at": "2022-03-01 07:30:44",
    "updated_at": "2022-08-22 08:00:14",
    "is_default": 0
  }
}
Retrieve all category information, optionally including the products and product options, by Platform Type.

Configuration Table:

Input Options:

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: You can specify a fixed attribute.
Name*List Category
Connection*Select your connection or create one.
Map Fields
Platform Type*Choose the source platform for category’s information retrieval.
Including ProductsYes – No
Including Product OptionsYes – No

(*) required field

[
  {
    "external_key": "4C6BRYOAVR7K",
    "meta_id": 97,
    "name": "Food",
    "cat_type": "FOOD",
    "active": true,
    "color_code": null,
    "created_at": "2024-11-19 10:16:52",
    "updated_at": "2024-11-19 10:16:52",
    "is_default": 0,
    "obj_gid": "b8846af1-bb9e-41b9-9dd0-654d12ee36ca",
    "global_id": "b8846af1-bb9e-41b9-9dd0-654d12ee36ca",
    "deleted_at": null,
    "pname": null,
    "psort": 0,
    "sort": 30000,
    "third_party": "category",
    "name_en": "Food",
    "products": [
      {
        "global_id": "73b0584b-f9c5-45e3-aea9-59cb5b559eba",
        "name": "Second product",
        "description": null,
        "active": true,
        "dish_code": null,
        "dish_type": "DISH",
        "cat_external_key": "4C6BRYOAVR7K",
        "cat_type": "FOOD",
        "category_name": "Food",
        "sort": "0",
        "external_key": "4MJMYWGSGSOX",
        "favorite": 0,
        "unit_measurement": "QUANTITY",
        "unit_size": "1.00",
        "track_quantity": "UNLIMITED",
        "is_sale": 1,
        "brand_id": null,
        "unit_size_measurement": null,
        "size_per_unit": "0.00",
        "size_per_unit_measurement": null,
        "is_link": 0,
        "isCustom": 0,
        "platform": "NHAM24",
        "pricebook_is_active": 1,
        "dish_price_gid": "3cd50805-a19c-4d49-9fe2-2cb1ad85ab0d",
        "order_dish_status": 0,
        "order_dish_id": null,
        "dish_price_tax_id": null,
        "dish_price_active": 1,
        "url": null,
        "name_en": "Second product",
        "description_en": null,
        "category_name_en": "Food",
        "addon": [],
        "dish_price": "1.00",
        "option_prices": [
          {
            "external_key": "4MJMYWGSGSOX_opt_price",
            "name": "Regular",
            "price": "1.00",
            "rank": 1,
            "active": true,
            "default": true
          }
        ]
Youding
Retrieve a single product information by Platform Type and Product ID.

Configuration Table:

Input Options:

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: You can specify a fixed attribute.
Name*Get Single Product
Connection*Select your connection or create one.
Matching Criteria
Platform Type*Choose the source platform for product’s information retrieval.
Product ID*Select the product from a dynamic list or Map it from Triggers or Methods (corresponding field: global_id)
Map Fields
If not Found Consider as:Success – When the record is not found during execution, the system does not treat this as an error. Instead, it considers the operation successful and continues with the workflow.

Failed – Wiresk treats this as an error or failure. The workflow stops or takes a predefined failure action.

(*) required field

{
  "global_id": "73b0584b-f9c5-45e3-aea9-59cb5b559eba",
  "name": "Second product",
  "description": null,
  "active": true,
  "dish_code": null,
  "dish_type": "DISH",
  "cat_external_key": "4C6BRYOAVR7K",
  "cat_type": "FOOD",
  "category_name": "Food",
  "sort": "0",
  "external_key": "4MJMYWGSGSOX",
  "favorite": 0,
  "unit_measurement": "QUANTITY",
  "unit_size": "1.00",
  "track_quantity": "UNLIMITED",
  "is_sale": 1,
  "brand_id": null,
  "unit_size_measurement": null,
  "size_per_unit": "0.00",
  "size_per_unit_measurement": null,
  "is_link": 0,
  "isCustom": 0,
  "platform": "NHAM24",
  "pricebook_is_active": 1,
  "dish_price_gid": "3cd50805-a19c-4d49-9fe2-2cb1ad85ab0d",
  "order_dish_status": 0,
  "order_dish_id": null,
  "dish_price_tax_id": null,
  "dish_price_active": 1,
  "url": null,
  "name_en": "Second product",
  "description_en": null,
  "category_name_en": "Food",
  "addon": [],
  "dish_price": 1.1,
  "option_prices": [
    {
      "external_key": "4MJMYWGSGSOX_opt_price",
      "name": "Regular",
      "price": 1.1,
      "rank": 1,
      "active": true,
      "default": true
    }
  ]
}
Retrieve all product information, optionally including the product options (Modifier group and Modifiers), by Platform Type.

Configuration Table:

Input Options:

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: You can specify a fixed attribute.
Name*List Products
Connection*Select your connection or create one.
Map Fields
Platform Type*Choose the source platform for Product’s information retrieval.
Including Product OptionsYes – No

(*) required field

[
  {
    "global_id": "73b0584b-f9c5-45e3-aea9-59cb5b559eba",
    "name": "Second product",
    "description": null,
    "active": true,
    "dish_code": null,
    "dish_type": "DISH",
    "cat_external_key": "4C6BRYOAVR7K",
    "cat_type": "FOOD",
    "category_name": "Food",
    "sort": "0",
    "external_key": "4MJMYWGSGSOX",
    "favorite": 0,
    "unit_measurement": "QUANTITY",
    "unit_size": "1.00",
    "track_quantity": "UNLIMITED",
    "is_sale": 1,
    "brand_id": null,
    "unit_size_measurement": null,
    "size_per_unit": "0.00",
    "size_per_unit_measurement": null,
    "is_link": 0,
    "isCustom": 0,
    "platform": "NHAM24",
    "pricebook_is_active": 1,
    "dish_price_gid": "3cd50805-a19c-4d49-9fe2-2cb1ad85ab0d",
    "order_dish_status": 0,
    "order_dish_id": null,
    "dish_price_tax_id": null,
    "dish_price_active": 1,
    "url": null,
    "name_en": "Second product",
    "description_en": null,
    "category_name_en": "Food",
    "addon": [],
    "dish_price": "1.00",
    "option_prices": [
      {
        "external_key": "4MJMYWGSGSOX_opt_price",
        "name": "Regular",
        "price": "1.00",
        "rank": 1,
        "active": true,
        "default": true
      }
    ]
Youding
Create a customer in Youding Database.

Configuration Table:

Input Options:

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: You can specify a fixed attribute.
Name*Create Customer
Connection*Select your connection or create one.
Map Fields
Platform ID*Choose the platform from a dynamic list where the customer will be created,, or Map it from Triggers or Methods.
New Customer information*:Provide information such as:

First Name*
Last Name*
Country Code*
Date of Birth*
Phone Number*
Email*
Address*
Gender*
Image URL
Description

(*) required field

Get information about a customer by Platform ID and Order ID.

Configuration Table:

Input Options:

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: You can specify a fixed attribute.
Name*Get Single Customer
Connection*Select your connection or create one.
Matching Criteria
Platform Type*Choose the platform from a dynamic list, or Map it from Triggers or Methods.
Order ID*Select the order from a dynamic list or Map it from Triggers or Methods.
Map Fields
If not Found Consider as:Success – When the record is not found during execution, the system does not treat this as an error. Instead, it considers the operation successful and continues with the workflow.

Failed – Wiresk treats this as an error or failure. The workflow stops or takes a predefined failure action.

(*) required field

List all customers from Youding database.

Configuration Table:

Input Options:

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: You can specify a fixed attribute.
Name*List Customers
Connection*Select your connection or create one.

(*) required field

Youding
Get information about a receipt by Receipt ID.

Configuration Table:

Input Options:

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: You can specify a fixed attribute.
Name*Get Receipt
Connection*Select your connection or create one.
Matching Criteria
Receipt ID*Choose the receipt from a dynamic list, or Map it from Triggers or Methods.
Map Fields
If not Found Consider as:Success – When the record is not found during execution, the system does not treat this as an error. Instead, it considers the operation successful and continues with the workflow.

Failed – Wiresk treats this as an error or failure. The workflow stops or takes a predefined failure action.

(*) required field

Get receipts information based on date range.

Configuration Table:

Input Options:

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: You can specify a fixed attribute.
Name*List Receipts
Connection*Select your connection or create one.
Matching Criteria
Start Date*Retrieve receipts from this date, format date "Y-m-d H:i:s".
End Date*Retrieve receipts to this date, format date "Y-m-d H:i:s".
Limit recordsEnter the maximum amount of receipts to retrieve.

(*) required field

Youding
This Method is used with GrabFood integration. To create a new order in Youding POS, you need to format the array “Modifiers” from GrabFood order first and Map it to Youding’s Method “Create Order”.

Configuration Table:

Input Options:

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: You can specify a fixed attribute.
Name*Format Items Object
Connection*Select your connection or create one.
Map Fields
Platform Type*Choose the platform from a dynamic list, or Map it from Triggers or Methods.
Items*Map the “Modifiers” array from GrabFood order.

(*) required field

This Method is used to update the venue external key by it Global ID.

Configuration Table:

Input Options:

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: You can specify a fixed attribute.
Name*Update Venue External Key
Connection*Select your connection or create one.
Matching Criteria
Global ID*Enter the global ID of the venue stored in Youding database, or Map it from the Method “Get Single Venue“.
Map Fields
External ID*Update the external ID.
Venue*Select the Venue.
Platform*Specify the Platform of the venue, e.g., GrabFood, Nham24, Foodpanda.
If not Found Consider as:Success – When the record is not found during execution, the system does not treat this as an error. Instead, it considers the operation successful and continues with the workflow.

Failed – Wiresk treats this as an error or failure. The workflow stops or takes a predefined failure action.

(*) required field

Youding
This Method is specifically design for Cloudbeds integration.It is used to update the payment of an order in Youding system from CloudBeds integration.

Configuration Table:

Input Options:

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: You can specify a fixed attribute.
Name*Update Payment
Connection*Select your connection or create one.
Map Fields
Platform Type*Choose the platform from a dynamic list, or Map it from Triggers or Methods.
Reservation ID*Reservation ID from Cloudbeds.
Room IDRoom ID from Cloudbeds.
Guest IDGuest ID from Cloudbeds.
If not Found Consider as:Success – When the record is not found during execution, the system does not treat this as an error. Instead, it considers the operation successful and continues with the workflow.

Failed – Wiresk treats this as an error or failure. The workflow stops or takes a predefined failure action.

(*) required field

Youding
Get information about a Platform in Youding Database by Platform ID. This Method is required from Youding for the “Create Order” process.

Configuration Table:

Input Options:

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: You can specify a fixed attribute.
Name*Get Single Venue
Connection*Select your connection or create one.
Map Fields
Platform Type*Choose the platform from a dynamic list, or Map it from Triggers or Methods.
If not Found Consider as:Success – When the record is not found during execution, the system does not treat this as an error. Instead, it considers the operation successful and continues with the workflow.

Failed – Wiresk treats this as an error or failure. The workflow stops or takes a predefined failure action.

(*) required field

{
  "external_key": "LAXINNEOYXBB",
  "meta_id": 305,
  "global_id": "9991bda8-7ed1-4e10-9451-56fc30df8dfe",
  "name": "N24 Retail",
  "currency_code": "USD",
  "rounding_unit": 0.01,
  "created_at": "2024-11-12 08:57:31",
  "updated_at": "2024-11-13 04:33:36",
  "rest_key": "73KYlhSx",
  "timezone": "Asia/Phnom_Penh",
  "third_party": "account",
  "sellingTimes": [
    {
      "id": "SELLINGTIME-01",
      "name": "Breakfast",
      "sequence": 1,
      "serviceHours": {
        "mon": {
          "openPeriodType": "OpenPeriod",
          "periods": [
            {
              "startTime": "09:00",
              "endTime": "22:00"
            }
          ]
        },
        "tue": {
          "openPeriodType": "OpenPeriod",
          "periods": [
            {
              "startTime": "09:00",
              "endTime": "22:00"
            }
          ]
        },
        "wed": {
          "openPeriodType": "OpenPeriod",
          "periods": [
            {
              "startTime": "09:00",
              "endTime": "22:00"
            }
          ]
        },
        "thu": {
          "openPeriodType": "OpenPeriod",
          "periods": [
            {
              "startTime": "09:00",
              "endTime": "22:00"
            }
          ]
        },
        "fri": {
          "openPeriodType": "OpenPeriod",
          "periods": [
            {
              "startTime": "09:00",
              "endTime": "22:00"
            }
          ]
        },
        "sat": {
          "openPeriodType": "OpenPeriod",
          "periods": [
            {
              "startTime": "09:00",
              "endTime": "22:00"
            }
          ]
        },
        "sun": {
          "openPeriodType": "OpenPeriod",
          "periods": [
            {
              "startTime": "09:00",
              "endTime": "22:00"
            }
          ]
        }
      }
    }
  ]
}

Objective:
Automatically manage and process orders across multiple venues by utilizing Youding’s order statuses and Wiresk’s tools.

Flow Overview

  1. Trigger: Retrieve New Orders
    Wiresk retrieves all new orders with the status NEW from Youding venues.
  2. Condition Logic Example by using Simple Condition Check Tool:
    • If the order status is NEW, validate the order and move it to ORDERED.
    • If the status is ORDERED, assign it to the kitchen and update it to SENT.
    • If the status is PENDING, escalate it for manual review.
    • If the status is CANCELLED, remove the order from the active queue and notify the relevant staff.

Detailed Actions

Screenshot of Wiresk Flow Builder. It shows a use case with Youding integration. From a Trigger "Retrieve new orders", by defining a condition logic the Flow initiate the Methods "Get Single Order" then "Update status", and finally "Send a Text Message " with telegram.
  1. For NEW Orders:
    • Use the Get Single Order method to fetch detailed information.
    • If all details are valid, use Update Status to mark the order as ORDERED.
    • Notify staff of the new order using notification tools like Telegram.
  1. For ORDERED Orders:
    • Use Get Order Items to retrieve order details and update the kitchen screen.
    • Change the status to SENT using Update Status, indicating the order is now in the kitchen’s queue.
  2. For SENT Orders:
    • Use Update Status to change the status to COOKING once the kitchen begins preparation.
    • Monitor the progress and move the order to DISPATCH when ready for delivery or DONE if served.
  3. For CANCELLED Orders:
    • Use Cancel Order to update the system.
    • Notify the customer and staff, and log the cancellation for reporting purposes.
  4. For PENDING Orders:
    • Flag the order for manual review using a Step with a notification tool like Telegram or Apple Push Notification.
    • Notify the manager or supervisor to resolve any issues.
  5. For DISPATCH Orders:
    • If the order is a delivery, update it to COMPLETED once delivered.
    • Notify the delivery team using Wiresk’s integration with communication tools like Telegram.

Order Status Workflow with Conditional Logic

Flow example:

  1. Trigger: Retrieve all orders with the status ALL (default) or filter specific statuses like NEW or PENDING.
  2. Condition Logic:
    • If status = NEW, validate and process.
    • If status = SENT, update to COOKING and notify staff.
    • If status = DONE, trigger a post-order action such as generating a receipt.
  3. Actions:
    • Retrieve Sales Data (Ticket Z): For tracking and analyzing completed orders.
    • Create Customer: Automatically add the customer to your database for future promotions if not already listed.
    • Get Receipt: Generate and print the receipt after the order status is marked COMPLETED.

Objective:
Automate the process of creating orders in Youding POS by integrating it with orders coming from GrabFood.

Workflow Overview

When an order is received on GrabFood platform, it is automatically sent to Youding using the Create Order method. This ensures that all orders are centralized and managed in Youding POS.

Step-by-Step Process

Screenshot of Wiresk Flow Builder. It shows a use case with Youding integration. It shows steps
  1. Trigger:
    • An order is placed on GrabFood platform, GrabFood will notify Wiresk of a new placed order.
  2. Retrieve Order Details:
    • Use Youding Methods to get:
      • Optional – Customer information (name, contact, delivery address).
      • Order items (product names, quantities, and prices, selected options).
      • Payment status (e.g., prepaid, cash on delivery).
      • Delivery or pickup details (time, location).
  3. Condition Logic:
    • If the external platform’s order is valid (e.g., payment confirmed, items in stock), proceed to create the order in Youding.
    • If the order contains unavailable items, trigger an alert for manual review.
  4. Action: Create Order in Youding
    • Use Youding’s Format Items Object Method to Format GrabFood fields to Youding Fields format.
    • Use Youding’s Get Merchant Details Method to retrieve required information about Youding’s Merchant account.
    • Use Youding’s Create Order Method to add the order to the POS system.
    • Pass the retrieved order details to Youding, including:
      • Optional – Customer details (use the Create Customer method if the customer doesn’t already exist in Youding).
      • Order items (format them using Format Items Object if needed).
      • Payment information (use the Update Payment method if applicable).
      • Discount information if applicable (discount type, discount amount, discount name).
      • Delivery Fees, Packaging fee.
  5. Status Updates:
    • Once the order is created in Youding, it is assigned the NEW status.
    • Notify the kitchen or delivery staff of the new order based on the venue.
  6. End of Flow:
    • Once the order is processed in Youding, the system updates the external platform with the order’s status using GrabFood Methods Update Order as Ready.


After setting up your Flow, you can choose to:

  • “Run once”, your Flow will run only a single time. You can use this function to test your Flow. Refer to how to set up an HTTP Trigger, in the “Create a Flow” step.
  • “Run Scheduler” will automate your Flows with the recurrence rule you previously defined.


For more details, refer to How to run a Flow tutorial in our Help Center.
 
If you are using a Webhook Trigger, the Flow will initiate automatically when a webhook is received from your connected apps. This means that the Flow is automated without a scheduler and will run until you deactivate the Flow manually. Refer to Webhook documentation in our Help Center.

Check related app documentations, such as: Nham24, GrabFood, Foodpanda, QuickBook, Xero.
If you need an integration that you cannot find in Wiresk, you can make a request to our team, and we will try our best to satisfy your needs.