AppFolio — Arbeitsaufträge & Wartung
Übersicht
Verwalten Sie den vollständigen Lebenszyklus von Wartungsarbeitsaufträgen über die AppFolio Stack API.
Nutzen Sie diesen Workflow, wenn Mieter Wartungsanfragen einreichen, wenn Sie offenen Arbeitsaufträgen Dienstleister zuweisen müssen, den Reparaturfortschritt über verschiedene Liegenschaften hinweg verfolgen oder abgeschlossene Aufträge mit Kostenaufzeichnungen abschließen möchten. Dies ist der sekundäre Workflow – für Liegenschafts-Dashboards und Vermietung siehe appfolio-core-workflow-a.
Voraussetzungen
- Ein verifizierter AppFolio-Vertrag und ein Sandbox-Portfolio mit synthetischen Liegenschafts-, Einheiten-, Dienstleister- und Arbeitsauftragsdatensätzen; testen Sie die Wartungsautomatisierung nicht gegen eine belegte Produktionseinheit.
- Eine Service-Identität mit minimalen Berechtigungen, Idempotenz-Unterstützung für Erstellungs-/Abschlussaktionen und ein genehmigter Eskalationspfad für sicherheitskritische Wartungsarbeiten.
- Eine Datenminimierungsrichtlinie: Speichern und übertragen Sie nur die Wartungsdaten, die zur Durchführung der Arbeiten erforderlich sind, niemals Mieterpräferenzen, Zugangscodes oder detaillierte Belegungsinformationen in allgemeinen Dienstleister-Notizen oder Protokollen.
Anleitung
Schritt 1: Erstellen eines Arbeitsauftrags aus einer Wartungsanfrage
const workOrder = await client.workOrders.create({
property_id: 'prop_4821',
unit_id: 'unit_12B',
category: 'plumbing',
priority: 'high',
description: 'Synthetic plumbing fixture leak reported in sandbox unit',
requested_by: 'tenant_8934',
due_date: '2026-04-10',
});
console.log(`Work order ${workOrder.id} created — status: ${workOrder.status}`);
Schritt 2: Einen Dienstleister zuweisen
const assignment = await client.workOrders.assign(workOrder.id, {
vendor_id: 'vendor_plumb_01',
scheduled_date: '2026-04-08',
time_window: '09:00-12:00',
notes: 'Confirm scheduled appointment through the approved work-order channel.',
});
console.log(`Assigned to ${assignment.vendor_name} on ${assignment.scheduled_date}`);
Schritt 3: Status des Arbeitsauftrags verfolgen
const open = await client.workOrders.list({
property_id: 'prop_4821',
status: ['open', 'in_progress', 'scheduled'],
sort: 'priority_desc',
});
open.items.forEach(wo =>
console.log(`#${wo.id} [${wo.priority}] ${wo.category} — ${wo.status} (due ${wo.due_date})`)
);
Schritt 4: Arbeitsauftrag mit Kostenaufzeichnung abschließen
const closed = await client.workOrders.close(workOrder.id, {
resolution: 'Replaced P-trap and tightened supply line. No further leaks.',
labor_cost: 175.00,
materials_cost: 42.50,
completed_date: '2026-04-08',
attachments: ['receipt_plumb_0408.pdf'],
});
console.log(`Closed #${closed.id} — total cost: $${closed.total_cost}`);
Fehlerbehandlung
| Problem | Ursache | Behebung |
|---|---|---|
401 Unauthorized | Abgelaufene oder ungültige API-Anmeldedaten | client_id/secret im Stack-Dashboard aktualisieren |
404 Work Order Not Found | Falsche Arbeitsauftrags-ID oder bereits gelöscht | ID mit workOrders.list() überprüfen |
422 Missing required fields | Kategorie oder property_id fehlt | Alle erforderlichen Felder gemäß Schema angeben |
409 Conflict | Arbeitsauftrag bereits abgeschlossen | Status vor dem Abschlussversuch prüfen |
429 Rate Limited | Maximal 120 Anfragen/Minute überschritten | Exponentielles Backoff mit 1s Basisverzögerung einbauen |
Ausgabe
Ein erfolgreicher Durchlauf erstellt einen Arbeitsauftrag, weist ihn einem Dienstleister mit einem geplanten Service-Fenster zu und schließt ihn mit Kostenaufzeichnungen und Lösungsnotizen ab. Der Hausverwalter erhält einen vollständigen Prüfpfad von der Anfrage bis zum Abschluss.
Beispiele
Für einen Sandbox-Sanitär-Workflow erstellen Sie einen synthetischen Arbeitsauftrag mit einem stabilen Idempotenz-Schlüssel, weisen einen Sandbox-Dienstleister zu und lesen seinen Status vor jedem Übergang zurück. Fügen Sie nur einen nicht sensitiven Testbeleg an, schließen Sie den Auftrag dann einmal ab und überprüfen Sie die Gesamtsumme und den Prüfdatensatz, ohne Mieter- oder Zugangsdetails zu protokollieren. Wiederholen Sie dieselbe Anfrage, um zu beweisen, dass doppelte Arbeitsaufträge und doppelte Kostenaufzeichnungen abgelehnt werden. Wenn die Dienstleisterzuweisung, die Sicherheitsklassifizierung, der vorherige Zustand oder das Abschlussergebnis unsicher sind, lassen Sie den Auftrag offen und leiten Sie ihn an den autorisierten Liegenschaftsbetreiber zur Überprüfung weiter.
Ressourcen
Nächste Schritte
Siehe appfolio-sdk-patterns für Authentifizierungseinrichtung und Paginierungs-Hilfen.