바코드와 리테일
벡터 PDF 출력을 위한 DataMatrix 바코드 API
제품, 의료, 리테일, 창고 워크플로를 위해 PDF 라벨과 문서 안에 DataMatrix 및 GS1 DataMatrix 바코드를 렌더링합니다.
주 API JSON Render
ENDPOINT
/api/v1/pdf/render 시스템 제품 라벨 시스템 / 창고 백엔드 / 리테일 백엔드 / 규제 대상 제품 워크플로
해결할 작업
DataMatrix 또는 GS1 DataMatrix 요청 데이터를 제품 라벨, 창고 라벨 또는 문서 안의 벡터 PDF 바코드 요소로 렌더링하되, 인코딩된 비즈니스 데이터의 책임은 호출 시스템에 남겨둡니다.
이 API를 쓰는 경우
- PDF 문서나 라벨 안에 2D DataMatrix 바코드가 필요합니다.
- 애플리케이션이 인코딩할 식별자, 로트, 시리얼 또는 제품 데이터를 이미 알고 있습니다.
- Template Render를 통해 반복되는 DataMatrix 라벨 레이아웃이 필요합니다.
- PDF 안에 래스터 이미지를 삽입하는 대신 벡터 바코드 출력이 필요합니다.
대체하지 않는 것
- gPdf에서 규제 인증, 의료기기 라벨 승인 또는 GS1 인증을 받아야 합니다.
- gPdf가 비즈니스 식별자를 생성하거나 외부 레지스트리를 조회해야 합니다.
- 스캐너 장비 관리가 필요합니다.
호출할 endpoint
/api/v1/pdf/render
JSON Render가 이 처리 흐름의 기본 경로입니다.
/api/v1/template-render
관련 API 경로, 템플릿 계약 또는 capability 조회가 필요할 때 사용합니다.
최소 request
POST /api/v1/pdf/render - 제품 라벨의 GS1 DataMatrix 바코드.
{
"pages": [
{
"size": "label_100_100",
"elements": [
{
"type": "barcode",
"format": "gs1-datamatrix",
"content": "(01)09506000134352(10)LOT26A",
"x": 10,
"y": 14,
"width": 34,
"height": 34
},
{
"type": "text",
"x": 10,
"y": 56,
"content": "GTIN 09506000134352\nLOT LOT26A",
"style": { "font_size": 9, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf가 처리하는 것
- PDF 안의 벡터 DataMatrix 및 GS1 DataMatrix 바코드 렌더링.
- 바코드 주변의 라벨 또는 문서 레이아웃.
- 반복되는 제품 또는 창고 라벨을 위한 템플릿 바인딩.
- 인쇄, 보관 또는 다운로드 워크플로를 위한 바이너리 PDF 출력.
자체 시스템이 책임지는 것
- 인코딩된 요청 데이터 내용, 응용 식별자(AI), 시리얼, 로트, 규제 문구.
- 스캐너 테스트, 모듈 크기 검증, 라벨 용지, 승인 기준.
- 바코드를 사용하는 업종별 컴플라이언스 워크플로.
운영 전 체크리스트
- 렌더링 전에 요청 데이터 문법을 검증합니다.
- 운영 크기, DPI, 소재로 인쇄하고 스캔합니다.
- 긴 식별자와 여러 제품 언어 변형을 테스트합니다.
- 인증과 규제 검토는 gPdf 밖에 둡니다.
- 승인된 라벨 패밀리에는 Template Render를 사용합니다.
지원 범위의 경계
- gPdf는 DataMatrix 바코드를 렌더링하며, 규제 준수를 인증하지 않습니다.
- 바코드 데이터의 업무상 의미와 스캐너 승인은 호출 시스템의 책임입니다.
- 벡터 렌더링은 물리적 인쇄 검증을 대체하지 않습니다.
PDF 안의 DataMatrix는 렌더링 작업입니다
DataMatrix 바코드는 제품 또는 물류 식별자를 담는 경우가 많습니다. 중요한 경계는 인코딩할 데이터입니다. gPdf는 사용자가 보낸 값에서 벡터 바코드를 렌더링합니다. 그 값이 무엇을 의미하고 외부 요구사항을 충족하는지는 호출 시스템이 판단합니다.
FAQ
- gPdf가 DataMatrix 바코드를 지원하나요?
- 예. 공개 schema에는 datamatrix와 GS1 DataMatrix 바코드 형식 alias가 포함되어 있습니다.
- gPdf가 규제 콘텐츠를 검증하나요?
- 아니요. gPdf는 바코드를 렌더링합니다. 요청 데이터의 정확성과 규제 검토는 호출 시스템의 책임입니다.
- DataMatrix 라벨에 Template Render를 사용할 수 있나요?
- 예. 반복 라벨 레이아웃이 비즈니스 데이터만 받도록 해야 할 때 Template Render를 사용하세요.
- 그래도 스캔 테스트가 필요한가요?
- 예. 항상 운영 프린터, 소재, 스캐너로 검증하세요.