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

# How to connect your Xentral instance to Procuros

> Step by step guide to setup your technical connection between your Xentral and Procuros

The setup of the Xentral Connector is done via a Personal Access Token in Xentral.

<Steps>
  <Step title="Open Administration Menu">
    Click on your username in the bottom left and select **Account Settings**.

    <img src="https://mintcdn.com/procuros-c35f505c/WEWxE_97bveYqyyM/XentralAPIToken(1).jpg?fit=max&auto=format&n=WEWxE_97bveYqyyM&q=85&s=be99e56d5f6a62d63574225254c3792a" alt="Xentral API Token (1).jpg" width="1920" height="1080" data-path="XentralAPIToken(1).jpg" />
  </Step>

  <Step title="Navigate to Developer Settings">
    Go to **Developer Settings > Personal Access Token**. Here you will see a list of all active tokens.

    <img src="https://mintcdn.com/procuros-c35f505c/B4duGMjGkBbihGWc/XentralAPIToken7.jpg?fit=max&auto=format&n=B4duGMjGkBbihGWc&q=85&s=15d70a4838887635a60d2cfc4c65acba" alt="Xentral API Token 7.jpg" width="1920" height="1080" data-path="XentralAPIToken7.jpg" />
  </Step>

  <Step title="Create New Token">
    Click on **+ Create Token**. If no tokens are active, you will find the button in the center of the screen. Otherwise, it appears at the top right above your token list.

    <img src="https://mintcdn.com/procuros-c35f505c/B4duGMjGkBbihGWc/XentralAPIToken8.jpg?fit=max&auto=format&n=B4duGMjGkBbihGWc&q=85&s=a350e3a7516c55ac6d68ee514af14f3c" alt="Xentral API Token 8.jpg" width="1920" height="1080" data-path="XentralAPIToken8.jpg" />
  </Step>

  <Step title="Assign a Name">
    Enter a unique name for your token (maximum 50 characters).

    <img src="https://mintcdn.com/procuros-c35f505c/B4duGMjGkBbihGWc/XentralAPIToken9.jpg?fit=max&auto=format&n=B4duGMjGkBbihGWc&q=85&s=432c7969fd3efc076e17bdc5136cf9a9" alt="Xentral API Token 9.jpg" width="1920" height="1080" data-path="XentralAPIToken9.jpg" />
  </Step>

  <Step title="Generate Token">
    Click on **Create Token**. The new token will appear on the screen.

    <img src="https://mintcdn.com/procuros-c35f505c/WEWxE_97bveYqyyM/XentralAPIToken10.jpg?fit=max&auto=format&n=WEWxE_97bveYqyyM&q=85&s=6d7dabde74b7bf4d4d3492f4876fb1a9" alt="Xentral API Token 10.jpg" width="1920" height="1080" data-path="XentralAPIToken10.jpg" />
  </Step>

  <Step title="Copy Token">
    Click on the copy icon to copy the token to the clipboard.

    <img src="https://mintcdn.com/procuros-c35f505c/WEWxE_97bveYqyyM/XentralAPIToken11.jpg?fit=max&auto=format&n=WEWxE_97bveYqyyM&q=85&s=00b7b04ea6a86acee9b4a7ea721b563e" alt="Xentral API Token 11.jpg" width="1920" height="1080" data-path="XentralAPIToken11.jpg" />
  </Step>
</Steps>

<Note>
  Keep the token safe, as it will not be displayed again after leaving the page.
</Note>

## Submit Access Information to Procuros

The following information is required for the setup:

1. **Xentral API URL**: This consists of your browser URL + "/api"
2. **Xentral PAT**: Encrypt this via [https://eu.onetimesecret.com/](https://eu.onetimesecret.com/) and send it by email to [help@procuros.io](mailto:help@procuros.io)
3. **Xentral Project ID**: If relevant for your integration

<Warning>
  Never transmit the Personal Access Token unencrypted via email.
</Warning>

## Test Connection

After configuration by the Procuros team, a connection test is performed:

1. Procuros sets up the connector with your access data
2. A test document is created to verify correct transmission
3. After successful verification, you will be informed about the operational connection

## Troubleshooting

If problems occur during setup:

<Accordion title="Common Setup Problems">
  1. **API Access Rights**: Ensure that the created token has sufficient rights
  2. **Firewall Settings**: Check if your firewall settings allow connections from Procuros
  3. **Xentral Version**: Confirm that your Xentral version is compatible with the connector
</Accordion>

If problems occur, contact the Procuros support team at [help@procuros.io](mailto:help@procuros.io) with a detailed description of the problem.