Anleitungen,
die weiterhelfen.

Onboarding

Von der Anmeldung zum ersten Verkauf.

In rund 30 Minuten bist du startklar. Diese Anleitung führt dich Schritt für Schritt durch das komplette Setup — inklusive Tipps aus über 500 echten Onboardings.

Voraussetzungen

Bevor du startest, halte folgendes bereit:

• Schweizer Handelsregister-Eintrag oder Einzelfirma mit UID
• IBAN deines Geschäftskontos (CHF, optional EUR)
• Ausweiskopie der zeichnungsberechtigten Person (für Payments-Onboarding)
• Logo deiner Firma (transparent, min. 512 × 512 px)
• Artikelliste — z. B. als Excel/CSV mit Name, Preis, MWST-Satz

Starte mit deiner geschäftlichen E-Mail-Adresse. Du erhältst innerhalb weniger Minuten eine Bestätigungs-Mail, mit der du dein Passwort setzt und dich anschliessend im Händler-Portal anmeldest.

• Geschäftliche E-Mail bevorzugen (z. B. info@deinefirma.ch)
• Passwort mit mindestens 12 Zeichen, Gross-/Kleinschreibung, Zahl & Sonderzeichen
• 2-Faktor-Authentifizierung (App oder SMS) direkt aktivieren — Pflicht für Inhaber-Rollen
• Recovery-Codes herunterladen und sicher aufbewahren

Erfasse Firmenname, Adresse, UID-Nummer und MWST-Status. Diese Daten erscheinen automatisch auf allen Belegen und Rechnungen.

• Firmenname — exakt wie im Handelsregister
• Rechtsform — AG, GmbH, Einzelfirma, Kollektiv, Verein
• Geschäftsadresse — Strasse, PLZ, Ort, Kanton
• UID-Nummer — Format CHE-123.456.789
• IBAN — für Auszahlungen, muss auf Firma lauten

BF POS unterstützt alle Schweizer MWST-Sätze. Lege pro Artikelgruppe den korrekten Satz fest:

Satz	Wert	Typische Branchen
Normalsatz	8.1 %	Detailhandel, Beauty, Dienstleistung
Reduzierter Satz	2.6 %	Lebensmittel, Bücher, Take-away
Sondersatz Beherbergung	3.8 %	Hotellerie
Befreit / nicht steuerbar	0 %	Bildung, Vereine

Wähle, welche Zahlungsmittel du akzeptieren möchtest. Bargeld und Rechnung sind standardmässig aktiv. Für Karten und TWINT verbindest du BF Payments oder einen externen Provider.

• Im Portal unter Einstellungen → Zahlungen
• Provider auswählen (BF Payments empfohlen)
• Onboarding-Formular ausfüllen (Firma, UID, IBAN, Ausweis hochladen)
• KYC-Prüfung abwarten — meist innerhalb 24 h freigeschaltet
• Test-Transaktion über CHF 1.00 durchführen

Drei Wege, dein Sortiment in BF POS zu bringen:

• Manuell — ideal für kleine Sortimente bis ca. 50 Artikel
• CSV-Import — Vorlage im Portal herunterladen, ausfüllen, hochladen
• API — für Integrationen mit ERP/Webshop (Beta)

CSV-Vorlage — Pflichtspalten: name, price_chf, vat_rate, category, sku (optional). Varianten (z. B. Grössen) und Modifikatoren (z. B. „extra Shot") fügst du danach im Portal hinzu.

Lade die BF POS App aus dem App Store oder Play Store und melde dich mit deinen Zugangsdaten an. Wähle den Standort und verbinde optional einen Belegdrucker oder ein Zahlterminal.

Empfohlene Hardware:

• Tablet — iPad (9. Gen) oder neuer · Samsung Galaxy Tab A8+
• Halterung — Heckler / Vogel's mit Kabeldurchführung
• Bondrucker — Epson TM-m30III (LAN/WLAN/Bluetooth)
• Kassenschublade — APG Vasario (RJ12 an Drucker)
• Barcode-Scanner — optional, Bluetooth (Socket S700)

Bevor du live gehst, simuliere einen kompletten Verkauf inklusive Bondruck, Bezahlung und Storno. So merkst du sofort, wenn etwas fehlt.

• Artikel auf den Bon legen
• Rabatt von 10 % testen
• Mit Bargeld bezahlen → Wechselgeld prüfen
• Bon drucken und Schublade öffnet sich
• Storno durchführen → erscheint im Portal

Go-Live Checkliste

• Konto erstellt + 2FA aktiv
• Firmendaten + Logo hochgeladen
• MWST-Sätze geprüft
• Payments freigeschaltet (Test-Tx über CHF 1.00 erfolgreich)
• Mindestens 10 Artikel angelegt
• Mitarbeiter eingeladen + Rollen zugewiesen
• Bondrucker druckt sauber inkl. Logo
• Tagesabschluss einmal manuell ausgelöst
• Treuhänder hat lesenden Zugriff (optional)

POS App

Mobile Kasse für iPad & Android.

Optimiert für schnelle Bedienung im Alltag — einhändig, mit Handschuhen, im Offline-Modus. Lade die App aus dem App Store oder Play Store und melde dich mit deinen Portal-Zugangsdaten an. Beim ersten Start wählst du Standort und Kasse aus.

Systemvoraussetzungen

• iOS / iPadOS — iPadOS / iOS 15 oder neuer
• Android — Version 10 oder neuer, ARMv8
• Speicher — 200 MB frei für App + lokalen Cache
• Arbeitsspeicher — mindestens 2 GB (4 GB empfohlen)
• Netzwerk — WLAN oder LTE (Offline-Modus immer verfügbar)

Empfohlene Geräte & Hardware

Komponente	Modell	Einsatzbereich
Tablet	iPad 10.9" / Samsung Galaxy Tab A9+	Stationäre Kasse, Gastronomie
Smartphone	iPhone 12+ / Pixel 7+	Foodtruck, Pop-up, Service am Tisch
Bondrucker	Epson TM-m30III / Star mC-Print3	WLAN/Bluetooth, 80 mm Bons
Küchen-Drucker	Epson TM-U220B (Nadel)	Hitzefest, mehrlagige Bons
Barcode-Scanner	Socket S700 / Zebra DS2278	Bluetooth, kabellos
Halterung	Heckler @Rest / Vogel's PTS	Drehbar, abschliessbar
Karten-Reader	SumUp Solo / Stripe BBPOS	Bluetooth, mobil

Anmelden & PIN

Beim ersten Start meldet sich der Inhaber mit E-Mail und Passwort an. Danach loggen sich Mitarbeiter mit ihrem persönlichen 4-stelligen PIN ein — schnell und ohne Tastatur-Fummelei.

• Auto-Logout nach 5 Minuten Inaktivität (konfigurierbar)
• PIN-Reset durch Manager im Portal
• Optional: Login per RFID-Chip am NFC-fähigen Gerät

Verkaufen

Drei Wege, einen Artikel auf den Bon zu bringen:

• Tippen — Kachel im Schnellwahl-Raster
• Suchen — Volltextsuche nach Name / SKU
• Scannen — Barcode mit Kamera oder Hardware-Scanner

Gesten: Wischen auf Position → Menge ändern oder löschen · Antippen → Modifikator hinzufügen · Antippen + halten → Notiz für die Küche („ohne Zwiebeln"). Mehrere Bons gleichzeitig (Split-Mode für stationäre Kassen).

Rabatte & Gutscheine

• Manuelle Rabatte — % oder CHF auf einzelne Position oder gesamten Bon
• Vordefinierte Rabatte — Mitarbeiter-, Stamm-, Happy-Hour-Rabatt
• Gutschein einlösen — per QR-Code scannen, Restbetrag bleibt gespeichert
• Kundenkarte — Kunde nennt Telefon, App findet Konto

Tische & Bestellungen

Im Gastro-Modus sind Tische, Splitting und Gänge verfügbar. Du kannst Bestellungen direkt an die Küche oder Bar drucken. Tische lassen sich umbenennen, zusammenlegen oder umsetzen.

• Tischplan — grafisch im Portal aufbauen, drag & drop
• Gänge — Vorspeise, Hauptgang, Dessert separat absenden
• Splitting — nach Person, Anteil oder Position
• Umbuchen — Gäste wechseln den Tisch, Bon folgt mit
• Reservierung — Tisch sperren, Gast-Notiz hinterlegen

Küchen-Display & Bons

Bestellungen erscheinen entweder auf dem klassischen Küchendrucker oder auf einem Küchen-Display (KDS). Letzteres sortiert nach Gang, zeigt Wartezeiten und kann pro Station (Pizza, Salat, Bar) gefiltert werden.

Verbinde Bondrucker per WLAN oder Bluetooth. Wir empfehlen Epson TM-m30III. Logo und Fusszeile passt du im Portal an. Bon-Layout:

• Logo oben (zentriert, max. 384 px breit)
• Firmenadresse + UID (automatisch)
• Positionen mit Menge, Bezeichnung, Preis
• MWST-Aufschlüsselung pro Satz
• QR-Rechnung (optional, für Rechnungs-Bons)
• Fusszeile mit Spruch oder QR zur Bewertung

Tap to Pay (iPhone & Android)

Auf kompatiblen Geräten akzeptierst du Karten, Apple Pay und Google Pay direkt am Smartphone — ohne zusätzliches Terminal. Voraussetzung: BF Payments aktiv und NFC-fähiges Gerät (iPhone XS+ / Android mit NFC).

• Auf „Bezahlen" tippen → „Tap to Pay" wählen
• Karte oder Smartphone des Gastes ans Gerät halten
• PIN-Eingabe direkt am Touchscreen (PCI-zertifiziert)
• Bon wird automatisch ausgestellt

Offline-Modus

Fällt das Internet aus, läuft die Kasse weiter. Verkäufe werden lokal gespeichert und automatisch synchronisiert, sobald die Verbindung zurückkehrt — ohne Datenverlust.

• Bis zu 7 Tage offline möglich
• Bargeld-, TWINT- und Karten-Zahlungen weiterhin möglich (Karten via Terminal)
• Bondruck funktioniert ohne Internet (lokale Verbindung)
• Sync läuft im Hintergrund, sobald Netz wieder da ist

Tagesabschluss

Am Ende des Tages erstellt jede Kasse einen Z-Bericht — fortlaufend nummeriert und revisionssicher.

• Bargeldbestand zählen → in App eingeben
• Differenz wird angezeigt (Soll vs. Ist)
• Bei Differenz: Notiz Pflicht (z. B. „Trinkgeld entnommen")
• Z-Bericht wird gedruckt + im Portal archiviert

Troubleshooting

• Drucker reagiert nicht — WLAN prüfen, Drucker neu starten, in App neu verbinden
• App startet nicht — Cache leeren (Einstellungen → BF POS → Speicher)
• Bons fehlen im Portal — Internet prüfen, Pull-to-Refresh in der Bon-Liste
• Tap to Pay nicht verfügbar — BF Payments + NFC-fähiges Gerät erforderlich
• Akku entlädt schnell — Display-Helligkeit auto, Hintergrundsync nur WLAN

API Reference

REST-API für eigene Integrationen.

Eine REST-API für eigene Integrationen, Webshops, ERP-Anbindungen und Custom-Workflows. Aktuell in Entwicklung — Beta-Plätze sind reservierbar.

Bald verfügbar — Beta-Anmeldung offen

Designprinzipien

Die BF POS API folgt REST-Prinzipien, nutzt JSON über HTTPS und authentifiziert per Bearer-Token. Wir orientieren uns an Stripe und Twilio — konsistent, vorhersehbar, gut testbar.

• Vollständig dokumentierte Endpunkte mit Live-Beispielen
• Sandbox-Umgebung mit unbegrenzten Testdaten
• SDKs für TypeScript, PHP und Python
• Versionierte Schnittstellen (/v1/, /v2/ …)
• Idempotency-Keys für sichere Wiederholung
• Cursor-Pagination, max. 100 Items pro Seite
• Rate-Limit: 100 Requests pro Sekunde, Burst 200

Authentifizierung

Jeder Request enthält im Authorization-Header einen Bearer-Token. Es gibt zwei Schlüssel:

• sk_test_… — Sandbox, kostenlos, ohne Auswirkung
• sk_live_… — Produktion, vollständig auditiert

Beispiel: Verkauf abrufen

curl https://api.bfpos.ch/v1/sales \
  -H "Authorization: Bearer sk_live_..." \
  -H "Accept: application/json"

{
  "id": "sale_01HZK8X9P7YQVA",
  "created_at": "2026-04-25T14:32:11+02:00",
  "location_id": "loc_zurich_hb",
  "employee": { "id": "emp_42", "name": "Mira" },
  "currency": "CHF",
  "subtotal": 24.50,
  "vat": 1.96,
  "total": 26.46,
  "items": [
    {
      "sku": "ESP-001",
      "name": "Espresso",
      "qty": 2,
      "unit_price": 4.50,
      "vat_rate": 8.1
    }
  ],
  "payment": { "method": "twint", "status": "succeeded" }
}

Beispiel: Artikel anlegen

curl -X POST https://api.bfpos.ch/v1/products \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Cappuccino",
    "sku": "CAP-001",
    "price_chf": 5.50,
    "vat_rate": 2.6,
    "category_id": "cat_kaffee"
  }'

Endpunkte

Method	Pfad	Beschreibung
GET	/v1/products	Artikel listen & filtern
POST	/v1/products	Artikel anlegen
PATCH	/v1/products/:id	Artikel aktualisieren
DELETE	/v1/products/:id	Artikel deaktivieren
GET	/v1/categories	Kategorien abfragen
GET	/v1/inventory	Lagerbestände abrufen
POST	/v1/inventory/adjust	Bestand anpassen (Wareneingang)
GET	/v1/sales	Verkäufe abfragen
GET	/v1/sales/:id	Bon-Details inkl. Positionen
POST	/v1/sales/:id/refund	Refund auslösen
GET	/v1/customers	Kundenliste
POST	/v1/customers	Kunde anlegen
GET	/v1/payouts	Auszahlungen mit Aufstellung
GET	/v1/reports/daily	Tagesabschluss als JSON
POST	/v1/webhooks	Webhook-Endpoint registrieren

Webhooks

Registriere eine HTTPS-URL und erhalte signierte JSON-Events in Echtzeit. Signaturen verifizierst du mit dem geteilten Secret per HMAC-SHA256.

Event	Beschreibung
sale.created	Neuer Bon abgeschlossen
sale.refunded	Refund verarbeitet
product.updated	Artikel geändert
inventory.low	Bestand unter Mindestmenge
payout.paid	Auszahlung auf Bankkonto
customer.created	Neuer Kunde im CRM

Fehlerbehandlung

Alle Fehler folgen demselben Schema:

{
  "error": {
    "type": "invalid_request",
    "code": "missing_field",
    "message": "Field 'price_chf' is required.",
    "doc_url": "https://docs.bfpos.ch/api/errors#missing_field"
  }
}

Roadmap

• Q4 2026 — Closed Beta (Read-Endpoints, Webhooks)
• Q1 2027 — Public Beta (Write-Endpoints, SDKs TS/PHP)
• Q2 2027 — GA mit SLA, Python-SDK, OAuth2