본문으로 건너뛰기

프린터 설정 가이드

영수증 프린터를 연결하고 사용하는 방법을 안내합니다.

지원 프린터​

SLK-TS100 (권장)​

세우전자(Sewoo)에서 제조한 열전사 영수증 프린터입니다.

항목사양
제조사세우전자 (Sewoo)
인쇄 방식열전사 (Thermal)
인쇄 속도220mm/s
해상도203 DPI
용지 폭80mm
한 줄 문자 수42자 (Font A 기준)
한글 폰트24×24 도트
인코딩EUC-KR
QR코드지원
바코드EAN-13, EAN-8, Code 39, Code 128
커터 수명1억회
인터페이스USB, Serial

기타 호환 프린터​

다음 프린터도 ESC/POS 호환 모드로 사용 가능합니다:

  • Epson TM-T88 시리즈 - USB Vendor ID: 0x04B8
  • Bixolon SRP-350 시리즈 - USB Vendor ID: 0x0DD4
  • 기타 ESC/POS 호환 프린터

프린터 연결 방법​

1. USB 케이블 연결​

  1. 프린터 전원을 켭니다
  2. USB 케이블로 프린터와 컴퓨터를 연결합니다
  3. 프린터 전원 표시등이 켜지는지 확인합니다

2. 브라우저에서 프린터 연결​

  1. 판매 상세 또는 고객 상세 페이지로 이동합니다
  2. 영수증 출력 버튼을 클릭합니다
  3. 브라우저에서 USB 장치 선택 창이 표시됩니다
  4. 목록에서 프린터를 선택합니다:
    • SLK-TS100: "SLK-TS100" 또는 "USB Printing Support"로 표시
  5. 연결 버튼을 클릭합니다

참고: 한 번 연결하면 브라우저가 프린터를 기억합니다. 다음 출력 시에는 자동으로 연결됩니다.

지원 브라우저​

WebUSB API를 지원하는 브라우저만 프린터 기능을 사용할 수 있습니다.

브라우저지원 여부비고
Chrome (Windows/Mac/Linux)✅ 지원권장
Edge (Windows/Mac)✅ 지원Chromium 기반
Opera✅ 지원Chromium 기반
Firefox❌ 미지원WebUSB 미지원
Safari❌ 미지원WebUSB 미지원
모바일 브라우저❌ 미지원USB 연결 불가

최소 Chrome 버전: 61 이상

출력 가능한 문서​

판매 영수증​

판매 완료 후 고객에게 제공하는 영수증입니다.

포함 내용:

  • 매장 정보 (상호, 사업자번호, 연락처)
  • 판매 일자
  • 고객 정보
  • 상품 목록 (품명, 수량, 단가, 금액)
  • 공급가액, 부가세, 합계
  • 결제 내역
  • 미수금 (있는 경우)

미수금 내역서​

고객별 미수금 현황을 정리한 문서입니다.

포함 내용:

  • 매장 정보
  • 고객 정보
  • 미수금 목록 (판매일, 품목, 미수금액)
  • 미수금 합계

문제 해결​

프린터가 목록에 표시되지 않음​

  1. USB 케이블 연결 확인

    • 케이블이 단단히 연결되어 있는지 확인
    • 다른 USB 포트에 연결해 봅니다

  2. 프린터 전원 확인

    • 전원 표시등이 켜져 있는지 확인
    • 프린터를 껐다가 다시 켭니다

  3. 브라우저 새로고침

    • 페이지를 새로고침합니다
    • 브라우저를 완전히 종료 후 다시 실행합니다

  4. 다른 프로그램 확인

    • 다른 프로그램에서 프린터를 사용 중인지 확인
    • 프린터 드라이버 유틸리티를 종료합니다

"연결할 수 없습니다" 오류​

  1. 권한 문제 (Linux)

    # udev 규칙 추가
    echo 'SUBSYSTEM=="usb", ATTR{idVendor}=="0483", MODE="0666"' | sudo tee /etc/udev/rules.d/99-slk-ts100.rules
    sudo udevadm control --reload-rules

  2. 브라우저 권한

    • 주소창의 자물쇠 아이콘 클릭
    • "사이트 설정"에서 USB 권한 확인

출력물이 깨져서 나옴​

  1. 용지 확인

    • 용지가 올바르게 장착되어 있는지 확인
    • 용지 방향 확인 (열감지 면이 안쪽)

  2. 프린터 헤드 청소

    • 프린터 커버를 열고 헤드를 부드러운 천으로 닦습니다

한글이 깨져서 출력됨​

  • 프린터가 EUC-KR 인코딩을 지원하는지 확인합니다
  • SLK-TS100은 한글을 기본 지원합니다
  • 호환 프린터의 경우 설정에서 한글 모드를 활성화해야 할 수 있습니다

QR코드가 출력되지 않음​

  • SLK-TS100, Epson TM-T88 등 QR코드 지원 프린터인지 확인합니다
  • 일부 저가형 프린터는 QR코드를 지원하지 않습니다

기술 정보​

ESC/POS 프로토콜​

영수증 프린터는 ESC/POS 명령어 프로토콜을 사용합니다. 주요 명령어:

명령어설명
ESC @프린터 초기화
ESC a n정렬 설정 (0=좌측, 1=중앙, 2=우측)
ESC E n볼드 설정
GS V n용지 절단
GS ( kQR코드 인쇄

WebUSB API​

브라우저에서 USB 장치에 직접 접근하는 JavaScript API입니다.

// 프린터 연결 요청
const device = await navigator.usb.requestDevice({
  filters: [{ vendorId: 0x0483 }]  // SLK-TS100
});

// 장치 열기
await device.open();
await device.selectConfiguration(1);
await device.claimInterface(0);

// 데이터 전송
await device.transferOut(endpoint, data);

관련 문서​