# Mobile App

> Stampfactory Mobile App für iOS und Android, Einrichtung und Funktionen



## Übersicht [#übersicht]

Die Stampfactory Mobile App ist für iOS und Android verfügbar und bietet Ihren Mitarbeitenden die wichtigsten Funktionen direkt auf dem Smartphone.

## Installation [#installation]

<CardGroup cols="2">
  <Card title="iOS" icon="apple" href="https://stamp.st/ios-app">
    Laden Sie die App aus dem Apple App Store herunter.
  </Card>

  <Card title="Android" icon="android" href="https://stamp.st/android-app">
    Laden Sie die App aus dem Google Play Store herunter.
  </Card>
</CardGroup>

## Ersteinrichtung [#ersteinrichtung]

Die App lässt sich per QR-Code einrichten oder manuell mit Firmen-Kennung und Zugangsdaten.

### Einrichtung per QR-Code [#einrichtung-per-qr-code]

Beim QR-Code-Weg geben die Mitarbeitenden weder Firmen-Kennung noch Anmelde-ID oder Passwort ein.

<Steps>
  <Step title="QR-Code erstellen">
    Öffnen Sie in der Web-App unter [Mitarbeitende](/docs/zeiterfassung/employees) die gewünschte Person, klicken Sie im Kopfbereich auf das Menü mit den drei Punkten und wählen Sie **QR-Code für App-Einrichtung**. Der Dialog erzeugt sofort einen Code und zeigt an, bis wann er gültig ist. Dafür wird die Berechtigung zur Mitarbeiterverwaltung benötigt.
  </Step>

  <Step title="Code persönlich übergeben">
    Der Code meldet das Gerät unmittelbar an und ist deshalb wie ein Passwort zu behandeln. Übergeben Sie ihn persönlich und verschicken Sie ihn nicht per E-Mail oder Chat. Er ist sieben Tage gültig und nur einmal einlösbar.
  </Step>

  <Step title="App installieren und Code scannen">
    Installieren Sie zuerst die App. Scannen Sie den Code anschließend mit der Kamera des Smartphones. Die App öffnet den Bildschirm **App einrichten** und fragt, ob die Anmeldung beim angezeigten Server erfolgen soll.
  </Step>

  <Step title="Anmeldung bestätigen">
    Tippen Sie auf **Jetzt anmelden**. Danach ist die App eingerichtet und angemeldet. Über **Manuell anmelden** gelangen Sie stattdessen zur regulären Anmeldung.
  </Step>
</Steps>

<Frame caption="QR-Code-Dialog in den Mitarbeiter-Details der Web-App">
  <img src="/images/employees/stamp-employees-enrollment-qr.png" />
</Frame>

Im selben Dialog listet **Bisher erstellte Codes** alle Codes der Person mit Status (**Offen**, **Eingelöst**, **Abgelaufen**) und, sofern schon eingelöst, das Gerät. Einen offenen Code machen Sie mit **Sperren** ungültig, mit **Neuen Code erstellen** erzeugen Sie einen weiteren. Ist ein Code abgelaufen, gesperrt oder bereits eingelöst, meldet die App beim Scannen: "Dieser Code ist nicht mehr gültig."

<Info>
  Die Einrichtung per QR-Code funktioniert nur mit einer Stampfactory-Instanz. Für Xnet Stamp 2 melden Sie sich manuell an.
</Info>

### Manuelle Einrichtung [#manuelle-einrichtung]

<Steps>
  <Step title="Verbindung herstellen">
    Wählen Sie **Firmen-Kennung** und geben Sie die Kennung Ihres Unternehmens ein (z.B. `meinefirma` für `meinefirma.stamp.eu`). Alternativ wechseln Sie zu **Server-URL** und geben die vollständige Adresse ein. Tippen Sie auf **Verbinden**.
  </Step>

  <Step title="Anmelden">
    Melden Sie sich mit Ihrer Anmelde-ID und Ihrem Passwort an.
  </Step>

  <Step title="Biometrie aktivieren (optional)">
    Aktivieren Sie Face ID oder Touch ID für schnelleren Zugang.
  </Step>

  <Step title="Benachrichtigungen erlauben">
    Erlauben Sie Push-Benachrichtigungen, um über Genehmigungen und Erinnerungen informiert zu werden.
  </Step>
</Steps>

### Verbindung mit Xnet Stamp 2 [#verbindung-mit-xnet-stamp-2]

<Info>
  Ab 

  **Version 1.1.1**

   ist die Mobile App auch mit 

  **Xnet Stamp 2**

   kompatibel.
</Info>

Um sich mit einer bestehenden Xnet Stamp 2 Instanz zu verbinden:

<Steps>
  <Step title="Auf Server-URL umschalten">
    Tippen Sie auf dem Verbindungsbildschirm oben auf **Server-URL**.
  </Step>

  <Step title="Server-URL eingeben">
    Geben Sie die URL Ihrer Xnet Stamp Instanz ein: `stamp.xnet-zeiterfassung.de/INSTANZ-ID`.

    Die Instanz-ID finden Sie in der Adresszeile Ihres Browsers, wenn Sie auf Ihre Xnet Stamp Instanz zugreifen.

    <Frame caption="Instanz-ID in der Adresszeile von Xnet Stamp 2">
      <img src="/images/xnet-stamp2-instanz-id.png" />
    </Frame>

    <Tip>
      `https://`

       muss nicht eingegeben werden, die App ergänzt es automatisch.
    </Tip>
  </Step>

  <Step title="Verbinden und Anmelden">
    Tippen Sie auf **Verbinden**. Nach erfolgreicher Verbindung melden Sie sich wie gewohnt mit Ihrer Anmelde-ID und Ihrem Passwort an.
  </Step>
</Steps>

<Frame caption="Server-URL-Eingabe in der Mobile App">
  <img src="/images/apps/stamp-mobile-xnet-url.png" />
</Frame>

## Funktionen [#funktionen]

### Startbildschirm [#startbildschirm]

<CardGroup cols="2">
  <Frame caption="Startbildschirm mit Abwesenheiten">
    <img src="/images/apps/stamp-mobile-home.png" />
  </Frame>

  <Frame caption="Stempel-Widget auf dem Startbildschirm">
    <img src="/images/apps/stamp-mobile-clock.png" />
  </Frame>
</CardGroup>

Der Startbildschirm zeigt:

* **Anstehende Abwesenheiten** und Feiertage auf einen Blick
* **Stempel-Button** am unteren Bildschirmrand mit Echtzeit-Timer
* **Abwesenheit beantragen** direkt vom Startbildschirm
* Wischen nach oben öffnet das erweiterte Stempel-Widget

### Live Activity (iOS) [#live-activity-ios]

<CardGroup cols="2">
  <Frame caption="Live Activity auf dem Sperrbildschirm">
    <img src="/images/apps/stamp-mobile-live-activity.png" />
  </Frame>

  <Frame caption="Stempel-Status mit Echtzeit-Timer">
    <img src="/images/apps/stamp-mobile-overview.png" />
  </Frame>
</CardGroup>

Auf iOS-Geräten zeigt eine **Live Activity** die laufende Arbeitszeit direkt auf dem Sperrbildschirm und in der Dynamic Island an. So behalten Sie Ihre Arbeitszeit im Blick, ohne die App öffnen zu müssen.

### Abwesenheiten [#abwesenheiten]

<CardGroup cols="2">
  <Frame caption="Abwesenheiten mit Urlaubskonto">
    <img src="/images/apps/stamp-mobile-absences.png" />
  </Frame>

  <Frame caption="Zeitkonto mit Wochenkalender">
    <img src="/images/apps/stamp-mobile-time-account.png" />
  </Frame>
</CardGroup>

Direkt aus der App:

* **Urlaubskonto** mit Anspruch, Genommen und Übrig auf einen Blick
* Abwesenheitsanträge stellen (Urlaub, Krankheit, etc.)
* Feiertage und genehmigte Abwesenheiten in der Übersicht
* Antrag zurückziehen per Swipe

### Zeitkonto [#zeitkonto]

Die Zeitansicht zeigt:

* **Wochenkalender** mit täglichen Arbeitszeiten
* **Wochentotal** der geleisteten Stunden
* Umschalten zwischen **Kalender** und **Stundenkonto**

### Profil & Einstellungen [#profil--einstellungen]

<CardGroup cols="2">
  <Frame caption="Profil und Einstellungen">
    <img src="/images/apps/stamp-mobile-profile.png" />
  </Frame>
</CardGroup>

Persönliche Einstellungen:

* **Profilbild** und Kontoinformationen
* **Passwort ändern**
* **Standort-Abfrage** ein-/ausschalten (beim Stempeln nach dem Standort fragen)
* **Kommentar beim Stempeln** ein-/ausschalten (Kommentarfeld beim Stempeln anzeigen)
* **Stempeluhr-Anzeige** wählen: Schwebend oder als Karte
* **Darstellung & Sprache**: Hell, Dunkel oder Systemeinstellung sowie die App-Sprache (Deutsch, Deutsch (Schweiz), English, Français, Español, Italiano, Nederlands, Türkçe, Shqip)
* **Abmelden** und **Verbindung trennen**

<Note>
  Die gewählte Sprache gilt auch für E-Mails, Push-Benachrichtigungen und Mitteilungen im Postfach.
</Note>

## Vorgaben für das Stempeln [#vorgaben-für-das-stempeln]

Unter [Einstellungen > Apps](/docs/zeiterfassung/settings#apps) legen Sie in der Web-App fest, ob beim Stempeln in der Mobile App ein **Standort** und ein **Kommentar** erfasst werden. Beide Angaben lassen sich getrennt auf **Aus**, **Optional** oder **Erforderlich** stellen. Die App übernimmt die Vorgabe beim nächsten Start.

| Einstellung  | Wirkung in der App                                                                                                                  |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
| Aus          | Die Angabe wird nicht erfasst, der Schalter im Profil wird ausgeblendet.                                                            |
| Optional     | Mitarbeitende entscheiden im Profil selbst, ob die Angabe abgefragt wird.                                                           |
| Erforderlich | Der Schalter im Profil zeigt **Vom Betrieb vorgegeben** und lässt sich nicht ändern. Ohne die Angabe wird die Stempelung abgelehnt. |

<Note>
  Offline erfasste Stempelungen werden auch bei **Erforderlich** übernommen, sobald wieder eine Verbindung besteht. Bereits erfasste Arbeitszeit geht dadurch nicht verloren.
</Note>

## Geofencing [#geofencing]

Wenn Ihr Unternehmen Standorte mit GPS-Koordinaten konfiguriert hat, kann die App automatisch erkennen, wenn Sie den Arbeitsort betreten oder verlassen:

* **Erinnerung beim Ankommen**: "Möchten Sie einstempeln?"
* **Erinnerung beim Verlassen**: "Möchten Sie ausstempeln?"

Die Nutzung von Geofencing ist optional und kann unter **Profil > Standort-Abfrage** aktiviert werden.

## Offline-Modus [#offline-modus]

Die App funktioniert auch ohne Internetverbindung:

* Stempelungen werden lokal zwischengespeichert
* Bei Wiederherstellung der Verbindung werden alle Stempelungen automatisch übertragen
* Ein Hinweis zeigt den Offline-Status an

## Push-Benachrichtigungen [#push-benachrichtigungen]

Mitarbeitende erhalten Benachrichtigungen bei:

* Genehmigung oder Ablehnung eines Abwesenheitsantrags
* Erinnerung bei vergessener Ausstempelung
* Neue Nachrichten von Vorgesetzten