클라우드 회계 플랫폼 Xero에 앱을 연결하여 연락처, 청구서, 지급 청구서, 결제, 은행 거래 및 재무 보고서를 활용합니다.
Xero에 앱 연결하기
클라우드 회계 플랫폼 Xero에 앱을 연결하여 연락처, 청구서, 지급 청구서, 결제, 은행 거래 및 재무 보고서를 활용하세요.
Xero는 연락처, 청구서, 지급 청구서, 결제 및 부기 워크플로우를 관리하는 클라우드 회계 플랫폼입니다. Xero 커넥터를 사용하면 자체 Xero 앱을 통해 Lovable 앱에서 Xero 조직의 회계 데이터를 활용할 수 있습니다. Xero 데이터를 기반으로 하는 재무 대시보드, 인보이스 워크플로우 및 내부 운영 도구에 적합합니다.
Xero는 앱 + 채팅 커넥터로 제공됩니다. 하나의 공유 연결이 빌드 중 채팅과 게시된 앱 모두에서 작동합니다.
Xero를 사용하면 앱에서 다음 작업을 할 수 있습니다:
- 고객과 공급업체를 포함한 연락처 읽기 및 관리
- 판매 청구서와 지급 청구서 생성, 업데이트 및 읽기
- 결제와 은행 거래 기록 및 읽기
- 조직 설정, 통화 및 세율 읽기
- 손익계산서, 대차대조표, 매출채권 및 매입채무 연령 분석 같은 재무 보고서 읽기
연결은 승인 과정에서 동의한 Xero 조직에 접근할 수 있으며, Lovable이 연결된 조직을 자동으로 찾습니다. 실시간 회계 데이터가 필요한 매출채권 대시보드, 청구 포털, 비용 추적기 및 보고 앱에 적합합니다.
주요 활용 사례 및 예시 앱
Lovable 앱에 Xero 조직의 연락처, 청구서, 지급 청구서, 결제 또는 재무 보고서 같은 실시간 회계 데이터가 필요할 때 Xero를 사용하세요.
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| 매출채권 대시보드 | Xero를 사용해 고객별 미결 청구서, 연체 잔액 및 매출채권 연령 분석을 보여주는 대시보드를 만들어줘. | Xero의 미수 수익을 한곳에서 추적합니다. 앱이 청구서, 결제 및 매출채권 연령 분석 보고서를 읽고 후속 조치가 필요한 고객을 강조합니다. |
| 청구서 생성 워크플로우 | Xero를 사용해 승인된 내부 요청에서 Xero의 판매 청구서 초안을 생성하는 양식을 만들어줘. | 내부 승인을 Xero 청구서로 전환합니다. 앱이 요청 세부 정보를 수집하고 올바른 연락처를 조회한 뒤 연결된 Xero 조직에 청구서를 생성합니다. |
| 공급업체 지급 청구서 추적기 | Xero를 사용해 예정 및 연체 지급 청구서를 공급업체별로 보여주는 추적기를 만들어줘. | 재무 팀에 지급채무 중심 보기를 제공합니다. 앱이 지급 청구서와 결제를 읽고 지급 예정, 지급 완료 및 연체 항목을 보여줍니다. |
| 현금 흐름 모니터 | Xero를 사용해 최근 은행 거래와 월별 유입액 및 유출액을 비교하는 앱을 만들어줘. | Xero를 열지 않고 현금 이동을 확인합니다. 앱이 은행 거래와 결제를 읽고 시간에 따른 유입 및 유출을 차트로 표시합니다. |
| 재무 보고 포털 | 최신 손익계산서와 대차대조표를 이해관계자에게 보여주는 포털을 만들어줘. | 주요 재무 보고서를 읽기 전용 보기로 공유합니다. 앱이 Xero에서 손익계산서와 대차대조표를 가져와 Xero 접근 권한이 없는 사용자에게 표시합니다. |
| 고객 계정 도구 | 직원이 고객을 검색하고 연락처 세부 정보와 청구서 이력을 볼 수 있는 도구를 만들어줘. | Xero 고객 데이터를 쉽게 조회합니다. 앱이 연락처와 청구서를 읽어 지원 및 영업 팀에 빠른 계정 개요를 제공합니다. |
Xero 연결하기
Xero 연결을 만들 수 있는 사용자는 플랜과 워크스페이스 설정에 따라 달라집니다. Free, Pro, Business 플랜에서는 앱 + 채팅 커넥터를 기본적으로 사용할 수 있습니다. Enterprise 플랜에서는 처음에 사실상 비활성화되어 있습니다. 관리자가 Connectors → Admin settings → App + chat connectors에서 변경하기 전까지 연결 및 클라이언트를 만들 수 있는 사용자가 No one으로 설정됩니다.
서로 다른 Xero 앱이나 계정으로 여러 Xero 연결을 만들 수 있어 환경을 분리하거나 여러 비즈니스를 관리할 때 유용합니다.
연결을 만든 후 사용할 프로젝트에 연결할 수 있습니다. 프로젝트에서 빌드하는 사용자는 누구나 채팅에서 Lovable에 연결을 요청할 수 있습니다.
사전 준비
Xero를 연결하기 전에 다음을 준비하세요:
- 연결할 조직에 접근할 수 있는 Xero 계정
- Client ID와 client secret이 있는 Xero 앱(1단계에서 생성)
- Lovable 워크스페이스에서 연결을 만들 수 있는 권한(연결 및 클라이언트를 만들 수 있는 사용자 참고)
이 커넥터를 통한 모든 API 요청은 자체 Xero 앱을 대상으로 실행되며 Xero의 속도 제한에 포함됩니다. 청구와 할당량은 Lovable이 아닌 Xero에서 직접 처리합니다.
1단계: Xero 앱 만들기
커넥터는 자체 Xero 앱을 통한 OAuth로 인증하므로 연결하기 전에 client ID와 client secret이 필요합니다.
Xero 개발자 포털 열기
Xero 계정으로 My Apps에 로그인합니다.
새 앱 만들기
New app을 클릭하고 이름(예: Lovable integration)을 지정한 다음 통합 유형으로 Web app을 선택합니다.
Redirect URI 설정하기
앱의 OAuth 2.0 구성에서 redirect URI를 다음과 정확히 일치하도록 설정합니다:
https://api.lovable.dev/workspaces/connectors/standard/oauth/callbackRedirect URI가 정확히 일치하지 않으면 Xero가 "Invalid redirect_uri" 오류로 승인을 실패합니다.
연결에 필요한 scope 활성화하기
앱의 Configuration 페이지에서 Lovable에서 선택할 모든 scope를 활성화합니다. 2026년 3월 이후 생성된 Xero 앱은 granular scope만 지원하며, Lovable이 요청한 scope가 앱에서 활성화되지 않으면 Xero가 전체 승인을 거부합니다.
인증 정보 복사하기
Configuration 페이지에서 Client id(32자 코드)를 복사하고 Client secret을 생성합니다. 둘 다 복사해 안전하게 보관하세요. 다음 단계에서 필요합니다.
Client secret은 비밀번호처럼 작동합니다. 안전하게 보관하고 공개적으로 공유하지 마세요.
자세한 내용은 Xero OAuth 2.0 가이드를 참고하세요.
2단계: Xero를 Lovable에 연결하기
서로 다른 Xero 앱을 사용해 여러 연결을 만들 수 있습니다.
Connectors에서 Xero 열기
Connectors를 열고 Xero를 선택합니다. 카탈로그를 여는 다른 위치는 커넥터를 찾을 수 있는 위치를 참고하세요.
연결 추가하기
Add connection을 클릭합니다.
연결 구성하기
- Display name: 연결 이름을 지정합니다(예:
Xero Prod). 이 이름은 Lovable 내부에서 연결을 식별할 때만 사용됩니다. - Client ID: Xero 앱의 client ID를 붙여넣습니다.
- Client Secret: 생성한 client secret을 붙여넣습니다.
Scope 검토하기(선택 사항)
Advanced settings를 펼쳐 앱이 요청할 권한을 검토합니다. 일반적인 활용 사례에 필요한 기본 scope가 미리 선택되어 있습니다.
| Scope | 설명 | 기본값 |
|---|---|---|
Refresh access (offline_access) | 다시 연결하지 않고 연결 유지 | 필수 |
Organisation settings (accounting.settings) | 조직 세부 정보, 통화 및 세율 | 필수 |
Contacts (accounting.contacts) | 고객 및 공급업체 | 필수 |
Invoices & bills (accounting.invoices) | 판매 청구서 및 지급 청구서 | 필수 |
Payments (accounting.payments) | 청구서 및 지급 청구서에 대한 결제 | 켜짐 |
Bank transactions (accounting.banktransactions) | 지출 및 수입 거래 | 켜짐 |
Profit and loss report (accounting.reports.profitandloss.read) | 손익계산서 읽기 | 켜짐 |
Balance sheet report (accounting.reports.balancesheet.read) | 대차대조표 읽기 | 켜짐 |
Aged receivables & payables reports (accounting.reports.aged.read) | 매출채권 및 매입채무 연령 분석 보고서 읽기 | 켜짐 |
Manual journals (accounting.manualjournals) | 수동 분개 | 꺼짐 |
Attachments (accounting.attachments) | 회계 레코드의 첨부 파일 | 꺼짐 |
Executive summary report (accounting.reports.executivesummary.read) | 경영 요약 보고서 읽기 | 꺼짐 |
Bank summary report (accounting.reports.banksummary.read) | 은행 요약 보고서 읽기 | 꺼짐 |
Trial balance report (accounting.reports.trialbalance.read) | 시산표 읽기 | 꺼짐 |
Budget summary report (accounting.reports.budgetsummary.read) | 예산 요약 보고서 읽기 | 꺼짐 |
Budgets (accounting.budgets.read) | 예산 읽기 | 꺼짐 |
여기서 선택하는 모든 scope는 Xero 앱의 Configuration 페이지에서도 활성화되어 있어야 합니다. 선택한 scope가 앱에서 활성화되지 않으면 Xero가 "Requested wrong apps scopes" 오류로 승인을 거부합니다.
전체 scope 문서는 Xero scope 참고 자료를 확인하세요.
이 연결을 사용할 사용자 선택하기
Who can use this connection에서 워크스페이스 내 연결 사용자를 결정합니다. 처음에는 본인만 접근할 수 있습니다:
- Only you(기본값): 접근 목록을 그대로 두면 본인만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite specific people: 이메일로 워크스페이스 멤버를 추가하면 본인과 추가한 사용자만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite entire workspace: Invite entire workspace를 클릭하면 Lovable 워크스페이스의 모든 사용자가 연결을 사용할 수 있습니다.
자세한 내용은 연결 및 클라이언트를 사용할 수 있는 사용자를 참고하세요.
Xero에 연결하고 승인하기
Connect를 클릭합니다. Xero 승인 창이 열리므로 브라우저가 팝업을 차단하지 않는지 확인하세요. 차단된 경우 Lovable이 대신 페이지를 이동합니다.
요청되면 Xero에 로그인하고 접근을 허용할 조직을 선택한 뒤 Allow access를 클릭합니다.
확인과 함께 Lovable로 다시 이동합니다.
연결되면 프로젝트에서 빌드하는 사용자는 구성된 연결 수준 접근 권한에 따라 채팅에서 Lovable에 프로젝트와 Xero의 연결을 요청할 수 있습니다. 이후 Lovable 앱에서 Xero 연락처, 청구서, 지급 청구서, 결제, 은행 거래 및 재무 보고서를 활용할 수 있습니다.
제한 사항
Xero 커넥터는 다음을 지원하지 않습니다:
- 연결에서 선택한 scope 밖의 데이터 쓰기. 보고서 scope는 읽기 전용입니다.
accounting.transactions또는accounting.reports.read같은 Xero umbrella scope. 대신 granular scope를 선택하세요.- 최종 사용자별 Xero 로그인. 각 연결은 연결된 모든 프로젝트에서 공유하는 하나의 Xero 계정을 나타냅니다.
Xero 측에서 승인이 취소되면 API 호출이 다시 성공하도록 Lovable에서 통합을 다시 연결해야 합니다.
문제 해결
Xero 연결이 실패하면 아래 섹션에서 가장 흔한 오류와 해결 방법을 확인하세요.
Xero 연결 관리하기
Connectors에서 연결을 관리합니다. **Xero**를 선택한 뒤 연결을 여세요.
- 특정 프로젝트의 Xero 접근만 제거하고 다른 프로젝트에서는 연결을 계속 사용하려면 Unlink projects를 사용합니다. 단계는 연결에서 프로젝트 연결 해제를 참고하세요.
- 워크스페이스에서 연결을 완전히 제거하려면 Delete the connection을 사용합니다. 삭제는 영구적입니다. 연결된 모든 프로젝트에서 인증 정보가 제거되고, 새 연결을 추가할 때까지 Xero을 사용하는 앱 기능이 중단됩니다. 단계와 삭제 권한은 연결 삭제를 참고하세요.