> For the complete documentation index, see [llms.txt](https://docs.rishvi.co.uk/linnworks/llms.txt). > Use it to discover all available pages before exploring further. # IOSS Note Automatically add marketplace IOSS or tax ID details from selected Linnworks orders into order notes, helping teams keep tax information visible during order processing and fulfilment. Marketplace IOSS and tax identification details are often required during international order processing, customs handling, and fulfilment checks. When this information is stored only in order extended properties, teams may need to open each order manually to confirm whether the required tax information is available. The *IOSS Note* macro helps make this information easier to access by checking selected Linnworks orders for marketplace IOSS or tax ID extended properties and adding those values into the order notes. This macro looks for the following order extended properties: - **MARKETPLACE\_IOSS** - **MARKETPLACE\_TAXID** When either value is found, the macro creates an order note containing the available tax information. This helps fulfilment, customer service, and operations teams quickly view the required marketplace tax details directly from the order notes. > Keep marketplace IOSS and tax ID information visible by automatically copying it from order extended properties into order notes. ## **Configure the Macro** Once the app is installed, you need to create a macro configuration so the system knows which macro to run and allows it to be selected in the Rule Engine. This setup can be adjusted anytime based on your operational requirements. ### **Steps to Configure** **Go to Apps > Macro Configuration and click + Add new configuration.**

**Select the IOSSNote macro and click Create Configuration.**

This creates a new configuration where the macro can be enabled and used by the Rule Engine. **In the Macro Configuration screen, add the configuration name.**

This macro uses the selected order IDs provided by the Rule Engine. No additional custom parameter values are required. **Make sure to enable the macro to continue with the Rule Engine configuration.**

**Note:** If the macro is not enabled, it will not appear in the **Action** value list when setting up the rule. **Go to Orders > Rules engine and click + Add new rule.**

**Enter the rule name and click Create.**

**Click Add new, select Condition, set the condition as required, and save it.**

Choose the condition that identifies the orders where IOSS or marketplace tax information should be added to the order notes. **Add the macro action and click Save.**

In the **Add action** window, enter the **Action name**, for example: `IOSSNote` - Set **Action type** to: `Execute a macro` - In **Action value**, select: `IOSSNote` - Click **Save** **Note:** If the macro is not enabled, it will not appear in the **Action** value list when setting up the rule. **Review the saved rule setup.**

- Verify the condition and action are connected correctly - Click **Save** in the bottom-right corner to save the rule Marketplace IOSS and tax ID details can be important for order handling, especially when marketplace tax information needs to be visible during fulfilment. This macro helps reduce manual checks by copying the relevant extended property values into the order notes. Eliminates the need to manually open each selected order and check extended properties for marketplace IOSS or tax ID values. Adds marketplace tax details into the order notes so they are easier to view during order processing. Helps warehouse, dispatch, and operations teams quickly identify relevant marketplace tax information. Uses the order extended properties already stored against the order in Linnworks. Allows teams to apply notes automatically instead of copying IOSS or tax ID values manually. The macro creates a note only when the selected order contains a matching marketplace IOSS or tax ID extended property. ### How It Works The macro checks each selected order and creates an order note only when marketplace IOSS or marketplace tax ID information is found. The macro starts execution and writes **Macro Start** to the log. It loops through each order ID provided in the **OrderIds** parameter. For each order, the macro retrieves the order details using the Linnworks Orders API. It checks the order extended properties for names matching **MARKETPLACE\_IOSS** or **MARKETPLACE\_TAXID**. If one or more matching extended properties are found, the macro creates a note starting with **MARKETPLACE\_IOSS :**. The macro appends the matching extended property values to the note. The macro saves the note against the order with **Internal** set to **false** and **CreatedBy** set to **IOSS Note Macro**. The macro logs any errors and writes **Macro Finished** when execution ends. ### **Usage of App** This macro is designed to run against selected orders through the Rule Engine. It is useful when orders need marketplace IOSS or tax ID values copied from extended properties into order notes. Defines the Linnworks order IDs that should be processed. Only these selected orders are checked for marketplace IOSS or tax ID extended properties. The macro checks for this extended property name and adds its value to the order note when found. The macro also checks for this extended property name and adds its value to the order note when found. When matching extended properties are found, the macro creates an order note containing the available marketplace tax values. The macro records the start, errors, and completion of the process using the macro logger. ### **Key Points to Remember** - The macro processes only the order IDs provided in **OrderIds** - The macro checks order extended properties for **MARKETPLACE\_IOSS** and **MARKETPLACE\_TAXID** - A note is created only when at least one matching extended property is found - The note starts with **MARKETPLACE\_IOSS :** - Matching extended property values are added to the note text - The note is created with **Internal** set to **false** - The note creator is set as **IOSS Note Macro** - The macro does not add a note when no matching extended property exists - The macro does not include duplicate-note checking logic Once the macro is running, it helps make marketplace tax information easier to see directly from order notes. ### **What You Can Expect** - **Marketplace IOSS values are added to order notes**\ Orders with a **MARKETPLACE\_IOSS** extended property receive a note containing the value - **Marketplace tax ID values are added to order notes**\ Orders with a **MARKETPLACE\_TAXID** extended property also have the value added to the note - **Orders without matching properties are skipped**\ If no matching extended property exists, the macro does not create a note for that order - **Notes are visible as non-internal notes**\ The macro creates the note with **Internal** set to **false** - **Execution is logged**\ The macro records when it starts, finishes, and if an error occurs ### **Overall Impact** This macro improves visibility of marketplace tax information, reduces manual checking of extended properties, and helps teams access IOSS or marketplace tax ID values directly from the order notes. ### What To Do After the Macro Runs After the macro has completed, review the selected orders if needed to confirm that the IOSS or marketplace tax ID information has been added to the order notes. ### **Steps to Follow** Open Linnworks and locate the orders processed by the rule. Open an affected order and review the order notes. Confirm that the note starts with **MARKETPLACE\_IOSS :**. Confirm that the expected IOSS or marketplace tax ID value has been added to the note. Continue with normal order processing, fulfilment, customs review, or dispatch handling. ### **Why This Matters** Keeping marketplace tax details visible helps: - Reduce manual extended property checks - Improve order review accuracy - Make IOSS and tax ID values easier to find - Support fulfilment and dispatch workflows - Help teams process relevant marketplace orders more efficiently ### Best Practices To get the most value from this macro, use it with rule conditions that target orders where marketplace tax data is expected. ### **Recommended Guidelines** - **Use clear rule conditions**\ Configure the Rule Engine so the macro runs only for orders where IOSS or marketplace tax ID data is relevant. - **Review sample orders after setup**\ Confirm that the note is created correctly before using the macro across a larger order set. - **Avoid repeated rule execution where possible**\ The macro code does not include duplicate-note checking, so repeated execution may create repeated notes depending on how the order is processed. - **Check extended property names carefully**\ The macro only checks for **MARKETPLACE\_IOSS** and **MARKETPLACE\_TAXID**. - **Use before fulfilment review**\ Run the macro before dispatch or customs-related order checks so the tax information is visible in the notes. ### **Troubleshooting** Confirm that the order has an extended property named **MARKETPLACE\_IOSS** or **MARKETPLACE\_TAXID**. Confirm that the macro configuration has been created and enabled in **Apps > Macro Configuration**. Check whether the extended property exists and contains a value on the order. Review the rule setup to ensure the macro is not being triggered repeatedly for the same order. Confirm that the rule condition matches the order and that the rule has been saved and enabled. ### **Summary** The *IOSS Note* macro checks selected Linnworks orders for marketplace IOSS and marketplace tax ID extended properties. When matching values are found, it creates an order note containing those values so the information is easier to access during order processing. This helps teams reduce manual checks, improve tax information visibility, and support smoother fulfilment workflows.