> For the complete documentation index, see [llms.txt](https://helpcenter.channable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.channable.com/list-advertise/orders/order-connections/how-to-set-up-an-order-connection/how-to-set-up-a-conrad-order-connection.md).
# 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](/list-advertise/orders/order-connections/how-to-set-up-an-order-connection.md).
***
### :memo-circle-check: 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`.
{% hint style="warning" %}
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.
{% endhint %}
***
### Create and configure your Conrad order connection
{% stepper %}
{% step %}
### 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**.
{% endstep %}
{% step %}
### 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-via-ecommerce-platform)
* [Add the delivery bill ID via the Channable API](#send-via-channable-api)
* [Add the delivery bill ID to the order, then confirm the shipment in Channable.](#add-via-channable)
### :circle-1: 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
For standard Magento setups, Magento uses their **Shipment Increment ID** as the delivery bill ID.
Since Magento prints this ID on its standard PDF packing slips, the printed packing slips automatically match Conrad's invoice.
**Use an external ERP?**
Send the ERP document number when you ship the order in Magento with the `channable_delivery_bill_id` extension attribute in the Magento API request:
```http
POST /rest/V1/order/{orderId}/ship
{
"tracks": [
{
"carrier_code": "dhl",
"title": "DHL",
"track_number": "3S123456789"
}
],
"arguments": {
"extension_attributes": {
"channable_delivery_bill_id": "DSN-123"
}
}
}
```
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.
{% hint style="info" %}
This endpoint provides access to order metafields, including the delivery bill ID.
{% endhint %}
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**.
{% hint style="info" %}
The field should look something like: `delivery-bill-id-123456`
{% endhint %}
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.
### :circle-2: Send via [Channable API](/list-advertise/orders/order-connections/supported-ecommerce-platforms-for-order-connections/how-to-set-up-the-channable-api-for-an-order-connection.md)
Add the order's delivery bill ID to the request body.
[*Learn more*](#https-api.channable.com-v1-docs-tag-orders-operation-shipment_companies__company_id__projects__proje)
### :circle-3: 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.
{% endstep %}
{% endstepper %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://helpcenter.channable.com/list-advertise/orders/order-connections/how-to-set-up-an-order-connection/how-to-set-up-a-conrad-order-connection.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
