Jobs & connections

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.

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.

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".

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).

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.

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.

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. Orders imported by jobs appear in the order overview.