Integrationen im Rechnungswesen

Verbinden Sie StockCraft direkt mit Ihrer Buchhaltungsplattform und steigern Sie Umsatz, Ausgaben und Kosten von Waren automatisch. Verfügbar im Plus-Plan (5 USD/Monat).

Unterstützte Anbieter

Einen Anbieter verbinden

Jeder Anbieter verwendet den branchenüblichen OAuth 2.0-Autorisierungsablauf. Sie geben niemals Ihr Buchhaltungskennwort weiter mit StockCraft — stattdessen erteilen Sie die Erlaubnis direkt über die Anmeldeseite des Anbieters.

Schritt für Schritt: Xero verbinden

1. Navigate to Finances → API Connections in StockCraft
2. Find the Xero card and click "Connect"
3. Sie werden zur Anmeldeseite von Xero weitergeleitet — melden Sie sich mit Ihren Xero-Anmeldeinformationen an
4. Erteilen Sie StockCraft die Erlaubnis, auf Ihre Xero-Organisation zuzugreifen
5. Xero leitet dich zurück zu StockCraft — die Verbindung ist jetzt aktiv

Schritt für Schritt: Verbinden Sie QuickBooks Online

1. Navigate to Finances → API Connections in StockCraft
2. Find the QuickBooks Online card and click "Connect"
3. Sie werden zur Anmeldeseite von Intuit weitergeleitet — melden Sie sich mit Ihren QuickBooks-Anmeldeinformationen an
4. Wählen Sie das Unternehmen aus, mit dem Sie eine Verbindung herstellen möchten, und gewähren Sie Zugriff
5. QuickBooks leitet Sie zurück zu StockCraft — die Verbindung ist jetzt aktiv

Schritt für Schritt: MYOB Business verbinden

1. Navigate to Finances → API Connections in StockCraft
2. Find the MYOB Business card and click "Connect"
3. Sie werden zur Anmeldeseite von MYOB weitergeleitet — melden Sie sich mit Ihren MYOB-Anmeldeinformationen an
4. Erteilen Sie StockCraft die Erlaubnis, auf Ihre MYOB-Unternehmensdateien zuzugreifen
5. Wenn Sie mehrere Unternehmensdateien haben, wählen Sie aus, mit welcher Datei synchronisiert werden soll
6. MYOB leitet dich zurück zu StockCraft weiter — die Verbindung ist jetzt aktiv

Konfiguration des Synchronisierungsdatumsbereichs

Bevor Sie eine Synchronisierung auslösen, konfigurieren Sie, wie weit StockCraft Finanzdaten zurückschieben soll. Dadurch wird eine Duplizierung verhindert historische Aufzeichnungen, die bereits in Ihrer Buchhaltungssoftware vorhanden sind.

1. On the connected provider card, locate the Sync Date Range section
2. Set a Start Date — only transactions on or after this date will be pushed
3. Optionally set an End Date — if left empty, StockCraft syncs up to the current date
4. Click "Save" to apply the date range

Manuelles Synchronisieren auslösen

Synchronisierungen werden manuell ausgelöst — Sie steuern, wann Daten auf Ihre Buchhaltungsplattform übertragen werden.

1. Navigate to Finances → API Connections
2. On the connected provider card, click "Sync Now"
3. StockCraft stellt den Sync-Job in die Warteschlange und zeigt eine Bestätigung an
4. Die Synchronisation läuft im Hintergrund — abgeschlossene Bestellungen und Ausgaben innerhalb Ihres konfigurierten Datumsbereichs werden übertragen zum Anbieter
5. Sobald der Vorgang abgeschlossen ist, werden der Synchronisierungsstatus und die Anzahl der Datensätze auf der Anbieterkarte angezeigt

Was wird gepusht

• Sales Revenue: Completed StockCraft orders are pushed as sales invoices (or equivalent) to your accounting platform
• Expenses & Cost of Goods: Material purchase expenses are pushed as bills or purchase entries

Teilweise Ausfälle

If some records fail to push (for example, due to a provider API error), StockCraft continues pushing the remaining records. The sync result will show as Partial Failure with a count of failed records and an error summary.

Synchronisierungsverlauf lesen

Jeder verbundene Anbieter zeigt die 20 letzten Synchronisierungsversuche an, wobei die neuesten zuerst sortiert werden. Jeder Synchronisierungsdatensatz beinhaltet:

• Provider: Which accounting platform was synced
• Started / Completed: Timestamps for the sync run
• Records Succeeded: Number of transactions successfully pushed
• Records Failed: Number of transactions that failed to push
• Status: Overall outcome — Success, Partial Failure, or Failed
• Error Summary: Human-readable description when issues occur

Problembehandlung bei der erneuten Autorisierung

Gelegentlich kann eine Verbindung eine erneute Autorisierung erfordern. Das passiert, wenn:

• Der Anbieter widerruft Ihr Aktualisierungstoken oder läuft ab
• Sie ändern Ihr Passwort auf der Buchhaltungsplattform
• Die Sicherheitsrichtlinien des Anbieters erfordern eine regelmäßige erneute Zustimmung
• Die Token-Entschlüsselung schlägt fehl (selten — weist auf ein Datenintegritätsproblem hin)

So autorisieren Sie erneut

1. Navigate to Finances → API Connections
2. The affected provider card will show a "Requires Re-authorisation" status badge
3. Click the "Re-connect" button
4. Schließen Sie den OAuth-Ablauf erneut ab (melden Sie sich beim Anbieter an und gewähren Sie Zugriff)
5. Sobald die Verbindung wiederhergestellt ist, werden die Synchronisationen normal fortgesetzt

MYOB Re-Autorisierung

Für MYOB-Verbindungen muss die erneute Autorisierung von einem Benutzer mit MYOB-Administratorzugriff abgeschlossen werden. Wenn du Wenn Sie eine Aufforderung zur erneuten Autorisierung sehen, stellen Sie sicher, dass der richtige MYOB-Administrator-Benutzer den Anmeldeschritt abgeschlossen hat.

Häufig auftretende Probleme

Symptom	Wahrscheinliche Ursache	Lösung
Das Logo „Erfordert eine erneute Autorisierung“ wird angezeigt	Aktualisierungstoken ist abgelaufen oder gesperrt	Klicken Sie auf „Erneut verbinden“ und schließen Sie den OAuth-Ablauf ab
Die Synchronisierung schlägt mit dem Fehler 409 fehl	Eine Synchronisierung ist bereits im Gange	Warten Sie, bis die aktuelle Synchronisierung abgeschlossen ist, und versuchen Sie es erneut
Teilweiser Ausfall mit einigen Datensätzen fehlgeschlagen	Die Provider-API hat einzelne Datensätze abgelehnt	Einzelheiten finden Sie in der Fehlerzusammenfassung; korrigieren Sie die Daten und synchronisieren Sie sie erneut
Verbindung kann nicht hergestellt werden — 403-Fehler	Konto befindet sich im kostenlosen Kontingent	Führen Sie ein Upgrade auf Plus durch, um auf Buchhaltungsintegrationen zuzugreifen
Sync zeigt 0 gepushte Datensätze	Keine Transaktionen im konfigurierten Datumsbereich	Passen Sie das Start-/Enddatum der Synchronisierung an den gewünschten Zeitraum an

Einen Anbieter trennen

Um eine Verbindung zu entfernen:

1. Navigate to Finances → API Connections
2. On the connected provider card, click "Disconnect"
3. Bestätigen Sie die Trennung im Dialog
4. StockCraft widerruft das OAuth-Token beim Anbieter (sofern unterstützt) und entfernt die Verbindung

Sicherheit

• OAuth-Token werden im Ruhezustand mithilfe der KMS-Umschlagverschlüsselung verschlüsselt
• Tokens werden niemals in der Benutzeroberfläche angezeigt — nur ein maskierter Indikator bestätigt, dass ein Token konfiguriert ist
• Der OAuth-Callback verwendet eine branchenübliche Zustandsparametervalidierung, um CSRF-Angriffe zu verhindern
• Xero-Verbindungen verwenden PKCE für zusätzliche Sicherheit während des Autorisierungsablaufs
• Die gesamte API-Kommunikation mit Anbietern verwendet HTTPS

Unterstützung

Benötigen Sie Hilfe bei Buchhaltungsintegrationen?

• Email: support@stockcraft.org
• Geben Sie Ihre Mieter-ID und den betroffenen Anbieter an, wenn Sie Probleme melden
• Nutzer des Plus-Tarifs erhalten innerhalb von 24 Stunden vorrangige Antworten