리테일 POS 플랫폼인 Lightspeed Retail X-Series에 앱을 연결해 제품, 재고, 매장, 고객, 매출 데이터를 Lovable 앱에서 활용합니다.
Lightspeed에 앱 연결하기
리테일 POS 플랫폼인 Lightspeed Retail X-Series에 앱을 연결해 제품, 재고, 매장, 고객, 매출 데이터를 Lovable 앱에서 활용하세요.
Lightspeed Retail X-Series는 제품, 재고, 매장, 고객, 결제, 매출을 관리하는 리테일 POS(Point of Sale) 플랫폼입니다. Lightspeed 커넥터를 사용하면 연결된 Lightspeed 스토어를 통해 Lovable 앱에서 Retail X-Series API를 호출할 수 있습니다.
Lightspeed는 앱 + 채팅 커넥터로 제공됩니다. 하나의 공유 연결이 빌드 중 채팅과 게시된 앱 모두에서 작동합니다.
Lightspeed를 사용하면 앱에서 다음 작업을 할 수 있습니다:
- 매장, 레지스터, 결제 유형, 리테일 설정 조회
- 제품 카탈로그, 브랜드, 가격표(price book), 재고 수준 읽기
- Retail X-Series 데이터로 고객·매출 대시보드 구축
- 재고, 프로모션, 기프트 카드, 스토어 크레딧 관련 워크플로우 생성
기본적으로 Lightspeed 연결은 일반적인 리테일 워크플로우에 필요한 읽기 scope를 요청합니다. 앱에서 Lightspeed의 리소스를 생성하거나 업데이트해야 하면 추가 고급 scope를 활성화할 수 있습니다.
주요 활용 사례 및 예시 앱
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| 리테일 재고 대시보드 | Lightspeed를 사용해 매장별 재고, 재고 부족 제품, 최근 재고 변동을 보여주는 재고 대시보드를 만들어줘. | 연결된 스토어 전반의 재고를 모니터링합니다. 앱이 Lightspeed에서 제품과 재고 데이터를 읽어 운영자가 주의가 필요한 품목을 찾도록 돕습니다. |
| 매출 성과 대시보드 | Lightspeed를 사용해 일일 매출, 결제 유형, 인기 제품, 매장 필터가 있는 매출 대시보드를 만들어줘. | 매장 성과를 한 화면에서 추적합니다. 앱이 Lightspeed에서 매출, 결제, 제품, 매장 데이터를 읽어 리테일 팀이 POS를 열지 않고도 추세를 검토할 수 있습니다. |
| 고객 구매 이력 포털 | Lightspeed를 사용해 연락처 정보, 고객 그룹, 최근 구매 내역을 보여주는 고객 조회 도구를 만들어줘. | 고객 응대 전에 직원에게 맥락을 제공합니다. 앱이 Lightspeed의 고객·매출 데이터를 결합해 지원이나 매장 운영 화면에 집중해서 보여줍니다. |
| 프로모션 기획 도구 | Lightspeed를 사용해 캠페인 시작 전에 제품, 브랜드, 가격, 현재 재고를 나열하는 프로모션 기획 도구를 만들어줘. | 실시간 카탈로그 데이터로 리테일 캠페인을 계획합니다. 앱이 제품, 가격표, 프로모션, 재고를 읽어 머천다이저가 적합한 품목을 고를 수 있습니다. |
| 기프트 카드·스토어 크레딧 추적기 | Lightspeed를 사용해 기프트 카드 잔액, 스토어 크레딧 거래, 관련 고객 레코드를 추적하는 도구를 만들어줘. | Lightspeed에서 고객 가치 잔액을 검토합니다. 앱이 기프트 카드와 스토어 크레딧 데이터를 읽어 매장 팀을 위해 고객 레코드와 연결합니다. |
| 공급업체·세금 참조 브라우저 | Lightspeed를 사용해 운영 팀을 위해 공급업체, 세율, 매장, 사용자 레코드를 나열하는 관리 페이지를 만들어줘. | 내부 워크플로우를 위해 Retail X-Series 참조 데이터를 노출합니다. 앱이 공급업체, 세금, 매장, 사용자 데이터를 읽어 팀이 일관된 운영 값을 사용할 수 있습니다. |
Lightspeed 연결하기
Lightspeed 연결을 만들 수 있는 사용자는 플랜과 워크스페이스 설정에 따라 달라집니다. 연결 및 클라이언트를 만들 수 있는 사용자를 참고하세요. 연결을 추가할 때 다음 중에서 선택할 수 있습니다:
- Managed by Lovable(Lightspeed OAuth 애플리케이션이 필요 없으며 스토어의 도메인 접두사만 있으면 됩니다)
- Lightspeed(client ID와 client secret으로 자체 OAuth 애플리케이션을 등록합니다)
서로 다른 Lightspeed 스토어나 OAuth 앱으로 여러 Lightspeed 연결을 만들 수 있어 환경을 분리하거나 여러 리테일 계정을 관리할 때 유용합니다.
연결을 만든 후 사용할 프로젝트에 연결할 수 있습니다. 프로젝트에서 빌드하는 사용자는 누구나 채팅에서 Lovable에 연결을 요청할 수 있습니다.
이 커넥터를 통한 모든 API 요청은 Lightspeed Retail X-Series API 제한과 연결된 계정의 권한에 포함됩니다. 청구와 할당량은 Lovable이 아닌 Lightspeed에서 직접 처리합니다.
Lightspeed를 연결하려는 방식에 따라 아래 설정 단계를 따르세요.
가장 빠르게 설정하려면 이 옵션을 선택하세요. Lightspeed 개발자 대시보드에서 OAuth 애플리케이션을 등록할 필요가 없습니다. Lovable이 OAuth 애플리케이션을 제공하고 관리하며, 사용자는 자신의 스토어를 대상으로 이를 승인합니다.
사전 준비
Lightspeed를 연결하기 전에 다음을 준비하세요:
- Lightspeed Retail X-Series 계정과 스토어
https://{domain_prefix}.retail.lightspeed.app의 스토어 도메인 접두사(domain prefix)- Lovable 워크스페이스에서 연결을 만들 수 있는 권한(연결 및 클라이언트를 만들 수 있는 사용자 참고)
Lightspeed 연결 설정하기
Connectors에서 Lightspeed 열기
Connectors로 이동해 Lightspeed를 선택합니다.
연결 추가하기
Add connection을 클릭합니다.
연결 이름 지정하기
Display name에 연결 이름을 지정합니다(예: Lightspeed Prod). 이 이름은 Lovable 내부에서 연결을 식별할 때만 사용됩니다.
Managed by Lovable 선택하기
Authentication에서 Managed by Lovable을 선택합니다.
도메인 접두사 입력하기
Domain Prefix에 https://{domain_prefix}.retail.lightspeed.app의 스토어 접두사를 입력합니다(예: my-store).
Scope 검토하기(선택 사항)
Advanced settings를 펼쳐 앱이 요청할 권한을 검토합니다. 일반적인 읽기 전용 리테일 워크플로우에 필요한 기본 scope가 미리 선택되어 있습니다. 전체 목록은 Scopes를 참고하세요.
이 연결을 사용할 사용자 선택하기
Managed 연결은 기본적으로 전체 워크스페이스와 공유됩니다. 연결을 사용할 수 있는 사용자를 제한하려면 Who can use this connection에서 Restrict to specific people을 클릭합니다.
자세한 내용은 연결 및 클라이언트를 사용할 수 있는 사용자를 참고하세요.
Lightspeed에 연결하고 승인하기
Connect를 클릭합니다. Lightspeed 승인 창이 열리므로 브라우저가 팝업을 차단하지 않는지 확인하세요. 차단된 경우 Lovable이 대신 페이지를 이동합니다.
요청되면 Lightspeed에 로그인하고 요청된 권한을 검토한 뒤 Allow를 클릭합니다.
확인과 함께 Lovable로 다시 이동합니다.
연결되면 프로젝트에서 빌드하는 사용자는 구성된 연결 수준 접근 권한에 따라 채팅에서 Lovable에 프로젝트와 Lightspeed의 연결을 요청할 수 있습니다. 이후 Lovable 앱에서 Lightspeed Retail X-Series의 제품, 재고, 매장, 고객, 매출 및 관련 리테일 데이터를 활용할 수 있습니다.
애플리케이션 등록, 브랜딩, scope 집합을 직접 제어하려면 자체 OAuth 애플리케이션을 사용하세요. 연결 양식에서 이 옵션은 Lightspeed로 표시됩니다.
사전 준비
Lightspeed를 연결하기 전에 다음을 준비하세요:
- Lightspeed Retail X-Series 계정과 스토어
- Lightspeed 개발자 대시보드 접근 권한
- client ID와 client secret이 있는 Lightspeed OAuth 애플리케이션
https://{domain_prefix}.retail.lightspeed.app의 스토어 도메인 접두사- Lovable 워크스페이스에서 연결을 만들 수 있는 권한(연결 및 클라이언트를 만들 수 있는 사용자 참고)
Lightspeed 연결 설정하기
Lightspeed OAuth 애플리케이션 만들거나 열기
Lightspeed 개발자 대시보드에 로그인합니다. Lovable용 OAuth 애플리케이션을 만들거나 사용할 기존 애플리케이션을 엽니다.
Redirect URI 설정하기
Lightspeed OAuth 애플리케이션에서 연결 과정 중 Lovable이 표시하는 redirect URI를 추가합니다. 애플리케이션을 저장한 뒤 Client ID와 Client Secret을 복사합니다.
Connectors에서 Lightspeed 열기
Connectors로 이동해 Lightspeed를 선택합니다.
연결 추가하기
Add connection을 클릭합니다.
연결 이름 지정하기
Display name에 연결 이름을 지정합니다(예: Lightspeed Prod). 이 이름은 Lovable 내부에서 연결을 식별할 때만 사용됩니다.
Lightspeed 선택하기
Authentication에서 Lightspeed를 선택합니다. 자체 OAuth 앱을 등록하는 옵션입니다.
연결 구성하기
연결 세부 정보를 입력합니다:
- Client ID: Lightspeed OAuth 애플리케이션의 client ID를 붙여넣습니다.
- Client Secret: Lightspeed OAuth 애플리케이션의 client secret을 붙여넣습니다.
- Domain Prefix:
https://{domain_prefix}.retail.lightspeed.app의 스토어 접두사를 입력합니다(예:my-store).
Scope 검토하기(선택 사항)
Advanced settings를 펼쳐 앱이 요청할 권한을 검토합니다. 일반적인 읽기 전용 리테일 워크플로우에 필요한 기본 scope가 미리 선택되어 있습니다. 전체 목록은 Scopes를 참고하세요.
이 연결을 사용할 사용자 선택하기
Who can use this connection에서 워크스페이스 내 연결 사용자를 결정합니다. 처음에는 본인만 접근할 수 있습니다:
- Only you(기본값): 접근 목록을 그대로 두면 본인만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite specific people: 이메일로 워크스페이스 멤버를 추가하면 본인과 추가한 사용자만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite entire workspace: Invite entire workspace를 클릭하면 Lovable 워크스페이스의 모든 사용자가 연결을 사용할 수 있습니다.
자세한 내용은 연결 및 클라이언트를 사용할 수 있는 사용자를 참고하세요.
Lightspeed에 연결하고 승인하기
Connect를 클릭합니다. Lightspeed 승인 창이 열리므로 브라우저가 팝업을 차단하지 않는지 확인하세요. 차단된 경우 Lovable이 대신 페이지를 이동합니다.
요청되면 Lightspeed에 로그인하고 요청된 권한을 검토한 뒤 Allow를 클릭합니다.
확인과 함께 Lovable로 다시 이동합니다.
연결되면 프로젝트에서 빌드하는 사용자는 구성된 연결 수준 접근 권한에 따라 채팅에서 Lovable에 프로젝트와 Lightspeed의 연결을 요청할 수 있습니다. 이후 Lovable 앱에서 Lightspeed Retail X-Series의 제품, 재고, 매장, 고객, 매출 및 관련 리테일 데이터를 활용할 수 있습니다.
Scopes
일반적인 읽기 전용 리테일 워크플로우에 필요한 기본 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) | 비밀번호를 제외한 사용자 정보 읽기 | 켜짐 |
이 외에 쓰기, 감사(audit), 채널, 위탁(consignment), 결제, 일련번호, 서비스, 웹훅 scope도 제공되지만 기본적으로 꺼져 있습니다. 앱에 필요한 scope만 선택하세요.
전체 scope 문서는 Lightspeed OAuth scope 참고 자료를 확인하세요.
제한 사항
Lightspeed 커넥터는 다음을 지원하지 않습니다:
- Lightspeed 계정 생성
- Lightspeed API 제한, 플랜 제한, 연결된 사용자 권한, 선택된 OAuth scope 우회
- 최종 사용자별 Lightspeed 로그인 제공. 각 연결은 연결된 프로젝트 전반에서 공유되는 하나의 Lightspeed 스토어 승인을 나타냅니다
- Lovable이 관리하는 웹훅 구독을 통한 Lightspeed 웹훅 이벤트 전달
Lightspeed 측에서 승인이 취소되면 API 호출이 다시 성공하도록 Lovable에서 통합을 다시 연결해야 합니다.
Lightspeed 연결 관리하기
Connectors에서 연결을 관리합니다. **Lightspeed**를 선택한 뒤 연결을 여세요.
- 특정 프로젝트의 Lightspeed 접근만 제거하고 다른 프로젝트에서는 연결을 계속 사용하려면 Unlink projects를 사용합니다. 단계는 연결에서 프로젝트 연결 해제를 참고하세요.
- 워크스페이스에서 연결을 완전히 제거하려면 Delete the connection을 사용합니다. 삭제는 영구적입니다. 연결된 모든 프로젝트에서 인증 정보가 제거되고, 새 연결을 추가할 때까지 Lightspeed을 사용하는 앱 기능이 중단됩니다. 단계와 삭제 권한은 연결 삭제를 참고하세요.