**Jobs** are automatic tasks X-Sitter runs for a company on a regular schedule – for example importing orders from a marketplace, synchronising stock or sending tracking numbers back to JTL-Wawi. **Connections** store the access data to the external systems these jobs work with, such as a JTL-Wawi database, a marketplace account or a carrier account.

Under **Administration › Jobs & connections** you manage both yourself:

- As a **main tenant** (logistician) you manage the jobs and connections of your own company **and** of all your active clients.
- A **client** sees and manages only its own jobs and connections – and only after the logistician has released this for the client.

![Screenshot: Jobs overview with the company, group and status filters, the job list with active switches and the buttons Connections, Releases and New job](/administration/images/jobs-and-connections-overview.png)

## Before you start

- Your user needs the permission **Jobs & connections** in the **Administration** area of the permissions tree. Ask your administrator.
- Your package must have room for another job or connection. All jobs of your company and your clients count against your package – active **and** inactive ones. A job only frees its place when you delete it.
- For most jobs you first need a connection with the access data of the external system.

## Step by step

### 1. Create a connection

1. Open **Administration › Jobs & connections** (*Administration › Jobs & Verbindungen*) and click **Connections** (*Verbindungen*).
2. Click **New connection** (*Neue Verbindung*).
3. Choose the **Company** (*Firma*) the connection belongs to – your own company or a client.
4. Choose the **Type** (*Typ*), e.g. JTL, Otto, Kaufland, eBay, DHL or GLS. The matching form for the access data appears.
5. Enter a **Comment** (*Bemerkung*). It is shown wherever you choose the connection, so make it meaningful (e.g. "Main account", "Client XY test").
6. Optional, as main tenant: **Share with** (*Teilen mit*) another company of your group. That company can then select the connection in its jobs without seeing the access data.
7. Fill in the access data.
8. Click **Save** (*Speichern*). You see "The connection was created".

You can create several connections of the same type for one company – they are numbered.

![Screenshot: New connection form with company, type, comment, share with and the credential fields of the chosen type](/administration/images/jobs-and-connections-connection-form.png)

### 2. Create a job

1. In the jobs overview, click **New job** (*Neuer Job*).
2. Choose the **Company** (*Firma*).
3. Choose the **Job** from the list. Jobs are grouped by topic.
4. Optionally enter a **Comment** (*Bemerkung*).
5. Click **Create job** (*Job anlegen*). The job is created **inactive**: "The job was created - please complete the settings now and activate the job".

![Screenshot: New job form with the company dropdown and the grouped job list opened](/administration/images/jobs-and-connections-new-job.png)

### 3. Configure and activate the job

1. The job settings open automatically (later: click the job name in the list).
2. Fill in the job-specific settings – usually the connection to use, plus options such as status, folder or intervals, depending on the job. Some jobs have no further settings.
3. Switch **Active** (*Aktiv*) on.
4. Click **Apply** (*Übernehmen*) to save and stay, or **Save & Close** (*Speichern & Schließen*). You see "The job settings were saved".

From now on X-Sitter runs the job automatically. The list shows when it ran last (**Last run**, *Letzter Lauf*) and how long it took (**Duration**, *Dauer*).

![Screenshot: Job settings page with group badge, company name, last run, duration, the Active switch, the job-specific fields and the Apply / Save & Close buttons](/administration/images/jobs-and-connections-job-settings.png)

### Switch a job on or off

Use the switch at the start of each row in the jobs list. You see "The job was activated" or "The job was deactivated". An inactive job keeps its settings and still counts against your package.

### Delete a job or connection

- **Job:** click the delete button in the list or **Delete job** (*Job löschen*) in the settings. Confirm "Delete job?". The job and its settings are removed; data that was already imported is kept.
- **Connection:** click the delete button in the connections list or **Delete connection** (*Verbindung löschen*) in the form. The confirmation tells you how many jobs still use the connection. Those jobs fail afterwards, so change or delete them first.

![Screenshot: Delete connection confirmation showing "This connection is still used by 2 job(s)"](/administration/images/jobs-and-connections-delete-connection.png)

## Release the mask to clients

As main tenant you decide which clients may manage their own jobs and connections.

1. In the jobs overview, click **Releases** (*Freigaben*). The button only appears if you have active clients.
2. The page **Releases for sub tenants** (*Freigaben für Untermandanten*) lists every active client with its number of jobs and connections.
3. Switch **Release** (*Freigabe*) on for a client: "The release was granted". Switch it off to withdraw it.
4. Use the buttons in each row to jump directly to the client's jobs or connections.

Released clients see their own jobs and connections under **Jobs & connections**. Their jobs still count against **your** package.

![Screenshot: Releases for sub tenants page with release switches, client names and job/connection counts](/administration/images/jobs-and-connections-releases.png)

## Fields and options

### Jobs list

| Column / filter | Meaning |
|---|---|
| Switch | Active / inactive. |
| **Company** (*Firma*) | Owner of the job (only shown if you manage several companies). Filter **All Companies** or one company. |
| **Group** (*Gruppe*) | Topic of the job, e.g. order import or tracking. Filter **All groups**. |
| **Job** | Name of the job, with your comment below. |
| **Slug** | Technical short name of the job – useful when talking to X-Sitter support. |
| **Last run** / **Duration** | Time of the last run and its duration in seconds. |
| Search | Searches job name, slug and comment. |

### Connection form

| Field | Meaning |
|---|---|
| **Company** | Owner of the connection. |
| **Type** | Kind of system. Determines the access data form. |
| **Comment** | Your label for the connection, max. 64 characters. |
| **Share with** | Another company of your group that may use the connection in its jobs (without seeing the access data). |
| Access data | Depends on the type. If there is no form for a type, enter the access data line by line as `key\|value`. |
| **Additional data (key\|value)** (*Weitere Daten (key\|value)*) | Extra fields, line by line as `key\|value`. They add to or overwrite the fields above. |

The connections list shows type, comment, **Shared with** (*Geteilt mit*) and the number of jobs that use each connection. Click the number to see those jobs.

## Good to know / Troubleshooting

| Message | Cause | Solution |
|---|---|---|
| **Not released** (*Nicht freigegeben*) – "The job administration is not yet released for your company…" | You are a client and your logistician has not released the mask. | Ask your logistician. |
| "This job already exists for this company" (*Diesen Job gibt es für diese Firma bereits*) | Each job can exist only once per company. | Open and edit the existing job. |
| "Please select a company" / "Please select a job" / "Please select a connection type" | A required field is empty. | Fill in the field. |
| **Package limit reached** (*Paketlimit erreicht*) | No more jobs or connections are included in your package. | Delete jobs you no longer need or contact X-Sitter support. |
| "Only the main tenant can grant releases" (*Freigaben kann nur der Hauptmandant erteilen*) | A client tried to open the releases. | Only the logistician manages releases. |
| A job does not run | The job is inactive, or its connection was deleted or has wrong access data. | Switch the job on and check the connection. |

Carrier accounts for DHL, DPD, GLS, UPS and Hermes can also be created directly under [Shipping providers](/administration/shipping-providers.md). Orders imported by jobs appear in the [order overview](/orders/order-overview.md).