회계 플랫폼인 QuickBooks에 앱을 연결하여 고객, 청구서, 청구, 결제, 계정, 회사 데이터를 다루는 앱을 만듭니다.
앱을 QuickBooks에 연결하기
회계 플랫폼인 QuickBooks에 앱을 연결하여 고객, 청구서, 청구, 결제, 계정, 회사 데이터를 다루는 앱을 만드세요.
QuickBooks는 회사 재무, 고객, 청구서, 청구, 결제, 장부 워크플로를 관리하는 회계 플랫폼입니다. QuickBooks connector를 사용하면 Lovable 앱이 연결된 Intuit 계정을 통해 QuickBooks Online 회계 데이터를 다룰 수 있습니다.
QuickBooks를 연결하면 앱은 다음 작업이 가능합니다.
- 고객, 공급업체, 항목, 계정, 회사 정보 조회
- 청구서, 청구, 결제, 구매, 판매 영수증 읽기
- 회계 대시보드 및 운영 재무 리포트 생성
- QuickBooks 레코드를 생성하거나 업데이트하는 워크플로 구축
QuickBooks connector는 OAuth를 통해 단일 QuickBooks Online 회사에 연결됩니다. 재무 대시보드, 청구서 워크플로, 고객 계정 도구, 결제 추적, QuickBooks Online 회계 데이터가 필요한 내부 운영 앱에 적합합니다.
주요 활용 사례 및 예시 앱
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| 재무 대시보드 | Use QuickBooks and build a dashboard that shows revenue, open invoices, overdue balances, and recent payments. | QuickBooks의 핵심 회계 지표를 한 화면에서 추적합니다. 앱이 청구서, 결제, 고객, 계정 데이터를 읽어 내부 팀을 위한 재무 추세를 표시합니다. |
| 청구서 추적기 | Use QuickBooks and build an invoice tracker that lists sent, paid, and overdue invoices by customer. | 팀에 청구서 상태를 집중적으로 보여줍니다. 앱이 QuickBooks 청구서를 조회해 상태별로 분류하고 후속 조치가 필요한 계정을 강조합니다. |
| 고객 청구 포털 | Use QuickBooks and build a customer billing portal where staff can search customers and view their invoice history. | QuickBooks 고객·청구서 데이터에 더 쉽게 접근하게 합니다. 권한이 있는 팀원이 고객 레코드를 검색하고 잔액을 검토하며 청구서 세부 정보를 확인할 수 있습니다. |
| 비용 검토 앱 | Use QuickBooks and build an app that shows recent bills and purchases, grouped by vendor and account category. | 검토를 위해 QuickBooks의 비용을 정리합니다. 앱이 청구, 구매, 공급업체, 계정을 읽어 재무팀이 비정상적인 지출을 찾도록 돕습니다. |
| 현금 흐름 리포트 | Use QuickBooks and build a cash flow report that compares paid invoices, open invoices, and upcoming bills. | QuickBooks의 현금 흐름 신호를 요약합니다. 앱이 매출채권과 매입채무 데이터를 결합해 수금된 금액과 지급 예정 금액을 보여줍니다. |
| 레코드 생성 워크플로 | Use QuickBooks and build a form that creates a new customer and draft invoice from an approved request. | 내부 승인을 QuickBooks 레코드로 전환합니다. 앱이 요청 세부 정보를 수집하고 필수 필드를 검증한 뒤 연결된 회사를 통해 QuickBooks 레코드를 생성하거나 업데이트합니다. |
QuickBooks 연결하기
workspace admin과 owner가 QuickBooks를 연결할 수 있습니다. 서로 다른 Intuit 계정이나 회사로 여러 QuickBooks 연결을 만들 수 있습니다. 샌드박스와 운영 환경을 분리하거나 여러 사업체를 관리할 때 유용합니다.
연결이 생성되면 workspace의 모든 프로젝트에서 QuickBooks를 사용할 수 있습니다. 프로젝트를 빌드하는 누구든 Lovable 채팅에서 자신의 프로젝트를 연결하도록 요청할 수 있습니다.
사전 요건
QuickBooks를 연결하기 전에 다음을 준비하세요.
- 연결하려는 QuickBooks Online 회사
- 해당 회사의 API 접근을 승인할 수 있는 Intuit 계정 접근 권한
- Lovable workspace owner 또는 admin 역할
이 connector를 통한 모든 API 요청은 연결된 QuickBooks Online 회사와 Intuit API 접근을 사용합니다. 청구, 할당량, API 한도는 Lovable이 아닌 Intuit에서 처리합니다.
QuickBooks 연결 설정
Connectors에서 QuickBooks 열기
Connectors → App connectors로 이동하여 QuickBooks를 선택하세요.
연결 추가
Add connection을 클릭하세요.
연결 이름 지정
Display name에서 연결 이름을 지정하세요(예를 들어 QuickBooks Prod). 이 이름은 Lovable 내부에서 연결을 식별하는 데만 사용됩니다.
환경 선택
Environment에서 운영 중인 QuickBooks Online 회사라면 Production을, Intuit 개발자 샌드박스 회사라면 Sandbox를 선택하세요.
QuickBooks 회사 ID를 이미 알고 있는 경우가 아니면 Company ID는 비워 두세요. Intuit는 보통 인증 중에 회사 ID를 반환합니다.
연결 접근 권한 선택
Who can access this connection에서 workspace 내 연결 사용 권한을 결정하세요.
- Only you (기본값): 연결을 만든 사람만 해당 연결과 관련 데이터를 사용할 수 있습니다.
- Invite specific people: 본인과 명시적으로 추가된 workspace 멤버만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite entire workspace: Invite entire workspace를 클릭하면 Lovable workspace의 모든 멤버가 연결을 사용할 수 있습니다.
자세한 내용은 Connection-level access를 참고하세요.
QuickBooks 연결 및 인증
Connect를 클릭하세요. QuickBooks 인증 창이 열립니다. 브라우저에서 팝업이 차단되지 않도록 하세요. 차단된 경우 Lovable이 대신 리다이렉트합니다.
메시지가 표시되면 Intuit에 로그인하고 연결할 QuickBooks 회사를 선택한 뒤 요청된 권한을 검토하고 접근을 승인하세요.
Lovable이 확인 메시지와 함께 다시 연결됩니다.
연결이 완료되면 프로젝트를 빌드하는 누구든 Lovable 채팅에서 자신의 프로젝트를 QuickBooks에 연결하도록 요청할 수 있습니다(설정된 connection-level access 기준). 이후 Lovable 앱은 연결된 회사를 통해 QuickBooks Online 회계 데이터를 조회하고 관리할 수 있습니다.
제한 사항
QuickBooks connector는 다음을 지원하지 않습니다.
- QuickBooks Desktop 연결. Intuit Accounting API를 통한 QuickBooks Online을 지원합니다.
- 연결된 Intuit 계정이 승인할 수 없는 QuickBooks 회사 접근.
- QuickBooks 웹훅 또는 실시간 이벤트 알림 수신.
- Intuit API 할당량, 속도 제한, 계정 제한 우회.
- 최종 사용자별 QuickBooks 로그인. 각 연결은 연결된 모든 프로젝트가 공유하는 단일 QuickBooks 회사를 나타냅니다.
Intuit 측에서 QuickBooks 인증이 취소된 경우, API 호출이 다시 성공하려면 Lovable에서 연동을 재연결해야 합니다.
QuickBooks 연결에서 프로젝트 연결 해제하기
Editor 이상 역할을 가진 멤버는 연결 자체를 삭제하지 않고 특정 프로젝트만 연결에서 제거할 수 있습니다. 연결은 다른 프로젝트에서 계속 사용 가능합니다.
프로젝트를 연결 해제하려면 다음을 따르세요.
Connectors 열기
Connectors를 열고 App connectors로 이동한 뒤 **QuickBooks**를 선택하세요.
연결 열기
관리할 연결을 여세요.
프로젝트 선택
Linked projects에서 연결 해제할 프로젝트를 선택하세요.
확인
Unlink projects를 클릭하고 확인하세요.
연결 해제된 프로젝트는 이 연결을 통해 QuickBooks에 더 이상 접근할 수 없습니다. 프로젝트에서 QuickBooks가 다시 필요하면 사용 가능한 연결에 다시 연결하세요.
QuickBooks 연결 삭제하기
workspace admin 및 owner는 QuickBooks 연결을 삭제할 수 있습니다. 다른 멤버는 자신이 만든 연결이거나 명시적으로 접근 권한을 부여받은 연결을 삭제할 수 있습니다.
연결 삭제는 되돌릴 수 없습니다. 연결된 모든 프로젝트에서 자격 증명이 제거되며, 이 연결을 사용하는 앱은 새 연결이 추가될 때까지 작동을 멈춥니다.
삭제하기 전에 Linked projects 섹션에서 현재 연결을 사용 중인 프로젝트를 확인하세요.
연결을 삭제하려면 다음을 따르세요.
Connectors 열기
Connectors를 열고 App connectors로 이동한 뒤 **QuickBooks**를 선택하세요.
연결 열기
제거할 연결을 여세요.
연결된 프로젝트 확인
Linked projects 섹션을 검토하세요.
삭제
Delete this connection 아래에서 Delete를 클릭하고 확인하세요.