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

# Reference

> Configuration properties, operations, events, and error mapping for the Dataverse connectors.

The Microsoft Dataverse integration retrieves and updates customer party data in Dataverse for Microsoft Dynamics 365 CRM. The party connector is outbound: it reads and updates contact records. The party inbound connector receives create, update, and delete webhooks from Dataverse and publishes party update events to the Sync Hub ASB producer. For setup steps, see [Get started](/connectors/crm/dataverse/get-started).

**Supported version:** Microsoft Dataverse Contact Entity API.

| Connector                              | Property file                  | Purpose                                             |
| :------------------------------------- | :----------------------------- | :-------------------------------------------------- |
| `gc-dataverse-party-connector`         | `party-v0.values.yaml`         | Outbound party retrieval and update                 |
| `gc-dataverse-party-inbound-connector` | `party-inbound-v0.values.yaml` | Inbound party update events from Dataverse webhooks |

## Configuration properties

### gc-dataverse-party-connector

Set these properties in `party-v0.values.yaml`. This connector sends outbound requests to Dataverse.

| Property                               | Description                                                     | Default                                  |
| :------------------------------------- | :-------------------------------------------------------------- | :--------------------------------------- |
| `dataverse.serviceUri`                 | Target API endpoint for Dataverse, including the API version.   | N/A (environment-specific)               |
| `dataverse.resourcePath`               | Resource path for the Dataverse entity mapped to a party.       | `/contacts`                              |
| `errorTemplate`                        | Error mapping template file used to translate Dataverse errors. | `transform-dataverse-error-details.json` |
| `http.client.connect.timeout`          | HTTP connect timeout, in milliseconds.                          | `5000`                                   |
| `http.client.request.timeout`          | HTTP request timeout, in milliseconds.                          | `10000`                                  |
| `http.client.socket.timeout`           | HTTP socket timeout, in milliseconds.                           | `5000`                                   |
| `http.client.connection.max.per.route` | Maximum HTTP connections per route.                             | `100`                                    |
| `http.client.connection.max.total`     | Maximum total HTTP connections.                                 | `200`                                    |
| `thread.profile.core.pool.size`        | Core thread pool size.                                          | `20`                                     |
| `thread.profile.max.pool.size`         | Maximum thread pool size.                                       | `20`                                     |
| `retryFlag`                            | Enable automatic request retries on connection failure.         | `true`                                   |
| `retry.statuses`                       | HTTP status codes that trigger a retry.                         | `429,502,503`                            |
| `redelivery.maximumRetries`            | Maximum number of redelivery attempts.                          | `3`                                      |
| `redelivery.delay`                     | Initial delay between redelivery attempts, in milliseconds.     | `200`                                    |
| `redelivery.backOffMultiplier`         | Backoff multiplier for redelivery attempts.                     | `2`                                      |

### gc-dataverse-party-inbound-connector

Set these properties in `party-inbound-v0.values.yaml`. This connector receives Dataverse webhooks and publishes events to the Sync Hub ASB producer.

| Property                       | Description                                                 | Default                                                     |
| :----------------------------- | :---------------------------------------------------------- | :---------------------------------------------------------- |
| `asb.producer.apiUri`          | Callback URI of the Sync Hub ASB producer.                  | `http://asb-producer-v0.synchub-producer.svc.cluster.local` |
| `asb.event.topic`              | ASB topic for party update events.                          | `party-updates`                                             |
| `asb.event.type`               | ASB event type for party update events.                     | `com.backbase.party.event.spec.v1.PartyUpdateEvent`         |
| `asb.event.source`             | ASB source for party update events.                         | `com.backbase.party`                                        |
| `asb.event.version`            | ASB schema version for party update events.                 | `1.0.0`                                                     |
| `connectionsPerRoute`          | Maximum HTTP connections per route.                         | `200`                                                       |
| `retryFlag`                    | Enable automatic request retries on connection failure.     | `true`                                                      |
| `retry.statuses`               | HTTP status codes that trigger a retry.                     | `429,500,502,503,504`                                       |
| `redelivery.maximumRetries`    | Maximum number of redelivery attempts.                      | `3`                                                         |
| `redelivery.delay`             | Initial delay between redelivery attempts, in milliseconds. | `200`                                                       |
| `redelivery.backOffMultiplier` | Backoff multiplier for redelivery attempts.                 | `2`                                                         |

## Supported operations

The Dataverse connector exposes the party operations of the Grand Central Unified API. For the operation-to-endpoint table, see [Overview](/connectors/crm/dataverse/overview). For the full contract, see the [unified API specifications](/connectors/reference/unified-api-specifications).

| Method                                       | Endpoint             | Purpose               |
| :------------------------------------------- | :------------------- | :-------------------- |
| <span className="http-method-get">GET</span> | `/parties/{partyId}` | Get party details.    |
| <span className="http-method-put">PUT</span> | `/parties/{partyId}` | Update party details. |

## Events

The party inbound connector publishes the following event to the Sync Hub ASB producer.

| Event        | Type property    | Source property    | Version property    | Topic property    |
| :----------- | :--------------- | :----------------- | :------------------ | :---------------- |
| Party update | `asb.event.type` | `asb.event.source` | `asb.event.version` | `asb.event.topic` |

The party inbound connector consumes notifications from the following source.

| Source                                                | Configuration                                                  |
| :---------------------------------------------------- | :------------------------------------------------------------- |
| Dataverse contact create, update, and delete webhooks | Registered callback URL in the Dataverse webhook configuration |

The party connector is synchronous and doesn't publish or consume events.

## Error mapping

The connector maps Dataverse error codes to Grand Central status codes using the shared `transform-dataverse-error-details.json` template. For the full list, see [Error codes](/connectors/reference/error-codes).

## Dependencies

* Microsoft Dataverse Contact Entity API (outbound), reachable at `dataverse.serviceUri`.
* Dataverse contact webhooks (inbound), delivered to the registered callback URL.
* Sync Hub ASB producer, which receives the published party update events.
* `dataverse-connector-sdk` (shared HTTP configuration and Dataverse error code mapping).