이커머스 플랫폼
셀러와 창고 백엔드를 위한 Amazon FBA 라벨 API
셀러 또는 창고 데이터에서 벡터 바코드와 템플릿 출력을 갖춘 Amazon FBA 스타일의 상품, 박스, 배송 라벨 PDF를 렌더링합니다.
주 API JSON Render
ENDPOINT
/api/v1/pdf/render 시스템 셀러 도구 / 창고 백엔드 / FBA 준비 서비스 / 이커머스 운영 시스템
해결할 작업
셀러, 준비 서비스 또는 창고 시스템이 올바른 식별자, 바코드 데이터, 라벨 규칙을 결정한 뒤 Amazon FBA 준비 워크플로용 상품, 박스, 배송 라벨 PDF를 렌더링합니다.
이 API를 쓰는 경우
- 시스템에 FNSKU, 박스, 배송 또는 준비 서비스 라벨 데이터가 이미 있습니다.
- 셀러 또는 창고 인쇄 스테이션용 벡터 바코드 라벨을 PDF 출력으로 만들어야 합니다.
- 반복되는 라벨 레이아웃을 Template Render 계약으로 만들고 싶습니다.
- 준비 작업, 감사, 예외 처리를 위한 결정적인 재출력이 필요합니다.
대체하지 않는 것
- gPdf가 공식 Amazon 연동, 앱 또는 SP-API 커넥터를 제공해야 합니다.
- Amazon이 gPdf를 통해 라벨을 인증해야 합니다.
- 재고, 리스팅 또는 배송 계획 관리가 필요합니다.
호출할 endpoint
/api/v1/pdf/render
JSON Render가 이 처리 흐름의 기본 경로입니다.
/api/v1/template-render
관련 API 경로, 템플릿 계약 또는 capability 조회가 필요할 때 사용합니다.
최소 request
POST /api/v1/pdf/render - FNSKU 스타일 바코드 데이터가 포함된 상품 라벨.
{
"pages": [
{
"width": 70,
"height": 35,
"elements": [
{
"type": "text",
"x": 4,
"y": 4,
"content": "FNSKU X00ABC1234",
"style": { "font_size": 8, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "code128",
"content": "X00ABC1234",
"x": 4,
"y": 12,
"width": 60,
"height": 12,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 4,
"y": 29,
"content": "SKU: ACME-FILTER-01",
"style": { "font_size": 6, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf가 처리하는 것
- JSON Render 요청 데이터에서 라벨 크기 PDF 렌더링.
- 벡터 바코드, 텍스트, SKU 블록, 박스, 템플릿 바인딩.
- Template Render를 통한 반복 라벨 출력.
- 인쇄 스테이션, 셀러 도구, 창고 워크플로용 PDF 응답.
자체 시스템이 책임지는 것
- Amazon 계정 연동, SP-API 호출, 배송 계획 데이터, FNSKU 값, 마켓플레이스 규칙.
- 정확한 바코드 데이터, 라벨 치수, 제품 데이터, 스캔 승인.
- 셀러 UX, 준비 워크플로, 저장, 재출력 승인.
운영 전 체크리스트
- 렌더링 전에 활성 마켓플레이스와 풀필먼트 요구사항을 확인합니다.
- 운영 라벨 용지에서 바코드 데이터와 물리적 인쇄 품질을 검증합니다.
- Amazon 연동과 자격 증명 처리는 gPdf 밖에 둡니다.
- 재출력이 결정적으로 동작하도록 원본 라벨 데이터를 저장합니다.
- 승인된 레이아웃은 인쇄 스테이션 연동을 위해 Template Render로 옮깁니다.
지원 범위의 경계
- gPdf는 공식 Amazon 앱이나 SP-API 커넥터가 아닙니다.
- gPdf는 PDF를 렌더링합니다. Amazon 컴플라이언스와 셀러 워크플로 규칙은 사용자가 담당합니다.
- PDF 렌더링을 Amazon 라벨 인증으로 간주하지 마세요.
FBA 라벨은 데이터 기반 PDF 라벨입니다
Amazon FBA 준비 워크플로에는 상품, 박스 또는 배송 라벨이 필요한 경우가 많습니다. 렌더링 문제는 단순합니다. 사용자 시스템이 식별자와 라벨 규칙을 제공하고, gPdf가 PDF를 렌더링합니다.
마켓플레이스 연동은 렌더링과 분리해 두세요. 셀러 또는 창고 시스템에서 올바른 식별자를 조회하거나 계산한 뒤, 최종 라벨 데이터로 gPdf를 호출합니다.
FAQ
- gPdf는 공식 Amazon FBA 앱인가요?
- 아니요. 셀러, 준비 서비스 또는 창고 백엔드가 gPdf를 호출할 수는 있지만, gPdf는 공식 Amazon 앱이나 SP-API 연동을 제공한다고 주장하지 않습니다.
- gPdf가 FNSKU 라벨을 렌더링할 수 있나요?
- gPdf는 바코드 요소가 포함된 PDF 라벨을 렌더링할 수 있습니다. FNSKU 값, 라벨 규칙, Amazon 워크플로는 사용자 시스템이 담당합니다.
- FBA 라벨에 템플릿을 써야 하나요?
- 좌표를 테스트하는 동안에는 JSON Render를 사용하세요. 라벨 디자인과 필드 계약이 승인된 뒤에는 Template Render를 사용하세요.
- gPdf가 Amazon용 라벨을 인증하나요?
- 아니요. 인쇄 품질, 스캔 승인, 마켓플레이스 컴플라이언스는 사용자의 책임입니다.