View a markdown version of this page

QuickBooks Integration - Amazon Quick

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

QuickBooks Integration

Mit dem QuickBooks Action-Connector können Sie in natürlicher Sprache direkt in Amazon Quick auf QuickBooks Online zugreifen. Sie können Rechnungen, Kunden, Lieferanten und Konten verwalten und Finanzberichte erstellen, ohne Amazon Quick verlassen zu müssen.

Amazon Quick unterstützt mehrere Authentifizierungsmethoden für QuickBooks. Wählen Sie die Methode, die den Sicherheitsanforderungen Ihres Unternehmens am besten entspricht.

  • Standard-OAuth-Anwendung — Verwendet eine AWS-verwaltete OAuth-Anwendung. Es sind keine zusätzlichen Anmeldeinformationen erforderlich. Benutzer authentifizieren sich direkt mit ihrem Intuit-Konto.

  • Benutzerdefinierte OAuth-App — Verwendet eine vom Kunden verwaltete Anwendung, die im Intuit Developer Portal registriert ist. Diese Option gibt Ihrer Organisation die volle Kontrolle über die OAuth-Konfiguration.

Weitere Informationen zu den von Amazon Quick unterstützten Authentifizierungsmethoden finden Sie unterAuthentifizierungsmethoden.

Bevor Sie beginnen

Stellen Sie sicher, dass Sie über Folgendes verfügen, bevor Sie die Integration einrichten.

Konfiguration QuickBooks

Wenn Sie die standardmäßige OAuth-App-Authentifizierung verwenden, überspringen Sie diesen Abschnitt und fahren Sie fort mit. Den Connector in Amazon Quick einrichten

Führen Sie für die benutzerdefinierte OAuth-App-Authentifizierung die folgenden Schritte im Intuit Developer Portal durch, bevor Sie Amazon Quick konfigurieren.

Erstellen Sie eine Intuit-Entwickler-App (benutzerdefinierte OAuth-App)

Erstellen Sie eine App im Intuit Developer Portal, um die Kundenanmeldedaten zu erhalten, die Sie für Amazon Quick benötigen. Weitere Informationen finden Sie unter OAuth 2.0 auf der Intuit Developer-Website.

  1. Melden Sie sich auf der Intuit-Website beim Intuit-Entwicklerportal an.

  2. Wählen Sie in Ihrem Workspace die Plus-Schaltfläche (+), um eine neue App zu erstellen.

  3. Wähle als Typ die QuickBooks Online-Plattform aus.

  4. Geben Sie einen App-Namen für Ihre Anwendung ein.

  5. Wählen Sie für Berechtigungen unter QuickBooks Online und Zahlungen die Autorisierungsbereiche aus, die für Ihre Integration erforderlich sind. Die empfohlenen Bereiche finden Sie unter. Empfohlene Bereiche

  6. Schließen Sie die App-Erstellung ab. Wählen Sie auf der Bestätigungsseite die Option Anmeldeinformationen anzeigen aus, um Ihre Entwickleranmeldedaten einzusehen.

  7. Notieren Sie sich die folgenden Werte. Sie benötigen sie, wenn Sie Amazon Quick konfigurieren.

    • Kunden-ID

    • Clientschlüssel

  8. Wählen Sie in den App-Einstellungen den Tab Umleitungs-URIs aus. Fügen Sie die Amazon Quick Callback-URL hinzu: https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

  9. Wählen Sie Speichern.

Empfohlene Bereiche

Wenn Sie eine Intuit Developer-App erstellen, wählen Sie je nach den Aktionen, die Sie verwenden möchten, die folgenden Autorisierungsbereiche aus.

QuickBooks empfohlene Bereiche
Scope Description
com.intuit.quickbooks.accounting Greift auf QuickBooks Online-Buchhaltungsdaten zu, einschließlich Rechnungen, Kunden, Lieferanten, Konten und Finanzberichten.
com.intuit.quickbooks.payment Greift auf QuickBooks Online-Zahlungsdaten zu, einschließlich Käufen und Zahlungsvorgängen.
openid Authentifiziert die Identität des Benutzers.
email Liest die E-Mail-Adresse des Benutzers.
profile Liest die Profilinformationen des Benutzers.
phone Liest die Telefonnummer des Benutzers.
address Liest die Adresse des Benutzers.
Anmerkung

Die address Bereiche openidemail, profilephone, und werden für die Benutzerauthentifizierung mit der benutzerdefinierten OAuth-App verwendet.

Den Connector in Amazon Quick einrichten

Über den Tab „Verfügbar“ eine Connect

Wenn Sie die standardmäßige OAuth-App-Authentifizierung verwenden möchten, können Sie ohne zusätzliche Konfiguration direkt über die Registerkarte Verfügbar eine Verbindung herstellen.

  1. Wählen Sie in der Amazon Quick-Konsole Connectors aus.

  2. Suchen QuickBooksund wählen Sie auf der Registerkarte Verfügbar Connect aus.

  3. Schließen Sie den QuickBooks Anmeldevorgang ab und gewähren Sie die angeforderten Berechtigungen.

Um stattdessen einen Connector mit der benutzerdefinierten OAuth-App zu konfigurieren, verwenden Sie den Tab „Für Ihr Team erstellen“ wie unten beschrieben.

Erstellen Sie auf der Registerkarte „Für Ihr Team erstellen“

Nachdem Sie alle erforderlichen QuickBooks Konfigurationen abgeschlossen haben, erstellen Sie den Connector in Amazon Quick.

  1. Wählen Sie in der Amazon Quick-Konsole Connectors aus.

  2. Wählen Sie den Tab „Für Ihr Team erstellen“.

  3. Finde und wähle QuickBooks.

    Anmerkung

    Wenn bereits ein QuickBooks Konnektor vorhanden ist, wird ein Dialogfeld mit Ihren vorhandenen Konnektoren angezeigt. Um einen vorhandenen Konnektor zu verwenden, wählen Sie ihn aus. Um einen neuen zu erstellen, wählen Sie Nein, neu erstellen.

  4. Geben Sie einen Namen für Ihren Connector ein. Wählen Sie optional + Beschreibung hinzufügen, um eine Beschreibung hinzuzufügen.

  5. Wählen Sie als Verbindungstyp die Option Öffentliches Netzwerk aus.

  6. Wählen Sie für die OAuth-Konfiguration eine der folgenden Authentifizierungsmethoden und konfigurieren Sie die erforderlichen Felder.

    1. Für die Standard-OAuth-App:

      Es sind keine zusätzlichen Anmeldeinformationen erforderlich. Wählen Sie Next (Weiter), um fortzufahren.

    2. Konfigurieren Sie für die benutzerdefinierte OAuth-App die folgenden Felder:

      • Basis-URL (optional) — Die QuickBooks API-Basis-URL. Beispiel: https://quickbooks.api.intuit.com

      • Client-ID — Die Client-ID aus Ihrer Intuit Developer-App.

      • Geheimer Client-Schlüssel — Der geheime Client-Schlüssel aus Ihrer Intuit Developer-App.

      • Token-URL — Der Token-Endpunkt. Beispiel: https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer

      • Autorisierungs-URL — Der Autorisierungsendpunkt. Beispiel: https://appcenter.intuit.com/connect/oauth2

      • Weiterleitungs-URL — Pre-filled mit der Amazon Quick Callback-URL.

  7. Wählen Sie Weiter aus.

  8. Wenn Sie die Standard-OAuth-App oder die benutzerdefinierte OAuth-App ausgewählt haben, wird ein Intuit-Autorisierungsfenster geöffnet. Überprüfen Sie die angeforderten Berechtigungen und wählen Sie Connect.

  9. Überprüfen Sie auf der Seite Überprüfen die verfügbaren Aktionen für den Connector. Wählen Sie Weiter aus.

  10. Wählen Sie auf der Seite Veröffentlichen aus, wer auf den Connector zugreifen kann. Sie können den Zugriff für alle in Ihrer Organisation aktivieren oder nach bestimmten Teams oder Gruppen suchen.

  11. Wählen Sie Publish.

Verfügbare Aktionen

Nachdem Sie den Connector eingerichtet haben, sind die folgenden Aktionen verfügbar.

QuickBooks verfügbare Aktionen
Kategorie Action Description
Abfragen Entitäten durchsuchen Sucht mithilfe einer Abfrage QuickBooks entitätsübergreifend.
Konten Kontodetails abrufen Ruft Details für ein bestimmtes Konto per Abfrage ab.
Konten Konto abrufen Ruft ein bestimmtes Konto anhand der ID ab.
Konten Konto erstellen Erstellt ein neues Konto im Kontenplan.
Rechnungen Rechnung abrufen Ruft eine bestimmte Rechnung anhand der ID ab.
Rechnungen Rechnungen auflisten Listet Rechnungen mit optionaler Filterung auf.
Rechnungen Rechnung erstellen Erstellt eine neue Rechnung.
Kunden Kunde werden Ruft einen bestimmten Kunden anhand der ID ab.
Kunden Kunde erstellen Erstellt einen neuen Kundendatensatz.
Anbieter Anbieter erstellen Erstellt einen neuen Lieferantendatensatz.
Purchases (Käufe) Kauf erstellen Erstellt eine neue Kauftransaktion.
Purchases (Käufe) Rechnung erstellen Erstellt eine neue Rechnung von einem Lieferanten.
Journaleinträge Journaleintrag erstellen Erstellt einen neuen Journaleintrag.
Berichte Gewinn- und Verlustbericht abrufen Generiert einen Gewinn- und Verlustbericht.
Berichte Holen Sie sich den Kundenbilanzbericht Generiert einen zusammenfassenden Bericht über die Kundenbilanz.
Berichte Details zum Kundenguthaben abrufen Generiert einen detaillierten Kundenbilanzbericht.
Berichte Holen Sie sich den Saldenbericht für Lieferanten Generiert einen zusammenfassenden Bericht über die Lieferantenbilanz.
Berichte Einzelheiten zum Lieferantensaldo abrufen Generiert einen detaillierten Saldenbericht für Lieferanten.
Berichte Holen Sie sich den Hauptbuchbericht Generiert einen Hauptbuchbericht.
Batch-Vorgänge Vorgang Batch ausführen Führt mehrere Operationen in einer einzigen Batch-Anfrage aus.
Unternehmen Unternehmensinformationen abrufen Ruft Informationen über das verbundene Unternehmen ab.
Anmerkung

Die Aktionen, die Sie verwenden können, hängen von den Unternehmensdaten ab, auf die der authentifizierte Benutzer zugreifen kann.

Verwaltung und Problembehandlung

Informationen zum Bearbeiten, Teilen oder Löschen Ihres Connectors finden Sie unterVerwaltung vorhandener Integrationen.

Probleme bei der Authentifizierung

  • Sign-in schlägt fehl (Standard-OAuth-App oder benutzerdefinierte OAuth-App) — Stellen Sie sicher, dass Ihr Intuit-Konto aktiv ist und dass Sie sich direkt auf der Intuit-Website bei quickbooks.intuit.com anmelden können. Stellen Sie für die benutzerdefinierte OAuth-App sicher, dass die Umleitungs-URI in Ihrer Intuit Developer-App mit der Amazon Quick Callback-URL übereinstimmt.

  • Ungültige Kundenanmeldedaten (benutzerdefinierte OAuth-App) — Stellen Sie sicher, dass die Client-ID und der geheime Client-Schlüssel mit den Werten in Ihrer Intuit Developer-App übereinstimmen. Sie können Ihre Anmeldeinformationen in den App-Einstellungen im Intuit-Entwicklerportal einsehen.

  • Unzureichende Berechtigungen — Stellen Sie sicher, dass die für Ihre Intuit Developer-App konfigurierten Bereiche die Berechtigungen enthalten, die für die Aktionen erforderlich sind, die Sie verwenden möchten. Siehe Empfohlene Bereiche.