Use this guide to print Yuzu documents from Mintsoft while your team verifies, scans, packs, or prints batches.
Before you start
Yuzu Print Extension is installed in Chrome.
Your Yuzu API key is saved in the extension.
You know which App ID your bench should use.
Your printers are connected in Yuzu.
Printer override or tag-based routing is configured if this bench should use specific printers.
For shared setup steps, use these guides after they are published:
Create a Yuzu API key and find your App ID
Set up tag-based printer routing
Share extension configuration between benches
Supported Mintsoft workflows
Mintsoft workflow | Manual print | Auto-print |
Barcode Verification | Yes | Yes |
Scan Actions | Yes | Yes |
Scan Order Success | Yes | Yes |
Batch Details Page | Yes | Yes |
Batch Order Selection | Yes | Yes |
3PL mode: Supported. Use the 3PL setup guide if one Mintsoft account prints for multiple merchants or clients.
Custom domains: Supported. Use the custom-domain setup guide if your team uses a branded or company-specific Mintsoft URL.
Choose the right App ID
Yuzu Print Extension needs an App ID so Yuzu can find the order you are printing.
Use one of these options:
Use the Mintsoft source app ID when the order IDs printed from Mintsoft match the source IDs for that app.
Use the org/team ID when the IDs you print from Mintsoft are unique within your Yuzu team.
Use the same choice on every bench that prints the same Mintsoft orders. If you are not sure which option your team uses, check with your Yuzu admin before testing live orders.
Configure the extension for Mintsoft
Open Yuzu Print Extension settings.
Confirm your API key is saved.
Enter the App ID for this Mintsoft bench.
If every document should go to one printer, turn on Specify Printer Override, select Static Printer ID, and enter the printer ID.
If different document types should go to different printers, turn on Specify Printer Override, select Tag-Based Routing, and enter each Document Tag and Printer UUID.
Example tag routing:
Document Tag | Printer |
| Document printer |
| Document printer |
| Label printer |
Enable auto-print for Mintsoft workflows
Use auto-print when documents should print automatically during a supported Mintsoft workflow.
Open Yuzu Print Extension settings while Mintsoft is the selected platform.
Turn on auto-print for the Mintsoft workflows your team uses.
If needed, add auto-print conditions so auto-print only runs on matching Mintsoft pages.
Test with one order before using auto-print during a live packing run.
Print during Barcode Verification
Open the Barcode Verification workflow your team uses in Mintsoft.
Scan or enter the order as usual.
Use the Yuzu print button, or let auto-print run if enabled.
Confirm the right documents print before moving to the next order.
Print from Scan Actions
Open the Scan Actions workflow your team uses in Mintsoft.
Scan the order or item as usual.
Use the Yuzu print button when the order is ready, or let auto-print run if enabled.
Confirm the documents printed for the correct order.
Print after Scan Order Success
Complete the scan workflow in Mintsoft.
Wait for the success screen.
Use the Yuzu print button, or let auto-print run if enabled.
Confirm the documents printed for the correct order.
Print from a Batch Details Page
Open the batch details page your team uses in Mintsoft.
Review the batch.
Use the Yuzu print button, or let auto-print run if enabled for that workflow.
Confirm the expected batch documents print.
Print from Batch Order Selection
Open the Mintsoft order list or batch order selection screen your team uses.
Select the orders to print.
Click the Yuzu print button.
Confirm the selected orders print successfully.
Use Mintsoft with 3PL mode
Use 3PL mode when the same Mintsoft account handles orders for multiple merchants or clients.
Turn on 3PL mode in Yuzu Print Extension settings.
Add a mapping for each merchant your bench should print.
Enter the merchant ID, API key, App ID, and live/draft status.
Leave a merchant in draft if Yuzu should skip that merchant silently for now.
Test one order for each live merchant before printing live batches.
If a new merchant is found while printing, the extension can add it as a draft mapping. Add the correct API key and App ID before making that merchant live.
Use Mintsoft with a custom domain
Use custom-domain support if your Mintsoft URL is not the standard Mintsoft domain.
Open Yuzu Print Extension settings.
Turn on Use Custom Domain.
Enter the base URL for your Mintsoft custom domain.
Save the settings.
Refresh Mintsoft and confirm the Yuzu print button appears in the workflows your team uses.
Confirm it worked
A successful print usually shows a Yuzu success notification and sends the expected documents to the configured printer.
If you use tag-based routing, confirm each document type separately. For example, check that Invoice and Gift message print on the document printer, and Sticker prints on the label printer.
Troubleshooting
The Yuzu print button does not appear: Refresh Mintsoft and confirm Yuzu Print Extension is enabled. If you use a custom domain, check the custom-domain settings.
Nothing prints: Check that the printer is online and that the printer ID or Printer UUID is correct.
The wrong printer is used: Review Static Printer ID or Tag-Based Routing in extension settings.
The order is not found: Check the App ID choice. Use the source app ID when Mintsoft IDs match a source app; use the org/team ID when IDs are unique within the team.
Documents print for the wrong merchant: Check the 3PL merchant mapping for that merchant.
A merchant is skipped: Check whether the merchant is in draft status.
Auto-print does not run: Confirm auto-print is enabled for that Mintsoft workflow and test with one order.