Przejdź do głównej zawartości

Skonfiguruj integrację QuickBooks

Przed rozpoczęciem​

Przed skonfigurowaniem integracji upewnij się, że:

  • Licencja Integracja QuickBooks jest aktywowana.
  • Masz dostęp administratora do aplikacji Syrve.
  • Sklepy, kategorie sprzedaży, kategorie podatkowe oraz typy płatności wymagane do eksportu są skonfigurowane w Syrve.
  • Posiadasz aktywną subskrypcję QuickBooks Online.
  • Masz dostęp administratora do firmy QuickBooks Online, która będzie odbierać dane.
  • Elementy QuickBooks, konta, wartości podatkowe, działy oraz klient wymagani do mapowania są skonfigurowane.
  • Posiadasz konto dewelopera Intuit.

Ta integracja obsługuje wyłącznie QuickBooks Online.

Pobierz dane uwierzytelniające połączenie QuickBooks​

Aby uzyskać Client ID i Client Secret wymagane do połączenia QuickBooks z Syrve:

Każdy klient musi utworzyć własną aplikację w portalu Intuit Developer i użyć jej danych uwierzytelniających produkcyjnych, aby połączyć się z rzeczywistą firmą QuickBooks.

  1. Przejdź do portalu Intuit Developer.
  2. Zaloguj się, używając tego samego konta Intuit, którego używasz do QuickBooks Online. Nie musisz tworzyć osobnego konta.
  3. Otwórz My Hub > App dashboard.
  4. Kliknij Create an app.
  5. Wybierz QuickBooks Online and Payments.
  6. Wprowadź nazwę aplikacji, na przykład Syrve QuickBooks Integration, i utwórz aplikację.
  7. Otwórz utworzoną aplikację.
  8. Otwórz stronę Keys & OAuth dla środowiska, które chcesz połączyć:
    • Production — dla rzeczywistej firmy QuickBooks.
    • Development — dla firmy QuickBooks Sandbox.
  9. Aby połączyć rzeczywistą firmę QuickBooks, ukończ konfigurację aplikacji produkcyjnej oraz wypełnij kwestionariusz zgodności wymagany przez Intuit.
  10. W ustawieniach aplikacji produkcyjnej dodaj następujący URI przekierowania dokładnie tak, jak pokazano:
`https://exchange.syrve.app/api/exchange/oauth2/auth`
  1. Otwórz stronę Keys & OAuth dla produkcji i skopiuj Client ID oraz Client Secret.
Client ID and Client Secret on the Intuit Developer Keys and OAuth page

Te dane uwierzytelniające wprowadzisz w konfiguracji QuickBooks w Syrve. Client Secret z Intuit odpowiada polu Secret key w Syrve.

 

Środowiska Development i Production używają różnych danych uwierzytelniających. Dane Development łączą się z firmą QuickBooks Sandbox. Aby połączyć rzeczywistą firmę, użyj danych Production. Nieprawidłowy lub niekompletny URI przekierowania uniemożliwia autoryzację QuickBooks.

Dodaj konfigurację QuickBooks​

Aby dodać konfigurację:

  1. Na stronie głównej aplikacji Syrve przejdź do Integrations > Data Exchange.

    Data Exchange configurations

  2. Kliknij Add.

  3. Wprowadź nazwę konfiguracji, na przykład QuickBooks.

  4. Wybierz QuickBooks jako typ konfiguracji.

  5. Wybierz sklepy, których dane chcesz eksportować.

  6. W razie potrzeby wprowadź opis.

  7. Utwórz konfigurację.

QuickBooks configuration for Red Lion

Połącz QuickBooks z Syrve​

Aby połączyć konfigurację z QuickBooks Online:

  1. Otwórz utworzoną konfigurację QuickBooks.

  2. Kliknij Edit.

  3. Otwórz zakładkę Connection Settings.

  4. Wybierz środowisko odpowiadające Twoim danym uwierzytelniającym Intuit:

    • Production — dla rzeczywistej firmy QuickBooks.
    • Sandbox — dla testowej firmy QuickBooks.

  5. Wprowadź Client ID oraz Secret key uzyskane z portalu Intuit Developer, jak opisano w Pobierz dane uwierzytelniające połączenie QuickBooks.

  6. Kliknij Connect.

    QuickBooks connection settings

  7. Na stronie Intuit zaloguj się na swoje konto QuickBooks Online.

    Signing in to Intuit

  8. Wybierz firmę QuickBooks, którą chcesz połączyć.

  9. Autoryzuj Syrve do dostępu do danych firmy.

Zostaniesz przekierowany do Syrve. Integracja załaduje elementy QuickBooks, konta, kody podatkowe, działy oraz klientów wymaganych do mapowania.

 

Jedno konto Syrve może być połączone tylko z jedną firmą QuickBooks. Aby połączyć inną firmę, najpierw rozłącz bieżącą.

Wybierz klienta​

QuickBooks wymaga, aby każda faktura była powiązana z klientem. Możesz użyć restauracji jako klienta dla faktur tworzonych przez integrację. W tym celu utwórz klienta w QuickBooks używając nazwy restauracji.

  1. Otwórz zakładkę Global Configurations.
  2. W polu Customer wybierz klienta QuickBooks utworzonego dla restauracji.
Selecting the QuickBooks customer for the restaurant :::info[ ] Jeśli wymagany klient nie jest dostępny na liście, utwórz go w QuickBooks i odśwież dane w Syrve. :::

Ustawienia silnika​

Ustawienia silników eksportu faktur i płatności są w trakcie opracowywania. Zakładka Engine settings obecnie nie zawiera opcji konfiguracyjnych, więc możesz ją pominąć.

Kolejne kroki​

Po połączeniu QuickBooks i wybraniu klienta, mapuj dane Syrve i QuickBooks.