---
title: "Data import from Azure Service Bus dead letter queue"
slug: "data-import-from-azure-service-bus-dead-letter-queue"
description: "Learn how to import data from Azure Service Bus dead letter queues into D365 F&SCM with setup instructions and message handling tips."
tags: ["Concept", "Connectivity Studio", "CS"]
status: "update"
updated: 2026-10-05T12:14:08Z
published: 2026-10-05T12:14:08Z
canonical: "docs.staedean.com/data-import-from-azure-service-bus-dead-letter-queue"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.staedean.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Data import from Azure Service Bus dead letter queue

If a receiver reads a message from a Service Bus queue or topic subscription, an error can occur. If so, the Service Bus moves the message to the applicable dead letter queue.

For more information, refer to [Service Bus queues, topics, and subscriptions](https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-queues-topics-subscriptions).

## Setup

In this section, you can find information on the setup required to import Service Bus dead letter queue data into D365 F&SCM.

### Connector

You can use a connector of type '**Service Bus queue**' to import data from an Azure Service bus dead letter queue.

Make sure that for the connector the:

- **Service Bus type** is '**Queue**'.
- **Entity** field is filled with the name of the applicable Service Bus dead letter queue.

### Document

The source document of the import message defines which data is imported from the **Received dead letter data (BisConSbReceivedDataDeadLetter)** table and in which format and structure.

Examples of fields that can be used in the document are:

- DeadLetterReason: Contains the reason the message was moved to the dead letter queue.
- DeadLetterErrorDescription: Contains the detailed error description associated with the dead-lettered message.

> [!NOTE]
> Note
> 
> In a dead letter data import message, you can only use these external file-based documents: **EDI**, **Fixed text**, **Text**, **XML**, **JSON**. For such a document select the version 3 (V3) handler class.

### Message

Set up messages to read data from the **Received dead letter data (BisConSbReceivedDataDeadLetter)** table and import this data into D365 F&SCM. The import messages must have the '**Service Bus queue**' connector as source connector.

### Service Bus search definitions

To import data received from a Service Bus dead letter queue, you need an import message. Define dead-letter-specific Service Bus search definitions that are used to assign messages to the received data records. You can use these messages to import the received dead letter data into D365 F&SCM.

## Data import from Service Bus dead letter queue

To import Service Bus dead letter queue data:

1. Run '**Receive dead letter data**' to receive data from a Service Bus dead letter queue. The received data is added to the **Received dead letter data (BisConSbReceivedDataDeadLetter)** table in Connectivity Studio. On receiving data from the Service Bus dead letter queue, based on the Service Bus search definitions and settings on the received data, import messages are automatically assigned to the received dead letter data records.
2. Run import messages to read data from the **Received dead letter data (BisConSbReceivedDataDeadLetter)** table and import this data into D365 F&SCM. The import messages must have the '**Service Bus queue**' connector as source connector.

![Diagram illustrating data import from Azure Service Bus dead letter queue to D365.](https://cdn.document360.io/da662430-6a41-47b1-8c7e-7e4ac37a9756/Images/Documentation/AzureServiceBusDeadLetterQueue-Import.png)

## Related

- [Data import from Azure Service Bus queue or topic subscription](/data-import-from-azure-service-bus-queue-or-topic-subscription.md)
- [Monitor and troubleshoot Service Bus dead letter data](/monitor-and-troubleshoot-service-bus-dead-letter-data.md)
- [Receive data from Service Bus dead letter queue](/receive-data-from-service-bus-dead-letter-queue.md)
- [Monitor data received from Service Bus dead letter queue](/monitor-data-received-from-service-bus-dead-letter-queue.md)
- [Set up Service Bus search definition](/set-up-service-bus-search-definition.md)
- [Set up Service Bus queue connector](/set-up-service-bus-queue-connector.md)
- [Reassign message to data received from Service Bus dead letter queue](/reassign-message-to-data-received-from-service-bus-dead-letter-queue.md)
- [Reset status of data received from Service Bus dead letter queue](/reset-status-of-date-received-from-service-bus-dead-letter-queue.md)