Zoho Books 자동화은(는) 무엇을 하나요?
Zoho Books 회계 워크플로우를 자동화합니다. 송장 생성 및 관리, 지출과 지불 추적, 연락처 검색, PDF 내보내기, 다중 조직 설정 등을 자연어 명령으로 수행할 수 있습니다.
툴킷 문서: composio.dev/toolkits/zoho_books
설정
- Rube MCP 서버를 환경에 추가하세요:
https://rube.app/mcp - 메시지가 표시되면 Zoho Books 계정을 연결하세요 (Composio를 통한 OAuth 흐름)
- Zoho Books 자동화를 위한 자연어 명령을 입력하세요
핵심 워크플로우
1. 조직 검색
인증된 사용자의 모든 조직을 검색합니다. organization_id는 거의 모든 다른 엔드포인트에서 필요하므로 이 단계는 필수입니다.
도구: ZOHO_BOOKS_LIST_ORGANIZATIONS
필요한 매개변수는 없습니다. 조직 ID, 이름, 메타데이터를 반환합니다.
다른 모든 Zoho Books 도구에서 필요한
organization_id를 얻으려면 항상 이 도구를 먼저 호출하세요.
예시 프롬프트:
"내 Zoho Books 조직 목록을 보여줘"
2. 송장 생성 및 관리
라인 항목이 포함된 송장을 생성하고, 기존 송장을 관리하며, PDF로 내보냅니다.
생성: ZOHO_BOOKS_CREATE_INVOICE
주요 매개변수:
organization_id-- 대상 조직 (필수)customer_id-- 청구할 고객 (필수)line_items-- 라인 항목 배열 (필수), 각 항목에는 다음이 포함됩니다:item_id또는name-- 기존 항목 참조 또는 임시 라인 생성quantity,rate-- 금액 세부 정보description,tax_id,discount-- 선택적 세부 정보
date/due_date--YYYY-MM-DD형식의 날짜invoice_number-- 사용자 지정 번호 (ignore_auto_number_generation=true설정 필요)discount/discount_type-- 송장 수준 할인 (entity_level또는item_level)notes/terms-- 송장에 인쇄될 내용send-- 생성 후 즉시 송장 이메일 발송payment_terms-- 결제 기한 (일수)
목록: ZOHO_BOOKS_LIST_INVOICES
주요 매개변수:
organization_id(필수)status--sent,draft,overdue,paid,void,unpaid,partially_paid,viewedcustomer_id/customer_name-- 고객별 필터date_start/date_end-- 날짜 범위 필터 (YYYY-MM-DD)search_text-- 송장 번호, 참조 또는 고객명 검색sort_column/sort_order--date,due_date,total,balance등으로 정렬page/per_page-- 페이지 매김 (최대 200개)
세부 정보 조회: ZOHO_BOOKS_GET_INVOICE -- invoice_id로 가져오며 accept 형식: json, pdf, html
삭제: ZOHO_BOOKS_DELETE_INVOICE -- invoice_id로 삭제
일괄 내보내기: ZOHO_BOOKS_BULK_EXPORT_INVOICES_PDF -- 최대 25개 송장을 하나의 PDF로 병합
일괄 인쇄: ZOHO_BOOKS_BULK_PRINT_INVOICES -- 최대 25개 송장에 대한 인쇄용 PDF 생성
예시 프롬프트:
"고객 1234567890에게 위젯 A 10개(개당 $25), 위젯 B 5개(개당 $50)의 2개 라인 항목으로 송장을 생성하고, 결제 기한은 30일로 설정해줘"
3. 지출 추적 및 관리
포괄적인 필터를 사용하여 공급업체 지출을 목록, 조회, 수정합니다.
목록: ZOHO_BOOKS_LIST_BILLS
주요 매개변수:
organization_id(필수)status--paid,open,overdue,void,partially_paidvendor_id/vendor_name_contains-- 공급업체별 필터bill_number/bill_number_contains-- 지출 번호별 필터date_start/date_end-- 날짜 범위 필터total_greater_than/total_less_than-- 금액 범위 필터sort_column/sort_order--vendor_name,bill_number,date,due_date,total등으로 정렬page/per_page-- 페이지 매김 (최대 200)
세부 정보 조회: ZOHO_BOOKS_GET_BILL -- bill_id와 organization_id로 전체 지출 정보 조회
수정: ZOHO_BOOKS_UPDATE_BILL -- 기존 지출 수정 (bill_id, organization_id, vendor_id, bill_number 필요)
예시 프롬프트:
"내 조직의 모든 연체된 지출을 결제 기한 순으로 정렬해서 보여줘"
4. 연락처 검색
송장 및 지출에 사용할 연락처(고객 및 공급업체)를 검색하고 필터링합니다.
도구: ZOHO_BOOKS_LIST_CONTACTS
주요 매개변수:
organization_id(필수)contact_type--customer또는vendorcontact_name_contains/contact_name_startswith-- 이름 필터email_contains/email_startswith-- 이메일 필터company_name_contains-- 회사명 필터filter_by-- 상태 필터:Status.Active,Status.Inactive,Status.Duplicate등search_text-- 연락처 이름 또는 메모로 검색 (최대 100자)sort_column--contact_name,email,outstanding_receivable_amount,created_time등으로 정렬page/per_page-- 페이지 매김 (최대 200)
예시 프롬프트:
"회사명에 '에이스'가 포함된 모든 활성 고객을 찾아줘"
5. 송장 결제 추적
특정 송장에 기록된 모든 결제를 조회합니다.
도구: ZOHO_BOOKS_LIST_INVOICE_PAYMENTS
주요 매개변수:
invoice_id-- 확인할 송장 (필수)organization_id-- 조직 (필수)
송장에 적용된 모든 결제 트랜잭션(금액, 날짜, 결제 방법 포함)을 반환합니다.
예시 프롬프트:
"송장 451025000000123045에 기록된 모든 결제 내역을 보여줘"
6. 전체 송장 워크플로우
도구를 결합하여 종합적인 송장 관리를 수행합니다:
- 조직:
ZOHO_BOOKS_LIST_ORGANIZATIONS--organization_id획득 - 연락처:
ZOHO_BOOKS_LIST_CONTACTS--customer_id찾기 또는 확인 - 생성:
ZOHO_BOOKS_CREATE_INVOICE-- 라인 항목이 포함된 송장 생성 - 검토:
ZOHO_BOOKS_GET_INVOICE-- 송장 세부 정보 또는 PDF 가져오기 - 추적:
ZOHO_BOOKS_LIST_INVOICE_PAYMENTS-- 결제 상태 모니터링 - 내보내기:
ZOHO_BOOKS_BULK_EXPORT_INVOICES_PDF-- 기록 보관용 일괄 내보내기
예시 프롬프트:
"'에이스 주식회사'의 고객 ID를 찾고, 컨설팅 서비스에 대한 송장을 생성한 다음 PDF를 받아줘"
알려진 문제점
| 문제점 | 설명 |
|---|---|
| 조직 ID 항상 필요 | 거의 모든 엔드포인트에 organization_id가 필요합니다 -- 항상 ZOHO_BOOKS_LIST_ORGANIZATIONS를 먼저 호출하세요 |
| 송장에 라인 항목 필수 | ZOHO_BOOKS_CREATE_INVOICE는 item_id 또는 name이 있는 라인 항목이 최소 하나 이상 필요합니다 |
| 송장 ID 형식 | 송장 객체의 숫자 invoice_id(예: 7472322000000264123)를 사용하세요. invoice_url의 인코딩된 ID가 아닙니다 |
| 일괄 처리 제한 | ZOHO_BOOKS_BULK_EXPORT_INVOICES_PDF와 ZOHO_BOOKS_BULK_PRINT_INVOICES 모두 최대 25개의 송장 ID만 허용합니다 |
| 페이지당 최대 200개 | 모든 목록 엔드포인트는 페이지당 200개 레코드로 제한됩니다 -- 전체 결과를 얻으려면 페이지를 반복하세요 |
| 지출 수정 시 모든 필드 필요 | ZOHO_BOOKS_UPDATE_BILL은 부분 수정 시에도 bill_id, organization_id, vendor_id, bill_number가 모두 필요합니다 |
| 날짜 형식 | 모든 날짜 매개변수는 YYYY-MM-DD 형식을 사용합니다 |
| response_option 문서화되지 않음 | ZOHO_BOOKS_LIST_INVOICES에는 문서화되지 않은 response_option 매개변수(0=전체, 1=전체+합계, 2=개수만)가 있으며, 사전 통보 없이 변경될 수 있습니다 |
빠른 참조
| 작업 | 도구 슬러그 | 주요 매개변수 |
|---|---|---|
| 조직 목록 | ZOHO_BOOKS_LIST_ORGANIZATIONS | (없음) |
| 송장 생성 | ZOHO_BOOKS_CREATE_INVOICE | organization_id, customer_id, line_items |
| 송장 목록 | ZOHO_BOOKS_LIST_INVOICES | organization_id, status, date_start |
| 송장 조회 | ZOHO_BOOKS_GET_INVOICE | invoice_id, organization_id, accept |
| 송장 삭제 | ZOHO_BOOKS_DELETE_INVOICE | invoice_id, organization_id |
| PDF 일괄 내보내기 | ZOHO_BOOKS_BULK_EXPORT_INVOICES_PDF | organization_id, invoice_ids |
| 일괄 인쇄 | ZOHO_BOOKS_BULK_PRINT_INVOICES | organization_id, invoice_ids |
| 지출 목록 | ZOHO_BOOKS_LIST_BILLS | organization_id, status, vendor_id |
| 지출 조회 | ZOHO_BOOKS_GET_BILL | bill_id, organization_id |
| 지출 수정 | ZOHO_BOOKS_UPDATE_BILL | bill_id, organization_id, vendor_id |
| 연락처 목록 | ZOHO_BOOKS_LIST_CONTACTS | organization_id, contact_type, search_text |
| 결제 목록 | ZOHO_BOOKS_LIST_INVOICE_PAYMENTS | invoice_id, organization_id |
Composio 제공