바코드와 리테일
GS1 물류 PDF를 위한 SSCC 라벨 API
물류, 팔레트, 카턴, 창고 워크플로를 위해 SSCC-18 바코드 라벨을 PDF로 렌더링하되, GS1 데이터 정확성은 호출 시스템이 담당합니다.
주 API JSON Render
ENDPOINT
/api/v1/pdf/render 시스템 WMS / 3PL 백엔드 / 리테일 물류 시스템 / 창고 인쇄 서비스
해결할 작업
시스템이 serial shipping container code를 할당하고 GS1 의미를 검증한 뒤, 팔레트·카턴·물류 단위용 SSCC-18 바코드 라벨을 벡터 PDF 출력으로 렌더링합니다.
이 API를 쓰는 경우
- 시스템이 이미 SSCC 값과 관련 응용 식별자(AI)를 관리합니다.
- 스캔 가능한 SSCC 바코드와 사람이 읽을 수 있는 텍스트가 포함된 PDF 라벨이 필요합니다.
- 창고 또는 3PL 인쇄 스테이션용 반복 SSCC 라벨 레이아웃이 필요합니다.
- SSCC 라벨을 더 넓은 팔레트 또는 창고 라벨 워크플로와 연결하고 싶습니다.
대체하지 않는 것
- gPdf에서 GS1 접두어 발급, 체크 디지트 생성 또는 컴플라이언스 인증을 받아야 합니다.
- 재고 또는 배송 상태 관리가 필요합니다.
- 운송사 라벨 구매 또는 요율 산정이 필요합니다.
호출할 endpoint
/api/v1/pdf/render
JSON Render가 이 처리 흐름의 기본 경로입니다.
/api/v1/template-render
관련 API 경로, 템플릿 계약 또는 capability 조회가 필요할 때 사용합니다.
최소 request
POST /api/v1/pdf/render - SSCC-18 라벨 바코드.
{
"pages": [
{
"size": "label_100_150",
"elements": [
{
"type": "text",
"x": 6,
"y": 8,
"content": "SSCC",
"style": { "font_size": 12, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "sscc-18",
"content": "000123456789012345",
"x": 6,
"y": 28,
"width": 86,
"height": 30,
"barcode_text": { "enabled": true, "position": "bottom" }
}
]
}
]
}
gPdf가 처리하는 것
- PDF 페이지 내부의 벡터 SSCC 바코드 렌더링.
- 텍스트, 박스, 바코드 텍스트, 선택적 템플릿 바인딩을 포함한 라벨 레이아웃.
- 인쇄, 저장 또는 창고 재인쇄 워크플로를 위한 PDF 출력.
- 요청 검증 실패 시 공통 오류 envelope.
자체 시스템이 책임지는 것
- GS1 회사 접두어, 확장 숫자, 일련 참조, 체크 디지트, 인코딩할 데이터.
- 창고 프로세스 규칙, 스캐너 승인, 라벨 용지 검증.
- SSCC를 사용하는 EDI, ASN, 운송사 또는 거래 파트너 워크플로.
운영 전 체크리스트
- gPdf를 호출하기 전에 SSCC 값과 체크 디지트를 검증합니다.
- 운영 스캐너와 라벨 용지로 출력을 스캔합니다.
- 어떤 창고 이벤트가 SSCC 라벨을 생성하고 재인쇄하는지 문서화합니다.
- 승인된 SSCC 라벨 레이아웃에는 Template Render를 사용합니다.
- 거래 파트너 컴플라이언스 검사는 Render 호출 밖에 둡니다.
지원 범위의 경계
- gPdf는 SSCC 바코드를 PDF로 렌더링하며, SSCC 값을 발급하거나 인증하지 않습니다.
- GS1 및 거래 파트너 컴플라이언스는 호출 시스템의 책임입니다.
- SSCC 라벨이 운송사 배송 생성을 의미하지는 않습니다.
SSCC 라벨은 초점이 좁은 바코드 워크플로입니다
SSCC 라벨은 일반 팔레트 라벨보다 범위가 좁습니다. 핵심은 serial shipping container code 자체입니다. gPdf는 그 코드를 PDF로 렌더링합니다. 코드 할당, GS1 규칙, 거래 파트너 요구사항은 호출 시스템이 담당합니다.
FAQ
- gPdf가 SSCC 번호를 만들 수 있나요?
- 아니요. 호출 시스템이 SSCC 값을 생성하고 검증합니다. gPdf는 그것을 PDF 안의 바코드로 렌더링합니다.
- 어떤 바코드 형식을 사용해야 하나요?
- SSCC 바코드 요소를 렌더링할 때 sscc-18 같은 지원되는 SSCC alias를 사용하세요.
- 템플릿으로 만들 수 있나요?
- 예. 대부분의 SSCC 라벨은 레이아웃과 필드 매핑이 승인된 뒤 Template Render로 옮기는 것이 좋습니다.
- 이것이 GS1 준수를 인증하나요?
- 아니요. gPdf는 벡터 바코드 출력을 렌더링합니다. 컴플라이언스와 스캐너 승인은 별도의 책임입니다.