회계 플랫폼인 Zoho Books에 앱을 연결하여 고객, 청구서, 견적서, 청구 비용, 프로젝트를 읽고 관리합니다.
앱을 Zoho Books에 연결하기
회계 플랫폼인 Zoho Books에 앱을 연결하여 고객, 청구서, 견적서, 청구 비용, 프로젝트를 읽고 관리하세요.
Zoho Books는 고객, 청구서, 견적서, 비용, 청구, 프로젝트, 장부 워크플로를 관리하는 회계 소프트웨어입니다. Zoho Books connector를 사용하면 Lovable 앱이 연결된 Zoho Books 계정을 통해 회계 레코드를 읽고 관리할 수 있습니다.
Zoho Books를 연결하면 앱은 다음 작업이 가능합니다:
- 조직 목록 조회 및 회계 API 호출에 조직 ID 활용
- 고객, 공급업체, 청구서, 견적서, 판매 주문 생성 및 관리
- 대시보드 및 리포트를 위한 청구, 비용, 구매 주문, 프로젝트 조회
- connector 게이트웨이를 통한 승인·리포트·장부 워크플로 구축
재무 대시보드, 고객 청구 포털, 비용 워크플로, 실시간 Zoho Books 데이터가 필요한 내부 회계 도구에 적합합니다.
주요 활용 사례 및 예시 앱
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| 청구서 운영 대시보드 | Use Zoho Books and build a dashboard that shows invoices by customer, due date, and payment status. | Zoho Books 청구서 상태를 한 화면으로 추적합니다. 연결된 조직의 청구서를 읽어 상태별로 분류하고 재무팀이 연체 결제를 추적할 수 있게 합니다. |
| 고객 청구 포털 | Use Zoho Books and build a customer portal where customers can view their invoices, estimates, and payment history. | 고객에게 청구 레코드 셀프 서비스 화면을 제공합니다. Zoho Books에서 고객, 청구서, 견적서 데이터를 가져와 각 계정과 연결된 레코드를 표시합니다. |
| 비용 승인 도구 | Use Zoho Books and build an expense approval app where managers can review expenses by project and vendor. | 구조화된 승인 흐름으로 Zoho Books 비용을 검토합니다. 비용 레코드를 읽어 관리자가 프로젝트 또는 공급업체별로 필터링하고 앱에 승인 결정을 기록할 수 있게 합니다. |
| 지급 계정 추적기 | Use Zoho Books and build a tracker for bills and purchase orders that flags upcoming due dates. | 운영팀이 공급업체 결제를 미리 파악합니다. Zoho Books에서 청구서 및 구매 주문을 읽어 검토 또는 결제가 필요한 레코드를 강조합니다. |
| 프로젝트 재무 대시보드 | Use Zoho Books and build a project dashboard that shows expenses, invoices, and profitability by project. | 프로젝트 업무를 재무 성과와 연결합니다. 프로젝트, 비용, 청구서 데이터를 읽어 팀이 스프레드시트를 내보내지 않고 예산과 마진을 모니터링할 수 있게 합니다. |
Zoho Books 연결하기
workspace admin 및 owner가 Zoho Books를 연결할 수 있습니다. 서로 다른 Zoho 계정, 지역, OAuth 앱, 조직 ID로 여러 Zoho Books 연결을 만들 수 있습니다. 운영 환경과 샌드박스 환경을 분리하거나 여러 법인을 관리할 때 유용합니다.
연결이 생성되면 workspace의 모든 프로젝트에서 Zoho Books를 사용할 수 있습니다. 프로젝트를 빌드하는 누구든 Lovable 채팅에서 자신의 프로젝트를 연결하도록 요청할 수 있습니다.
사전 요건
Zoho Books를 연결하기 전에 다음을 준비하세요:
- Zoho Books 계정
- Server-based Application을 만들 수 있는 Zoho API Console 접근 권한
- Zoho Books 계정이 호스팅된 데이터 센터 (미국, 유럽, 인도, 호주, 일본, 캐나다, 중국, 사우디아라비아 중 해당 지역)
- 연결을 특정 조직에 고정하려는 경우 사용할 Zoho Books 조직 ID
- Lovable workspace owner 또는 admin 역할
이 connector를 통한 모든 API 요청은 Zoho Books API 한도와 플랜에 카운트됩니다. 청구 및 할당량은 Lovable이 아닌 Zoho Books에서 직접 처리합니다.
1단계: Zoho API Console 애플리케이션 생성
Zoho Books는 OAuth로 타사 접근을 인증합니다. Zoho API Console에서 Server-based Application을 만들어 Lovable용 Client ID와 Client Secret을 받으세요.
Zoho API Console 열기
연결할 Zoho 계정으로 Zoho API Console에 로그인하세요.
Server-based Application 생성
Add Client 또는 Get started를 클릭한 뒤 Server-based Applications를 선택하세요.
애플리케이션 세부 정보 입력
애플리케이션 세부 정보를 작성하세요:
- Client Name: 예를 들어
Lovable Integration - Homepage URL: 앱 또는 회사 웹사이트 URL
- Authorized Redirect URIs:
https://api.lovable.dev/workspaces/connectors/standard/oauth/callback
자격 증명 복사
애플리케이션을 저장한 뒤 생성된 Client ID와 Client Secret을 복사하세요. Lovable에서 두 값 모두 필요합니다.
Client Secret은 비밀번호와 같습니다. 안전하게 보관하고 절대 공개하지 마세요. 다음 단계에서 필요합니다.
자세한 내용은 Zoho API Console 문서를 참고하세요.
2단계: Zoho Books를 Lovable에 연결하기
Connectors에서 Zoho Books 열기
Connectors → App connectors로 이동하여 Zoho Books를 선택하세요.
연결 추가
Add connection을 클릭하세요.
연결 세부 정보 입력
연결 필드를 작성하세요:
- Display name: 예를 들어
Zoho Books Prod와 같이 연결 이름을 지정하세요. 이 이름은 Lovable 내부에서 연결을 식별하는 데만 사용됩니다. - Data center: Zoho Books 계정이 호스팅된 지역을 선택하세요. Zoho Books URL을 확인하면 알 수 있습니다. 예를 들어
books.zoho.eu는 유럽을 의미합니다. - Client ID: Zoho API Console 애플리케이션의 Client ID.
- Client secret: Zoho API Console 애플리케이션의 Client Secret.
- Organization ID (선택): 연결 메타데이터에 포함할 Zoho Books 조직 ID를 숫자로 입력하세요. 비워두면 연결 후 앱에서 조직을 가져올 수 있습니다.
scope 검토 (선택)
Advanced settings를 펼쳐 Lovable가 요청하는 Zoho Books 권한을 검토하세요. 기본 scope는 일반적인 회계 워크플로를 위해 선택되어 있습니다.
Settings: read는 connector가 연결을 확인하고 Zoho Books 설정 API를 통해 조직을 나열하는 데 필요하므로 필수입니다. 앱에서 해당 회계 영역이 필요하지 않으면 선택적 scope를 제거할 수 있습니다.
| Scope | 허용 작업 | 기본값 |
|---|---|---|
Settings: read (ZohoBooks.settings.READ) | 조직 목록 조회 및 사용자, 세금, 통화, 항목 등 설정 데이터 읽기 | 필수 |
Contacts: full access (ZohoBooks.contacts.ALL) | 고객 및 공급업체 생성·조회·수정·삭제 | 활성 |
Invoices: full access (ZohoBooks.invoices.ALL) | 청구서 생성·조회·수정·삭제 | 활성 |
Estimates: full access (ZohoBooks.estimates.ALL) | 견적서 및 인용 생성·조회·수정·삭제 | 활성 |
Sales orders: full access (ZohoBooks.salesorders.ALL) | 판매 주문 생성·조회·수정·삭제 | 활성 |
Purchase orders: full access (ZohoBooks.purchaseorders.ALL) | 구매 주문 생성·조회·수정·삭제 | 활성 |
Bills: full access (ZohoBooks.bills.ALL) | 청구 생성·조회·수정·삭제 | 활성 |
Expenses: full access (ZohoBooks.expenses.ALL) | 비용 생성·조회·수정·삭제 | 활성 |
Projects: full access (ZohoBooks.projects.ALL) | 프로젝트 및 프로젝트 태스크 생성·조회·수정·삭제 | 활성 |
전체 scope 문서는 Zoho Books OAuth scopes를 참고하세요.
접근 권한 설정
Who can access this connection에서 workspace 내 연결 사용 권한을 결정하세요:
- Only you (기본값): 연결을 만든 사람만 해당 연결과 관련 데이터를 사용할 수 있습니다.
- Invite specific people: 본인과 명시적으로 추가된 workspace 멤버만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite entire workspace: Invite entire workspace를 클릭하면 Lovable workspace의 모든 멤버가 연결을 사용할 수 있습니다.
자세한 내용은 Connection-level access를 참고하세요.
Zoho Books 연결 및 인증
Connect를 클릭하세요. Zoho Books 인증 창이 열립니다. 브라우저에서 팝업이 차단되지 않도록 하세요. 차단된 경우 Lovable이 대신 리다이렉트합니다.
메시지가 표시되면 Zoho Books에 로그인하고 요청된 권한을 검토한 뒤 Accept 또는 Allow를 클릭하세요.
Lovable이 확인 메시지와 함께 다시 연결됩니다.
연결이 완료되면 프로젝트를 빌드하는 누구든 Lovable 채팅에서 자신의 프로젝트를 Zoho Books에 연결하도록 요청할 수 있습니다(설정된 connection-level access 기준). 이후 Lovable 앱은 연결된 Zoho 계정을 통해 Zoho Books 레코드를 읽고 관리할 수 있습니다.
조직 활용
대부분의 Zoho Books 리소스 엔드포인트에는 organization_id 쿼리 매개변수가 필요합니다. 연결 생성 시 Organization ID를 입력하면 Lovable이 해당 값을 연결 메타데이터에 포함하므로 앱이 재사용할 수 있습니다.
Organization ID를 비워두면 먼저 connector를 통해 Lovable에게 조직을 가져오도록 요청한 뒤 반환된 조직 ID를 연락처, 청구서, 청구, 비용, 프로젝트 호출에 전달하세요.
제한 사항
Zoho Books connector는 다음을 지원하지 않습니다:
- 최종 사용자별 Zoho Books 로그인. 각 연결은 연결된 모든 프로젝트가 공유하는 단일 Zoho 계정을 나타냅니다.
- connector를 통한 Zoho Books 웹훅 이벤트 수신.
- Zoho Books API 한도, 속도 제한, 플랜 제한 우회.
- Zoho Books 리소스 호출에서
organization_id생략. 앱은 설정된 조직 ID를 사용하거나/organizations에서 가져와야 합니다.
Zoho 측에서 Zoho Books 인증이 취소되거나 Zoho API Console 애플리케이션이 삭제 또는 변경된 경우, API 호출이 다시 성공하려면 Lovable에서 연동을 재연결해야 합니다.
Zoho Books 연결에서 프로젝트 연결 해제하기
Editor 이상 역할을 가진 멤버는 연결 자체를 삭제하지 않고 특정 프로젝트만 연결에서 제거할 수 있습니다. 연결은 다른 프로젝트에서 계속 사용 가능합니다.
프로젝트를 연결 해제하려면 다음을 따르세요.
Connectors 열기
Connectors를 열고 App connectors로 이동한 뒤 **Zoho Books**를 선택하세요.
연결 열기
관리할 연결을 여세요.
프로젝트 선택
Linked projects에서 연결 해제할 프로젝트를 선택하세요.
확인
Unlink projects를 클릭하고 확인하세요.
연결 해제된 프로젝트는 이 연결을 통해 Zoho Books에 더 이상 접근할 수 없습니다. 프로젝트에서 Zoho Books가 다시 필요하면 사용 가능한 연결에 다시 연결하세요.
Zoho Books 연결 삭제하기
workspace admin 및 owner는 Zoho Books 연결을 삭제할 수 있습니다. 다른 멤버는 자신이 만든 연결이거나 명시적으로 접근 권한을 부여받은 연결을 삭제할 수 있습니다.
연결 삭제는 되돌릴 수 없습니다. 연결된 모든 프로젝트에서 자격 증명이 제거되며, 이 연결을 사용하는 앱은 새 연결이 추가될 때까지 작동을 멈춥니다.
삭제하기 전에 Linked projects 섹션에서 현재 연결을 사용 중인 프로젝트를 확인하세요.
연결을 삭제하려면 다음을 따르세요.
Connectors 열기
Connectors를 열고 App connectors로 이동한 뒤 **Zoho Books**를 선택하세요.
연결 열기
제거할 연결을 여세요.
연결된 프로젝트 확인
Linked projects 섹션을 검토하세요.
삭제
Delete this connection 아래에서 Delete를 클릭하고 확인하세요.