whereparcel

何か聞きたいことがあれば、気軽にどうぞ。WhereParcelを作った開発者が直接メッセージを読んで返信します。

ガイド 7 分で読めます

国境を越える荷物追跡:完全ガイド

複数の配送業者や国をまたぐ国際荷物の追跡について知っておくべきことをすべてまとめました。

WhereParcel Team

国際荷物の追跡は、いつの時代も複雑なものでした。ひとつの荷物が国境を越える間に、3〜4社の異なる配送業者を経由することも珍しくありません。WhereParcelは、9カ国+国際・39社以上の配送業者に対応する単一のAPIでこの問題を解決します。

国際追跡の課題

ソウルからニューヨークへ荷物を送る場合、次のようなルートをたどることがあります:

  1. CJ Logistics(韓国国内の集荷)
  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は、主要なEC市場の配送業者に対応しています:

地域国主要な配送業者
アジア韓国、日本CJ Logistics、ヤマト運輸
北米アメリカ、カナダ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. Webhookを設定する - 国際配送には数日かかるため、ポーリングではなくWebhookを利用しましょう
  3. タイムゾーンに注意する - すべてのタイムスタンプはUTC基準です
  4. 更新の空白に備える - 輸送中は更新頻度が低くなる配送業者もあります

対応する配送業者の全リストは、配送業者ドキュメントをご覧ください。

ご希望の配送業者が見つかりませんか?リクエストいただければ迅速に対応いたします。

配送業者をリクエスト →

何か聞きたいことがあれば、気軽にどうぞ。 Discordに来てください — WhereParcelを作った開発者が直接メッセージを読んで返信します。ボットもチケットもなし。気軽に話しかけてください。

Discordに参加 → Slackに参加 →

タグ: #international #carriers #tracking