whereparcel

궁금한 게 있으세요? 편하게 물어보세요. WhereParcel을 만든 개발자가 직접 읽고 답장드립니다.

가이드 7 분 소요

국경을 넘는 소포 추적: 완벽 가이드

다양한 택배사와 국가를 넘나드는 국제 소포 추적에 대해 알아야 할 모든 것을 정리했습니다.

WhereParcel Team

국제 소포 추적은 언제나 복잡한 일이었습니다. 하나의 소포가 국경을 넘는 동안 3~4개의 서로 다른 택배사를 거치는 경우도 흔합니다. WhereParcel은 9개국 + 국제, 39개 이상의 택배사를 지원하는 단일 API로 이 문제를 해결합니다.

국제 추적의 어려움

서울에서 뉴욕으로 소포를 보낸다면, 다음과 같은 경로를 거칠 수 있습니다:

  1. CJ 대한통운 (한국 국내 수거)
  2. 우체국(Korea Post) (국제 우편 인계)
  3. 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 와 함께 돌려줍니다. 점수가 가장 높은 후보로 조회하세요.

국제 추적 팁

  1. 택배사 먼저 찾기 - /v2/detect 는 무료이고 실제 조회를 하지 않습니다
  2. 웹훅 설정 - 국제 배송은 며칠이 걸리므로 폴링 대신 웹훅을 사용하세요
  3. 시간대 처리 - 모든 타임스탬프는 UTC 기준입니다
  4. 업데이트 공백에 대비 - 운송 중에는 일부 택배사의 업데이트 빈도가 낮을 수 있습니다

지원하는 택배사의 전체 목록은 택배사 문서에서 확인하세요.

원하는 택배사가 없으신가요? 요청해 주시면 빠르게 연동해 드립니다.

택배사 요청하기 →

궁금한 게 있으세요? 편하게 물어보세요. Discord에 들어오시면 WhereParcel을 만든 개발자가 직접 읽고 답장드립니다. 봇도 없고 티켓도 없어요. 그냥 편하게 대화하세요.

Discord 참여하기 → Slack 참여하기 →

태그: #international #carriers #tracking