클라우드 인쇄
클라우드 인쇄를 사용하면 WCPOS가 계산대를 실행하는 장치에 직접 연결되지 않은 프린터로 영수증을 전송할 수 있습니다. WP Admin에서 한 번만 설정하면, 각 장치가 하드웨어를 직접 검색하고 페어링할 필요 없이 주문이 주방 프린터, 백오피스 프린터 또는 다른 방의 프린터로 인쇄됩니다.
클라우드 인쇄란?
로컬 인쇄에서는 POS를 실행하는 장치가 USB, 블루투스 또는 로컬 네트워크를 통해 프린터와 직접 통신합니다. 프린터가 계산대 옆에 있을 때 적합한 방식입니다 — 동일한 장치에서 USB, 블루투스, 네트워크 프린터를 연결하는 방법은 프린터 설정을 참조하세요.
클라우드 인쇄는 그 외의 모든 경우를 위한 것입니다: 다른 위치에 있거나, 다른 네트워크에 있거나, 각 장치마다 따로 설정하지 않고 모든 장치가 공유하기를 원하는 프린터입니다. 전달 방식은 두 가지가 있습니다:
- 폴링 프린터. 프린터가 일정에 따라 인터넷을 통해 WCPOS에 접속하여 "전송할 작업이 있나요?"라고 물어보고 대기 중인 작업을 가져옵니다. WCPOS는 프린터에 연결하지 않으며, 항상 프린터가 먼저 통신을 시작합니다. Star CloudPRNT와 Epson Server Direct Print가 이 방식으로 작동합니다.
- 호스팅 릴레이 제공업체. WCPOS가 호스팅 서비스에 인쇄 작업을 제출하면, 해당 서비스가 프린터로 전달합니다. Star Online과 PrintNode가 이 방식으로 작동합니다. Star Online은 stario.online 계정에 등록된 Star CloudPRNT 프린터로 전달하고, PrintNode는 데스크톱 클라이언트를 통해 해당 컴퓨터가 이미 인쇄할 수 있는 거의 모든 프린터로 전달합니다.
폴링 프린터는 열린 포트, 고정 IP 또는 방화벽 변경이 필요 없으며, 오직 아웃바운드 요청만 보냅니다. 따라서 원격 사이트에 있거나 제어할 수 없는 라우터 뒤에 있는 프린터에 이상적입니다. 단점은 약간의 지연입니다: 프린터는 다음 폴링이 돌아올 때만 인쇄합니다.
제공업체 선택
하드웨어에 맞는 제공업체를 선택하세요.
Star CloudPRNT
CloudPRNT 펌웨어를 실행하는 Star 감열 프린터용. 프린터가 WCPOS를 폴링하여 작업을 가져옵니다. 영수증은 프린터의 네이티브 명령으로 렌더링됩니다. 감열 템플릿이 필요합니다.
Star Online
stario.online 계정에 등록된 Star 프린터용. WCPOS가 Star Document Markup을 Star의 호스팅 서비스에 제출하면, 프린터가 Star Online에서 이를 수집합니다. 감열 템플릿이 필요합니다.
Epson Server Direct Print
Server Direct Print를 지원하는 Epson ePOS 프린터용. 프린터가 WCPOS를 폴링하여 작업을 ePOS-Print XML로 가져옵니다. 감열 템플릿이 필요합니다.
PrintNode
PrintNode 데스크톱 클라이언트를 통해 모든 OS에서 컴퓨터가 인쇄할 수 있는 거의 모든 프린터와 함께 작동합니다. WCPOS가 PDF를 제출하므로 전체 페이지 HTML 인보이스를 포함한 모든 템플릿을 사용할 수 있습니다.
| 제공업체 | 하드웨어 | 작업 흐름 방식 | 템플릿 |
|---|---|---|---|
| Star CloudPRNT | CloudPRNT 펌웨어가 있는 Star 감열 프린터 | 프린터가 WCPOS를 폴링 | 감열 전용 |
| Star Online | stario.online에 등록된 Star 프린터 | WCPOS가 Star Document Markup을 Star Online에 제출 | 감열 전용 |
| Epson Server Direct Print | Server Direct Print가 있는 Epson ePOS 프린터 | 프린터가 WCPOS를 폴링 | 감열 전용 |
| PrintNode | OS에 연결된 모든 프린터 + PrintNode 클라이언트 | WCPOS가 PrintNode에 PDF를 제출 | 모든 템플릿 |
클라우드 프린터 설정
클라우드 프린터는 WP Admin에서 한 번 구성되어 모든 장치에서 공유됩니다 — 장치마다 저장되는 로컬 프린터와는 다릅니다.
WP Admin > POS > Settings > Cloud Print로 이동하여 Add printer를 클릭하세요. 이름(예: "Kitchen" 또는 "Back office")을 지정합니다. WCPOS는 프린터로부터 안정적인 프린터 ID를 자동으로 도출하며, 이 ID는 절대 변경되지 않으므로 프린터의 펌웨어 구성에서 참조해도 안전합니다.
프린터가 생성된 후 제공업체 쪽을 구성합니다.
Star 또는 Epson (폴링 프린터)
WCPOS에서 프린터 추가
WP Admin > POS > Settings > Cloud Print에서 프린터를 추가하고 제공업체로 Star CloudPRNT 또는 Epson Server Direct Print를 선택합니다. WCPOS는 해당 프린터에 대한 폴 URL과 일회용 토큰을 생성합니다.
폴 URL과 토큰 복사
생성된 폴 URL과 토큰을 복사합니다. 토큰은 한 번만 표시됩니다 — 분실한 경우 프린터 카드에서 새 토큰을 재생성하고 새 값으로 프린터를 업데이트하세요.
프린터 구성에 입력
프린터의 구성 페이지를 엽니다 — Star의 경우 CloudPRNT 설정, Epson의 경우 Server Direct Print 설정 — 그리고 폴 URL과 토큰을 붙여넣습니다. 프린터가 폴링 간격을 요구하면 설정하세요(보통 몇 초). 필요한 경우 프린터를 저장하고 재부팅하세요.
폴링 주기 내에 프린터가 체크인하면 WCPOS에서 해당 상태가 Waiting에서 Connected로 변경됩니다.
PrintNode
PrintNode 데스크톱 클라이언트 설치
대상 프린터로 이미 인쇄할 수 있는 컴퓨터에 PrintNode 클라이언트를 설치하고 로그인합니다. 작업이 인쇄되려면 클라이언트가 계속 실행되고 온라인 상태를 유지해야 합니다.
PrintNode API 키 발급
PrintNode 계정에서 API 키를 생성합니다. 이를 통해 WCPOS가 PrintNode 계정에 작업을 제출할 수 있습니다.
WCPOS에 API 키 입력
WP Admin > POS > Settings > Cloud Print에서 프린터를 추가하고 제공업체로 PrintNode를 선택한 후 API 키를 붙여넣습니다. WCPOS는 이를 사용하여 PrintNode 계정에 등록된 프린터 목록을 가져옵니다.
프린터 선택
PrintNode 클라이언트가 보고한 프린터 목록에서 대상 프린터를 선택한 후 저장합니다. WCPOS는 이 프린터에 대한 작업을 PrintNode에 제출하고, 클라이언트가 이를 인쇄합니다.
Star Online
Star 프린터가 이미 stario.online 계정에 등록되어 있고 Star의 호스팅 서비스가 전달을 처리하기를 원할 때 Star Online을 사용하세요.
CloudPRNT URL 발급
stario.online에서 Device Groups를 열고 그룹의 CloudPRNT URL을 복사합니다. https://device.stario.online/cloudprnt/... 또는 https://eu-device.stario.online/cloudprnt/...와 같은 형식이어야 합니다.
권한이 있는 API 키 생성
stario.online에서 WCPOS용 API 키를 생성합니다. 키에는 장치를 나열하고 인쇄할 수 있는 권한이 있어야 합니다. 최소한 다음을 활성화하세요:
- EnumDevices — WCPOS가 장치 목록을 가져올 때 필요
- ViewDevice — 장치 상태 확인에 사용
- PrintToDevice — 인쇄 작업 제출에 필요
- ViewDeviceGroups — 그룹 조회 및 진단에 권장
이러한 권한이 활성화되지 않으면 API 키가 존재하더라도 실패할 수 있습니다.
WCPOS에 URL과 API 키 입력
WP Admin > POS > Settings > Cloud Print에서 프린터를 추가하고 제공업체로 Star Online을 선택한 후 CloudPRNT URL과 API 키를 붙여넣습니다. Fetch my devices를 클릭합니다.
Star 장치 선택
장치 목록에서 프린터를 선택하고 저장합니다. WCPOS는 API 키를 서버 측에 저장하고, Star Online에 작업을 제출할 때 선택한 장치의 액세스 식별자를 사용합니다.
자동 인쇄 규칙
자동 인쇄 규칙은 무엇을 어디에 인쇄할지 자동으로 결정합니다 — 평이한 문장으로 작성됩니다. 규칙은 범위 × 프린터 × 템플릿으로 구성되며, 예를 들면 다음과 같습니다:
Kitchen Ticket을 사용하여 모든 주문을 Kitchen에 인쇄합니다.
일치하는 주문이 완료되면 WCPOS가 선택한 템플릿을 서버 측에서 프린터에 필요한 형식으로 렌더링하여 대기열에 넣습니다 — 캐셔가 할 일은 없습니다.
Star 및 Epson 프린터는 감열 템플릿만 사용할 수 있습니다. 작업이 프린터의 네이티브 명령 언어(Star의 경우 Star Document Markup 또는 ESC/POS, Epson의 경우 ePOS-Print)로 렌더링되어야 하기 때문입니다. PrintNode는 작업이 PDF로 렌더링되므로 모든 템플릿(감열 또는 전체 페이지 HTML)을 사용할 수 있습니다. 템플릿이 특정 프린터의 옵션으로 나타나지 않는다면, 이는 프린터가 해당 형식을 렌더링할 수 없기 때문입니다. 감열 레이아웃 생성은 감열 템플릿을 참조하세요.
매장별 프린터 (Pro)
기본적으로 자동 인쇄 규칙은 전역적이며, 모든 매장이 이를 공유합니다. Pro에서는 개별 매장에 자체 클라우드 인쇄 규칙을 부여하여 해당 매장의 주문이 자체 프린터로 인쇄되도록 할 수 있습니다(한 위치의 주방 티켓이 다른 위치에서 인쇄되어서는 안 됩니다).
POS → Stores에서 매장을 편집하고 Cloud Printing 섹션을 열어 Add rule을 클릭하세요. 각 규칙은 다음과 같습니다:
- 프린터 ID — 전송할 클라우드 프린터의 안정적인 ID
- 범위 — POS 주문만(기본값), 온라인 주문만 또는 모든 주문
- 형식 — StarPRNT(기본값), ESC/POS, Epson ePOS-Print 또는 HTML
주문이 자체 규칙이 있는 매장에 속하면 WCPOS는 이를 해당 매장의 프린터로 라우팅합니다. 매장에 자체 규칙이 없으면 전역 자동 인쇄 규칙으로 폴백합니다 — 따라서 다른 설정이 필요한 매장만 구성하면 됩니다.
수동 인쇄
자동 인쇄 규칙을 기다릴 필요가 없습니다. 결제/영수증 화면에서 캐셔는 필요에 따라 클라우드 프린터로 영수증을 전송할 수 있습니다 — 재인쇄하거나 일회성 티켓을 특정 프린터로 라우팅할 때 유용합니다.
영수증이 생성되는 방식은 프린터에 따라 다릅니다:
- Star CloudPRNT — 영수증이 장치에서 렌더링되어 CloudPRNT를 통해 프린터로 전달됩니다.
- Star Online, Epson, PrintNode — 영수증이 선택한 주문과 템플릿으로부터 서버에서 렌더링된 후 프린터 또는 호스팅 릴레이로 전달됩니다.
테스트 인쇄 및 연결 상태
각 프린터 카드에는 Test print 버튼이 있어 짧은 진단 작업을 전송하므로, 실제 주문에 사용하기 전에 프린터에 도달할 수 있는지와 형식이 올바른지 확인할 수 있습니다.
또한 카드에는 실시간 상태가 표시됩니다:
| 제공업체 | 상태 | 의미 |
|---|---|---|
| Star CloudPRNT / Epson | Waiting | 프린터가 아직 체크인하지 않았습니다 — WCPOS가 첫 폴링을 기다리고 있습니다. |
| Star CloudPRNT / Epson | Connected | 프린터가 최근에 WCPOS를 폴링했으며 작업을 수집하고 있습니다. |
| Star Online | Online | Star Online이 선택한 장치가 사용 가능하다고 보고합니다. |
| Star Online | Offline | Star Online이 선택한 장치가 사용 불가능하다고 보고합니다. |
| Star Online | Unknown | WCPOS가 Star Online에서 장치 상태를 확인할 수 없었습니다. |
| PrintNode | Online | PrintNode 서비스가 클라이언트와 프린터가 사용 가능하다고 보고합니다. |
| PrintNode | Offline | PrintNode가 클라이언트 또는 프린터를 사용할 수 없다고 보고합니다. |
문제 해결
프린터가 Waiting 상태에 멈춤
Waiting 상태를 벗어나지 못하는 폴링 프린터는 WCPOS에 한 번도 성공적으로 도달하지 못한 것입니다. 다음을 확인하세요:
- 프린터 펌웨어의 폴 URL과 토큰이 WCPOS가 생성한 것과 정확히 일치하는지. 문자 하나만 틀려도 모든 폴링이 거부됩니다 — 확실하지 않으면 WCPOS에서 토큰을 재생성하고 다시 입력하세요.
- 프린터가 인터넷을 통해 실제로 사이트에 도달할 수 있는지(올바른 DNS, 아웃바운드 HTTPS를 차단하는 방화벽 없음, 스토어의 유효한 SSL 인증서).
- 프린터의 CloudPRNT / Server Direct Print 구성에서 폴링이 활성화되어 있고 적절한 간격으로 설정되어 있는지. 설정을 변경한 후에는 프린터를 재부팅하세요.
Star Online에서 API 키가 권한이 없거나 금지되었다고 표시됨
Star Online은 인증과 권한을 구분합니다:
- 401 / 인증 실패는 API 키 자체가 수락되지 않았음을 의미합니다. 키가 올바르게 복사되었는지, 취소되지 않았는지, 예상한 Star Online 계정/지역에 속하는지 확인하세요.
- 403 / 금지는 API 키는 수락되었지만 요청한 작업에 대한 권한이 없음을 의미합니다. stario.online에서 키를 편집하고 필요한 권한, 특히 Fetch my devices를 위한 EnumDevices와 인쇄를 위한 PrintToDevice를 활성화하세요.
Fetch my devices는 성공하지만 프린터가 나타나지 않으면 stario.online의 Device Groups 페이지를 확인하세요. 그룹에는 연결된 장치가 하나 이상 있어야 하며, WCPOS의 CloudPRNT URL이 동일한 그룹을 가리켜야 합니다.
PrintNode 작업이 인쇄되지 않음
작업이 PrintNode에 도달했지만 프린터에서 출력되지 않았습니다. 다음을 확인하세요:
- 프린터에 연결된 컴퓨터에서 PrintNode 데스크톱 클라이언트가 실행 중이고 온라인 상태인지. 컴퓨터가 절전 모드이거나 클라이언트가 닫혀 있으면 아무것도 인쇄되지 않습니다.
- WCPOS에서 올바른 프린터를 선택했는지 — 이름이 클라이언트가 보고하는 프린터와 일치해야 합니다.
- API 키가 유효하고 취소되지 않았는지. PrintNode가 프린터를 Offline으로 표시하면 다시 입력하세요.
Star 또는 Epson 프린터에서 내 템플릿을 선택할 수 없음
Star 및 Epson 클라우드 프린터에서는 감열 템플릿만 작동합니다. 영수증이 ESC/POS 또는 ePOS-Print 명령으로 렌더링되어야 하기 때문입니다. HTML 및 전체 페이지 템플릿은 이러한 형식으로 표현할 수 없으므로 이 프린터에서는 숨겨집니다.
감열 템플릿을 선택하거나 PrintNode 프린터를 사용하세요 — PrintNode는 PDF로 렌더링하므로 모든 템플릿을 인쇄할 수 있습니다.