리테일 POS 플랫폼인 Lightspeed Retail X-Series에 앱을 연결해 제품, 재고, 매장, 고객, 매출 데이터를 Lovable 앱에서 활용합니다.
Lightspeed에 앱 연결하기
리테일 POS 플랫폼인 Lightspeed Retail X-Series에 앱을 연결해 Lovable 앱에서 제품, 재고, 매장, 고객, 매출 데이터를 활용하세요.
Lightspeed Retail X-Series는 제품, 재고, 매장, 고객, 결제, 매출을 관리하는 리테일 POS 플랫폼입니다. Lightspeed connector를 사용하면 Lovable 앱이 연결된 Lightspeed 스토어를 통해 Retail X-Series API를 호출할 수 있습니다.
Lightspeed를 연결하면 앱은 다음 작업이 가능합니다.
- 매장, 레지스터, 결제 유형, 리테일 설정 목록 조회
- 제품 카탈로그, 브랜드, 가격표, 재고 수준 읽기
- Retail X-Series 데이터로 고객·매출 대시보드 구축
- 재고, 프로모션, 기프트 카드, 스토어 크레딧 관련 워크플로우 구축
기본적으로 Lightspeed 연결은 일반적인 리테일 워크플로우를 위한 읽기 scope를 요청합니다. 앱에서 Lightspeed의 리소스를 생성하거나 업데이트해야 할 경우 추가 고급 scope를 활성화할 수 있습니다.
주요 활용 사례 및 예시 앱
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| 리테일 재고 대시보드 | Lightspeed를 사용해 매장별 재고, 재고 부족 제품, 최근 재고 변동을 보여주는 재고 대시보드를 만들어줘. | 연결된 매장 전체의 재고를 모니터링합니다. 앱이 Lightspeed에서 제품·재고 데이터를 읽어 주의가 필요한 품목을 파악하도록 돕습니다. |
| 매출 성과 대시보드 | Lightspeed를 사용해 일별 매출, 결제 유형, 인기 제품, 매장 필터가 있는 매출 대시보드를 만들어줘. | 한 화면에서 매장 성과를 추적합니다. 앱이 Lightspeed에서 매출, 결제, 제품, 매장 데이터를 읽어 리테일 팀이 POS를 열지 않고도 추이를 검토할 수 있게 합니다. |
| 고객 구매 이력 포털 | Lightspeed를 사용해 연락처, 고객 그룹, 최근 구매 내역을 보여주는 고객 조회 도구를 만들어줘. | 고객 상담 전 직원에게 맥락을 제공합니다. 앱이 Lightspeed에서 고객·매출 데이터를 결합해 고객지원·매장 운영 화면에 집중적으로 제공합니다. |
| 프로모션 기획 도구 | Lightspeed를 사용해 캠페인 시작 전 제품, 브랜드, 가격, 현재 재고를 나열하는 프로모션 기획 도구를 만들어줘. | 실시간 카탈로그 데이터로 리테일 캠페인을 기획합니다. 앱이 Lightspeed에서 제품, 가격표, 프로모션, 재고를 읽어 머천다이저가 적합한 품목을 선택할 수 있게 합니다. |
| 기프트 카드·스토어 크레딧 트래커 | Lightspeed를 사용해 기프트 카드 잔액, 스토어 크레딧 거래, 관련 고객 레코드를 추적하는 트래커를 만들어줘. | Lightspeed에서 고객 가치 잔액을 검토합니다. 앱이 기프트 카드·스토어 크레딧 데이터를 읽고 매장 팀을 위해 고객 레코드와 연결합니다. |
| 공급업체·세율 참조 브라우저 | Lightspeed를 사용해 운영팀을 위해 공급업체, 세율, 매장, 사용자 레코드를 나열하는 어드민 페이지를 만들어줘. | 내부 워크플로우를 위해 Retail X-Series 참조 데이터를 제공합니다. 앱이 공급업체, 세율, 매장, 사용자 데이터를 읽어 팀이 일관된 운영 값을 사용할 수 있게 합니다. |
Lightspeed 연결하기
Workspace admins와 owners가 Lightspeed를 연결할 수 있습니다. App connectors는 Free, Pro, Business 플랜에서 기본으로 활성화됩니다. Enterprise 플랜에서는 workspace admins와 owners가 workspace의 app connector 가용성을 관리할 수 있습니다.
다른 Lightspeed 스토어나 OAuth 앱을 사용해 여러 Lightspeed 연결을 생성할 수 있습니다. 환경을 분리하거나 여러 리테일 계정을 관리할 때 유용합니다.
연결이 생성되면 workspace 내 모든 프로젝트에서 Lightspeed를 사용할 수 있습니다. 프로젝트에서 작업하는 누구든 Lovable 채팅에서 프로젝트를 연결해달라고 요청할 수 있습니다.
사전 준비
Lightspeed를 연결하기 전에 다음을 준비하세요.
- Lightspeed Retail X-Series 계정 및 스토어
- Lightspeed 개발자 대시보드 접근 권한
- client ID와 client secret이 있는 Lightspeed OAuth 애플리케이션
https://{domain_prefix}.retail.lightspeed.app에서 스토어 도메인 prefix- Lovable workspace owner 또는 admin 역할
이 connector를 통한 모든 API 요청은 Lightspeed Retail X-Series API 제한과 연결된 계정의 권한에 적용됩니다. 결제와 할당량은 Lovable이 아닌 Lightspeed가 직접 처리합니다.
Lightspeed 연결 설정하기
Lightspeed OAuth 애플리케이션 생성 또는 열기
Lightspeed 개발자 대시보드에 로그인합니다. Lovable용 OAuth 애플리케이션을 생성하거나 사용할 기존 애플리케이션을 엽니다.
리다이렉트 URI 구성하기
Lightspeed OAuth 애플리케이션에서 연결 흐름 중 Lovable이 보여주는 리다이렉트 URI를 추가합니다. 애플리케이션을 저장한 후 Client ID와 Client Secret을 복사합니다.
Connectors에서 Lightspeed 열기
Connectors → App connectors로 이동해 Lightspeed를 선택합니다.
연결 추가하기
Add connection을 클릭합니다.
연결 구성하기
연결 상세 정보를 입력합니다.
- Display name: 예를 들어
Lightspeed Prod처럼 연결 이름을 지정합니다. - Client ID: Lightspeed OAuth 애플리케이션의 client ID를 붙여넣습니다.
- Client Secret: Lightspeed OAuth 애플리케이션의 client secret을 붙여넣습니다.
- Domain Prefix:
https://{domain_prefix}.retail.lightspeed.app에서 스토어 prefix를 입력합니다. 예:my-store.
Scope 검토하기 (선택)
Advanced settings를 펼쳐 앱이 요청하는 권한을 검토합니다. 일반적인 읽기 전용 리테일 워크플로우를 위한 기본 scope가 미리 선택되어 있습니다.
| Scope | 설명 | 기본값 |
|---|---|---|
Retailer configuration (retailer:read) | 로열티, 시간대, 국가, 통화 등 계정 구성 읽기 | 켜짐 |
Outlets (outlets:read) | 매장 읽기 | 켜짐 |
Registers (registers:read) | 레지스터 읽기 | 켜짐 |
Payment types (payment_types:read) | 내부 결제 유형 제외한 결제 유형 읽기 | 켜짐 |
Products (products:read) | 원가 제외한 제품, 제품 유형, 제품 이미지, 브랜드, 태그 읽기 | 켜짐 |
Price books (products:read:price_books) | 제품 가격표 읽기 | 켜짐 |
Inventory (inventory:read) | 현재 및 과거 제품 재고 수준 읽기 | 켜짐 |
Customers (customers:read) | 고객과 고객 그룹 읽기 | 켜짐 |
Sales (sales:read) | 매출과 결제 읽기 | 켜짐 |
Fulfillments (fulfillments:read) | 주문 이행 읽기 | 켜짐 |
Promotions (promotions:read) | 프로모션과 프로모션 제품 적격성 읽기 | 켜짐 |
Gift cards (gift_cards:read) | 기프트 카드와 기프트 카드 거래 읽기 | 켜짐 |
Store credits (store_credits:read) | 스토어 크레딧 거래 읽기 | 켜짐 |
Suppliers (suppliers:read) | 공급업체 읽기 | 켜짐 |
Taxes (taxes:read) | 해당하는 경우 세율, 세금 규칙, 세금 그룹 읽기 | 켜짐 |
Users (users:read) | 비밀번호 제외한 사용자 정보 읽기 | 켜짐 |
쓰기, 감사, 채널, 위탁, 결제, 일련번호, 서비스, 웹훅 scope는 추가로 제공되지만 기본값은 꺼짐입니다. 앱에 필요한 scope만 선택하세요.
전체 scope 문서는 Lightspeed의 OAuth scope 레퍼런스를 참고하세요.
이 연결에 접근할 수 있는 사람 선택하기
Who can access this connection 아래에서 workspace 내 누가 이 연결을 사용할 수 있는지 결정합니다.
- Only you (기본): 연결을 생성한 사람만 사용할 수 있습니다.
- Invite specific people: 명시적으로 추가된 workspace 멤버만 사용할 수 있습니다.
- Invite entire workspace: Invite entire workspace를 클릭해 Lovable workspace 전체에 공개합니다.
자세한 내용은 Connection-level access를 참고하세요.
Lightspeed에 연결하고 권한 부여하기
Connect를 클릭합니다. Lightspeed 인증 창이 열리므로 브라우저가 팝업을 차단하지 않는지 확인하세요. 차단된 경우 Lovable이 대신 리다이렉트합니다.
요청 시 Lightspeed에 로그인하고, 요청된 권한을 검토한 후 Allow를 클릭합니다.
확인과 함께 Lovable로 다시 리다이렉트됩니다.
연결이 완료되면 프로젝트에서 작업하는 누구든 Lovable 채팅에서 프로젝트를 Lightspeed에 연결해달라고 요청할 수 있습니다(구성된 connection-level access 기준). Lovable 앱은 Lightspeed Retail X-Series의 제품, 재고, 매장, 고객, 매출, 관련 리테일 데이터를 활용할 수 있습니다.
제한사항
Lightspeed connector는 다음 작업을 지원하지 않습니다.
- Lightspeed 계정이나 OAuth 애플리케이션 생성
- Lightspeed API 제한, 플랜 제한, 연결된 사용자 권한, 선택된 OAuth scope 우회
- 최종 사용자별 Lightspeed 로그인. 각 연결은 연결된 모든 프로젝트가 공유하는 단일 Lightspeed 스토어 인증을 나타냅니다.
- Lovable 관리 웹훅 구독을 통한 Lightspeed 웹훅 이벤트 전달
Lightspeed 측에서 인증이 취소되면 API 호출이 성공하기 전에 Lovable에서 통합을 다시 연결해야 합니다.
Lightspeed 연결에서 프로젝트 연결 해제하기
Editors 이상은 연결 자체를 삭제하지 않고 특정 프로젝트만 연결에서 제거할 수 있습니다. 연결은 다른 프로젝트에서 계속 사용할 수 있습니다.
프로젝트 연결을 해제하려면 다음 단계를 따르세요.
Connectors 열기
Connectors를 열고 App connectors로 이동한 후 **Lightspeed**를 선택합니다.
연결 열기
관리할 연결을 엽니다.
프로젝트 선택하기
Linked projects 아래에서 연결을 해제할 프로젝트를 체크합니다.
확인하기
Unlink projects를 클릭하고 확인합니다.
연결 해제 후 해당 프로젝트는 이 연결을 통해 Lightspeed에 접근할 수 없습니다. 다시 Lightspeed가 필요하면 사용 가능한 연결에 프로젝트를 연결하면 됩니다.
Lightspeed 연결 삭제하기
Workspace admins와 owners가 Lightspeed 연결을 삭제할 수 있습니다. 다른 멤버는 본인이 생성했거나 명시적으로 접근 권한을 부여받은 연결만 삭제할 수 있습니다.
연결 삭제는 영구적이며 취소할 수 없습니다. 연결된 모든 프로젝트에서 자격증명이 제거되고, 이 연결을 사용하는 앱은 새 연결이 추가될 때까지 작동을 멈춥니다.
삭제 전에 Linked projects 섹션에서 현재 이 연결을 사용하는 프로젝트를 확인하세요.
연결을 삭제하려면 다음 단계를 따르세요.
Connectors 열기
Connectors를 열고 App connectors로 이동한 후 **Lightspeed**를 선택합니다.
연결 열기
제거할 연결을 엽니다.
연결된 프로젝트 검토하기
Linked projects 섹션을 검토합니다.
삭제하기
Delete this connection 아래에서 Delete를 클릭하고 확인합니다.