SortingGo Print Service는 무엇인가요?
Windows PC에 설치하는 백그라운드 서비스와 Web 관리 화면으로 구성되어 라벨 디자인, 데이터 형식 관리, 프린터 관리, 인쇄를 담당합니다. APP이 아니며 클라우드 인쇄 서비스도 아니므로, 사내 LAN 안에서만 동작합니다.
Web 관리 화면 주소와 기본 포트는 무엇인가요?
기본 포트는 28088입니다. Windows PC 자체에서는 http://localhost:28088 로 열 수 있으며, 휴대폰이나 다른 기기에서는 Windows PC의 사설망 IP를 사용해야 합니다(예: http://192.168.1.50:28088). 휴대폰에서의 localhost는 휴대폰 자신을 가리키므로 PC에는 연결되지 않습니다.
휴대폰 APP이 Print Service에 연결되지 않으면 어떻게 하나요?
다음 순서로 확인하세요: ①Windows PC 자체 브라우저에서 서비스 주소를 열어 서비스가 실행 중인지 확인, ②휴대폰 브라우저에서 같은 주소를 열어보고 실패하면 대부분 방화벽 또는 Wi-Fi 클라이언트 격리 문제, ③APP에 입력한 IP와 포트가 올바른지 확인, ④API Key를 새로 만들어 테스트. 성공하면 APP에 연결 성공과 라벨 형식 개수가 표시됩니다.
인터넷 없이도 사용할 수 있나요?
네. LAN 인쇄와 Web 관리 화면 모두 내부망에서 동작합니다. 새 버전 다운로드, 라이선스 활성화, 외부 서비스 이용 시에만 인터넷이 필요할 수 있습니다.
AI나 고객 지원에 제공하면 안 되는 정보는 무엇인가요?
완전한 API Key, 비밀번호, Signed Entitlement 라이선스 증명서, 내부망 인증 정보, 개인정보가 포함된 주문 데이터는 제공하지 마세요. 도움이 필요할 때는 버전, 발생 시각, 오류 메시지 스크린샷, 마스킹된 일부 정보만으로 충분합니다.
문제는 어떻게 신고하나요?
Print Service 버전, Windows 버전, APP 버전과 휴대폰 기종, 프린터 브랜드/모델과 연결 방식, 발생 시각, 오류 스크린샷, 인쇄 기록 ID, 로그 일부를 제공해 주세요. 완전한 API Key, 비밀번호, 라이선스 증명서는 절대 첨부하지 마세요.
데이터베이스는 어디에 있고 어떻게 백업하나요?
설치 프로그램으로 배포한 경우 데이터는 C:\ProgramData\SortingGoPrintService에 저장되며, 주 데이터베이스는 data\labelprint.db입니다. 백업 전에는 서비스를 먼저 중지한 뒤 labelprint.db, labelprint.db-wal, labelprint.db-shm 세 파일을 함께 복사하는 것을 권장합니다.
참조 데이터 소스는 무엇에 쓰이나요?
상품 마스터, 고객 마스터 같은 Excel을 업로드한 뒤 데이터 형식 관리에서 join 필드를 연결하면, 라벨에서 바코드·판매가·원산지 같은 Excel 열을 사용할 수 있습니다. 인쇄 시 서버가 자동으로 조회해서 채워 주므로, 매번 인쇄 데이터에 해당 열을 포함시킬 필요가 없습니다.
다시 가져오기를 하면 어떻게 되나요?
다시 가져오기는 해당 소스의 기존 데이터 전체를 새 Excel로 교체합니다. key가 비어 있는 행은 건너뛰고, key가 중복된 행은 나중 행이 덮어씁니다. 가져오기 완료 시 건너뛴 행 수와 덮어쓴 행 수가 표시됩니다.
참조 데이터 소스를 삭제할 수 없는 이유는 무엇인가요?
해당 소스가 어떤 데이터 형식에 연결되어 사용 중이기 때문입니다. 먼저 데이터 형식 관리에서 연결을 해제한 뒤 다시 삭제하세요. 소스를 삭제하면 모든 데이터 행이 사라지며 되돌릴 수 없습니다.
인쇄 시 key를 찾지 못하면 어떻게 되나요?
key와 일치하는 행이 없으면 참조 필드는 빈칸으로 인쇄되며 오류는 발생하지 않습니다. 라벨의 참조 필드가 대부분 비어 있다면 join 필드 값과 참조 데이터 소스의 key가 일치하는지 확인하세요.
내장된 기본 데이터 형식과 라벨 템플릿이 제가 수정한 내용을 덮어쓰나요?
아니요. 서비스 시작 시 데이터베이스에 동일한 ID의 데이터 형식이나 라벨 템플릿이 이미 있으면 수정한 내용을 덮어쓰지 않습니다.
데이터 형식을 삭제하면 어떤 영향이 있나요?
데이터 형식을 삭제하면 여기에 연결된 라벨 형식도 함께 삭제됩니다. 삭제 전에 반드시 확인하고, 필요하면 먼저 「내보내기」로 JSON 백업을 만드세요. 시스템 기본 형식은 삭제할 수 없습니다.
참조 데이터 소스 연결은 무엇인가요?
데이터 형식의 특정 필드를 join 필드로 지정해 참조 데이터 소스의 key와 매칭하고, 가상 필드 접두사(예: pinfo)를 설정합니다. 연결 후 라벨 디자인에서 「pinfo.barcode」 같은 참조 필드를 사용할 수 있으며, 인쇄 시 서버가 실제 값을 조회해 채워 줍니다. 변경 후에는 반드시 「이 데이터 형식 저장」을 클릭하세요.
계산 필드는 어떻게 사용하나요?
계산 필드는 인쇄 전에 서버가 계산해서 생성하며, {필드}+'문자열' 형태의 연결 수식을 사용합니다(예: {상품코드}+','+{수량}). 원본 필드, 다른 계산 필드, 참조 필드를 참조할 수 있으며, 주로 바코드 내용을 조합할 때 사용합니다.
Excel 열 머리글로 바로 필드를 만들 수 있나요?
네, 「샘플 Excel 선택」으로 열 머리글을 적용하면 필드를 일괄 생성할 수 있습니다. 단, 이 기능은 해당 데이터 형식의 기존 필드, 참조 연결, 계산 필드를 모두 지우고 Excel 열 머리글로 다시 만드므로, 적용 후 저장을 잊지 마세요.
이미지 요소는 어떤 형식을 지원하나요? 크기 제한이 있나요?
PNG, JPEG, WebP를 지원하며 SVG와 GIF는 지원하지 않습니다. 파일 크기는 512KB 이하, 원본 가로세로는 1200px 이하를 권장합니다. 이미지 표시 방식은 완전 표시(contain), 채워서 자르기(cover), 늘려서 채우기(stretch) 중에서 선택할 수 있습니다.
소계 라벨의 명세표와 집계 필드는 어떻게 동작하나요?
소계 레이아웃 하나에는 명세표를 하나만 넣을 수 있으며, 행 수가 한 페이지 용량을 넘으면 자동으로 다음 장에 이어서 인쇄됩니다. 집계 필드(건수 또는 합계)는 항상 전체 그룹의 합계를 표시하고, 여러 장으로 나뉘면 「(1/2) 합계 123」처럼 페이지 표시가 자동으로 추가됩니다.
인쇄한 라벨이 밀리거나 잘리거나 비율이 맞지 않으면 어떻게 하나요?
라벨 레이아웃의 용지 가로세로와 DPI가 실제 라벨 용지(예: 60x40 mm)와 프린터 해상도(203 또는 300 DPI)에 맞는지 확인한 뒤, 프린터 자체의 용지 설정과 보정을 확인하세요. Windows 드라이버 모드에서는 「Windows 드라이버 보정」으로 X/Y 위치와 배율을 미세 조정할 수 있습니다.
요소 위치를 정밀하게 조정할 수 있나요?
네. 요소를 선택한 뒤 방향키로 0.5mm 단위 미세 조정이 가능합니다(Shift를 누르면 1.0mm 단위). 속성 패널에서 X/Y 좌표와 가로세로(mm)를 직접 입력할 수도 있습니다.
라벨 형식을 백업하거나 다른 PC로 옮길 수 있나요?
네. 「내보내기」로 라벨 형식을 JSON 파일로 저장하고, 대상 환경에서 「가져오기」로 복원할 수 있습니다. 「복제」로 사본을 만든 뒤 수정할 수도 있고, 실수했을 때는 「복원」으로 마지막 저장 상태로 되돌릴 수 있습니다.
어떤 프린터 연결 방식을 지원하나요?
네트워크(TCP raw, 보통 포트 9100), USB／블루투스 시리얼(COM 포트), Windows 시스템 프린터 세 가지입니다. 블루투스 SPP는 Windows에서 보통 COM 포트로 표시됩니다. BLE 라벨 프린터는 SortingGo APP의 Device BLE 모드가 직접 처리하므로 여기서 만들 필요가 없습니다.
명령 프로토콜(TSPL, ZPL, EPL, ESC/POS)은 어떻게 선택하나요?
명령 프로토콜은 프린터가 지원하는 방식에 맞춰 선택하세요. TSC 호환 기종은 주로 TSPL/TSPL2, Zebra 호환 기종은 ZPL/ZPL II, 구형 Zebra/Eltron 호환 기종은 EPL, 열전사 영수증 프린터는 ESC/POS를 사용합니다. 글자를 내장 폰트가 아닌 비트맵으로 출력하려면 인쇄 콘텐츠 모드를 이미지로 선택합니다. 명령어 텍스트가 그대로 인쇄되거나 빈 라벨이 나오면 대부분 프로토콜 또는 콘텐츠 모드 선택이 잘못된 경우입니다.
한글이나 다른 언어가 깨져서 나오면 어떻게 하나요?
먼저 명령 프로토콜이 올바른지 확인한 뒤, 문자 인코딩을 하나씩 바꿔가며 테스트하세요(auto, utf-8, big5, gbk, shift_jis, cp949, cp874, cp1258, cp1252 지원). 테스트 라벨에는 선택한 인코딩의 언어 샘플이 인쇄됩니다. Raw 모드는 프린터 내장 폰트에 따라 제한되므로, 모든 언어를 확실히 인쇄하려면 Windows 드라이버(PDF/Bitmap) 모드로 전환하세요.
Windows 프린터의 출력 모드는 어떤 차이가 있나요?
Raw 명령 모드는 TSPL/ZPL 등 명령을 직접 전송해 빠르지만 프린터 내장 폰트에 제한됩니다. Windows 드라이버 모드(PDF/Bitmap)는 시스템이 렌더링해 다국어에 가장 안정적이지만 Microsoft Edge가 필요합니다. GDI 대체 모드는 브라우저 렌더링을 사용하지 않습니다. 대량 인쇄 시에는 인쇄 렌더링 성능 모드(저빈도 안정 우선／중빈도 균형／고빈도 성능 우선)를 조정할 수 있습니다.
프린터가 반응이 없을 때 어떻게 진단하나요?
먼저 이 페이지에서 「테스트 인쇄」를 실행한 뒤, 프린터 전원과 연결 상태, 네트워크 프린터의 IP/포트, COM 포트 존재 여부와 점유 여부, Windows 프린터 이름을 순서대로 확인하세요. 그래도 안 되면 인쇄 기록에서 상세 정보를 확인하거나 .bin 명령 파일을 다운로드해 「명령 파일 가져와서 테스트 인쇄」로 재생해 보세요.
이전 인쇄 명령을 다시 재생할 수 있나요?
네. 인쇄 기록의 상세 정보에서 컴파일된 .bin 명령 파일을 다운로드한 뒤, 프린터 관리 페이지의 「명령 파일 가져와서 테스트 인쇄」로 라벨 형식 컴파일 없이 그대로 프린터에 전송할 수 있습니다. 네트워크／시리얼／Windows RAW 프린터만 지원하며 Windows 드라이버 모드는 지원하지 않습니다.
Excel을 가져와 인쇄할 때 제한 사항은 무엇인가요?
파일 크기는 10 MB 이하이며, 행 수·열 수·셀 길이·전체 셀 수에 제한이 있습니다. 수식이 포함된 셀은 거부됩니다. 파싱 과정에서 서버에 파일을 임시 저장하지 않으며, 참조 데이터 소스를 생성하거나 영향을 주지도 않습니다. 건수가 많으면 나눠서 인쇄하는 것을 권장합니다.
PDF 내보내기가 실패하면 어떻게 하나요?
PDF 렌더링에는 서비스 계정이 실행할 수 있는 Microsoft Edge가 필요합니다. Edge 설치 여부를 확인하고 서비스 로그를 확인한 뒤, 레이아웃을 단순화(예: 큰 이미지 제거)해서 다시 테스트해 보세요. 그래도 실패하면 최신 버전 Print Service로 업그레이드하세요.
라벨에 왜 '체험판'과 SortingGo 표시가 붙나요?
PRO/ENT 라이선스가 없으면(FREE, LITE, STD 또는 미인증) 모든 출력물에 체험판과 SortingGo 표시가 강제로 추가됩니다. 인쇄 기능 자체는 제한되지 않습니다. 표시를 없애려면 유효한 Pro/Ent 라이선스가 필요하며, 라이선스 상태 페이지에서 현재 판단 결과를 확인할 수 있습니다.
여러 인쇄 작업이 서로 방해가 되나요?
아니요. 같은 물리 프린터의 작업은 순차 대기열로 들어가 순서대로 처리되며, 다른 프린터는 각자 별도로 대기합니다. 짧은 시간에 많은 작업을 보내면 인쇄가 대기 상태가 될 수 있으니, 인쇄 버튼을 반복해서 누르지 말고 중복 인쇄를 피하세요.
테스트 인쇄가 성공하면 실제 인쇄도 반드시 성공하나요?
보장되지 않습니다. 실제 인쇄는 라벨 레이아웃, 실제 데이터 내용, 용지, 프린터 상태의 영향을 받습니다. 대량 인쇄 전에 소량의 실제 데이터로 먼저 인쇄해 확인하는 것을 권장합니다.
인쇄 기록에서 무엇을 조회할 수 있나요?
상태(pending, printing, compiled, completed, failed 등), 소스(Web 또는 API), 날짜 범위로 필터링할 수 있습니다. 각 기록에는 시간, 데이터 형식, 라벨 형식, 기기, 종류, 매수, 부수, 체험판 표시, 상태가 포함되며 명령 상세 정보도 확인할 수 있습니다.
인쇄 기록은 자동으로 삭제되나요?
기본 보관 기간은 90일이며, 0으로 설정하면 자동 삭제되지 않습니다. 자동 삭제는 서비스 재시작 시나 24시간마다의 예약 점검 시 실행되며, 설정 저장 즉시 삭제되는 것은 아닙니다. 즉시 삭제하려면 「인쇄 기록 수동 삭제」를 사용하되, 이 작업은 되돌릴 수 없습니다.
인쇄 기록을 내보낼 수 있나요?
네, Excel로 내보낼 수 있으며 조건에 맞는 최대 5000건까지 가능합니다. 더 많은 데이터가 필요하면 날짜 범위를 좁혀 여러 번 나눠서 내보내세요.
일부 기록에는 왜 다운로드할 명령 파일이 없나요?
Windows 드라이버 모드(PDF/Bitmap)로 인쇄한 작업은 raw 명령 파일을 생성하지 않거나, 아직 컴파일 단계에 도달하지 않아 .bin이 없을 수 있습니다. Raw 명령으로 인쇄한 기록은 상세 정보에서 .bin을 다운로드해 재생 진단에 활용할 수 있습니다.
일부 라벨만 재인쇄할 수 있나요?
단일 라벨 작업은 명세를 펼쳐 재인쇄할 항목만 선택할 수 있습니다. 소계 라벨은 한 장에 그룹 전체를 집계한 것이므로 항상 그룹 전체를 재인쇄합니다.
재인쇄할 때 프린터를 바꾸거나 여러 부 인쇄할 수 있나요?
네. 재인쇄 대화상자에서 원하는 서버 측 프린터를 대상으로 선택할 수 있으며, 부수는 1~99까지 설정할 수 있습니다. Web 재인쇄에는 서버 측 프린터가 최소 1대 필요하므로, 없으면 먼저 프린터 관리에서 만들어 주세요.
재인쇄하면 원래의 체험판 표시가 사라지나요?
아니요. 재인쇄는 원본 기록의 체험판 상태를 그대로 유지합니다. 원본에 체험판 표시가 있었다면 재인쇄된 라벨에도 체험판과 SortingGo 표시가 그대로 남습니다.
휴대폰 BLE로 인쇄한 기록도 Web에서 재인쇄할 수 있나요?
네. APP의 Device BLE 모드로 인쇄한 기록도 재인쇄 조회에 표시되며, Web에서 재인쇄하면 선택한 서버 측 프린터로 전송됩니다.
API Key는 어디에 쓰이나요?
API Key는 SortingGo APP(또는 외부 시스템)이 Print Service의 인쇄 API를 호출할 때 사용하는 인증 정보입니다. APP의 「설정 > 인쇄 설정」에서 서버 주소와 이 키를 입력하면 연결해 인쇄할 수 있습니다.
API Key 평문을 나중에 다시 볼 수 있나요?
볼 수 없습니다. 평문은 생성 시 한 번만 표시되며, 페이지를 벗어나면 다시 볼 수 없으므로 즉시 복사해 보관하세요. 분실했다면 새 키를 만들고 기존 키를 폐기하면 됩니다.
APP에 'API Key가 유효하지 않습니다'라고 표시되면 어떻게 하나요?
대부분 키 입력 오류이거나 이미 폐기된 키입니다. 이 페이지에서 기존 키를 폐기하고 새로 만든 뒤, APP의 인쇄 설정에 새 키를 입력하고 연결 테스트를 하세요. 폐기하면 해당 키를 쓰던 APP은 즉시 인쇄 API를 호출할 수 없게 됩니다.
관리자와 일반 사용자는 어떻게 다른가요?
일반 사용자는 인쇄와 조회를 할 수 있고, 관리자는 추가로 사용자, API Key, 라이선스, 고위험 설정(인쇄 기록 삭제 등)을 관리할 수 있습니다. 평소 작업에는 일반 사용자 계정을 사용하고, 관리 작업이 필요할 때만 관리자 계정을 사용하는 것을 권장합니다.
기본 계정과 비밀번호는 무엇인가요? 왜 변경해야 하나요?
최초 설치 시 기본 계정은 admin / sortinggo입니다. 이는 공개된 정보이므로 서비스에 접속할 수 있는 누구나 로그인할 수 있어, 첫 로그인 후 즉시 비밀번호를 변경해야 합니다. 새 사용자 비밀번호는 최소 8자 이상이어야 합니다.
각 명령 프로토콜(TSPL, ZPL, EPL, ESC/POS)은 어떤 언어를 지원하나요? 어떻게 선택해야 하나요?
텍스트 명령 모드에서 특정 언어가 인쇄되는지는 프린터 내장 폰트에 달려 있으며, 소프트웨어 설정만으로 보장되지 않습니다. TSPL/TSPL2는 이미 각 언어(중국어, 영어, 일본어, 한국어, 태국어, 베트남어)에 대한 폰트 매핑을 시도합니다. ZPL/ZPL II는 기본적으로 라틴 폰트만 있어 중국어, 일본어, 한국어, 태국어, 베트남어를 인쇄하려면 프린터 설정에서 "ZPL 국제 폰트"(프린터 메모리에 내장되었거나 직접 설치한 아시아/국제 폰트 파일명, 예: E:SIMSUN.FNT)를 설정해야 합니다. 설정하지 않으면 ZPL은 영어나 스페인어 같은 라틴 문자만 인쇄할 수 있습니다. ESC/POS는 이미 중국어, 일본어, 한국어를 지원하지만 태국어는 대응 코드표가 없어 지원되지 않습니다. EPL은 라틴 문자 이외 언어를 전혀 지원하지 않습니다. 프린터에 해당 폰트가 실제로 있는지 확실하지 않다면, "인쇄 내용 모드"를 이미지로 전환하는 것이 가장 안전합니다. 시스템이 텍스트를 비트맵으로 렌더링한 후 전송하므로 프린터 내장 폰트의 제한을 받지 않고 모든 언어의 인쇄가 보장됩니다. 인쇄 후 경고가 표시되면 어떤 필드의 어떤 언어가 현재 설정에서 인쇄되지 않는지와 권장 조치가 함께 표시됩니다.
체험판 표시는 어떻게 없애나요?
유효한 Pro 또는 Ent 라이선스가 필요합니다. 이 페이지에서 라이선스 센터가 발급한 Signed Entitlement(compact JWS)를 가져와 활성화하거나, 신뢰 모드에서는 APP이 전달하는 PRO/ENT 등급을 사용할 수 있습니다. FREE, LITE, STD는 인쇄는 가능하지만 출력물에 체험판 표시가 붙습니다.
라이선스 활성화에 실패하거나 체험판 표시가 계속 나오면 어떻게 하나요?
「Trial Mark 진단」의 판단 결과를 확인하세요. 흔한 원인은 라이선스 만료, 서명 검증 실패, 검증용 공개키 미설정, 라이선스 등급이 Pro/Ent가 아님, 또는 라이선스에 label_print_no_trial 권한이 없는 경우입니다. 붙여넣은 것이 완전한 compact JWS인지 확인하고, 필요하면 라이선스 센터에서 다시 발급받으세요.
환불에는 어떤 제한이 있나요? 환불 후에는 어떻게 되나요?
환불은 구매 후 30일 이내에, Owner Session(Email + License Key를 함께 검증한 세션. Email만으로 복구한 Recovery Session으로는 불가)으로만 셀프서비스로 요청할 수 있습니다. 확정되면 서버는 즉시 해당 라이선스를 환불됨으로 표시하고, 이후 어떤 장치도 활성화나 갱신을 할 수 없습니다. 이는 되돌릴 수 없습니다. 환불을 요청한 그 장치는 자신의 로컬 캐시를 즉시 지우지만, 같은 라이선스를 공유하는 다른 장치가 있다면(Professional은 최대 2대) 각자의 캐시는 자체 30일 만료 시점까지 유효할 수 있습니다. 이는 오프라인 설계의 알려진 동작이며 결함이 아닙니다.
정상 비활성화, Emergency Reset, License Key 분실 시 복구는 어떻게 다른가요?
"정상 비활성화"는 아직 조작 가능한 장치에서 실행하며 슬롯을 즉시 해제하고 Reset 횟수에는 전혀 포함되지 않습니다. 기기를 교체하거나 더 이상 쓰지 않을 때는 항상 이것을 먼저 사용하세요. "Emergency Reset"은 장치를 분실하거나 파손해 스스로 조작할 수 없을 때 사용하며, 먼저 Email + License Key로 검증한 Owner Session이 필요하고 rolling 365일 최대 12회 한도에 포함되며, 실행하면 그 장치의 라이선스는 즉시 취소되고 되돌릴 수 없습니다. "License Key를 잊었을 때"는 Key 자체를 분실했을 때의 복구 경로로, 이메일만으로 제한된 Recovery Session을 얻을 수 있습니다. 장치 목록 확인과 Reset은 가능하지만 환불 요청이나 Key 재발급은 할 수 없습니다. 이 두 가지는 반드시 Email + Key로 검증한 Owner Session이 필요합니다.