BDLinx Integration

IN THIS GUIDE

Overview
Setup
Integration Settings
Product Settings
Custom Details for BDLinx

Overview

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.

This guide explains how to set up and use the BDLinx integration and the features available.

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.
Custom1 Custom field available. Sends as Custom1 to BDLinx.
Custom2 Custom field available. Sends as Custom2 to BDLinx.
Custom3 Custom field available. Sends as Custom3 to BDLinx.
Custom4 Custom field available. Sends as Custom4 to BDLinx.
OptionName1 Send an option name and value pair to BDLinx. You can send OptionName1-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-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.
Custom1
Custom field available. Sends as Custom1 to BDLinx.
Custom2 Custom field available. Sends as Custom2 to BDLinx.
Custom3 Custom field available. Sends as Custom3 to BDLinx.
Custom4 Custom field available. Sends as Custom4 to BDLinx.

If you are unfamiliar with checkout data, please read the How to Work with Checkout Data guide.

Still need help? Contact Us Contact Us