ERP를 Global Container Network에 연동하세요

이용 대상

이미 ERP, TMS 또는 스프레드시트로 컨테이너를 관리하고 있으며 해당 카탈로그를 GCN에서 실시간으로 운영하고자 하는 기업을 위해 설계되었습니다.

• 판매 / 리스 재고를 동기화하는 트레이더 및 리서
• 실시간 가용 재고를 게시하는 데포 및 재고 보유업체
• 화물 오퍼를 게시하는 운송사 및 포워더

온보딩 단계

1. 1

   Business로 가입

   회사명으로 Business 계정을 만드세요. 개인 계정은 API 키를 발급받을 수 없습니다.

   가입 페이지 열기
2. 2

   KYB / 회사 인증 제출

   조직 프로필을 완료하세요. 관리자가 인증할 때까지 API로 생성한 항목은 PENDING 상태로 유지됩니다. 인증된 조직은 자동으로 ACTIVE 상태로 게시됩니다.

   회사 대시보드 열기
3. 3

   API 키 발급

   대시보드 → 엔터프라이즈 API에서 TEST 또는 LIVE 키를 생성하세요. 생성 시에만 표시되므로 즉시 복사하세요.

   엔터프라이즈 API 열기
4. 4

   Postman (또는 OpenAPI) 가져오기

   컬렉션을 가져오고 apiKey를 설정한 후 Ready → Me → inventory/listings bulk를 실행하세요. 모든 행에 ERP의 고정된 externalId를 사용하세요.

   Postman 컬렉션 다운로드
5. 5

   카탈로그 동기화 및 웹훅 등록

   모든 모듈에서 요청당 최대 200개 항목을 일괄 업서트할 수 있습니다. 선택 사항: 생성 / 검토 / 문의 이벤트에 대한 웹훅 URL을 등록하세요.

   API 문서 보기

연동 도구

• /api/v1/ready — 스키마가 활성화되었는지 확인
• /api/v1/openapi — 전체 OpenAPI 3 스키마
• Postman 컬렉션 — 바로 실행 가능한 요청
• API 레퍼런스 — 엔드포인트, 스코프, 참고사항

동기화 실패를 방지하는 규칙

• 모든 일괄 처리 항목에는 고정된 externalId(ERP 기본 키)가 필요합니다.
• 일괄 요청당 최대 200개 항목 — 더 큰 카탈로그는 페이지로 나누어 처리하세요.
• POST/PATCH 재시도 시 Idempotency-Key를 사용하세요.
• 현재 TEST 키는 LIVE와 동일한 데이터베이스에 기록됩니다 — 샌드박스 분리가 적용되기 전까지 신중히 사용하세요.