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

# Ledger preview

The **Preview** feature for ledger entries allows you to **safely test and validate synchronization flows** without committing any actual ledger entries to the target accounting system. It acts like a sandbox mode for data synchronization, showing exactly which ledger entries would be created **without writing any real data**.

> [!WARNING]
>
> For now, only Point of Sale to Accounting (*Export des ventes vers la
> comptabilité - Par catégorie OU Taux de TVA*) is supported.

## Purpose & business value

* **Risk reduction:** Preview data before activating a flow, avoiding duplicates or errors.
* **Confidence building:** See exactly which ledger entries would be created.
* **Debugging & compliance:** Access execution logs to troubleshoot issues and verify accounting accuracy.
* **Time & support savings:** Reduces failed integrations and support tickets.

## How it works

### 1. Initiate preview

Start a preview from the flow configuration modal by clicking **Aperçu des écritures comptables**.

![Flow configuration modal with preview button](https://mintcdn.com/chift/YfM6CGx7RnGBih-K/assets/docs/syncs/preview/01.png?fit=max\&auto=format\&n=YfM6CGx7RnGBih-K\&q=85\&s=ebb2c165710bc7b7ae02b3f326e859b7)

### 2. Select date range

Select a date range for the preview. You can select only historical data (max 1 year).

![Date range selection dialog](https://mintcdn.com/chift/YfM6CGx7RnGBih-K/assets/docs/syncs/preview/02.png?fit=max\&auto=format\&n=YfM6CGx7RnGBih-K\&q=85\&s=a9839c4c8bac46bced19f5a42afdf919)

### 3. System processing

The preview runs asynchronously, generating simulated ledger entries. Chift notifies you by email when the preview is ready.

![Preview processing status](https://mintcdn.com/chift/YfM6CGx7RnGBih-K/assets/docs/syncs/preview/03.png?fit=max\&auto=format\&n=YfM6CGx7RnGBih-K\&q=85\&s=e4b0218adf080ed30e77a9101e5ae80e)

### 4. Email notification

Once the preview finishes, Chift sends an email with a link to view the results or errors.

![Email notification with preview results link](https://mintcdn.com/chift/YfM6CGx7RnGBih-K/assets/docs/syncs/preview/04.png?fit=max\&auto=format\&n=YfM6CGx7RnGBih-K\&q=85\&s=a846cfe8aee064a8173774d795c53aa6)

### 5. Review results

Access the preview results through two tabs:

**Ledger tab:** Displays formatted journal entries (debits, credits, accounts, descriptions).

![Ledger tab showing journal entries](https://mintcdn.com/chift/YfM6CGx7RnGBih-K/assets/docs/syncs/preview/05.png?fit=max\&auto=format\&n=YfM6CGx7RnGBih-K\&q=85\&s=4f69ceb5ac4f9a2ef29f910518ab72c5)

**Logs tab:** Shows execution details, errors, and debug information.

![Logs tab showing execution details](https://mintcdn.com/chift/YfM6CGx7RnGBih-K/assets/docs/syncs/preview/06.png?fit=max\&auto=format\&n=YfM6CGx7RnGBih-K\&q=85\&s=b5aa9fc0d52a8b215d68e65b4e2ecc95)

### 6. Decision

Based on the preview results, you can activate the flow, adjust configurations, or run another preview.

## Feature highlights

### Status tracking

Chift tracks the preview status throughout the process:

| Status | Description |
| - | - |
| **pending** | Preview is running |
| **ready** | Preview completed successfully, results available |
| **viewed** | User has accessed the preview results |
| **failed** | Preview encountered an error |

### Additional features

* **Secure access:** Each preview is scoped to the requesting user and time-limited.
* **Email notifications:** Chift notifies you when a preview completes or fails, with links to view results or errors.
* **Ledger entry validation:** Verify that ledger entries are balanced (debits = credits) before committing.

> [!NOTE]
>
> Preview result links expire after 7 days.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.