회계·인보이스 플랫폼인 Sevdesk에 앱을 연결해 Lovable 앱에서 연락처, 인보이스, 주문, 전표, 경리 워크플로우를 관리합니다.
Sevdesk에 앱 연결하기
회계·인보이스 플랫폼인 Sevdesk에 앱을 연결해 Lovable 앱에서 연락처, 인보이스, 주문, 전표, 경리 워크플로우를 관리하세요.
Sevdesk는 비즈니스 연락처, 인보이스, 주문, 전표, 결제, 경리 워크플로우를 관리하는 회계·인보이스 플랫폼입니다. Sevdesk connector를 통해 Lovable 앱이 연결된 Sevdesk 계정으로 Sevdesk API를 호출할 수 있습니다.
Sevdesk를 연결하면 앱은 다음 작업이 가능합니다.
- 고객, 공급업체, 연락처 주소 조회 및 관리
- 인보이스, 주문, 전표, 신용 메모 생성 및 조회
- 결제와 계정 데이터를 기반으로 경리 워크플로우 구축
- 국가, 세금 규칙, 카테고리 같은 회계 리소스 쿼리
앱에 Sevdesk 계정과 연동된 운영 회계 데이터, 재무 워크플로우, 백오피스 도구가 필요할 때 Sevdesk가 적합합니다.
주요 활용 사례 및 예시 앱
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| 인보이스 대시보드 | Use Sevdesk and build an invoice dashboard that lists open invoices, due dates, customers, and payment status. | 하나의 내부 뷰에서 인보이스 업무를 추적합니다. 앱이 Sevdesk에서 인보이스와 연락처 데이터를 가져와 재무팀이 미결 업무를 확인할 수 있습니다. |
| 고객 회계 포털 | Use Sevdesk and build a customer portal that shows invoices, orders, and credit notes for each customer. | 고객에게 회계 문서 접근 권한을 제공합니다. 앱이 Sevdesk에서 적절한 레코드를 가져와 브랜드 포털에 표시합니다. |
| 연락처 관리 도구 | Use Sevdesk and build an internal tool for searching customers, suppliers, and contact addresses. | 회계 연락처를 쉽게 접근할 수 있게 합니다. 앱이 Sevdesk 연락처(개인 연락처 포함)를 읽어 팀에게 고객·공급업체 데이터를 위한 집중된 인터페이스를 제공합니다. |
| 전표 검토 워크플로우 | Use Sevdesk and build a voucher review workflow for incoming expenses and receipts. | 경비 검토를 안내형 앱으로 옮깁니다. 앱이 Sevdesk에서 전표 레코드를 생성하거나 조회하고 운영자가 누락된 세부 정보를 검토할 수 있게 합니다. |
| 주문 추적 앱 | Use Sevdesk and build an order tracking app that shows active orders and related customer records. | 인보이스가 되기 전 주문을 모니터링합니다. 앱이 Sevdesk에서 주문과 관련 연락처를 가져와 영업·재무 후속 조치에 활용합니다. |
| 경리 리소스 브라우저 | Use Sevdesk and build an admin page that lists tax rules, countries, categories, and check accounts. | 재무 워크플로우를 위한 참조 데이터를 표시합니다. 앱이 Sevdesk 회계 리소스를 읽어 운영자가 내부 워크플로우에서 일관된 값을 사용할 수 있게 합니다. |
Sevdesk 연결하기
Workspace admin과 owner가 Sevdesk를 연결할 수 있습니다.
서로 다른 API 토큰을 사용해 여러 Sevdesk 연결을 만들 수 있으며, 다른 Sevdesk 계정이나 사용자를 연결할 때 유용합니다.
연결이 생성되면 Sevdesk는 workspace의 모든 프로젝트에서 사용 가능합니다. 프로젝트에서 작업하는 누구든 Lovable 채팅에서 프로젝트를 연결해 달라고 요청할 수 있습니다.
사전 준비
Sevdesk를 연결하기 전에 다음을 준비하세요.
- API 접근이 가능한 Sevdesk 계정
- Sevdesk API 토큰
- Lovable workspace owner 또는 admin 역할
이 connector를 통한 모든 API 요청은 Sevdesk API 토큰을 사용합니다. API 사용량, 플랜 한도, 청구는 Lovable이 아닌 Sevdesk에서 직접 관리됩니다.
1단계: Sevdesk API 토큰 발급
Sevdesk API 토큰으로 Lovable 앱이 Sevdesk API에 인증합니다.
Sevdesk API 토큰을 찾는 방법은 다음과 같습니다.
Sevdesk 계정 열기
연결할 계정으로 Sevdesk에 로그인합니다.
사용자 설정 열기
Settings → Users로 이동한 뒤 API 접근을 사용할 사용자를 엽니다.
API 토큰 복사
API token 필드에서 32자리 토큰을 복사합니다.
API 토큰은 비밀번호와 같습니다. 안전하게 보관하고 공개적으로 공유하지 마세요. 다음 단계에서 필요합니다.
자세한 내용은 Sevdesk 문서를 참고하세요. Sevdesk API 문서
2단계: Lovable에 Sevdesk 연결하기
서로 다른 API 토큰을 사용해 여러 연결을 만들 수 있습니다.
Connectors에서 Sevdesk 열기
Connectors → App connectors로 이동해 Sevdesk를 선택합니다.
연결 추가
Add connection을 클릭합니다.
연결 설정
- Display name: 연결 이름을 입력합니다. 예:
Sevdesk Prod - API token: Sevdesk 32자리 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를 클릭합니다.
연결이 완료되면 프로젝트에서 작업하는 누구든(구성된 connection-level access 기준) Lovable 채팅에서 프로젝트를 Sevdesk에 연결해 달라고 요청할 수 있습니다. Lovable 앱은 이후 Sevdesk 회계, 연락처, 인보이스, 주문, 전표, 결제 데이터를 활용할 수 있습니다.
연락처 활용
Sevdesk의 연락처 API는 조직과 개인 연락처를 분리합니다. Lovable에게 연락처 목록을 요청할 때 고객, 공급업체, 개인 연락처가 모두 표시되어야 한다면 개인 연락처도 포함하도록 지정하세요.
예를 들어 Lovable에게 다음과 같이 요청하세요.
Use Sevdesk and build a contacts page that lists organizations and person contacts. Include person contacts from Sevdesk when fetching /Contact.제한 사항
Sevdesk connector는 다음을 수행할 수 없습니다.
- Sevdesk 계정 또는 API 토큰 생성
- API 토큰 자동 교체. 토큰을 교체하려면 Sevdesk에서 토큰을 업데이트하고 Lovable 연결을 업데이트하세요.
- 엔드 유저별 Sevdesk 인증 지원. 각 연결은 연결된 모든 프로젝트에서 공유되는 단일 Sevdesk 계정을 나타냅니다.
- 연결된 Sevdesk 사용자의 API 한도, 플랜 한도, 권한 우회
Sevdesk 연결에서 프로젝트 연결 해제하기
Editor 이상의 권한을 가진 멤버는 연결 자체를 삭제하지 않고 특정 프로젝트의 연결을 해제할 수 있습니다. 다른 프로젝트는 연결을 계속 사용할 수 있습니다.
프로젝트 연결을 해제하는 방법은 다음과 같습니다.
Connectors 열기
Connectors를 열고 App connectors로 이동해 **Sevdesk**를 선택합니다.
연결 열기
관리할 연결을 엽니다.
프로젝트 선택
Linked projects 아래에서 연결 해제할 프로젝트를 선택합니다.
확인
Unlink projects를 클릭하고 확인합니다.
연결이 해제되면 해당 프로젝트는 이 연결을 통해 Sevdesk에 접근할 수 없습니다. 프로젝트에 다시 Sevdesk가 필요하다면 사용 가능한 연결에 다시 연결하면 됩니다.
Sevdesk 연결 삭제하기
Workspace admin과 owner는 Sevdesk 연결을 삭제할 수 있습니다. 연결을 생성했거나 명시적으로 접근 권한을 부여받은 멤버도 삭제할 수 있습니다.
연결 삭제는 영구적이며 되돌릴 수 없습니다. 연결된 모든 프로젝트에서 자격 증명이 제거되며 이 연결을 사용하는 앱은 새 연결이 추가될 때까지 작동을 멈춥니다.
삭제 전에 Linked projects 섹션에서 현재 연결을 사용 중인 프로젝트를 확인하세요.
연결을 삭제하는 방법은 다음과 같습니다.
Connectors 열기
Connectors를 열고 App connectors로 이동해 **Sevdesk**를 선택합니다.
연결 열기
제거할 연결을 엽니다.
연결된 프로젝트 확인
Linked projects 섹션을 확인합니다.
삭제
Delete this connection 아래에서 Delete를 클릭하고 확인합니다.