> For the complete documentation index, see [llms.txt](https://docs.dynalogic.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dynalogic.com/birds-smart-connect/setup-and-configuration/parameters.md).

# Parameters and settings

Configure Smart Connect parameters to control system behavior and defaults.

Smart Connect parameters control system-wide behavior, defaults, and processing rules. This page covers parameter configuration and the key settings that affect how Smart Connect operates.

## Accessing parameters

Navigate to **Smart Connect > Setup > Parameters**.

The parameters form contains tabs for different functional areas:

* **General** – Default behavior and logging
* **Processing** – Queue and processor defaults
* **Integration** – External system defaults
* **Document Warehouse** (DMS) – Document processing settings

## Core parameters

### General settings

| Parameter            | Description                                | Default | Impact                                                      |
| -------------------- | ------------------------------------------ | ------- | ----------------------------------------------------------- |
| Enable logging       | Log all Smart Connect activities           | Yes     | Affects performance; required for troubleshooting           |
| Log retention (days) | How long to keep logs                      | 90      | Older logs are archived; longer retention uses more storage |
| Enable notifications | Send system notifications on events        | Yes     | Alerts go to configured email addresses                     |
| Timezone             | System timezone for timestamp calculations | UTC     | Affects when batch jobs run and log timestamps              |
| Number sequence      | Counter for Smart Connect transaction IDs  | –       | Used internally for uniqueness                              |

### Processing settings

| Parameter                | Description                           | Default | Impact                                                       |
| ------------------------ | ------------------------------------- | ------- | ------------------------------------------------------------ |
| Default queue priority   | Priority for new queues (1-10)        | 5       | Higher = processed sooner; adjust based on volume            |
| Max queue batch size     | Messages processed per batch          | 100     | Larger batches process faster but use more memory            |
| Default retry attempts   | Retries for failed messages           | 3       | More retries increase chance of success but delay processing |
| Retry interval (minutes) | Wait time between retries             | 5       | Longer intervals give external systems time to recover       |
| Enable async processing  | Process messages asynchronously       | Yes     | Yes = better performance; No = messages process sequentially |
| Async worker threads     | Number of parallel processing threads | 4       | More threads = faster processing; uses more CPU              |

### Connector defaults

| Parameter                    | Description                               | Default |
| ---------------------------- | ----------------------------------------- | ------- |
| Connection timeout (seconds) | How long to wait for connector response   | 30      |
| Certificate auto-refresh     | Automatically renew expiring certificates | No      |
| API retry logic              | Retry failed API calls                    | Yes     |

## Document Warehouse parameters (DMS)

These parameters apply when DMS is installed and integrated with **Birds Document Warehouse**.

### Document processing

| Parameter                             | Description                            | Default | Impact                                              |
| ------------------------------------- | -------------------------------------- | ------- | --------------------------------------------------- |
| Enable Document Warehouse integration | Route documents to Document Warehouse  | Yes     | If No, DMS queues do not send documents for storage |
| Document retention (days)             | Keep documents in Document Warehouse   | 365     | Balance storage cost vs. audit trail                |
| Archive to cold storage (days)        | Move old documents to low-cost storage | 730     | Reduces cost; access is slower                      |

### Format-specific settings

#### UBL (electronic invoice)

| Parameter             | Description                       | Default |
| --------------------- | --------------------------------- | ------- |
| Validate UBL schema   | Validate XML against UBL standard | Yes     |
| Auto-create supplier  | Create vendor if not found        | No      |
| UBL namespace version | Which UBL version to accept       | 2.3     |

#### Tungstan (purchase documents)

| Parameter                        | Description                     | Default |
| -------------------------------- | ------------------------------- | ------- |
| Tungstan endpoint URL            | Tungstan service URL            | –       |
| Match PO automatically           | Match received documents to POs | Yes     |
| Create purchase receipt on match | Auto-create GRN when PO found   | No      |

## Setting a parameter value

1. Navigate to **Smart Connect > Setup > Parameters**
2. Find the parameter in the appropriate tab
3. Edit the value
4. Click **Save**
5. A confirmation message shows the change took effect
6. Some parameters require an application restart; follow the on-screen instruction

## Parameter change history

All parameter changes are logged. To view history:

Navigate to **Smart Connect > Setup > Parameters > History**.

| Column         | Description              |
| -------------- | ------------------------ |
| Parameter name | Which parameter changed  |
| Old value      | Previous value           |
| New value      | Current value            |
| Changed by     | User who made the change |
| Changed date   | When the change occurred |

Use this to audit configuration changes and revert if needed.

## Impact of parameter changes

{% hint style="warning" %}
Some parameter changes affect running processes. Test parameter changes in a development environment first.
{% endhint %}

| Parameter                | Immediate effect       | Requires restart? | Affects                      |
| ------------------------ | ---------------------- | ----------------- | ---------------------------- |
| Enable logging           | Immediately            | No                | All new activities logged    |
| Max queue batch size     | Next batch             | No                | Queue processing performance |
| Async worker threads     | Next processing cycle  | Yes (recommended) | Parallel processing capacity |
| Certificate auto-refresh | Next scheduled refresh | No                | Certificate renewal          |

## Best practices

* **Test before changing:** Modify in a non-production environment first
* **Document changes:** Leave a comment in the History explaining why
* **Monitor impact:** After a significant change, monitor logs for unexpected behavior
* **Batch timeouts:** If batch jobs often timeout, increase worker threads or reduce batch size
* **Archive old logs:** Regularly archive logs to keep the system performant

## Default vs. specific settings

Some settings can be overridden at the queue or processor level:

* **Parameter setting:** Applies to all queues
* **Queue setting:** Overrides parameter for that specific queue

Example:

* Parameter: Default retry attempts = 3
* Queue A: Retry attempts = 5 (uses 5, not 3)
* Queue B: No override (uses parameter value of 3)

## Related pages

* [Queues and message handling](https://docs.dynalogic.com/birds-smart-connect/setup-and-configuration/queues-and-message-handling.md)
* [Processors and transformations](https://docs.dynalogic.com/birds-smart-connect/readme/processors-and-transformations.md)
* [Security roles and privileges](https://docs.dynalogic.com/birds-smart-connect/setup-and-configuration/security-roles.md)


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dynalogic.com/birds-smart-connect/setup-and-configuration/parameters.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
