> For the complete documentation index, see [llms.txt](https://docs.xyb.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xyb.co/xyb-platform-1/xyb-ledger/integrate-with-xyb-ledger/understanding-reconciliation-in-xyb/ledger-data-extract-workflow.md).

# Ledger Data Extract Workflow

The Ledger Data Extract workflow is used when you want to **automate how the platform retrieves ledger data** for reconciliation. Instead of manually exporting transactions or balances from your ledger, this workflow lets you create a repeatable, reliable process that:

* Generates a ledger extract automatically,
* Saves it in File Vault, and
* Makes it available for reconciliation runs.

### Steps to create the workflow

1. **Create the workflow:** Go to **Workflows > Automations** and select **+ New automation**. Give it a name, such as *Ledger Data Extract*, and add a brief description.
2. **Add a trigger node:** Add a trigger to define how the workflow starts. You can choose an internal event (for automated runs) or a webhook (to trigger it externally). Configure the trigger details and save.
3. Add the **Ledger Data Extract** node to pull data from your ledger. Enter the dataset, time range, and output format, then save the configuration.<br>

   <figure><img src="https://2842134550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FakJn6TxWIBAbZwLlYoVP%2Fuploads%2FYwwCldY1oSp0igS0p2Ka%2Fimage.png?alt=media&amp;token=a2ef23dc-04d3-4cea-b951-e71bceb0ed9f" alt=""><figcaption></figcaption></figure>
4. **(Optional) Add a notification node:** You can include a notification step to alert your team (for example, through Slack or email) when the extract is completed.
5. **Publish the workflow:** Review the setup and activate the workflow.

***

### Viewing the results

When the workflow runs, the generated ledger extract file appears in **File Vault** under the *Statement* tab. You can view, download, or verify the file and its metadata, such as dataset, time range, and creation date.


---

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.xyb.co/xyb-platform-1/xyb-ledger/integrate-with-xyb-ledger/understanding-reconciliation-in-xyb/ledger-data-extract-workflow.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
