바코드와 리테일
벡터 PDF 라벨을 위한 GS1 바코드 API
GS1-128, GS1 DataMatrix, GS1 QR, ITF-14, SSCC-18 라벨 워크플로를 포함해 PDF 안에 벡터 GS1 바코드를 렌더링합니다.
주 API JSON Render
ENDPOINT
/api/v1/pdf/render 시스템 리테일 백엔드 / WMS / 카탈로그 시스템 / 창고 시스템
해결할 작업
GS1 바코드 요청 데이터를 벡터 PDF 라벨이나 문서로 렌더링하되, 제품·창고·리테일 시스템이 올바른 응용 식별자(AI), 체크 디지트, 스캐너 승인 책임을 유지합니다.
이 API를 쓰는 경우
- 붙여 넣은 비트맵 이미지가 아니라 PDF 벡터 콘텐츠로 바코드 모듈을 그려야 합니다.
- 시스템에 이미 올바른 GS1 데이터와 사람이 읽을 수 있는 해석이 있습니다.
- 라벨이나 문서에서 GS1-128, GS1 DataMatrix, GS1 QR, ITF-14 또는 SSCC-18 워크플로가 필요합니다.
- 반복되는 바코드 라벨 레이아웃을 Template Render로 옮기고 싶습니다.
대체하지 않는 것
- gPdf에서 GS1 인증 또는 제품 데이터 의미 검증을 받아야 합니다.
- gPdf가 GS1 회사 접두어, GTIN, SSCC 또는 체크 디지트를 할당해야 합니다.
- 재고 또는 제품 마스터 데이터 관리가 필요합니다.
호출할 endpoint
/api/v1/pdf/render
JSON Render가 이 처리 흐름의 기본 경로입니다.
/api/v1/template-render
관련 API 경로, 템플릿 계약 또는 capability 조회가 필요할 때 사용합니다.
최소 request
POST /api/v1/pdf/render - GS1-128 스타일 PDF 바코드 요소.
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "barcode",
"format": "gs1-128",
"content": "(00)012345678901234567",
"x": 8,
"y": 22,
"width": 86,
"height": 24,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 8,
"y": 56,
"content": "SSCC pallet label",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf가 처리하는 것
- PDF 출력 내부의 벡터 바코드 렌더링.
- 텍스트, 선, 제품 데이터, 라벨 구조와 함께 바코드 배치.
- 반복되는 제품, 팔레트, 카턴, 창고 라벨을 위한 Template Render.
- 스캐너 및 인쇄 테스트에 사용할 수 있는 PDF 출력.
자체 시스템이 책임지는 것
- GS1 응용 식별자(AI), 회사 접두어, GTIN, SSCC, 체크 디지트.
- 올바른 바코드 데이터, 제품 데이터, 규제 문구, 스캐너 승인 테스트.
- 인쇄 프로세스, 라벨 용지, quiet zone, 운영 QA.
운영 전 체크리스트
- GS1 요청 데이터를 상류 시스템에서 생성하고 테스트 가능하게 유지합니다.
- 운영 프린터와 스캐너에서 인쇄 및 스캔 테스트를 수행합니다.
- quiet zone, 모듈 크기, 사람이 읽을 수 있는 텍스트, 라벨 용지를 검증합니다.
- 라벨 레이아웃이 승인되면 Template Render를 사용합니다.
- gPdf는 바코드를 렌더링하지만 GS1 준수를 인증하지 않는다는 점을 문서화합니다.
지원 범위의 경계
- gPdf는 벡터 PDF 바코드를 렌더링하며, GS1 인증 기관이 아닙니다.
- GS1 데이터 의미와 체크 디지트는 호출자가 책임집니다.
- 스캐너 승인은 호출자의 운영 환경에서 검증해야 합니다.
GS1 바코드 렌더링은 PDF 렌더링 작업입니다
gPdf는 바코드를 PDF에 그리는 일을 담당합니다. GTIN, SSCC 또는 응용 식별자(AI) 시퀀스가 비즈니스에 유효한지 판단하는 일은 gPdf의 책임이 아닙니다. 그 로직은 ERP, WMS, 제품 정보 시스템 또는 GS1 도구에 유지하세요.
JSON Render 또는 Template Render를 사용하세요
코드가 라벨이나 문서를 직접 배치한다면 JSON Render를 사용하세요. 바코드가 반복 라벨 레이아웃 안의 한 필드라면 Template Render를 사용하세요. 두 경우 모두 호출자가 인코딩해야 할 요청 데이터를 보냅니다.
실제 스캐너로 검증하세요
바코드 성공 여부는 모니터에서 이미지가 올바르게 보이는지가 아니라 스캐너 승인으로 판단합니다. 운영에서 사용하는 동일한 프린터, 스캐너, 라벨 용지로 인쇄 출력을 검증하세요.
FAQ
- gPdf가 GS1 라벨을 인증하나요?
- 아니요. gPdf는 PDF 안에 벡터 바코드 그래픽을 렌더링합니다. GS1 데이터의 정확성, 스캐너 테스트, 인증 워크플로는 팀에서 담당합니다.
- GS1 바코드를 Template Render와 함께 사용할 수 있나요?
- 예. 게시된 템플릿에 바코드 필드를 둘 수 있으며, 호출자는 반복 라벨 레이아웃에 필요한 가변 데이터만 보낼 수 있습니다.
- SSCC 또는 GTIN은 누가 생성하나요?
- 제품, 창고 또는 ERP 시스템이 식별자를 생성하고 검증합니다. gPdf는 요청 데이터를 받아 렌더링합니다.
- 왜 벡터 바코드를 사용하나요?
- 벡터 모듈은 래스터 스케일링 아티팩트를 피하고, 프린터 DPI와 확대 수준이 달라져도 라벨 PDF를 더 선명하게 유지합니다.