프린터 설정
프린터 설정은 POS의 설정 > 프린터에서 찾을 수 있습니다. 각 기기는 자체 프린터 구성을 관리합니다. 프린터는 로컬에 저장되며 기기 간에 동기화되지 않습니다.
이 페이지에서는 USB, Bluetooth 또는 로컬 네트워크로 계산대에 연결된 프린터를 다룹니다. 다른 방이나 위치에 있는 프린터, 또는 모든 기기에서 공유하려는 프린터는 클라우드 인쇄를 참조하세요.
플랫폼별 지원 프린터
프린터 추가 양식은 사용 중인 앱에 맞게 조정됩니다. 각 플랫폼에는 실제로 사용할 수 있는 연결 방식과 옵션만 표시됩니다.
| 플랫폼 | 지원 프린터 | 연결 |
|---|---|---|
| 웹 앱 | 내장 웹 서버가 있는 Epson 및 Star 프린터 | 네트워크 (HTTP) |
| 데스크톱 앱 | 모든 네트워크 영수증 프린터 | 네트워크 (raw TCP) |
| iOS 앱 | Epson 및 Star | 네트워크, Bluetooth |
| Android 앱 | Epson 및 Star | 네트워크, Bluetooth, USB |
웹 브라우저는 원시 TCP 연결을 열 수 없습니다. Epson 및 Star 영수증 프린터에는 HTTP를 통해 인쇄 작업을 받는 내장 웹 서버가 포함되어 있으며, 브라우저에서 ESC/POS 명령을 보내는 유일한 방법입니다. 데스크톱 앱은 TCP를 통해 직접 연결할 수 있으므로 이 제한이 없습니다.
모바일 앱에서는 Bluetooth 및 USB 인쇄가 Epson과 Star의 공식 SDK를 통해 처리되므로, 이러한 연결에도 Epson 또는 Star 프린터가 필요합니다. 일반 프린터는 네트워크를 통해서만 작동합니다.
프린터 추가
프린터 설정 열기
POS에서 설정 > 프린터로 이동합니다. 아직 구성된 프린터가 없으면 프린터 추가 버튼이 있는 빈 상태 화면이 표시됩니다. 모든 프린터에는 프린터 이름이 지정됩니다. 이는 단순한 라벨이며 "영수증 프린터"(이후 "영수증 프린터 2" 등)로 자동 입력됩니다. 프린터를 구분하는 데 도움이 되는 이름으로 자유롭게 변경할 수 있습니다.
프린터 연결 방식 선택
이 단계는 플랫폼마다 다릅니다.
- 웹 앱 — 공급업체를 선택합니다: Epson 또는 Star. 브라우저는 이 두 브랜드의 내장 웹 서버에만 접근할 수 있으므로, 웹에서는 이것이 첫 번째 선택 항목입니다.
- 데스크톱 앱 — 프린터는 네트워크를 통해 연결되며, 여기에서 추가로 선택할 항목은 없습니다.
- 모바일 앱 — 연결 유형을 선택합니다: 네트워크, Bluetooth 또는 USB(USB는 Android 전용). 아래 필드는 선택한 항목에 맞게 변경됩니다.
프린터 식별
네트워크 프린터 — IP 주소를 입력합니다(예: 192.168.1.100). WCPOS는 주소를 검사하여 Epson 또는 Star 장치인지 감지하고, 포트, 명령 언어, 공급업체를 자동으로 입력합니다. 감지가 완료되면 "감지됨: Epson" 또는 "감지됨: Star" 레이블이 표시됩니다. 웹 앱에서는 연결할 정확한 엔드포인트 URL도 표시됩니다.
Bluetooth 또는 USB 프린터(모바일) — 검색된 장치 목록에서 프린터를 선택합니다. 장치를 선택하면 이름과 공급업체가 자동으로 입력됩니다. 프린터가 아직 목록에 없으면 프린터 검색(Bluetooth) 또는 새로 고침(USB)을 누릅니다.
자동 감지가 모든 항목을 올바르게 설정하지 못한 경우 고급 설정에서 모두 조정할 수 있습니다.
저장 및 테스트
저장을 클릭합니다. WCPOS는 먼저 테스트 인쇄를 보내며, 성공한 경우에만 프린터를 저장합니다.
테스트 인쇄는 짧은 진단 출력입니다. 번호가 매겨진 열 눈금자, 가운데 정렬된 일반 및 두 배 크기 텍스트, 왼쪽/오른쪽 정렬 행, 용지 절단이 포함됩니다. 프린터에 연결할 수 있는지만 확인하는 것이 아니라, 용지 너비, 정렬, 크기, 절단이 모두 올바르게 구성되었는지 확인하도록 설계되었습니다.
테스트에 실패하면 오류와 함께 프로필을 그대로 저장할 수 있는 테스트하지 않고 저장 옵션이 표시됩니다.
연결 유형(모바일 앱)
iOS 및 Android 앱에서는 프린터를 세 가지 방식으로 연결할 수 있습니다. 프린터 추가 양식 상단에서 연결 유형을 선택하면 연결 필드가 그에 맞게 업데이트됩니다.
네트워크
프린터가 기기와 동일한 Wi-Fi 네트워크에 있습니다. IP 주소를 입력합니다 — 프린터의 IP 주소 찾기를 참조하세요. 네트워크 프린터는 Epson, Star 또는 일반 프린터일 수 있습니다.
Bluetooth
프린터가 Bluetooth로 기기와 페어링되어 있습니다. 프린터 검색을 탭하고 목록에서 해당 프린터를 선택합니다 — 이름과 공급업체가 자동으로 입력됩니다. Bluetooth 인쇄는 Epson 및 Star의 네이티브 SDK를 사용하므로 프린터는 Epson 또는 Star 모델이어야 합니다.
USB(Android 전용)
프린터가 USB 케이블로 연결되어 있습니다. 새로 고침을 탭하고 연결된 기기 목록에서 선택합니다. Bluetooth와 마찬가지로 USB 인쇄에는 Epson 또는 Star 프린터가 필요합니다. iOS는 일반 USB 주변기기 지원을 제공하지 않으므로 이 옵션은 Android에서만 표시됩니다.
포트 설정은 네트워크 프린터에만 적용됩니다 — Bluetooth 및 USB 연결에서는 숨겨집니다.
고급 설정
고급 설정을 펼쳐 프린터 구성을 세부 조정합니다. 대부분의 항목은 제조사가 확인되면 자동으로 입력됩니다.
이 설정은 모든 플랫폼에 적용됩니다.
| 설정 | 옵션 | 설명 |
|---|---|---|
| 언어 | ESC/POS, StarPRNT, Star Line Mode | 프린터가 사용하는 명령 프로토콜입니다. 감지된 제조사에 따라 자동으로 입력됩니다. |
| 프린터 텍스트 너비 | 58mm (32자), 80mm 표준 (42자), 80mm 와이드 (48자) | 한 줄에 들어가는 문자 수입니다. 용지와 프린터에 맞게 설정하세요. 대부분의 80mm 프린터는 한 줄에 42자를 사용하며, 일부는 48자를 사용합니다. |
| 전체 영수증 래스터 | 끄기 / 켜기 | 전체 영수증을 텍스트 대신 이미지로 인쇄합니다. 아래의 전체 영수증 래스터를 참고하세요. |
다음 두 설정은 플랫폼과 연결 유형에 따라 다르게 동작합니다.
| 설정 | 옵션 | 적용 위치 |
|---|---|---|
| 제조사 | Epson, Star, 일반 | 프린터 제조사입니다. 웹 앱에서는 제조사가 고급 설정이 아니라 양식 상단의 기본 선택 항목(Epson 또는 Star만 해당)입니다. 데스크톱 및 모바일 앱의 네트워크 프린터에는 일반 옵션을 사용할 수 있지만, Bluetooth 또는 USB 연결에는 사용할 수 없습니다. |
| 포트 | 자동 입력 | 프린터의 네트워크 포트입니다. 네트워크 전용 - Bluetooth 및 USB 연결에서는 숨겨집니다. |
프린터 옵션
이 토글은 프린터 추가 양식 하단에 있습니다.
| 옵션 | 설명 |
|---|---|
| 용지 자동 절단 | 각 영수증 출력 후 용지를 자동으로 절단합니다 |
| 금전함 자동 열기 | 인쇄 후 연결된 금전함을 열도록 킥 명령을 보냅니다 |
| 기본값으로 설정 | 이 프린터를 기본 프린터로 지정합니다 — 특정 프린터로 라우팅되지 않은 모든 영수증에 사용됩니다 |
판매가 완료될 때 영수증을 자동으로 인쇄하는 것은 프린터 설정이 아니라 장바구니 설정입니다 — POS 장바구니 설정에서 영수증 자동 인쇄를 켜세요. 사용할 프린터는 기본 프린터와 템플릿별 프린터 라우팅에 따라 결정됩니다.
인쇄 라우팅
감열식 영수증과 A4 인보이스처럼 둘 이상의 템플릿을 사용하는 경우, 인쇄 라우팅이 각 템플릿을 어느 프린터로 인쇄할지 결정합니다. 라우팅은 다음 순서로 확인되는 세 계층으로 구성됩니다.
- 작업별 재정의. 영수증 화면에서 템플릿 전환기 옆에 프린터 드롭다운이 있습니다. 여기서 프린터를 선택하면 해당 인쇄 작업 하나에 대해 모든 설정을 재정의합니다. 템플릿을 전환하면 다시 자동으로 초기화됩니다.
- 설정 재정의. 설정 → 인쇄 라우팅으로 이동하여 각 템플릿에 특정 프린터를 지정합니다. 예를 들어 감열식 영수증은 Epson 네트워크 프린터로, HTML 인보이스는 시스템 인쇄 대화상자로 라우팅할 수 있습니다. 재정의를 제거하려면 템플릿을 다시 자동으로 설정하세요.
- 자동 매칭. 재정의가 설정되어 있지 않으면 WCPOS가 자동으로 매칭합니다.
- 열전사 템플릿은 문자 너비가 일치하는 열전사 프린터로 라우팅됩니다. 58mm 열전사 템플릿은 32열 프린터를 우선 사용하고, 80mm 템플릿은 42열 또는 48열 프린터를 우선 사용합니다.
- HTML 템플릿은 시스템 인쇄 대화상자로 라우팅됩니다.
- 여러 프린터가 일치하면 기본 프린터가 사용됩니다.
호환되지 않는 프린터로 템플릿을 직접 보내면, 예를 들어 열전사 템플릿을 시스템 대화상자로 보내면 영수증 화면에 황색 불일치 경고가 표시됩니다. 인쇄는 계속 진행되지만 출력이 올바르게 렌더링되지 않을 수 있습니다.
라우팅 재정의는 기기별로 저장됩니다. 각 iPad, 휴대폰 또는 컴퓨터가 자체 라우팅을 관리하며, 서버 측 동기화는 없습니다.
인쇄 라우팅 설정 페이지는 프린터를 하나 이상 추가한 후에만 표시됩니다. 구성된 프린터가 없으면 모든 템플릿은 암묵적으로 시스템 인쇄 대화상자를 사용합니다.
전체 영수증 래스터
기본적으로 WCPOS는 프린터의 내장 글꼴을 사용해 빠르고, 작고, 선명한 텍스트로 영수증을 열전사 프린터에 보냅니다. 다만 열전사 프린터 글꼴은 제한된 문자 집합만 지원합니다. 프린터에 해당 글꼴이 없는 문자 체계, 예를 들어 여러 비라틴 문자, 오른쪽에서 왼쪽으로 쓰는 텍스트, 일부 기호는 빈 사각형이나 깨진 문자로 출력될 수 있습니다.
전체 영수증 래스터는 이 문제를 해결합니다. 이 옵션을 켜면 WCPOS가 전체 영수증을 이미지로 렌더링하고 해당 이미지를 프린터로 보내므로, 인쇄물은 언어나 문자 체계와 관계없이 화면에 표시된 내용과 정확히 일치합니다.
프린터별로 고급 설정에서 켤 수 있습니다. 알아둘 사항:
- 더 느립니다. 이미지는 텍스트 한 줄보다 훨씬 크기 때문에 영수증을 전송하고 인쇄하는 데 시간이 더 오래 걸립니다.
- 필요한 경우에만 사용하세요. 영수증이 텍스트로 문제없이 인쇄된다면 이 옵션을 꺼 둡니다.
- 이 설정은 연결 방식(네트워크, Bluetooth, USB)에 관계없이 열전사 프린터에 적용됩니다. 이미 전체 페이지 렌더링에서 인쇄하는 시스템 인쇄 대화상자에는 적용되지 않습니다.
프린터 검색
모바일 앱에서는 프린터 추가 양식에 Bluetooth(iOS 및 Android) 및 USB(Android만 해당) 연결로 주변 프린터가 표시됩니다. 프린터 검색 또는 새로 고침을 탭하고 목록에서 프린터를 선택하세요. 이름과 공급업체가 자동으로 입력됩니다.
모든 플랫폼의 네트워크 프린터는 IP 주소를 직접 입력하세요. 아래의 프린터 IP 주소 찾기를 참조하세요. 웹 앱에는 네트워크 검색 기능이 없으므로(브라우저는 네트워크를 스캔할 수 없음) 항상 IP를 수동으로 입력해야 합니다.
프린터 IP 주소 찾기
대부분의 영수증 프린터는 IP 주소가 포함된 자체 테스트 페이지를 인쇄할 수 있습니다.
- Epson: 전원을 켤 때 급지 버튼을 길게 누릅니다.
- Star: 전원이 켜진 상태에서 급지 버튼을 5초 동안 길게 누릅니다.
또는 라우터의 연결된 장치 목록이나 프린터 구성 유틸리티를 확인하세요.
고정 IP 권장
영수증 프린터는 프린터를 재시작할 때 주소가 변경되지 않도록 고정 IP 주소를 사용해야 합니다. 다음 중 하나로 설정하세요:
- 프린터의 내장 웹 인터페이스에서 설정합니다(일반적으로 다음 주소에서 접근 가능:
http://<printer-ip>) - 라우터의 DHCP 설정에서 설정합니다(프린터의 MAC 주소에 예약 IP 할당)
Epson 프린터
ePOS를 지원하는 Epson 프린터는 HTTP를 통해 통신합니다. WCPOS는 프린터의 내장 웹 서버로 SOAP/XML 요청을 보냅니다.
연결 세부 정보:
- 포트
8008(HTTP) 또는8043(HTTPS) - 엔드포인트:
/cgi-bin/epos/service.cgi
작동이 확인된 모델:
- Epson TM-T70-i 2 (네트워크)
- Epson TM-m30iii (Printus 미들웨어 사용)
Epson 프린터 구성에서 ePOS가 활성화되어 있는지 확인하세요. 프린터의 웹 인터페이스에 접속하여 http://<printer-ip> ePOS 설정을 확인하고 활성화하세요.
모바일 앱에서는 Epson 프린터를 Epson의 네이티브 SDK를 통해 Bluetooth 또는 USB로도 연결할 수 있습니다. IP 주소나 ePOS 웹 서버는 필요하지 않습니다.
Star 프린터
WebPRNT를 지원하는 Star 프린터는 HTTP를 통해 통신합니다. WCPOS는 Star WebPRNT 엔드포인트로 명령을 보냅니다.
연결 세부 정보:
- HTTPS 또는 HTTP
- 엔드포인트:
/StarWebPRNT/SendMessage
모바일 앱에서는 Star 프린터를 Star의 네이티브 SDK를 통해 Bluetooth 또는 USB로도 연결할 수 있습니다.
일반 프린터
데스크톱 앱은 raw TCP를 통해 모든 네트워크 영수증 프린터를 지원합니다. 프린터의 IP 주소와 포트(일반적으로 9100)를 입력하세요. ESC/POS 명령을 수신할 수 있다면 제조업체와 관계없이 대부분의 감열식 프린터에서 작동합니다.
모바일 앱에서도 일반 프린터가 지원됩니다. 단, 네트워크 연결만 지원하며 Bluetooth 또는 USB 연결은 지원하지 않습니다(이 경우 Epson 또는 Star 프린터가 필요합니다). 웹 앱은 일반 프린터를 전혀 지원하지 않습니다.
금전함
영수증 프린터에 연결된 금전함은 각 판매 후 자동으로 열리도록 설정할 수 있습니다.
- 프린터 옵션에서 금전함 자동 열기를 활성화하세요.
- POS는 인쇄 후 ESC/POS 킥 명령을 전송합니다.
금전함 제어에는 감열식 프린터 프로필이 필요합니다. 브라우저 인쇄 대화상자로는 금전함을 열 수 없습니다.
문제 해결
설정 중 프린터가 감지되지 않음
- 프린터 전원이 켜져 있고 기기와 동일한 네트워크에 연결되어 있는지 확인하세요.
- 네트워크 프린터: IP 주소가 올바른지 확인하세요(자가 테스트 페이지 인쇄).
- 웹 앱: 프린터가 ePOS/WebPRNT를 지원하는 Epson 또는 Star 모델인지 확인하세요.
- 데스크톱 앱: 포트 9100으로 Generic 공급업체 옵션을 시도해 보세요.
- Bluetooth: 먼저 기기의 Bluetooth 설정에서 프린터를 페어링한 다음 프린터 검색을 탭하세요.
- USB(Android): 케이블을 확인하고 USB 권한 요청이 표시되면 승인하세요.
- 방화벽이 연결을 차단하고 있지 않은지 확인하세요.
프린터는 감지되지만 아무것도 인쇄되지 않음
- 용지 롤을 확인하세요. 비어 있거나 걸렸을 수 있습니다.
- 프린터 텍스트 너비 설정이 용지(58mm 또는 80mm)와 일치하는지 확인하세요.
- 프린터 자체에서 자가 테스트를 인쇄해 정상 작동하는지 확인하세요.
- 명령 언어가 프린터와 일치하는지 확인하세요(Epson은 ESC/POS, Star는 StarPRNT 또는 Star Line Mode).
영수증이 깨져 보이거나 잘못된 문자가 표시됨
- 명령어 언어 설정이 잘못되었을 수 있습니다 — ESC/POS, StarPRNT, Star Line Mode 간에 전환해 보세요
- 프린터 텍스트 너비 설정이 올바른지 확인하세요
- 영수증이 비라틴 문자 체계 또는 오른쪽에서 왼쪽으로 쓰는 언어로 되어 있는 경우, 고급 설정에서 전체 영수증 래스터를 켜세요 — 영수증을 이미지로 인쇄하므로 모든 언어가 올바르게 렌더링됩니다
금전함이 열리지 않음
- 프린터 옵션에서 금전함 자동 열기가 활성화되어 있는지 확인하세요
- 금전함이 별도의 전원이 아니라 프린터의 DK 포트에 연결되어 있는지 확인하세요
- 모든 프린터가 금전함 열기 명령을 지원하는 것은 아닙니다 — 프린터 문서를 참조하세요
웹 앱에서 연결할 수 없음
- 웹 앱은 내장 웹 서버가 있는 Epson 및 Star 프린터에만 연결할 수 있습니다
- 일반 및 USB 프린터는 웹에서 지원되지 않습니다 — 대신 데스크톱 또는 모바일 앱을 사용하세요
- 사이트가 HTTPS를 사용하지만 프린터가 HTTP만 지원하는 경우, 브라우저가 혼합 콘텐츠로 간주하여 연결을 차단할 수 있습니다
Bluetooth 프린터가 연결되지 않음(모바일)
- WCPOS에 추가하기 전에 기기의 시스템 Bluetooth 설정에서 프린터를 페어링하세요
- Bluetooth 인쇄는 Epson 및 Star 프린터만 지원합니다 — 일반 Bluetooth 프린터는 지원되지 않습니다
- 프린터가 목록에 표시되지 않으면 프린터 검색을 다시 탭하고, 프린터 전원이 켜져 있으며 범위 내에 있는지 확인하세요