How to set up a Conrad order connection

Learn how to set up a Conrad order connection and provide the required delivery bill ID.

Conrad order connections require a delivery bill ID before you can confirm a shipment.

In this article, you’ll learn how to set up a Conrad order connection in Channable, and how to attach your delivery bill ID to orders.

For standard connections, see the general order connection setup guide.

---

Before you start

You’ll need

• The Order Sync add-on enabled
• An existing Conrad channel set up in your Channable project
• A eCommerce platform that supports order-level field creation (Shopware 5, Shopware 6, Shopify, Magento, WooCommerce)

Good to know

• You need to attach a delivery bill ID to each order to ship Conrad orders

About the delivery bill ID

A delivery bill ID is a unique ID Conrad requires to link a delivery event to an order or invoice.

This ID is attached to the customer's invoice after they place an order through your Conrad listing. This ID is NOT generated by Conrad.

How to generate delivery bill IDs

If you use an ERP system, the system likely generates a delivery bill ID automatically which you can enter in your eCommerce platform, send to the Channable API, or Channable manually.

Don't use an ERP system?

You'll need to generate the delivery bill ID yourself using different software, or create your own delivery bill logic to track and follow.

Conrad doesn't require a specific format or generation method. You can use any unique value that identifies the delivery or parcel. The value can contain letters, numbers, and special characters, such as #DSN-123.

Conrad uses the delivery bill ID for verification purposes.

If you generate delivery bill IDs yourself, keep track of the IDs you use for each order. It's best to send an ID that is both unique to that order and increases incrementally, such as an invoice or order number, to help you keep track of your IDs and prevent verification issues.

---

Create and configure your Conrad order connection

1

Set up a Conrad connection

1. Go to Setup > Order connections.
2. Click Add connection.
3. Select your webshop platform and your Conrad channel.
4. Fill in the following fields:

   • Name: Add a descriptive name for your order connection, such as Conrad DE orders.
   • Fulfillment: Select your fulfillment type

     • Select DEFAULT if you fulfill orders yourself.
     • Select 3rd party fulfilled if another carrier fulfils shipment.
5. Click Save.

2

Add your delivery bill ID and confirm shipment

You need to add a delivery bill ID to all Conrad orders before you can confirm shipment.

Use any of these methods:

• Add the delivery bill ID to an order field in your eCommerce platform.
• Add the delivery bill ID via the Channable API
• Add the delivery bill ID to the order, then confirm the shipment in Channable.

Add via eCommerce platform

If you use one of the following eCommerce platforms, create an order-level field for the delivery bill ID. Channable retrieves the value with the order.

Magento

Add the delivery bill ID to the order notes or custom field you use for shipment data in Magento. Channable retrieves the value with the order.

Shopify

To add a delivery bill ID in Shopify:

1. In Shopify, go to Metafields.
2. Select Orders.
3. Create a metafield named Delivery bill ID.
4. Set the type to Single line text. The metafield becomes available on each order.

To retrieve the delivery bill ID programmatically, make a GET request to the orders/{order_id}/metafields.json endpoint.

This endpoint provides access to order metafields, including the delivery bill ID.

Shopware 5

To set up a delivery bill ID field in Shopware 5:

1. Go to Configuration > Free Text Field Management.
2. Add a text field named delivery_bill_id to the Orders (s_order_attributes) table.
3. Check that Display in Backend is selected so it appears in the order overview.
4. Click Save. It will appear at the bottom of the Overview tab in the Order details section.
5. Channable retrieves the field as deliveryBillId.

Shopware 6

To add a delivery bill ID in Shopware 6:

1. Go to Settings > System > Custom Fields.
2. Click Add Set and name it Delivery bill ID.

   
3. Inside the new set, create a new text custom field.
4. For Technical name, enter delivery_bill_id.
5. For Label, enter Delivery bill ID.
6. Click Save. The field appears in the order details.

Squarespace

To add a delivery bill ID in Squarespace:

1. In your Squarespace dashboard, go to Orders.
2. Click on the order.
3. In the order details, click the Notes tab.
4. In the field, enter: delivery-bill-id- .
5. Right after -, enter your delivery bill id.
6. Click Save.

The field should look something like: delivery-bill-id-123456

WooCommerce

To add a delivery bill ID in WooCommerce:

1. In your WordPress dashboard, go to WooCommerce > Orders.
2. Select the order.
3. Locate Custom fields in the order details. Its location depends on your WooCommerce version and plugins.
4. Create a custom field. For Name, enter delivery_bill_id. For Value, enter the delivery bill ID.
5. Save your field.

Send via Channable API

Add the order's delivery bill ID to the request body.

Learn more

Add via Channable

1. In Channable, open the project containing your Conrad channel.
2. Go to Orders.
3. In Processed orders, open the order.
4. Select Shipment confirmation.
5. For Delivery bill ID, fill in your delivery bill id.
6. Add the tracking code and transporter, if applicable.
7. Click Send shipment confirmation.

Channable will send the shipment confirmation to Conrad.