Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# QuickBooks integrasi
Dengan konektor QuickBooks aksi, Anda dapat mengakses QuickBooks Online langsung di Amazon Quick melalui bahasa alami. Anda dapat mengelola faktur, pelanggan, vendor, akun, dan menghasilkan laporan keuangan tanpa meninggalkan Amazon Quick.
Amazon Quick mendukung beberapa metode otentikasi untuk QuickBooks. Pilih metode yang paling sesuai dengan persyaratan keamanan organisasi Anda.
+ Aplikasi **OAuth default — Menggunakan aplikasi** OAuth yang AWS dikelola. Tidak diperlukan kredensi tambahan. Pengguna mengautentikasi langsung dengan akun Intuit mereka.
+ Aplikasi **OAuth khusus - Menggunakan aplikasi** yang dikelola pelanggan yang terdaftar di portal Pengembang Intuit. Opsi ini memberi organisasi Anda kontrol penuh atas konfigurasi OAuth.
Untuk informasi selengkapnya tentang metode otentikasi yang didukung Amazon Quick, lihat[Metode autentikasi](quick-action-auth.md).
## Sebelum Anda mulai
Pastikan Anda memiliki yang berikut ini sebelum Anda mengatur integrasi.
+ Akun QuickBooks online aktif dengan akses ke data perusahaan yang ingin Anda gunakan.
+ Untuk **aplikasi OAuth Kustom**: Akses ke [portal Pengembang Intuit](https://developer.intuit.com/) di situs web Intuit untuk membuat aplikasi.
+ Untuk persyaratan berlangganan Amazon Quick, lihat[Siapkan integrasi di konsol](integration-console-setup-process.md).
## Mengkonfigurasi QuickBooks
Jika Anda menggunakan otentikasi **aplikasi OAuth Default**, lewati bagian ini dan lanjutkan ke. [Menyiapkan konektor di Amazon Quick](#quickbooks-quicksuite-setup)
Untuk otentikasi aplikasi OAuth Kustom, selesaikan langkah-langkah berikut di portal Pengembang Intuit sebelum mengonfigurasi Amazon Quick.
### Buat aplikasi Pengembang Intuit (aplikasi OAuth Kustom)
Buat aplikasi di portal Pengembang Intuit untuk mendapatkan kredensi klien yang Anda butuhkan untuk Amazon Quick. Untuk informasi selengkapnya, lihat [OAuth 2.0 di situs web](https://developer.intuit.com/app/developer/qbo/docs/develop/authentication-and-authorization/oauth-2.0) Pengembang Intuit.
1. Masuk ke [portal Pengembang Intuit di situs](https://developer.intuit.com/) web Intuit.
1. Dari ruang kerja Anda, pilih tombol plus (\+) untuk membuat aplikasi baru.
1. Untuk **Jenis**, pilih platform QuickBooks Online.
1. Masukkan **nama Aplikasi** untuk aplikasi Anda.
1. Untuk **Izin**, di bawah **QuickBooks Online dan Pembayaran**, pilih cakupan otorisasi yang diperlukan integrasi Anda. Untuk cakupan yang direkomendasikan, lihat[Cakupan yang direkomendasikan](#quickbooks-oauth-scopes).
1. Selesaikan pembuatan aplikasi. Pada halaman konfirmasi, pilih **Tampilkan kredensial untuk melihat kredensi** pengembangan Anda.
1. Catat nilai-nilai berikut. Anda membutuhkannya saat mengonfigurasi Amazon Quick.
+ **ID Klien**
+ **Rahasia klien**
1. Di pengaturan aplikasi, pilih tab **Redirect URI**. Tambahkan URL callback Cepat Amazon: `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`
1. Pilih **Simpan**.
### Cakupan yang direkomendasikan
Saat Anda membuat aplikasi Pengembang Intuit, pilih cakupan otorisasi berikut berdasarkan tindakan yang ingin Anda gunakan.
**QuickBooks cakupan yang direkomendasikan**
| Lingkup | Deskripsi |
| --- | --- |
| com.intuit.quickbooks.accounting | Mengakses data akuntansi QuickBooks online, termasuk faktur, pelanggan, vendor, akun, dan laporan keuangan. |
| com.intuit.quickbooks.payment | Mengakses data pembayaran QuickBooks online, termasuk pembelian dan transaksi pembayaran. |
| openid | Mengautentikasi identitas pengguna. |
| email | Membaca alamat email pengguna. |
| profile | Membaca informasi profil pengguna. |
| phone | Membaca nomor telepon pengguna. |
| address | Membaca alamat pengguna. |
**catatan**
Cakupan `openid``email`,`profile`,`phone`, dan `address` cakupan digunakan untuk otentikasi pengguna dengan aplikasi Custom OAuth.
## Menyiapkan konektor di Amazon Quick
### Connect dari tab Tersedia
Jika Anda ingin menggunakan otentikasi aplikasi OAuth Default, Anda dapat terhubung langsung dari tab **Tersedia** tanpa konfigurasi tambahan.
1. Di konsol Amazon Quick, pilih **Konektor**.
1. Pada tab **Tersedia**, temukan **QuickBooks**dan pilih **Connect**.
1. QuickBooks Selesaikan alur masuk dan berikan izin yang diminta.
Untuk mengonfigurasi konektor dengan aplikasi Custom OAuth sebagai gantinya, gunakan tab **Buat untuk tim Anda** seperti yang dijelaskan di bawah ini.
### Buat dari tab Buat untuk tim Anda
Setelah Anda menyelesaikan QuickBooks konfigurasi yang diperlukan, buat konektor di Amazon Quick.
1. Di konsol Amazon Quick, pilih **Konektor**.
1. Pilih tab **Buat untuk tim Anda**.
1. Temukan dan pilih **QuickBooks**.
**catatan**
Jika QuickBooks konektor sudah ada, dialog akan muncul dengan konektor yang ada. Untuk menggunakan konektor yang ada, pilihlah. Untuk membuat yang baru, pilih **Tidak, buat yang baru**.
1. Masukkan **Nama** untuk konektor Anda. Secara opsional, pilih **\+ Tambahkan Deskripsi** untuk menambahkan deskripsi.
1. Untuk **jenis Koneksi**, pilih **Jaringan publik**.
1. Untuk **Konfigurasi OAuth**, pilih salah satu metode otentikasi berikut dan konfigurasikan bidang yang diperlukan.
1. Untuk aplikasi **OAuth Default**:
Tidak diperlukan kredensi tambahan. Pilih **Next** untuk melanjutkan.
1. Untuk **aplikasi Custom OAuth**, konfigurasikan bidang berikut:
+ **URL Dasar** (Opsional) - URL dasar QuickBooks API. Contoh: `https://quickbooks.api.intuit.com`
+ **ID Klien — ID** klien dari aplikasi Pengembang Intuit Anda.
+ **Rahasia klien — Rahasia** klien dari aplikasi Pengembang Intuit Anda.
+ **URL Token** — Titik akhir token. Contoh: `https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer`
+ **URL otorisasi** — Titik akhir otorisasi. Contoh: `https://appcenter.intuit.com/connect/oauth2`
+ **Redirect URL** — Pre-filled dengan URL callback Amazon Quick.
1. Pilih **Berikutnya**.
1. Jika Anda memilih aplikasi **OAuth Default atau aplikasi** **Custom OAuth**, jendela otorisasi Intuit akan terbuka. Tinjau izin yang diminta dan pilih **Connect**.
1. Pada halaman **Ulasan**, tinjau tindakan yang tersedia untuk konektor. Pilih **Berikutnya**.
1. Pada halaman **Publikasikan**, pilih siapa yang dapat mengakses konektor. Anda dapat mengaktifkan akses untuk semua orang di organisasi Anda atau mencari tim atau grup tertentu.
1. Pilih **Terbitkan**.
## Tindakan yang tersedia
Setelah Anda mengatur konektor, tindakan berikut tersedia.
**QuickBooks tindakan yang tersedia**
| Kategori | Tindakan | Deskripsi |
| --- | --- | --- |
| Kueri | Entitas Pencarian | Pencarian di seluruh QuickBooks entitas menggunakan kueri. |
| Akun | Dapatkan Detail Akun | Mengambil detail untuk akun tertentu berdasarkan kueri. |
| Akun | Dapatkan Akun | Mengambil akun tertentu dengan ID. |
| Akun | Buat Akun | Membuat akun baru di bagan akun. |
| Faktur | Dapatkan Faktur | Mengambil faktur tertentu berdasarkan ID. |
| Faktur | Daftar Faktur | Daftar faktur dengan penyaringan opsional. |
| Faktur | Buat Faktur | Membuat faktur baru. |
| Pelanggan | Dapatkan Pelanggan | Mengambil pelanggan tertentu dengan ID. |
| Pelanggan | Buat Pelanggan | Membuat catatan pelanggan baru. |
| Vendor | Buat Vendor | Membuat catatan vendor baru. |
| Pembelian | Buat Pembelian | Membuat transaksi pembelian baru. |
| Pembelian | Buat Bill | Membuat tagihan baru dari vendor. |
| Entri jurnal | Buat Entri Jurnal | Membuat entri jurnal baru. |
| Laporan | Dapatkan Laporan Untung Rugi | Menghasilkan laporan laba rugi. |
| Laporan | Dapatkan Laporan Saldo Pelanggan | Menghasilkan laporan ringkasan saldo pelanggan. |
| Laporan | Dapatkan Detail Saldo Pelanggan | Menghasilkan laporan saldo pelanggan terperinci. |
| Laporan | Dapatkan Laporan Saldo Vendor | Menghasilkan laporan ringkasan saldo vendor. |
| Laporan | Dapatkan Detail Saldo Vendor | Menghasilkan laporan saldo vendor terperinci. |
| Laporan | Dapatkan Laporan Buku Besar | Menghasilkan laporan buku besar. |
| Operasi batch | Operasi Eksekusi Batch | Menjalankan beberapa operasi dalam satu permintaan batch. |
| Perusahaan | Dapatkan Info Perusahaan | Mengambil informasi tentang perusahaan yang terhubung. |
**catatan**
Tindakan yang dapat Anda gunakan bergantung pada data perusahaan yang dapat diakses oleh pengguna yang diautentikasi.
## Mengelola dan memecahkan masalah
Untuk mengedit, membagikan, atau menghapus konektor Anda, lihat[Mengelola integrasi yang ada](integration-workflows.md#managing-existing-integrations).
### Masalah otentikasi
+ **Sign-in gagal (Aplikasi OAuth default atau aplikasi Custom OAuth)** - Verifikasi bahwa akun Intuit Anda aktif dan Anda dapat masuk ke [quickbooks.intuit.com](https://quickbooks.intuit.com) di situs web Intuit secara langsung. Untuk aplikasi OAuth Khusus, konfirmasikan bahwa URI pengalihan di aplikasi Pengembang Intuit Anda cocok dengan URL callback Amazon Quick.
+ **Kredensi klien tidak valid (aplikasi OAuth Kustom)** — Verifikasi bahwa ID Klien dan rahasia Klien cocok dengan nilai di aplikasi Pengembang Intuit Anda. Anda dapat melihat kredensialnya dari pengaturan aplikasi di portal Pengembang Intuit.
+ **Izin tidak memadai** — Verifikasi bahwa cakupan yang dikonfigurasi untuk aplikasi Pengembang Intuit Anda menyertakan izin yang diperlukan untuk tindakan yang ingin Anda gunakan. Lihat [Cakupan yang direkomendasikan](#quickbooks-oauth-scopes).