물류와 라벨
라벨, 명세서, 창고 문서를 위한 물류 PDF API
WMS, OMS, 3PL 데이터에서 라벨, 포장 명세서, 운송장, 적하목록, 창고 문서 같은 구조화된 물류 PDF를 생성합니다.
주 API JSON Render
ENDPOINT
/api/v1/pdf/render 시스템 WMS / OMS / 3PL 백엔드 / 운송사 운영
해결할 작업
운송사 거래, 배송 라우팅, 창고 상태, 업무 규칙은 호출자 시스템에 둔 채, 구조화된 WMS, OMS, 3PL, 풀필먼트 데이터에서 운영용 물류 문서를 렌더링합니다.
이 API를 쓰는 경우
- 라벨, 포장 명세서, 적하목록, 운송장, 창고 서류용 PDF가 필요합니다.
- 물류 시스템이 이미 배송, 주문, 재고, 경로, 운송사 데이터를 알고 있습니다.
- 재현 가능한 재출력과 대량 API 렌더링이 필요합니다.
- 사용자를 더 좁은 라벨 및 창고 업무 흐름으로 안내하는 넓은 허브 페이지가 필요합니다.
대체하지 않는 것
- gPdf가 운임을 산정하거나 우편 요금을 구매하거나 운송사와 직접 통신해야 합니다.
- WMS, OMS, TMS 또는 재고 관리 기능이 필요합니다.
- PDF 생성 범위를 벗어난 네이티브 EDI, 통관 신고, 화물 중개 업무 흐름이 필요합니다.
호출할 endpoint
/api/v1/pdf/render
JSON Render가 이 처리 흐름의 기본 경로입니다.
/api/v1/template-render
관련 API 경로, 템플릿 계약 또는 capability 조회가 필요할 때 사용합니다.
최소 request
POST /api/v1/template-render - 구조화된 데이터에서 반복 물류 문서를 렌더링합니다.
{
"template_id": "packing_list",
"data": [
{
"order_number": "SO-8421",
"warehouse": "LAX-01",
"ship_to": "Example Retailer, 88 Harbor Rd, Long Beach, CA",
"items": [
{ "sku": "CASE-001", "description": "Widget case", "quantity": 4 },
{ "sku": "CASE-002", "description": "Replacement kit", "quantity": 1 }
]
}
]
}
gPdf가 처리하는 것
- 구조화된 물류 문서의 PDF 렌더링.
- 라벨 크기 페이지, A4/letter 문서, 바코드, 표, 주소 블록, 메타데이터.
- 승인된 창고 및 풀필먼트 문서 레이아웃을 위한 Template Render.
- 재출력과 감사 기록을 위한 일관된 출력.
자체 시스템이 책임지는 것
- 배송 상태, 운송사 서비스, 라우팅 규칙, 재고 상태, 문서 생성 가능 여부.
- WMS, OMS, TMS, ERP 또는 3PL 시스템에서 오는 업무 데이터 매핑.
- 프린터 라우팅, 저장, 전달, 재시도 로직, 운영 예외 처리.
운영 전 체크리스트
- 어떤 문서를 직접 JSON Render로 만들고 어떤 문서를 템플릿으로 만들지 결정합니다.
- 문서 유형마다 바코드, 주소, 표 overflow 케이스를 검증합니다.
- 재출력과 감사 요구사항에 맞춰 원본 데이터 또는 PDF를 저장합니다.
- 운송사 API 호출과 렌더링 API 호출을 별도 연동 단계로 유지합니다.
- 내용을 중복하지 말고 배송 라벨과 창고 라벨용 더 좁은 페이지를 연결합니다.
지원 범위의 경계
- gPdf는 물류 PDF를 생성합니다. 운송사, WMS, OMS, TMS, 우편 요금 제공자가 아닙니다.
- 배송 운임 산정, 라벨 구매, 재고 상태, 운송사 운영은 gPdf 밖에 남습니다.
- 이 넓은 페이지는 정확한 업무 의도를 위해 더 좁은 솔루션 페이지로 연결되어야 합니다.
물류 문서는 하나의 문서군입니다
물류 PDF 생성은 여러 문서 유형을 포함합니다. 배송 라벨, 창고 라벨, 포장 명세서, 적하목록, 운송장, 피킹 티켓, 내부 인수인계 문서가 여기에 포함됩니다. 이 페이지는 넓은 진입점입니다. 라벨과 바코드 중심 업무 흐름의 정확한 검색 의도는 더 좁은 페이지가 담당해야 합니다.
API 사용 패턴
대부분의 물류 문서는 JSON Render 또는 Template Render 중 하나를 사용합니다. JSON Render는 생성형 레이아웃이나 특수 문서에 맞습니다. Template Render는 운영팀이 안정적인 레이아웃과 작은 데이터 필드 집합을 기대하는 반복 문서에 맞습니다.
운영 시스템을 기준 정보로 유지
WMS, OMS, TMS, 3PL 플랫폼, ERP 또는 운송사 연동은 배송 상태와 업무 규칙의 기준 정보로 남습니다. gPdf는 최종 문서 데이터를 받아 PDF 출력을 만듭니다.
FAQ
- 이 페이지는 배송 라벨 페이지와 다른가요?
- 예. 이 페이지는 넓은 물류 문서 페이지입니다. 배송 라벨과 창고 라벨에는 더 구체적인 라벨 및 바코드 가이드를 담은 좁은 페이지가 있습니다.
- gPdf가 운송사를 호출하나요?
- 아니요. 운송사 API, 우편 요금, 배송 운임 산정, 라우팅은 자체 물류 스택이 처리합니다. gPdf는 받은 데이터에서 PDF를 렌더링합니다.
- 물류 문서에는 어떤 엔드포인트가 맞나요?
- 맞춤 레이아웃에는 JSON Render를, 포장 명세서나 창고 라벨처럼 승인된 반복 문서에는 Template Render를 사용하세요.
- 물류 페이지에 바코드를 포함할 수 있나요?
- 예. gPdf는 PDF 안에 바코드 요소를 렌더링하지만, 인코딩되는 입력 데이터와 운영 검증은 자체 시스템이 담당합니다.