BDLinx Integration
Order Desk can import orders from your shopping cart(s), sync in your print details and then automatically send them on to BDLinx for fulfillment. When orders are shipped, the tracking details will be sent back to Order Desk and back to your shopping cart if your store is set up for it.
IN THIS GUIDE
Setup
Integration Settings
Product Settings
Custom Details for BDLinx
Setup
To enable the integration, click on Manage Integrations in the left sidebar. Under the Print on Demand tab, find and enable the BDLinx integration.
Alternatively, search for BDLinx from the available integration search.
Enter your API User and API Secret credentials and click to connect.
Please note that Order Desk isn’t able to help find or reset your credentials, as they can only be provided by BDLinx.
Integration Settings
Once connected, you'll have some shipment and integration settings to adjust per your preferences.
After Import, Move To
Select the folder you want orders to be moved into after they are successfully sent to BDLinx.
You can use one of the default folders already in your store or create your own. Read the Working with Folders guide for more information.
After Shipment, Move To
Select the folder you want orders to be moved into as BDLinx sends shipment details back.
Notification URL
Give this notification URL to BDLinx. This is what connects BDLinx back to Order Desk so they can send shipment details automatically as they fulfill your orders.
Shipment Return Address
Set your default return address for BDLinx to use on your order shipments.
If you need to customize the return address for certain orders, you can save different return addresses to your Store Settings and then use a rule to set the return address to specific orders. If a return address is not added to the order, the default address set here in the BDLinx settings will be used.
For information on adding additional return addresses and applying them to specific orders with a rule, read the Store Settings guide.
Product Settings
For more information on what these product settings within the BDLinx integration are for, please refer to the Print on Demand Product Settings guide.
Custom Details for BDLinx
Initially, getting your orders ready to send to BDLinx is going to take some time before everything is in place for it to happen automatically. For detailed instructions on how to use Order Desk with your print on demand orders, please take a few moments to read the print on demand fulfillment guide.
Item Details
The following fields can be set as variations or item metadata for each item in an order:
Action of VAS. Current allowed options are “Pull” and “Print”. Defaults to “Pull”
| Field Name | Field Description |
| print_sku | Required. The BDLinx product code for the item. |
| print_url | Required. Link to your artwork file. print_url_1 is also accepted. Available in values 1 through 6. File types can be PNG, TIF, AR3, ARX4. |
| print_preview | Optional. Link to preview of artwork. Available in values 1 through 6. File types can be PNG, JPG, BMP, GIF, TIF and will accept an image. |
| print_location | Required. Options are Full Front, Back, Left Chest and others as specified. Available in values 1 through 6. |
| print_height | Height of the image to be printed (1/10mm). Available in values 1 through 6. |
| print_width | Width of the image to be printed (1/10mm). Available in values 1 through 6. |
| print_leftoffset | Left offset from the center of the image to be printed (1/10mm). Available in values 1 through 6. |
| print_topoffset | Top offset of the image to be printed (1/10mm). Available in values 1 through 6. |
| size | Size of apparel. |
| color | Color of apparel. |
| volume | If you have a volume setting for the line item, please use this field for that value. |
| print_underbase | Set to true or false (or 1 or 0) to tell BDLinx if a white print underbase is required on the item or not. Default is false if this field is not included. |
| type | Set "Finished" if sending an item to BDLinx without a print_url. The print_sku is still required. |
| style | Use if BDLinx asks you to. |
| vendor | Use if BDLinx asks you to. |
| WarehouseLocation | Use if BDLinx asks you to. |
| ProcessMode | Default is Piece. Bulk can also be used. |
| Custom_x | Custom field available, supports Custom_1 through 8. Sends as Custom1 to BDLinx. |
| OptionName1 | Send an option name and value pair to BDLinx. You can send OptionName1 through 4. If sending an OptionNameX, you must send an accompanying OptionValueX as well. |
| OptionValue1 | The accompanying value to the option being set. |
| vas_name_1 | If you have a Value Added Service (VAS), you can set these details here. This is available in 1 through 4. There are a number of other settings below which you can include for each VAS, though they are all optional (except for URL in some cases). The VAS Name is the main display name of the VAS. |
| vas_value_1 | Added details of VAS, such as location (EX: Bin #34) |
| vas_action_1 | This is the action of VAS. Current allowed options are "Pull" and "Print". Defaults to "Pull" |
| vas_sequence_1 | Priority of VAS in reference to others at the same level (order, product) Defaults to 0, highest |
| vas_url_1 | Location of file being printed. This is required for the Print action. |
| vas_singular_1 | Enter "true" or "false". Singular if once per product regardless of quantity of product, defaults to "false". This option only applies to Product-level VAS and is ignored if you are adding VAS at the order level. |
| vas_machine_type_1 | Specification of machine type to determine what printer to send to (user-defined customization) |
| vas_type_1 | Additional Value Added Service (VAS) field that can be sent to BDLinx as needed. |
| vas_preview_1 | Additional Value Added Service (VAS) field that can be sent to BDLinx as needed. |
Order Details
The following fields can be set as checkout data or order metadata to add or change the details that are sent to BDLinx about the order.
Please note: In addition to the fields below, the VAS values above are also available at the order level. It is important that you add these with the number at the end, since "vas_name" will not work. It must be "vas_name_1".
| Field Name | Field Description |
| Source | Default is Order Desk. If requested by BDLinx, set a different source. |
| OrderNotes | Send a note to BDLinx for the order. |
| Priority | Default is Normal. Can set a custom priority if necessary. |
| PackingSlip | URL for the PDF to be included as the packing slip with the order. Details here. |
| AlternateOrderID | Override a default order number for a particular order. |
| Custom_x |
Custom field available, supports Custom_1 through 8. Sends as Custom1 to BDLinx. |
| ShippingLabel | Add your shipping label URL to the order. |
| TaxID |
Use to set the tax identifier. |
| TaxType |
Use to set the tax identifier type. Options for this field value can be found here. Default is IOSS. |
If you are unfamiliar with checkout data, please read the How to Work with Checkout Data guide.