회계·청구서 플랫폼인 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 연결하기
Lexware 연결을 만들 수 있는 사용자는 플랜과 워크스페이스 설정에 따라 다릅니다. 앱 + 채팅 커넥터는 Free, Pro, Business 플랜에서 기본 제공됩니다. Enterprise 플랜에서는 처음에 사실상 비활성화되어 있습니다. Admin이 Connectors → Admin settings → App + chat connectors에서 변경하기 전까지 연결 및 클라이언트를 만들 수 있는 사용자의 기본값이 No one이기 때문입니다.
다른 API 키를 사용해 여러 Lexware 연결을 생성할 수 있습니다. 환경을 분리하거나(예: 개발·프로덕션) 다른 Lexware 계정을 연결할 때 유용합니다.
연결이 생성되면 사용할 프로젝트에 연결을 링크할 수 있습니다. 프로젝트에서 빌드하는 사람은 누구나 채팅에서 Lovable에게 프로젝트를 이 연결에 링크해 달라고 요청할 수 있습니다.
사전 준비
Lexware를 연결하기 전에 다음을 준비하세요.
- 공개 API에 접근할 수 있는 Lexware 계정
- Lexware 공개 API 키
- Lovable workspace에서 연결을 만들 수 있는 권한(연결 및 클라이언트를 만들 수 있는 사용자 참조)
이 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로 이동해 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 전체에 공개합니다.
자세한 내용은 연결 수준 접근을 참고하세요.
연결하기
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 연결 관리
연결은 Connectors에서 관리합니다. **Lexware**을 선택한 다음 연결을 여세요.
- Unlink projects를 사용하면 다른 프로젝트에서 연결을 계속 사용할 수 있도록 유지하면서 특정 프로젝트의 Lexware 접근 권한만 제거할 수 있습니다. 단계별 절차는 연결에서 프로젝트 연결 해제를 참고하세요.
- Delete the connection을 사용하면 워크스페이스에서 연결을 완전히 제거할 수 있습니다. 삭제는 영구적이며 연결된 모든 프로젝트에서 자격 증명이 제거되고, Lexware을 사용하는 앱 기능은 새 연결을 추가할 때까지 작동하지 않습니다. 단계와 삭제 권한은 연결 삭제를 참고하세요.