물류와 라벨
WMS와 ERP 인쇄 워크플로를 위한 창고 라벨 API
WMS 또는 ERP 데이터에서 팔레트, 케이스, 빈, 재고, 창고 운영 라벨 PDF를 생성하고 결정적인 재출력을 지원합니다.
주 API JSON Render
ENDPOINT
/api/v1/pdf/render 시스템 WMS / ERP / 창고 인쇄 서비스 / 재고 워크플로
해결할 작업
재고 상태, 피킹 규칙, 창고 운영은 호출자 시스템에 유지하면서 WMS 또는 ERP 데이터에서 팔레트, 박스, 빈, 자산, 위치, 재고 이동용 창고 라벨을 렌더링합니다.
이 API를 쓰는 경우
- 팔레트, 박스, 빈, 위치, 재고 또는 자산 라벨이 PDF로 필요합니다.
- WMS 또는 ERP가 이미 SKU, 로트, 위치, SSCC, 재고 데이터를 관리합니다.
- 라벨이 손상되었거나 스테이션이 작업을 재시도할 때 결정적인 재출력이 필요합니다.
- 승인된 라벨 레이아웃을 Template Render로 재사용하고 싶습니다.
대체하지 않는 것
- gPdf가 재고를 관리하거나 위치를 배정하거나 창고 워크플로를 실행해야 합니다.
- gPdf가 스캐너 앱, 인쇄 스테이션 에이전트, 라벨 라우팅 시스템을 제공해야 합니다.
- 바코드 렌더링이 아니라 GS1 인증이 필요합니다.
호출할 endpoint
/api/v1/pdf/render
JSON Render가 이 처리 흐름의 기본 경로입니다.
/api/v1/template-render
관련 API 경로, 템플릿 계약 또는 capability 조회가 필요할 때 사용합니다.
최소 request
POST /api/v1/pdf/render - SSCC 바코드 데이터가 포함된 팔레트 라벨.
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "text",
"x": 6,
"y": 8,
"content": "PALLET LAX-01-2026-00042",
"style": { "font_size": 12, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "sscc-18",
"content": "012345678901234567",
"x": 6,
"y": 30,
"width": 88,
"height": 26,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 6,
"y": 70,
"content": "SKU: CASE-001\nQTY: 48\nLOCATION: A-14-02",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf가 처리하는 것
- 창고 인쇄 워크플로를 위한 PDF 라벨.
- 벡터 바코드, 텍스트, 박스, 라벨 페이지 크기, 템플릿 바인딩.
- 재출력과 감사 워크플로를 위한 결정적인 출력.
- 맞춤 레이아웃용 JSON Render와 승인된 라벨 계약용 Template Render.
자체 시스템이 책임지는 것
- 재고 상태, SKU 데이터, 로트/시리얼 데이터, SSCC 값, 위치 의미.
- 프린터 라우팅, 스테이션 설정, 스캐너 검증, 창고 프로세스 규칙.
- 템플릿 선택, 재시도, 렌더링된 PDF 또는 원본 데이터 저장.
운영 전 체크리스트
- 실제 프린터와 라벨 용지에 맞춰 라벨 치수를 검증합니다.
- 창고 프로세스에서 사용하는 모든 바코드 형식을 스캔합니다.
- WMS/ERP 상태를 권위 있는 기준으로 유지하고 최종 라벨 데이터만 gPdf로 보냅니다.
- 여러 시스템이나 스테이션이 인쇄하는 라벨에는 Template Render를 사용합니다.
- 재출력 추적성을 위해 원본 문서 ID와 요청 ID를 기록합니다.
지원 범위의 경계
- gPdf는 창고 라벨 PDF를 렌더링합니다. 재고나 창고 상태를 관리하지 않습니다.
- 호출자가 바코드 데이터의 업무적 의미와 스캐너 승인 여부를 담당합니다.
- Template Render는 라벨 레이아웃을 안정화할 수 있지만 WMS 규칙을 대체하지 않습니다.
창고 라벨은 운영 기록입니다
창고 라벨은 팔레트, 케이스, 빈, 자산, 재고 이동, 위치를 식별합니다. 이런 라벨은 WMS 또는 ERP의 운영 상태와 연결되어 있습니다. gPdf는 최종 라벨 데이터를 받아 렌더링해야 하며, 재고의 의미나 창고 프로세스 상태를 결정해서는 안 됩니다.
Template Render는 인쇄 스테이션을 단순하게 만듭니다
여러 스테이션에서 쓰는 라벨은 승인된 레이아웃을 템플릿으로 게시하세요. 그러면
인쇄 서비스가 모든 호출자에서 좌표를 다시 만들지 않고 template_id와 WMS
데이터를 보낼 수 있습니다.
재출력 결정성
창고는 라벨을 다시 인쇄합니다. 라벨 손상, 프린터 걸림, 스테이션 재시도가 조금 다른 문서를 만들어서는 안 됩니다. 원본 라벨 데이터를 창고 레코드와 연결해 두고, 재출력에는 결정적인 렌더 입력을 사용하세요.
FAQ
- gPdf가 창고 재고를 관리하나요?
- 아니요. WMS 또는 ERP가 재고 상태, 위치, SKU, 로트, 프로세스 규칙을 관리합니다. gPdf는 최종 데이터에서 라벨 PDF를 렌더링합니다.
- 창고 라벨에 GS1 또는 SSCC 바코드를 사용할 수 있나요?
- 네. gPdf는 지원되는 바코드 형식을 PDF 출력에 렌더링할 수 있습니다. 바코드 데이터와 스캐너 승인 여부는 사용자 시스템이 담당합니다.
- 반복해서 쓰는 창고 라벨은 템플릿을 써야 하나요?
- 대체로 그렇습니다. 라벨 레이아웃이 승인된 뒤에는 Template Render가 인쇄 스테이션에 안정적인 template_id와 data 계약을 제공합니다.
- 재출력은 어떻게 처리해야 하나요?
- 원본 라벨 데이터 또는 생성된 PDF를 창고 레코드와 함께 저장한 뒤, 원래 운영 ID로 동일한 라벨을 다시 렌더링하거나 조회하세요.