물류와 라벨
풀필먼트 워크플로를 위한 패킹 슬립 PDF API
이커머스, 3PL, OMS, 창고 풀필먼트 워크플로를 위해 주문, 배송, 박스, 품목 데이터에서 패킹 슬립 PDF를 생성합니다.
주 API Template Render
ENDPOINT
/api/v1/template-render 시스템 OMS / WMS / 3PL 백엔드 / Shopify 앱 백엔드
해결할 작업
배송, 수취인, 품목, 박스 데이터에서 패킹 슬립을 렌더링하여 풀필먼트 팀이 각 출고 주문에 대해 일관된 문서를 인쇄하거나 동봉할 수 있게 합니다.
이 API를 쓰는 경우
- OMS 또는 WMS에 주문 품목, 수량, 수취인 데이터, 배송 식별자가 이미 있습니다.
- 창고 인쇄 스테이션이나 고객 택배 동봉용 PDF 패킹 슬립이 필요합니다.
- 하나의 승인된 레이아웃을 여러 창고, 브랜드, 판매 채널에서 재사용하고 싶습니다.
- 주문 조회나 반품 접수를 위한 바코드 또는 QR 코드가 필요할 수 있습니다.
대체하지 않는 것
- 운임 구매, 배송 요금 산정, 운송사 라벨 생성이 필요합니다.
- 문서 렌더링이 아니라 창고 재고 관리가 필요합니다.
- 법적 인보이스 또는 전자 인보이스의 의미가 필요합니다.
호출할 endpoint
/api/v1/template-render
Template Render가 이 처리 흐름의 기본 경로입니다.
/api/v1/pdf/render
관련 API 경로, 템플릿 계약 또는 capability 조회가 필요할 때 사용합니다.
최소 request
POST /api/v1/template-render - 한 건의 배송을 포함한 packing_list 템플릿.
{
"template_id": "packing_list",
"data": [
{
"shipment": {
"number": "PL-2026-1001",
"date": "2026-05-29"
},
"shipper": {
"name": "Acme Warehouse",
"address": "1200 Logistics Pkwy"
},
"consignee": {
"name": "Receiver Inc.",
"address": "123 Main St"
},
"items": [
{
"item_no": "1",
"description": "Replacement filter",
"quantity": "2",
"unit": "pcs",
"gross_weight": "1.2 kg",
"net_weight": "1.0 kg"
}
]
}
]
}
gPdf가 처리하는 것
- 게시된 패킹 슬립 레이아웃을 위한 Template Render.
- 설계 중이거나 일회성 워크플로에서 맞춤 패킹 슬립 페이지를 위한 JSON Render.
- 표, 품목 행, 주소 블록, 선택적 바코드, PDF 출력.
- 같은 데이터와 템플릿을 사용할 때의 결정적인 재출력.
자체 시스템이 책임지는 것
- 주문 데이터, 품목 수량, 배송 상태, 창고 라우팅, 고객 안내.
- 템플릿 필드 매핑, 인쇄 스테이션 라우팅, 재출력 정책.
- 택배와 함께 이동해야 하는 운송사, 통관 또는 인보이스 문서.
운영 전 체크리스트
- 가장 긴 SKU, 품목명, 주소 조합을 테스트합니다.
- 단일 품목, 다중 박스, 백오더, 부분 배송 케이스를 검증합니다.
- 패킹 슬립 레이아웃이 승인된 뒤에는 Template Render를 사용합니다.
- 각 풀필먼트 인쇄 요청에 대해 template_id와 X-Request-Id를 로그에 남깁니다.
- 운송사 라벨 생성은 패킹 슬립 렌더링과 분리합니다.
지원 범위의 경계
- gPdf는 패킹 슬립 PDF를 렌더링합니다. 재고나 풀필먼트 상태를 관리하지 않습니다.
- 패킹 슬립은 자동으로 세금 인보이스나 통관 문서가 되지 않습니다.
- 운송사 라벨 구매와 배송 요금 산정은 gPdf 범위 밖입니다.
패킹 슬립은 템플릿 경로에 잘 맞습니다
패킹 슬립은 보통 발송인, 수취인, 배송 번호, 품목 행, 선택적 메모처럼 안정적인 구조를 갖습니다. 그래서 레이아웃이 승인된 뒤에는 Template Render가 잘 맞습니다.
JSON Render도 설계 단계에서는 여전히 중요합니다. 안정적인 template_id 계약을
게시하기 전에 팀이 열, 간격, 바코드 위치, 페이지 나눔을 조정할 수 있게 합니다.
FAQ
- 패킹 슬립은 별도의 gPdf 엔드포인트인가요?
- 아니요. 승인된 패킹 슬립 템플릿에는 Template Render를 사용하고, 시스템이 레이아웃을 직접 설명할 때는 JSON Render를 사용하세요.
- 패킹 슬립에 바코드를 포함할 수 있나요?
- 네. gPdf는 PDF 안에 바코드 요소를 렌더링할 수 있습니다. 인코딩되는 주문, 박스, 반품 데이터는 사용자 시스템이 담당합니다.
- gPdf가 운송사 라벨을 생성하나요?
- 아니요. 운송사 라벨은 별도의 워크플로입니다. gPdf는 운송사 또는 배송 시스템이 제공하는 데이터에서 PDF를 렌더링합니다.
- 하나의 요청으로 여러 패킹 슬립을 렌더링할 수 있나요?
- Template Render는 해당 엔드포인트에 문서화된 공개 API 제한 안에서 한 요청에 여러 항목을 담은 data 배열을 받을 수 있습니다.