국경을 넘는 소포 추적: 완벽 가이드
다양한 택배사와 국가를 넘나드는 국제 소포 추적에 대해 알아야 할 모든 것을 정리했습니다.
WhereParcel Team
국제 소포 추적은 언제나 복잡한 일이었습니다. 하나의 소포가 국경을 넘는 동안 3~4개의 서로 다른 택배사를 거치는 경우도 흔합니다. WhereParcel은 9개국 + 국제, 39개 이상의 택배사를 지원하는 단일 API로 이 문제를 해결합니다.
국제 추적의 어려움
서울에서 뉴욕으로 소포를 보낸다면, 다음과 같은 경로를 거칠 수 있습니다:
- CJ 대한통운 (한국 국내 수거)
- 우체국(Korea Post) (국제 우편 인계)
- USPS (미국 국내 배달)
각 택배사마다 자체 추적 시스템, 데이터 형식, API가 다릅니다. 통합 솔루션 없이는 각 택배사와 개별적으로 연동해야 합니다.
WhereParcel의 국경 간 추적 방식
WhereParcel API는 택배사 간 인계를 자동으로 감지하고, 여러 택배사의 추적 이벤트를 하나의 타임라인으로 병합합니다:
{
"trackingNumber": "EC123456789KR",
"status": "in_transit",
"events": [
{
"carrier": "kr.post",
"timestamp": "2026-02-01T09:00:00Z",
"status": "picked_up",
"location": "Seoul, South Korea"
},
{
"carrier": "kr.post",
"timestamp": "2026-02-03T14:00:00Z",
"status": "departed",
"location": "Incheon Airport, South Korea"
},
{
"carrier": "us.usps",
"timestamp": "2026-02-05T08:00:00Z",
"status": "arrived",
"location": "JFK Airport, New York, USA"
},
{
"carrier": "us.usps",
"timestamp": "2026-02-06T11:00:00Z",
"status": "out_for_delivery",
"location": "Manhattan, New York, USA"
}
]
}
지원 국가
WhereParcel은 주요 이커머스 지역의 택배사를 지원합니다:
| 지역 | 국가 | 주요 택배사 |
|---|---|---|
| 아시아 | 한국, 일본 | CJ 대한통운, 야마토운수 |
| 북미 | 미국, 캐나다 | UPS, FedEx, USPS |
| 유럽 | 독일, 영국, 이탈리아 | Deutsche Post, FedEx UK, Poste Italiane |
국제 추적 시작하기
국내 소포든 국제 소포든 API 호출 방식은 동일합니다:
# 1. 택배사 찾기 — 무료: 형식 비교만, 조회·사용량 없음
curl -X POST https://api.whereparcel.com/v2/detect \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"trackingNumber": "EC123456785KR"}'
# 2. 가장 잘 맞는 택배사로 조회 (여기서는 kr.post)
curl -X POST https://api.whereparcel.com/v2/track \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"trackingItems": [{"carrier": "kr.post", "trackingNumber": "EC123456785KR"}]}'
택배사를 모를 때는 POST /v2/detect 가 번호 형식이 맞는 택배사 후보를 specificityScore 와 함께 돌려줍니다. 점수가 가장 높은 후보로 조회하세요.
국제 추적 팁
- 택배사 먼저 찾기 -
/v2/detect는 무료이고 실제 조회를 하지 않습니다 - 웹훅 설정 - 국제 배송은 며칠이 걸리므로 폴링 대신 웹훅을 사용하세요
- 시간대 처리 - 모든 타임스탬프는 UTC 기준입니다
- 업데이트 공백에 대비 - 운송 중에는 일부 택배사의 업데이트 빈도가 낮을 수 있습니다
지원하는 택배사의 전체 목록은 택배사 문서에서 확인하세요.
원하는 택배사가 없으신가요? 요청해 주시면 빠르게 연동해 드립니다.
택배사 요청하기 →더 알아보기
궁금한 게 있으세요? 편하게 물어보세요. Discord에 들어오시면 WhereParcel을 만든 개발자가 직접 읽고 답장드립니다. 봇도 없고 티켓도 없어요. 그냥 편하게 대화하세요.
Discord 참여하기 → Slack 참여하기 →