MWW On Demand Integration
Order Desk can send your orders to MWW on Demand (MWW). As MWW fulfills your orders, the shipment info will automatically be added to your orders in Order Desk and, if your store is set up for it, sent back to the original shopping cart.
You can use the MWW Europe integration for your European orders. This guide covers the settings found in both integrations.
IN THIS GUIDE
Setup
Integration Settings
Product Settings
Shipping Class Match
Preparing Orders
Canceling Orders
Resubmitting Orders
Setup
To connect your MWW account to Order Desk, click on Manage Integrations under the Integrations menu in the left sidebar. Under the Print on Demand tab, find and enable MWW.
Alternatively, search for MWW from the available integration search.
Enter your API Key and click to connect.
IMPORTANT
Please note that Order Desk isn’t able to help find or reset your credentials, as they can only be provided by MWW.
Integration Settings
Customer API Key
If you see this setting, it means you would have connected to the integration before this method was an option with MWW.
Get your Customer API Key from MWW, drop it in here and save your settings. When we switch our integration over to their new connection method, your connection will not be interrupted. Once entered, this setting will disappear.
Default Mail Classes
Select the default mail classes you want MWW to use for your orders. The shipping method chosen here will be used for all orders where the method on the order does not match any of MWW's shipping method names.
If you need to apply specific methods for certain orders, match your method names to MWW's names in the Shipping Class Match section below.
Ship Type
Select the ship type for your orders. In most cases this should be set to Mail to Home unless your MWW rep has instructed otherwise.
Shipping Account #
If you have a UPS, FedEx, or DHL shipping account that you want MWW to use for your shipments, enter your account number in this field.
If you are shipping on MWW's account number, you do not have to enter anything here.
If you have a USPS account number, you do not need to enter it in this box. This account number is already linked to your account.
After Import, Move To
Select the folder you want orders to be moved into after they are sent to MWW.
If you want to use a custom folder, create your own from Store Settings. Read the Working with Folders guide for more information.
After Shipment, Move To
Select the folder you want orders to be moved into when MWW sends shipment details back into Order Desk.
If Canceled, Move To
Select the folder you want orders moved into if they are canceled at MWW.
Notification URL
Take this notification URL and drop it into your account in MWW. They will use it to connect to your Order Desk account and send shipment details back to your orders automatically.
Add the URL on this page: https://api.mwwondemand.com/account/user/webhooks
Select Enabled, Received and Shipped.
If you have more than one MWW integration set up in Order Desk for the same MWW account, you will need to setup notification URL redirects following the instructions in the next section.
Setup Redirects
If you have MWW connected to more than one Order Desk store for the same MWW account, instead of adding the notification URL for each connection to MWW, add any additional notification URLs from other connections to your primary account. To add these, click on Setup Redirects. Add one URL per line.
When MWW ships your items, these redirects will help the shipments find their way back into the Order Desk store the orders came from.
Submit Orders in Test Mode
If you need to set up your store in test mode before going live, you can enable the test mode setting just below the folder options in the basic settings:
Orders will either be in live or test mode based on this setting, however, if your store is live you can still send a test order to MWW. This needs to be done using OrderType|test set as either metadata or checkout data on the order. For more information on how to set this up, please scroll down to the Preparing Orders section below.
Product Settings
For more information on what these product settings within the MWW integration are for, please read the Print on Demand Product Settings guide.
Shipping Class Match
The shipping methods that you have set up in your shopping cart(s) may not match the methods that MWW uses. To make sure your shipping preferences are sent through to MWW with each order, match your methods to theirs in the shipping class match feature. If matches aren't made, MWW will use your default preferences set above.
To learn in more detail about how to set up your shipping class matches, see the shipping class match guide.
Preparing Orders
Because MWW has some unique requirements to be able to receive and print your orders, certain information about each item you send to them will need to be stored with your item here in Order Desk and synced into your order before you can send any orders to them.
For a full walkthrough on how to set up your products and your store to send orders to MWW, please read through our Print on Demand Fulfillment Guide. We'll briefly go over the info here with a few details specific to MWW. Don't hesitate to contact Order Desk support if you need help getting started.
Every print on demand item should be stored in your Order Desk inventory. You can see your inventory items in Order Desk by clicking on Inventory Items under the Tools menu in the left sidebar.
Each item will need a print_sku (MWW's code for the product you want them to print on) and a print_url (a link to your artwork file so MWW knows what you want to print). These can either be stored as item variations or in the item's metadata:
The following item metadata fields will need to be added to your MWW products, depending on the requirement and product you are ordering:
Field Name | Value | Required |
inventory_location | MWW | recommended |
print_sku | MWW Part Number | required |
print_url_x | Your Print URL. Up to 5 (e.g. print_url_1, print_url_2). | required |
print_location_x | The print location for your image (e.g. front, back). Up to 5, but must match up with a coordinating print_url_x (e.g. print_url_1, print_location_1). | required |
print_placement_x | The print placement for your image (e.g. top-center, etc.). Up to 5, but must match up with a coordinating print_url_x (e.g. print_url_1, print_placement_1). | required |
print_neck_tape_color | If Required. | optional |
print_thread_color | If Required. Default color is black. | optional |
personalized_name | Use to pass a personalized name value. | optional |
personalized_name_font | Use to pass a font for the personalized name. | optional |
personalized_number | Use to pass a personalized number value. | optional |
personalized_number_font | Use to pass a font for the personalized number. | optional |
template_name | Use to pass template name. | optional |
vas_name_1 | Use to pass vas1 data. | optional |
vas_name_2 | Use to pass vas2 data. | optional |
IMPORTANTSetting the inventory's Location is recommended so your orders can be split as necessary when not all items in an order are going to MWW.
A typical inventory item set up to be submitted to MWW will look like this:
Your Code/SKU should match what you have set up in your shopping cart so the metadata fields will sync into your orders when they come into Order Desk. The Location field does not have to say MWW, but whatever name you choose to use here, such as manualww, should be consistent on all of your MWW products.
The following fields can be set on the order level either as checkout data or metadata:
Field Name | Description |
OrderType | new , test , redo , or reorder . By default it will be new or test based on your live mode setting on the Order Desk setup page. |
ShippingAccount | If you have a custom shipping account number for a particular order |
ShippingMethod | If you have a custom shipping method request for the order. This must match the MWW shipment code |
ShippingLabel | Link to a PDF file with shipping label. If you include a shipping URL, we will automatically set your shipping method to PRESHIP |
PackingSlip | Link to a packing slip PDF file you would like MWW to print and include in the package. For more details, see this guide. |
ProjectCode | Reference number for you to track a set of orders. OrderGroup is also accepted here. |
ProjectShipDate | Reference date when you want these orders to be shipped by. Actual ship dates are determined by the SLA. |
PONumber | The PO Number will be sent to MWW as the Order ID. |
IMPORTANTWhile it is possible to use redo
, we do not recommend it because we won't be able to get details about the shipment after the order has shipped.
Canceling Orders
If you need to cancel an order that you have already submitted to MWW, you can click the Cancel Order at MWW button within the first few seconds after the order was submitted:
Once an order has been canceled, if you need to resubmit it to MWW, you must change the order number first. Read the Resubmitting Orders section below for instructions.
IMPORTANT
If it has already been more than a minute or two since the order was sent to MWW, this button will not cancel the order. You must contact MWW directly to cancel the order. This button is only meant to immediately cancel an order that was just submitted.
Resubmitting Orders
If you need to resubmit an order to MWW, the order number will first need to be changed so MWW doesn't reject what they will think is a duplicate order.
To do this, open up the order details page and click on Edit Order Details:
Edit the Source ID# for the order. We recommend putting a -X on the end of the order number. This way the new order number is similar to the original with an easy to understand edit:
Once the order number is changed, you can now resubmit the order to MWW by clicking on the submit to MWW button: