물류와 라벨

창고와 3PL 워크플로를 위한 팔레트 라벨 API

SSCC, GS1-128, 텍스트 블록, 재출력에 안전한 템플릿을 사용해 창고, 3PL, 리테일, 물류 워크플로용 팔레트 라벨 PDF를 생성합니다.

주 API JSON Render
ENDPOINT /api/v1/pdf/render
시스템 WMS / 3PL 백엔드 / ERP 내보내기 서비스 / 창고 인쇄 서비스
해결할 작업

WMS, ERP 또는 3PL 데이터에서 팔레트 라벨 PDF를 렌더링하여 창고 팀이 팔레트를 식별하고 SSCC 또는 GS1 바코드를 스캔하며 입고, 출고, 재고 이동 중 동일한 라벨을 재출력할 수 있게 합니다.

이 API를 쓰는 경우

  • WMS에 팔레트 ID, SKU 또는 GTIN 데이터, 수량, 로트, 목적지가 이미 있습니다.
  • SSCC, GS1-128 또는 기타 지원 바코드 형식이 포함된 PDF 라벨이 필요합니다.
  • 같은 원본 요청 데이터에서 결정적인 재출력을 원합니다.
  • 레이아웃을 안정적인 Template Render 계약으로 만들 필요가 있습니다.

대체하지 않는 것

  • gPdf가 재고, 팔레트 구성 또는 창고 작업을 관리해야 합니다.
  • PDF 바코드 렌더링이 아니라 GS1 인증이 필요합니다.
  • 프린터 명령 출력을 직접 받아야 합니다.

호출할 endpoint

주 경로

/api/v1/pdf/render

JSON Render가 이 처리 흐름의 기본 경로입니다.

보조 경로 1

/api/v1/template-render

관련 API 경로, 템플릿 계약 또는 capability 조회가 필요할 때 사용합니다.

최소 request

POST /api/v1/pdf/render - SSCC 바코드가 포함된 팔레트 라벨.

{
  "pages": [
    {
      "size": "label_4_6_in",
      "elements": [
        {
          "type": "text",
          "x": 5,
          "y": 7,
          "content": "PALLET 12 / DOCK B",
          "style": { "font_size": 13, "font_family": "NotoSans-Regular" }
        },
        {
          "type": "barcode",
          "format": "sscc-18",
          "content": "000123456789012345",
          "x": 5,
          "y": 28,
          "width": 92,
          "height": 30,
          "barcode_text": { "enabled": true, "position": "bottom" }
        },
        {
          "type": "text",
          "x": 5,
          "y": 78,
          "content": "GTIN 09506000134352\nQTY 48 CASES\nLOT L-2026-05",
          "style": { "font_size": 10, "font_family": "NotoSans-Regular" }
        }
      ]
    }
  ]
}

gPdf가 처리하는 것

  • 텍스트, 박스, 바코드 요소가 포함된 라벨 크기 PDF 페이지.
  • PDF 출력에서 SSCC, GS1-128, Code 128, QR 및 기타 지원 바코드 형식.
  • 승인된 팔레트 라벨 레이아웃을 위한 템플릿 바인딩.
  • 재출력과 감사 증거를 위한 결정적인 출력.

자체 시스템이 책임지는 것

  • 팔레트 식별자, 제품 데이터, 로트 데이터, 수량, 라우팅, 창고 규칙.
  • 바코드 데이터 정확성, 체크 디지트, 스캐너 테스트, 라벨 용지 검증.
  • 인쇄 스테이션 라우팅, 재출력 승인, 재고 상태.

운영 전 체크리스트

  1. 렌더링 전에 SSCC 또는 GS1 데이터를 검증합니다.
  2. 입고와 출고 스테이션의 운영 스캐너로 라벨을 스캔합니다.
  3. 조밀한 데이터, 긴 제품명, 여러 창고 언어 요구사항을 테스트합니다.
  4. 재출력을 위해 template_id, 원본 팔레트 ID, 요청 ID를 기록합니다.
  5. 창고 상태 전이는 렌더링 API 밖에 둡니다.

지원 범위의 경계

  • gPdf는 팔레트 라벨 PDF를 렌더링합니다. 팔레트나 창고 재고를 관리하지 않습니다.
  • gPdf는 GS1 인증 기관이 아닙니다.
  • 스캐너 승인과 창고 프로세스 정확성은 사용자가 담당합니다.

팔레트 라벨은 WMS 데이터를 인쇄 출력과 연결합니다

팔레트 라벨 워크플로는 WMS 또는 ERP에서 시작됩니다. 어떤 팔레트, 제품, 수량, 로트, 경로 데이터가 라벨에 들어갈지 그 시스템이 결정합니다. gPdf는 그 데이터를 창고 인쇄 스테이션이 출력하고 재출력할 수 있는 PDF로 바꿉니다.

검색 의도가 SSCC-18 또는 GS1 물류 라벨링에 구체적으로 맞춰져 있다면 더 좁은 SSCC 페이지를 사용하세요. 이 페이지는 더 넓은 팔레트 라벨 워크플로에 사용합니다.

FAQ

gPdf가 SSCC 팔레트 라벨을 생성할 수 있나요?
gPdf는 PDF 출력에 SSCC 바코드 요소를 렌더링할 수 있습니다. SSCC 값과 GS1 의미는 사용자 시스템이 담당합니다.
gPdf가 팔레트 재고를 관리하나요?
아니요. WMS 또는 ERP 시스템이 재고 상태를 관리합니다. gPdf는 라벨 PDF를 렌더링합니다.
팔레트 라벨에 Template Render를 사용할 수 있나요?
네. 팔레트 라벨 레이아웃이 승인된 뒤에는 보통 Template Render가 운영 경로가 됩니다.
gPdf가 GS1 라벨을 인증하나요?
아니요. gPdf는 벡터 PDF 바코드를 렌더링합니다. 인증, 스캔 테스트, 승인 여부는 사용자가 담당합니다.