Hier findest du alle wichtigen Informationen auf einen Blick.
Wartungspreise berechnen mit optimaler Verteilung der Einmalkosten – ohne Vorleistung im 1. Jahr.
Die App und der Proxy laufen auf dem eigenen Server. Er übernimmt Login, Sessions, ERP, Freshdesk, Mailchimp, Liftaro, Order Display und den Hintergrund-Sync.
Alle API-Schlüssel liegen als Variablen im Railway-Dashboard (Service servicebox-proxy) – nicht in der App und nicht in Airtable.
Neue Server-Versionen kommen automatisch mit jedem Update des Repos.
Der Val.town-Proxy ist die Brücke zwischen dieser App und dem Aufzugshandwerk-ERP. Er behandelt Auth, Sessions und CORS. Trage deinen persönlichen Val.town-Token (vt_pat_…) ein und das Setup legt einen Val automatisch in deinem Account an.
val.town → Settings → API Tokens. Berechtigung: vals.read, vals.write, vals.execute.https://giltglobalinvest--elevatorserviceboxproxy.val.runAUFZUG_API_KEY_<FIRMA>). Hier nur testen.
API-Keys für verwaltung.api.aufzugshandwerk.de. Pro Mandant ein eigener Key – der Key wird im Val.town-Proxy als Env-Variable abgelegt (nicht im Browser).
Beim Sync wählt der Proxy automatisch den passenden Key für die aktive Firma. Falls für eine Firma kein Key gesetzt ist, fällt er auf einen optionalen globalen Key zurück.
💡 Mandanten-ID (Tenant) wird pro Firma in 🏢 Firmen-Verwaltung → Spalte "ERP-Tenant" hinterlegt (z.B. 1, 4).
/api/auftraege?limit=1 ab und zeigt HTTP-Status + Antwort-Body. Damit siehst du sofort, ob Key+Tenant passen.GOOGLE_MAPS_KEY). Hier nur testen.Für das Anlegen von Kunden und Anlagen braucht das ERP eine Google-Place-ID als Adresse. Mit einem Google-API-Key (Geocoding API) findet die App die Place-ID automatisch aus der eingetippten Adresse — inkl. Karten-Vorschau.
Für 📝 Stellungnahmen im Auftrag: Abschrift der 🎤 Aufnahme und Brieftext mit ChatGPT. Der Schlüssel wird beim Speichern bei OpenAI geprüft
und verschlüsselt auf dem Server abgelegt – angezeigt wird er danach nie wieder. Eine Railway-Variable OPENAI_API_KEY hat Vorrang.
Für 🧾 Spesen: In „Tag eintragen“ stehen Beginn und Ende des Tags aus clockin (erster bis letzter Stempel) – ein Tipp auf
„Übernehmen“ füllt Abfahrt und Ankunft. Jeder sieht nur seine eigenen Zeiten; die Person wird über den Namen gefunden (anders zuordnen: Spesen → Alle → ⏱ clockin).
Der Schlüssel wird beim Speichern bei clockin geprüft und verschlüsselt auf dem Server abgelegt – angezeigt wird er danach nie wieder. Eine Railway-Variable CLOCKIN_API_TOKEN hat Vorrang.
Für 📨 Mails → 🔔 Benachrichtigungen: Die Mitteilungen kommen dann auch in Telegram – im Auto zeigt CarPlay
sie an und Siri liest sie vor (CarPlay zeigt keine Web-Apps). Jeder verbindet sich selbst mit einem Tipp; es gelten dieselben Regeln (Gruppen, „Nur Mails von Kunden“).
An Telegram gehen nur Titel, Absender und Betreff. Der Schlüssel wird beim Speichern bei Telegram geprüft und verschlüsselt auf dem Server abgelegt – angezeigt wird er danach nie wieder.
Eine Railway-Variable TELEGRAM_BOT_TOKEN hat Vorrang.
/newbot schicken.bot endet, wählen.123456789:AA…) kopieren und hier einfügen.
Lass den ERP-Sync regelmäßig im Hintergrund auf Val.town laufen – ohne dass die App offen sein muss.
Der Cron-Job ruft /sync/run-all auf und synchronisiert alle aktiven Firmen mit gesetztem ERP-Tenant.
Der Status pro Firma erscheint dann automatisch im Banner der Aufträge-Ansicht.
FRESHDESK_DOMAIN_<FIRMA>, FRESHDESK_API_KEY_<FIRMA>, FRESHDESK_REQUESTER_<FIRMA>). Hier nur testen.
Pro Firma ein eigenes Freshdesk-Konto. Nach jedem neuen Arbeitsbericht wird automatisch ein Ticket erstellt (mit PDF als Anhang).
Domain = der Teil vor .freshdesk.com, API-Key bekommst du in Freshdesk unter Profil → API-Key.
Synchronisiert Kunden-Kontakte aus dem ERP in eine Mailchimp-Audience je Firma. Idempotent (existierende Member werden aktualisiert, neue werden mit Status subscribed angelegt). Felder: FNAME, LNAME, COMPANY, PHONE + Tag mit dem Kundennamen für Segmentierung.
📧 Mailchimp-Key — der API-Key (endet mit Server-Suffix wie -us12)📧 Audience-ID — die List-/Audience-ID aus MailchimpMAILCHIMP_API_KEY_<FIRMA> + MAILCHIMP_AUDIENCE_<FIRMA> in val.town funktionieren weiterhin, sind aber nur nötig wenn man die Keys nicht in Airtable haben will.Liftaro ist eine Vergleichsplattform für Wartungsverträge. Wir agieren als Subunternehmer-Partner und können auf Anfragen Angebote abgeben. Liste offener Anfragen + Submit-Workflow in 📋 Liftaro Checks.
LIFTARO_PARTNER_KEY, aktualisiert automatisch den Proxy-Code und testet die Verbindung.
Legt aus einem bestätigten Auftrag automatisch einen Auftrag im Order Display an (LiteLead-MCP createOrder; Stage und offen/geschlossen wählbar – v10.72). Der Button 🚀 In Order Display anlegen erscheint dann im Auftrag-Detail.
ORDERDISPLAY_TOKEN + ORDERDISPLAY_ACCOUNT_KEY_<FIRMA>, pusht den Proxy-Code und prüft, ob beide angekommen sind.
Lädt alle aktiven Aufträge (Status: Auftrag bestätigt, In Bearbeitung, Abgeschlossen) aus dem ERP der aktuell gewählten Firma in unsere Datenbank. MITANGEBOT-Aufträge bekommen zusätzlich Leistungsumfang + Erläuterungen aus dem Angebot.