회계 플랫폼인 Zoho Books에 앱을 연결하여 고객, 청구서, 견적서, 청구 비용, 프로젝트를 읽고 관리합니다.
Zoho Books에 앱 연결하기
회계 플랫폼 Zoho Books에 앱을 연결하여 고객, 청구서, 견적서, 지급 청구서, 청구 비용 및 프로젝트를 읽고 관리하세요.
Zoho Books는 고객, 청구서, 견적서, 청구 비용, 지급 청구서, 프로젝트 및 부기 워크플로우를 관리하는 회계 소프트웨어입니다. Zoho Books 커넥터를 사용하면 자체 Zoho Books 계정을 통해 Lovable 앱에서 회계 레코드를 읽고 관리할 수 있습니다.
Zoho Books는 앱 + 채팅 커넥터로 제공됩니다. 하나의 공유 연결이 빌드 중 채팅과 게시된 앱 모두에서 작동합니다.
Zoho Books를 사용하면 앱에서 다음 작업을 할 수 있습니다:
- 조직 목록과 세금, 통화, 품목 같은 설정 조회
- 고객, 공급업체, 청구서, 견적서 및 판매 주문 생성 및 관리
- 고객 결제와 credit note 기록
- 지급 청구서, 청구 비용, 구매 주문 및 프로젝트 읽기와 관리
회계 장부를 Zoho에서 관리하면서 Zoho Books를 열지 않고도 해당 레코드를 표시하거나 업데이트하는 앱을 만들 때 적합합니다.
주요 활용 사례 및 예시 앱
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| 청구서 운영 대시보드 | Zoho Books를 사용해 고객별, 마감일별, 결제 상태별로 청구서를 보여주는 대시보드를 만들어줘. | Zoho Books의 청구서 상태를 한곳에 집중해 추적합니다. 앱이 연결된 조직의 청구서를 읽어 상태별로 묶고, 재무 팀이 연체 결제에 후속 조치를 하도록 돕습니다. |
| 고객 청구 포털 | Zoho Books를 사용해 고객이 자신의 청구서, 견적서 및 결제 이력을 볼 수 있는 고객 포털을 만들어줘. | 고객에게 청구 레코드를 셀프서비스 형태로 보여줍니다. 앱이 Zoho Books에서 고객, 청구서 및 견적서 데이터를 가져와 각 계정에 연결된 레코드를 표시합니다. |
| 비용 승인 도구 | Zoho Books를 사용해 관리자가 프로젝트별, 공급업체별로 청구 비용을 검토할 수 있는 비용 승인 앱을 만들어줘. | Zoho Books 청구 비용을 구조화된 승인 흐름으로 검토합니다. 앱이 청구 비용 레코드를 읽고, 관리자가 프로젝트나 공급업체로 필터링하도록 하며, 승인 결정을 앱에 기록합니다. |
| 매입채무 추적기 | Zoho Books를 사용해 다가오는 마감일을 표시하는 지급 청구서와 구매 주문 추적기를 만들어줘. | 운영 팀이 공급업체 결제에 앞서 대응하도록 돕습니다. 앱이 Zoho Books에서 지급 청구서와 구매 주문을 읽고, 검토나 결제가 필요한 레코드를 강조합니다. |
| 프로젝트 재무 대시보드 | Zoho Books를 사용해 프로젝트별 청구 비용, 청구서 및 수익성을 보여주는 프로젝트 대시보드를 만들어줘. | 프로젝트 업무를 재무 성과와 연결합니다. 앱이 프로젝트, 청구 비용 및 청구서 데이터를 읽어 팀이 스프레드시트로 내보내지 않고도 예산과 마진을 모니터링합니다. |
Zoho Books 연결하기
Zoho Books 연결을 만들 수 있는 사용자는 플랜과 워크스페이스 설정에 따라 다릅니다. 앱 + 채팅 커넥터는 Free, Pro, Business 플랜에서 기본 제공됩니다. Enterprise 플랜에서는 처음에 사실상 비활성화되어 있습니다. Admin이 Connectors → Admin settings → App + chat connectors에서 변경하기 전까지 연결 및 클라이언트를 만들 수 있는 사용자의 기본값이 No one이기 때문입니다.
서로 다른 Zoho 계정, 데이터 센터, client 애플리케이션 또는 조직으로 여러 Zoho Books 연결을 만들 수 있어, 프로덕션과 샌드박스 환경을 분리하거나 여러 법인을 관리할 때 유용합니다.
연결이 생성되면 사용할 프로젝트에 연결을 링크할 수 있습니다. 프로젝트에서 빌드하는 사람은 누구나 채팅에서 Lovable에게 프로젝트를 이 연결에 링크해 달라고 요청할 수 있습니다.
사전 준비
Zoho Books를 연결하기 전에 다음을 준비하세요:
- Zoho Books 계정
- Server-based Application을 만들기 위한 Zoho Books 데이터 센터의 Zoho API Console 접근 권한
- Zoho Books 계정이 호스팅되는 데이터 센터(United States, Europe, India, Australia, Japan, Canada, China, Saudi Arabia 등)
- 연결을 한 조직에 고정하려는 경우 사용할 Zoho Books 조직 ID
- Lovable 워크스페이스에서 연결을 만들 수 있는 권한(연결 및 클라이언트를 만들 수 있는 사용자 참조)
이 커넥터를 통한 모든 API 요청은 Zoho Books API 제한과 Zoho Books 플랜에 포함됩니다. 청구와 할당량은 Lovable이 아닌 Zoho Books에서 직접 처리합니다.
1단계: Zoho API console 애플리케이션 만들기
Zoho Books는 OAuth로 서드파티 접근을 승인합니다. Zoho Books 계정과 같은 데이터 센터의 Zoho API Console에서 Server-based Application을 만들어 Lovable에 사용할 Client ID와 Client Secret을 확보하세요.
| Zoho Books 데이터 센터 | API Console URL |
|---|---|
United States (books.zoho.com) | api-console.zoho.com |
Europe (books.zoho.eu) | api-console.zoho.eu |
India (books.zoho.in) | api-console.zoho.in |
Australia (books.zoho.com.au) | api-console.zoho.com.au |
Japan (books.zoho.jp) | api-console.zoho.jp |
Canada (books.zohocloud.ca) | api-console.zohocloud.ca |
China (books.zoho.com.cn) | api-console.zoho.com.cn |
Saudi Arabia (books.zoho.sa) | api-console.zoho.sa |
Zoho API Console 열기
Zoho Books 데이터 센터와 일치하는 Zoho API Console URL에 로그인합니다.
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로 이동해 Zoho Books를 선택합니다.
연결 추가하기
Add connection을 클릭합니다.
연결 세부 정보 입력하기
연결 필드를 입력합니다:
- Display name: 연결 이름을 지정합니다(예:
Zoho Books Prod). 이 이름은 Lovable 내부에서 연결을 식별할 때만 사용됩니다. - Data center: Zoho Books 계정이 호스팅되는 지역을 선택합니다. United States (.com), Europe (.eu)(기본값), India (.in), Australia (.com.au), Japan (.jp), Canada (.ca), China (.com.cn), Saudi Arabia (.sa) 중에서 선택할 수 있습니다.
- 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는 커넥터가 연결을 검증하고 Zoho Books settings API로 조직 목록을 조회하기 때문에 필수입니다. 앱에 해당 회계 영역이 필요하지 않으면 선택 scope를 제거할 수 있습니다.
| Scope | 설명 | 기본값 |
|---|---|---|
Settings: read (ZohoBooks.settings.READ) | 조직 목록 조회 및 사용자, 세금, 통화, 품목 같은 설정 데이터 읽기 | 필수 |
Contacts: full access (ZohoBooks.contacts.ALL) | 고객 및 공급업체 생성, 읽기, 업데이트 및 삭제 | 켜짐 |
Invoices: full access (ZohoBooks.invoices.ALL) | 청구서 생성, 읽기, 업데이트 및 삭제 | 켜짐 |
Customer payments: full access (ZohoBooks.customerpayments.ALL) | 고객에게 받은 결제 생성, 읽기, 업데이트 및 삭제 | 켜짐 |
Credit notes: full access (ZohoBooks.creditnotes.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에서 워크스페이스 내 연결 사용자를 결정합니다:
- Only you(기본값): 연결을 만든 사람만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite specific people: 본인과 명시적으로 추가한 워크스페이스 멤버만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite entire workspace: Invite entire workspace를 클릭하면 Lovable 워크스페이스의 모든 사용자가 연결을 사용할 수 있습니다.
자세한 내용은 연결 수준 접근을 참고하세요.
Zoho Books에 연결하고 승인하기
Connect를 클릭합니다. Zoho Books 승인 창이 열리므로 브라우저가 팝업을 차단하지 않는지 확인하세요. 차단된 경우 Lovable이 대신 페이지를 이동합니다.
요청되면 Zoho Books에 로그인하고 요청된 권한을 검토한 뒤 Accept 또는 Allow를 클릭합니다.
확인과 함께 Lovable로 다시 이동합니다.
연결되면 프로젝트에서 빌드하는 사용자는 구성된 연결 수준 접근 권한에 따라 채팅에서 Lovable에 프로젝트와 Zoho Books의 연결을 요청할 수 있습니다. 이후 Lovable 앱에서 연결된 Zoho 계정을 통해 Zoho Books 레코드를 읽고 관리할 수 있습니다.
조직 다루기
대부분의 Zoho Books 리소스 엔드포인트는 organization_id 쿼리 매개변수가 필요합니다. 연결을 만들 때 Organization ID를 입력하면 Lovable이 그 값을 연결 메타데이터에 포함하므로 앱이 재사용할 수 있습니다.
Organization ID를 비워 두면 먼저 커넥터를 통해 Lovable에 조직을 가져오도록 요청한 뒤 반환된 조직 ID를 연락처, 청구서, 지급 청구서, 청구 비용 및 프로젝트 같은 레코드 호출에 전달하세요.
제한 사항
Zoho Books 커넥터는 다음을 할 수 없습니다:
- 최종 사용자별 Zoho Books 로그인 지원. 각 연결은 연결된 모든 프로젝트에서 공유하는 하나의 Zoho 계정을 나타냅니다.
- 커넥터를 통한 Zoho Books 웹훅 이벤트 수신.
Zoho 측에서 Zoho Books 승인이 취소되거나 Zoho API console 애플리케이션이 삭제 또는 변경되면, API 호출이 다시 성공하도록 Lovable에서 통합을 다시 연결해야 합니다.
Zoho Books 연결 관리하기
Connectors에서 연결을 관리합니다. **Zoho Books**를 선택한 뒤 연결을 여세요.
- 특정 프로젝트의 Zoho Books 접근만 제거하고 다른 프로젝트에서는 연결을 계속 사용하려면 Unlink projects를 사용합니다. 단계는 연결에서 프로젝트 연결 해제를 참고하세요.
- 워크스페이스에서 연결을 완전히 제거하려면 Delete the connection을 사용합니다. 삭제는 영구적입니다. 연결된 모든 프로젝트에서 인증 정보가 제거되고, 새 연결을 추가할 때까지 Zoho Books을 사용하는 앱 기능이 중단됩니다. 단계와 삭제 권한은 연결 삭제를 참고하세요.