회계·인보이스 플랫폼인 Sevdesk에 앱을 연결해 Lovable 앱에서 연락처, 인보이스, 주문, 전표, 경리 워크플로우를 관리합니다.
Sevdesk에 앱 연결하기
회계·인보이스 플랫폼인 Sevdesk에 앱을 연결해 Lovable 앱에서 연락처, 인보이스, 주문, 전표, 경리 워크플로우를 관리하세요.
Sevdesk는 비즈니스 연락처, 인보이스, 주문, 전표, 결제, 경리 워크플로우를 관리하는 회계·인보이스 플랫폼입니다. Sevdesk connector를 통해 Lovable 앱이 연결된 Sevdesk 계정으로 Sevdesk API를 호출할 수 있습니다. Sevdesk에 연결된 운영 회계 데이터, 재무 워크플로우, 백오피스 도구가 필요한 앱을 위해 설계되었습니다.
이 통합은 앱 + 채팅 커넥터로 제공됩니다. 하나의 공유 연결이 빌드 중 채팅과 게시된 앱 모두에서 작동합니다.
Sevdesk를 연결하면 앱은 다음 작업이 가능합니다.
- 고객, 공급업체, 연락처 주소 조회 및 관리
- 인보이스, 주문, 전표, 신용 메모 생성 및 조회
- 결제와 계정 데이터를 기반으로 경리 워크플로우 구축
- 국가, 세금 규칙, 카테고리 같은 회계 리소스 쿼리
이미 Sevdesk로 장부를 관리하는 팀이 그 레코드를 읽거나 업데이트하는 Lovable 앱을 원할 때 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 연결하기
Sevdesk 연결을 만들 수 있는 사용자는 플랜과 워크스페이스 설정에 따라 다릅니다. 앱 + 채팅 커넥터는 Free, Pro, Business 플랜에서 기본 제공됩니다. Enterprise 플랜에서는 처음에 사실상 비활성화되어 있습니다. Admin이 Connectors → Admin settings → App + chat connectors에서 변경하기 전까지 연결 및 클라이언트를 만들 수 있는 사용자의 기본값이 No one이기 때문입니다.
서로 다른 API 토큰을 사용해 여러 Sevdesk 연결을 만들 수 있으며, 다른 Sevdesk 계정이나 사용자를 연결할 때 유용합니다.
연결이 생성되면 사용할 프로젝트에 연결을 링크할 수 있습니다. 프로젝트에서 빌드하는 사람은 누구나 채팅에서 Lovable에게 프로젝트를 이 연결에 링크해 달라고 요청할 수 있습니다.
사전 준비
Sevdesk를 연결하기 전에 다음을 준비하세요.
- API 접근이 가능한 Sevdesk 계정
- Sevdesk API 토큰
- Lovable workspace에서 연결을 만들 수 있는 권한(연결 및 클라이언트를 만들 수 있는 사용자 참조)
이 connector를 통한 모든 API 요청은 Sevdesk API 토큰을 사용합니다. API 사용량, 플랜 한도, 청구는 Lovable이 아닌 Sevdesk에서 직접 관리됩니다.
1단계: Sevdesk API 토큰 발급
Sevdesk API 토큰으로 Lovable 앱이 하나의 Sevdesk 사용자 자격으로 Sevdesk API에 인증합니다. 연결은 그 사용자가 Sevdesk에서 할 수 있는 일을 할 수 있습니다.
Sevdesk API 토큰을 찾는 방법은 다음과 같습니다.
Sevdesk 계정 열기
연결할 계정으로 Sevdesk에 로그인합니다.
사용자 설정 열기
Settings → Users로 이동한 뒤 API 접근을 사용할 사용자를 엽니다.
API 토큰 복사
API token 필드를 찾아 토큰을 복사합니다. 토큰은 32자이며 숫자와 a부터 f까지의 문자로만 구성됩니다.
API 토큰은 비밀번호와 같습니다. 안전하게 보관하고 공개적으로 공유하지 마세요. 다음 단계에서 필요합니다.
자세한 내용은 Sevdesk 문서를 참고하세요. Sevdesk API 문서
2단계: Lovable에 Sevdesk 연결하기
서로 다른 API 토큰을 사용해 여러 연결을 만들 수 있습니다.
Connectors에서 Sevdesk 열기
Connectors를 열고 Sevdesk를 선택합니다. 카탈로그를 여는 다른 위치는 커넥터를 찾을 수 있는 위치를 참고하세요.
연결 추가
Add connection을 클릭합니다.
연결 설정
- Display name: 연결의 이름을 지정합니다(예:
Sevdesk Prod). 이 이름은 Lovable 내부에서 연결을 식별하는 데만 사용됩니다. - API token: 32자 Sevdesk API 토큰을 붙여넣습니다.
이 연결을 사용할 수 있는 사람 선택
Sharing 아래에서 연결은 기본적으로 본인에게만 공개되며 Private 라벨이 표시됩니다. 공유하려면 Share with others를 클릭합니다. 그런 다음 이메일로 워크스페이스 멤버를 추가하거나 Invite entire workspace를 클릭해 Lovable 워크스페이스의 모든 사용자가 연결을 사용할 수 있게 합니다.
자세한 내용은 연결 및 클라이언트를 사용할 수 있는 사용자를 참고하세요.
연결 완료
Connect를 클릭합니다. Lovable은 연결을 저장하기 전에 Sevdesk API로 토큰을 검증합니다.
연결이 완료되면 프로젝트에서 작업하는 누구든(구성된 connection-level access 기준) Lovable 채팅에서 프로젝트를 Sevdesk에 연결해 달라고 요청할 수 있습니다. Lovable 앱은 이후 Sevdesk 회계, 연락처, 인보이스, 주문, 전표, 결제 데이터를 활용할 수 있습니다.
연락처 활용
Sevdesk의 연락처 API는 조직과 개인 연락처를 분리하며, 일반 연락처 목록은 조직만 반환합니다. Lovable에게 연락처 목록을 요청할 때는 개인 연락처도 포함해야 한다고 말하세요. 그러지 않으면 개별 고객과 공급업체가 나타나지 않습니다.
예를 들어 Lovable에게 다음과 같이 요청하세요.
Use Sevdesk and build a contacts page that lists organizations and person contacts from Sevdesk.제한 사항
Sevdesk connector는 다음을 수행할 수 없습니다.
- Sevdesk 계정 또는 API 토큰 생성
- API 토큰 자동 교체. 토큰을 교체하려면 Sevdesk에서 새 토큰을 생성한 뒤 Lovable 연결을 업데이트하세요.
- 토큰이 속한 Sevdesk 사용자의 권한 우회
- 엔드 유저별 Sevdesk 로그인 지원. 각 연결은 링크된 모든 프로젝트에서 공유되는 단일 Sevdesk 사용자를 나타냅니다.
Sevdesk 연결 관리
연결은 Connectors에서 관리합니다. **Sevdesk**을 선택한 다음 연결을 여세요.
- Unlink projects를 사용하면 다른 프로젝트에서 연결을 계속 사용할 수 있도록 유지하면서 특정 프로젝트의 Sevdesk 접근 권한만 제거할 수 있습니다. 단계별 절차는 연결에서 프로젝트 연결 해제를 참고하세요.
- Delete the connection을 사용하면 워크스페이스에서 연결을 완전히 제거할 수 있습니다. 삭제는 영구적이며 연결된 모든 프로젝트에서 자격 증명이 제거되고, Sevdesk을 사용하는 앱 기능은 새 연결을 추가할 때까지 작동하지 않습니다. 단계와 삭제 권한은 연결 삭제를 참고하세요.