Skip to main content

Set up tag-based printer routing in Yuzu Print Extension

Use tag-based routing to send different Yuzu document types to different printers from the same print request. For example, you can send Invoice and Gift message documents to a document printer, and Sticker documents to a label printer.

Use tag-based routing to send different Yuzu document types to different printers from the same print request. For example, you can send Invoice and Gift message documents to a document printer, and Sticker documents to a label printer.

Before you start

  • Yuzu Print Extension is installed and configured.

  • Your API key and App ID are saved in the extension.

  • Your printers are connected in Yuzu.

  • You have access to edit Yuzu flows.

Find the printer IDs you want to use

  1. Open Yuzu.

  2. Go to /printers.

  3. Find the printer you want to use for each document type.

  4. Copy the printer ID from the table, or open the printer and copy the ID from the URL.

Yuzu printers table showing printer IDs

Add tags to your order documents

  1. In Yuzu, open Flows.

  2. Open the On order flow.

  3. Add an Add order document module for each document you want to print.

  4. Add a clear tag to each document.

Example setup:

Document

Tag

Invoice

Invoice

Gift message

Gift message

Sticker

Sticker

Use the same spelling in the extension later. If the tag in the flow is Gift message, enter Gift message in the extension.

Yuzu On order flow with Add order document modules
Add order document module showing the Document tag field

Turn on tag-based routing in the extension

  1. Open Yuzu Print Extension settings.

  2. Turn on Specify Printer Override.

  3. Select Tag-Based Routing.

  4. Add one row for each document tag you want to route.

  5. Enter the Document Tag exactly as it appears in Yuzu.

  6. Enter the Printer UUID for the printer that should receive that document.

Example routing:

Document Tag

Printer UUID

Invoice

document printer UUID

Gift message

document printer UUID

Sticker

label printer UUID

Yuzu Print Extension settings with Tag-Based Routing selected

Test the routing

  1. Open or create a test order that creates all the document types you routed.

  2. Print the order with Yuzu Print Extension.

  3. Confirm each document prints on the expected printer.

Expected result:

  • The invoice prints on the document printer.

  • The gift message prints on the document printer.

  • The sticker prints on the label printer.

  • The extension shows a successful print notification.

Troubleshooting

  • A document printed on the wrong printer: Check that the document tag in Yuzu matches the Document Tag in the extension exactly.

  • A document did not print: Check that the printer is online and that the Printer UUID is correct.

  • All documents printed on one printer: Confirm Tag-Based Routing is selected, not Static Printer ID.

  • Only some documents routed correctly: Check every Add order document module in the On order flow.

  • The extension route is ignored: Save the extension settings, refresh the platform page, then try another test order.

Did this answer your question?