Skip to main content
A CMR is the transport document for a vehicle. Its recipient can differ from the physical delivery destination. For an ordinary booking, omit items[].cmr_recipient. Bahn uses the customer’s configured recipient default. Without a configured default, it uses the physical delivery address, even when the company address is complete. Use this guide when your transport needs a different document recipient or your system lets staff choose one before booking.

​
Read the available choices

Call Get CMR options with the orders:read scope:
The response contains the registered company address, saved locations on the customer account, and defaults for future orders. This endpoint reads the authenticated account’s choices and does not accept ordered_for. An ordering channel must not treat these as another business’s saved locations. Each option contains a selection, a display label, a resolved recipient, and missing_fields. An incomplete address can have a null recipient and a list of missing fields. Do not offer it as a ready-to-use recipient. Ask the customer to complete the address or select another option.

​
Select a recipient when creating an order

Set cmr_recipient on the relevant vehicle in the create-order request: For company and saved-location choices, you can send the displayed recipient as expected_recipient. Bahn then rejects a selection if the address changed before order creation. Refresh the choices and ask the customer to confirm the updated address. Each vehicle has its own choice, including a trade-in vehicle. The choice does not change the route or whether the document is physical, digital, or unnecessary. An explicit recipient takes precedence over a configured rule that would otherwise copy driver details into the document.

​
Keep the confirmed recipient

The recipient is fixed when the order is created. PATCH /v2/orders/{order_id} cannot change cmr_recipient. Later edits to a saved location or customer default affect future orders. Read Files and inspections to retrieve the generated CMR PDF from the order file list.