회계·청구서 플랫폼인 Lexware에 앱을 연결해 연락처, 청구서, 전표, 품목, 회계 이벤트를 Lovable 앱에서 처리합니다.
Lexware에 앱 연결하기
회계·청구서 플랫폼인 Lexware에 앱을 연결해 연락처, 청구서, 전표, 품목, 회계 이벤트를 Lovable 앱에서 활용하세요.
Lexware는 비즈니스 연락처, 문서, 전표, 결제, 장부 워크플로우를 관리하는 회계·청구서 플랫폼입니다. Lexware connector를 사용하면 Lovable 앱이 연결된 Lexware 계정을 통해 Lexware API를 호출할 수 있습니다. Lexware의 운영 회계 데이터를 읽거나 관리해야 하는 앱을 위해 설계되었습니다.
Lexware를 연결하면 앱은 다음 작업이 가능합니다.
- 회사 프로필과 회계 설정 읽기
- 연락처, 품목, 청구서, 견적, 전표 생성 및 조회
- 청구서 PDF 등 생성된 회계 문서 다운로드
- Lexware 이벤트 구독으로 청구서·결제·연락처 변경에 반응
- Lexware 비즈니스 데이터를 기반으로 장부, 영업, 재무 워크플로우 구축
Lexware는 Lexware 계정에 연결된 회계 데이터, 문서 워크플로우, 백오피스 자동화가 필요한 앱에 적합합니다.
주요 활용 사례 및 예시 앱
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| 청구서 운영 대시보드 | Lexware를 사용해 미결 청구서, 결제 상태, 고객 상세 정보를 나열하는 대시보드를 만들어줘. | 청구서 업무를 하나의 내부 화면에서 추적합니다. 앱이 Lexware에서 청구서와 연락처 데이터를 가져와 재무팀이 미결 업무를 검토할 수 있게 합니다. |
| 고객 회계 포털 | Lexware를 사용해 청구서, 견적, 다운로드 가능한 PDF를 보여주는 고객 포털을 만들어줘. | 고객이 회계 문서에 직접 접근합니다. 앱이 Lexware에서 적절한 문서를 가져와 브랜드 포털로 제공합니다. |
| 전표 접수 워크플로우 | Lexware를 사용해 수입 경비의 전표 업로드·검토 워크플로우를 만들어줘. | 경비 접수를 가이드된 앱으로 이동합니다. 앱이 Lexware에서 전표 레코드를 생성·조회하고 운영자가 누락된 상세 정보를 검토하도록 돕습니다. |
| 연락처 관리 도구 | Lexware를 사용해 비즈니스 연락처를 검색하고 업데이트하는 내부 도구를 만들어줘. | 고객·공급업체 레코드를 쉽게 접근할 수 있게 합니다. 앱이 Lexware에서 연락처 레코드를 읽어 팀에게 재무 관련 고객 데이터를 위한 집중된 인터페이스를 제공합니다. |
| 영업 견적 트래커 | Lexware를 사용해 견적 상태와 관련 연락처를 보여주는 견적 트래커를 만들어줘. | 청구서가 되기 전 견적을 모니터링합니다. 앱이 Lexware에서 견적과 관련 연락처 데이터를 가져와 영업·재무 후속 조치에 활용합니다. |
| 회계 이벤트 모니터 | Lexware를 사용해 청구서, 결제, 연락처 변경을 위한 이벤트 모니터를 만들어줘. | 앱 워크플로우에서 Lexware 변경에 반응합니다. 앱이 이벤트 구독으로 변경 알림을 받고 Lexware에서 업데이트된 리소스를 가져옵니다. |
Lexware 연결하기
Workspace admins와 owners가 Lexware를 연결할 수 있습니다.
다른 API 키를 사용해 여러 Lexware 연결을 생성할 수 있습니다. 환경을 분리하거나(예: 개발·프로덕션) 다른 Lexware 계정을 연결할 때 유용합니다.
연결이 생성되면 workspace 내 모든 프로젝트에서 Lexware를 사용할 수 있습니다. 프로젝트에서 작업하는 누구든 Lovable 채팅에서 프로젝트를 연결해달라고 요청할 수 있습니다.
사전 준비
Lexware를 연결하기 전에 다음을 준비하세요.
- 공개 API에 접근할 수 있는 Lexware 계정
- Lexware 공개 API 키
- Lovable workspace owner 또는 admin 역할
이 connector를 통한 모든 API 요청은 Lexware API 키를 사용합니다. API 사용량, 플랜 제한, 결제는 Lovable이 아닌 Lexware가 직접 처리합니다.
Step 1: Lexware API 키 가져오기
Lexware 공개 API 키로 Lovable 앱이 Lexware API에 인증합니다. 환경이나 앱별로 별도 키를 생성할 수 있습니다.
Lexware API 키를 생성하려면 다음 단계를 따르세요.
Lexware 공개 API 페이지 열기
Lexware에 로그인하고 Public API 페이지를 엽니다. 로그인을 요청하면 완료 후 링크를 다시 엽니다.
API 키 생성하기
공개 API 키를 생성합니다. Lexware에서 이름을 요청하면 예를 들어 Lovable integration처럼 알아보기 쉬운 이름을 지정하세요.
키 복사하기
API 키를 복사하고 안전하게 보관합니다. 다음 단계에서 필요합니다.
API 키는 비밀번호처럼 기능합니다. 안전하게 보관하고 절대 공개적으로 공유하지 마세요.
자세한 내용은 Lexware 문서를 참고하세요. Lexware API documentation.
Step 2: Lexware를 Lovable에 연결하기
다른 API 키를 사용해 여러 연결을 생성할 수 있습니다.
Connectors에서 Lexware 열기
Connectors → App connectors로 이동해 Lexware를 선택합니다.
연결 추가하기
Add connection을 클릭합니다.
연결 구성하기
- Display name: 예를 들어
Lexware Prod처럼 연결 이름을 지정합니다. - API key: Lexware 공개 API 키를 붙여넣습니다.
이 연결에 접근할 수 있는 사람 선택하기
Who can access this connection 아래에서 workspace 내 누가 이 연결을 사용할 수 있는지 결정합니다.
- Only you (기본): 연결을 생성한 사람만 사용할 수 있습니다.
- Invite specific people: 명시적으로 추가된 workspace 멤버만 사용할 수 있습니다.
- Invite entire workspace: Invite entire workspace를 클릭해 Lovable workspace 전체에 공개합니다.
자세한 내용은 Connection-level access를 참고하세요.
연결하기
Connect를 클릭합니다.
연결이 완료되면 프로젝트에서 작업하는 누구든 Lovable 채팅에서 프로젝트를 Lexware에 연결해달라고 요청할 수 있습니다(구성된 connection-level access 기준). Lovable 앱은 Lexware 회계, 연락처, 청구서, 견적, 전표, 품목 데이터를 활용할 수 있습니다.
Lexware 이벤트 구독 활용하기
Lexware는 청구서, 결제, 연락처, 품목, 전표, 견적, 관련 문서 이벤트 등 변경 알림을 위한 이벤트 구독을 지원합니다.
Lovable에 웹훅 기반 Lexware 워크플로우를 구축해달라고 요청하면 앱에 공개 HTTPS 콜백 엔드포인트가 필요합니다. Lexware가 해당 엔드포인트로 이벤트 알림을 전송하면, 앱이 콜백 서명을 검증한 후 Lexware에서 변경된 리소스를 가져옵니다.
Lexware는 초당 약 2건의 낮은 전역 속도 제한을 적용합니다. 가능한 곳에서 페이지네이션을 사용하고, 불필요한 병렬 요청을 피하며, 속도 제한 응답은 백오프를 적용해 재시도하세요.
제한사항
Lexware connector는 다음 작업을 지원하지 않습니다.
- Lexware 계정이나 API 키 생성
- API 키 자동 교체. 키를 교체하려면 Lexware에서 새 키를 생성하고 Lovable 연결을 업데이트하세요.
- Lexware API 키 변경 후 이벤트 구독 유지. 새 키로 재연결 후 Lexware 이벤트 구독을 다시 생성하세요.
- 최종 사용자별 Lexware 인증. 각 연결은 연결된 프로젝트 전체가 공유하는 단일 Lexware 계정을 나타냅니다.
Lexware 연결에서 프로젝트 연결 해제하기
Editors 이상은 연결 자체를 삭제하지 않고 특정 프로젝트만 연결에서 제거할 수 있습니다. 연결은 다른 프로젝트에서 계속 사용할 수 있습니다.
프로젝트 연결을 해제하려면 다음 단계를 따르세요.
Connectors 열기
Connectors를 열고 App connectors로 이동한 후 **Lexware**를 선택합니다.
연결 열기
관리할 연결을 엽니다.
프로젝트 선택하기
Linked projects 아래에서 연결을 해제할 프로젝트를 체크합니다.
확인하기
Unlink projects를 클릭하고 확인합니다.
연결 해제 후 해당 프로젝트는 이 연결을 통해 Lexware에 접근할 수 없습니다. 다시 Lexware가 필요하면 사용 가능한 연결에 프로젝트를 연결하면 됩니다.
Lexware 연결 삭제하기
Workspace admins와 owners가 Lexware 연결을 삭제할 수 있습니다. 다른 멤버는 본인이 생성했거나 명시적으로 접근 권한을 부여받은 연결만 삭제할 수 있습니다.
연결 삭제는 영구적이며 취소할 수 없습니다. 연결된 모든 프로젝트에서 자격증명이 제거되고, 이 연결을 사용하는 앱은 새 연결이 추가될 때까지 작동을 멈춥니다.
삭제 전에 Linked projects 섹션에서 현재 이 연결을 사용하는 프로젝트를 확인하세요.
연결을 삭제하려면 다음 단계를 따르세요.
Connectors 열기
Connectors를 열고 App connectors로 이동한 후 **Lexware**를 선택합니다.
연결 열기
제거할 연결을 엽니다.
연결된 프로젝트 검토하기
Linked projects 섹션을 검토합니다.
삭제하기
Delete this connection 아래에서 Delete를 클릭하고 확인합니다.