기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# QuickBooks 통합
QuickBooks 작업 커넥터를 사용하면 자연어를 통해 Amazon Quick에서 직접 QuickBooks Online에 액세스할 수 있습니다. Amazon Quick을 벗어나지 않고도 인보이스, 고객, 공급업체, 계정을 관리하고 재무 보고서를 생성할 수 있습니다.
Amazon Quick은 QuickBooks에 대한 여러 인증 방법을 지원합니다. 조직의 보안 요구 사항에 가장 적합한 방법을 선택합니다.
+ **기본 OAuth 앱** AWS- 관리형 OAuth 애플리케이션을 사용합니다. 추가 자격 증명은 필요하지 않습니다. 사용자는 Intuit 계정으로 직접 인증합니다.
+ **사용자 지정 OAuth 앱** - Intuit 개발자 포털에 등록된 고객 관리형 애플리케이션을 사용합니다. 이 옵션을 사용하면 조직에서 OAuth 구성을 완전히 제어할 수 있습니다.
Amazon Quick에서 지원하는 인증 방법에 대한 자세한 내용은 섹션을 참조하세요[인증 방법](quick-action-auth.md).
## 시작하기 전 준비 사항
통합을 설정하기 전에 다음 사항이 있는지 확인합니다.
+ 사용하려는 회사 데이터에 액세스할 수 있는 활성 QuickBooks Online 계정입니다.
+ **사용자 지정 OAuth 앱**의 경우: [Intuit 웹 사이트의 Intuit 개발자 포털](https://developer.intuit.com/)에 액세스하여 앱을 생성합니다.
+ Amazon Quick 구독 요구 사항은 섹션을 참조하세요[콘솔에서 통합 설정](integration-console-setup-process.md).
## QuickBooks 구성
**기본 OAuth 앱** 인증을 사용하는 경우이 섹션을 건너뛰고 로 이동합니다[Amazon Quick에서 커넥터 설정](#quickbooks-quicksuite-setup).
사용자 지정 OAuth 앱 인증의 경우 Amazon Quick을 구성하기 전에 Intuit 개발자 포털에서 다음 단계를 완료합니다.
### Intuit Developer 앱 생성(사용자 지정 OAuth 앱)
Intuit Developer 포털에서 앱을 생성하여 Amazon Quick에 필요한 클라이언트 자격 증명을 가져옵니다. 자세한 내용은 Intuit 개발자 웹 사이트의 [OAuth 2.0](https://developer.intuit.com/app/developer/qbo/docs/develop/authentication-and-authorization/oauth-2.0)을 참조하세요.
1. [Intuit 웹 사이트에서 Intuit 개발자 포털](https://developer.intuit.com/)에 로그인합니다.
1. 워크스페이스에서 더하기(\+) 버튼을 선택하여 새 앱을 생성합니다.
1. **유형**에서 QuickBooks Online 플랫폼을 선택합니다.
1. 애플리케이션의 **앱 이름을** 입력합니다.
1. **권한의** **QuickBooks Online 및 Payments**에서 통합에 필요한 권한 부여 범위를 선택합니다. 권장 범위는 섹션을 참조하세요[권장 범위](#quickbooks-oauth-scopes).
1. 앱 생성을 완료합니다. 확인 페이지에서 자격 **증명 표시를** 선택하여 개발 자격 증명을 확인합니다.
1. 다음 값을 기록합니다. Amazon Quick을 구성할 때 필요합니다.
+ **클라이언트 ID**
+ **클라이언트 보안 암호(client secret)**
1. 앱 설정에서 ** URIs 리디렉션** 탭을 선택합니다. Amazon Quick 콜백 URL을 추가합니다. `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`
1. **저장**을 선택합니다.
### 권장 범위
Intuit Developer 앱을 생성할 때 사용하려는 작업에 따라 다음 권한 부여 범위를 선택합니다.
**QuickBooks 권장 범위**
| Scope | 설명 |
| --- | --- |
| com.intuit.quickbooks.accounting | 인보이스, 고객, 공급업체, 계정 및 재무 보고서를 포함한 QuickBooks Online 회계 데이터에 액세스합니다. |
| com.intuit.quickbooks.payment | 구매 및 결제 거래를 포함한 QuickBooks Online 결제 데이터에 액세스합니다. |
| openid | 사용자의 자격 증명을 인증합니다. |
| email | 사용자의 이메일 주소를 읽습니다. |
| profile | 사용자의 프로필 정보를 읽습니다. |
| phone | 사용자의 전화번호를 읽습니다. |
| address | 사용자의 주소를 읽습니다. |
**참고**
`openid`, `email`, `profile``phone`, 및 `address` 범위는 사용자 지정 OAuth 앱을 사용한 사용자 인증에 사용됩니다.
## Amazon Quick에서 커넥터 설정
### 사용 가능 탭에서 연결
기본 OAuth 앱 인증을 사용하려면 추가 구성 없이 **사용 가능** 탭에서 직접 연결할 수 있습니다.
1. Amazon Quick 콘솔에서 **커넥터를** 선택합니다.
1. **사용 가능** 탭에서 **QuickBooks**를 찾아 **연결을** 선택합니다.
1. QuickBooks 로그인 흐름을 완료하고 요청된 권한을 부여합니다.
대신 사용자 지정 OAuth 앱으로 커넥터를 구성하려면 아래 설명과 같이 **팀에 대해 생성** 탭을 사용합니다.
### 팀에 대해 생성 탭에서 생성
필요한 QuickBooks 구성을 완료한 후 Amazon Quick에서 커넥터를 생성합니다.
1. Amazon Quick 콘솔에서 **커넥터를** 선택합니다.
1. **팀에 대해 생성** 탭을 선택합니다.
1. **QuickBooks** 찾아 선택합니다.
**참고**
QuickBooks 커넥터가 이미 있는 경우 기존 커넥터와 함께 대화 상자가 나타납니다. 기존 커넥터를 사용하려면 선택합니다. 새로 생성하려면 **아니요, 새로 생성을** 선택합니다.
1. 커넥터의 **이름을** 입력합니다. 선택적으로 **\+ 설명 추가**를 선택하여 설명을 추가합니다.
1. **연결 유형**에서 **퍼블릭 네트워크를** 선택합니다.
1. **OAuth 구성**에서 다음 인증 방법 중 하나를 선택하고 필수 필드를 구성합니다.
1. **기본 OAuth 앱**의 경우:
추가 자격 증명은 필요하지 않습니다. **다음**을 선택하여 계속 진행합니다.
1. **사용자 지정 OAuth 앱**의 경우 다음 필드를 구성합니다.
+ **기본 URL**(선택 사항) - QuickBooks API 기본 URL입니다. 예시: `https://quickbooks.api.intuit.com`
+ **클라이언트 ID** - Intuit Developer 앱의 클라이언트 ID입니다.
+ **클라이언트 보안 암호** - Intuit Developer 앱의 클라이언트 보안 암호입니다.
+ **토큰 URL** - 토큰 엔드포인트입니다. 예시: `https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer`
+ **권한 부여 URL** - 권한 부여 엔드포인트입니다. 예시: `https://appcenter.intuit.com/connect/oauth2`
+ **리디렉션 URL** - Amazon Quick 콜백 URL로 미리 채워집니다.
1. **다음**을 선택합니다.
1. **기본 OAuth 앱** 또는 **사용자 지정 OAuth 앱을** 선택한 경우 Intuit 권한 부여 창이 열립니다. 요청된 권한을 검토하고 **연결을** 선택합니다.
1. **검토** 페이지에서 커넥터에 사용할 수 있는 작업을 검토합니다. **다음**을 선택합니다.
1. **게시** 페이지에서 커넥터에 액세스할 수 있는 사용자를 선택합니다. 조직의 모든 사람에 대해 액세스를 활성화하거나 특정 팀 또는 그룹을 검색할 수 있습니다.
1. **게시**를 선택합니다.
## 사용 가능한 작업
커넥터를 설정한 후 다음 작업을 사용할 수 있습니다.
**QuickBooks 사용 가능한 작업**
| 카테고리 | 작업 | 설명 |
| --- | --- | --- |
| 쿼리 | 개체 검색 | 쿼리를 사용하여 QuickBooks 엔터티를 검색합니다. |
| 계정 | 계정 세부 정보 가져오기 | 쿼리를 통해 특정 계정에 대한 세부 정보를 검색합니다. |
| 계정 | 계정 가져오기 | ID별로 특정 계정을 검색합니다. |
| 계정 | 계정 생성 | 계정 차트에 새 계정을 생성합니다. |
| 인보이스 | 인보이스 가져오기 | ID별로 특정 인보이스를 검색합니다. |
| 인보이스 | 인보이스 나열 | 선택적 필터링이 포함된 인보이스를 나열합니다. |
| 인보이스 | 인보이스 생성 | 새 인보이스를 생성합니다. |
| Customers | 고객 가져오기 | ID로 특정 고객을 검색합니다. |
| Customers | 고객 생성 | 새 고객 레코드를 생성합니다. |
| Vendors | 공급업체 생성 | 새 공급업체 레코드를 생성합니다. |
| 구매 횟수 | 구매 생성 | 새 구매 트랜잭션을 생성합니다. |
| 구매 횟수 | 청구서 생성 | 공급업체로부터 새 청구서를 생성합니다. |
| 저널 항목 | 저널 항목 생성 | 새 저널 항목을 생성합니다. |
| Reports | 손익 보고서 가져오기 | 손익 보고서를 생성합니다. |
| Reports | 고객 잔액 보고서 가져오기 | 고객 잔액 요약 보고서를 생성합니다. |
| Reports | 고객 잔액 세부 정보 가져오기 | 자세한 고객 잔액 보고서를 생성합니다. |
| Reports | 공급업체 잔액 보고서 가져오기 | 공급업체 잔액 요약 보고서를 생성합니다. |
| Reports | 공급업체 잔액 세부 정보 가져오기 | 자세한 공급업체 잔액 보고서를 생성합니다. |
| Reports | 총계정원장 보고서 가져오기 | 일반 원장 보고서를 생성합니다. |
| 배치 작업 | 배치 실행 작업 | 단일 배치 요청에서 여러 작업을 실행합니다. |
| Company | 회사 정보 가져오기 | 연결된 회사에 대한 정보를 검색합니다. |
**참고**
사용할 수 있는 작업은 인증된 사용자가 액세스할 수 있는 회사 데이터에 따라 다릅니다.
## 관리 및 문제 해결
커넥터를 편집, 공유 또는 삭제하려면 섹션을 참조하세요[기존 통합 관리](integration-workflows.md#managing-existing-integrations).
### 인증 문제
+ **로그인 실패(기본 OAuth 앱 또는 사용자 지정 OAuth 앱)** - Intuit 계정이 활성 상태이고 Intuit 웹 사이트에서 [quickbooks.intuit.com](https://quickbooks.intuit.com) 직접 로그인할 수 있는지 확인합니다. 사용자 지정 OAuth 앱의 경우 Intuit Developer 앱의 리디렉션 URI가 Amazon Quick 콜백 URL과 일치하는지 확인합니다.
+ **잘못된 클라이언트 자격 증명(사용자 지정 OAuth 앱)** - 클라이언트 ID와 클라이언트 보안 암호가 Intuit Developer 앱의 값과 일치하는지 확인합니다. Intuit 개발자 포털의 앱 설정에서 자격 증명을 볼 수 있습니다.
+ **권한 부족 **- Intuit Developer 앱에 대해 구성된 범위에 사용하려는 작업에 필요한 권한이 포함되어 있는지 확인합니다. [권장 범위](#quickbooks-oauth-scopes)을(를) 참조하세요.