SKILLOfficialproductivity

tracking

プラグイン: shippo
ソース: GitHub で見る ↗

説明

複数の配送業者にまたがる荷物の追跡状況を確認でき、追跡履歴の閲覧、追跡情報の自動通知設定（ウェブフック：特定のイベント発生時に外部システムへ自動で情報を送信する仕組み）が Shippo API を経由して利用できます。

原文を表示

Track packages across carriers, view tracking history, and set up tracking webhooks via the Shippo API

ユースケース

複数の配送業者の荷物追跡状況を確認するとき
追跡履歴を閲覧したいとき
追跡情報の自動通知を設定するとき

本文（日本語訳）

荷物追跡

追跡番号で追跡する

配送業者と追跡番号を特定する。配送業者は小文字の Shippo トークン（例: usps、ups、fedex、dhl_express）である必要があります。配送業者ごとの追跡番号形式については shippo/references/carrier-guide.md を参照してください。不確実な場合は、ユーザーに確認してください。
GetTrack を呼び出し、carrier（配送業者）と tracking_number（追跡番号）を指定します。
重要なレスポンス項目: tracking_status（ステータス、詳細、日時、場所）、tracking_history（履歴）、eta（予定到着日時）
各追跡イベントには substatus オブジェクト（詳細ステータス）が含まれており、code（コード）、text（説明）、action_required（対応が必要か）の情報があります。追跡履歴を表示する際は、各ステップで何が起きたかについてのより詳しい情報となるため、詳細ステータスも必ず含めてください。
現在のステータス、場所、予定到着日時、詳細ステータス、時系列の履歴イベント（最新順）を表示します。

ステータス値

配送業者固有のステータスの違いについては shippo/references/carrier-guide.md を参照してください。標準的な値は以下のとおりです:

ステータス	意味
PRE_TRANSIT	ラベル作成済み、配送業者がまだ荷物を受け取っていない
TRANSIT	配送中
DELIVERED	配達完了
RETURNED	返送中または返送済み
FAILURE	配達失敗
UNKNOWN	配送業者から追跡情報がない

eta（予定到着日時）はほとんどの大手配送業者（USPS、UPS、FedEx、DHL Express）から提供されますが、地域配送業者や配送業者がまだルートを確定していない場合は null になる可能性があります。提供されないことはエラーではなく、情報として扱ってください。

追跡可能な荷物を検索する

ListTransactions を呼び出します。object_status: SUCCESS でフィルタリングします。各取引成功レコードには tracking_number（追跡番号）と配送業者情報が含まれます。その後、選択した項目に対して GetTrack を呼び出します。

追跡 Webhook を登録する

ユーザーの HTTPS Webhook URL を取得します。
createWebhook を呼び出し、url と event: track_updated を指定します。
必要に応じて CreateTrack を呼び出し、配送業者と追跡番号を指定して、特定の荷物をプッシュ通知に登録します。

クイックリファレンス

荷物を追跡する: GetTrack（配送業者 + 追跡番号を指定）

過去の荷物の追跡情報を検索する: ListTransactions → SUCCESS でフィルタリング → GetTrack

原文（English）を表示

Package Tracking

Track by Number

Determine carrier and tracking number. Carrier must be a lowercase Shippo token (e.g., usps, ups, fedex, dhl_express). See shippo/references/carrier-guide.md for tracking number format hints per carrier. If uncertain, ask the user.
Call GetTrack with carrier and tracking_number.
Key response fields: tracking_status (status, status_details, status_date, location), tracking_history, eta.
Each tracking event includes a substatus object with code, text, and action_required (boolean). Include substatus details when presenting tracking history -- these provide more specific information about what happened at each step.
Present: current status, location, ETA, substatus details, and chronological event history (most recent first).

Status Values

See shippo/references/carrier-guide.md for carrier-specific status nuances. Standard values:

Status	Meaning
PRE_TRANSIT	Label created, carrier has not received the package
TRANSIT	Package is in transit
DELIVERED	Delivered
RETURNED	Being returned or returned to sender
FAILURE	Delivery failed
UNKNOWN	No tracking information from carrier

The eta field is provided by most major carriers (USPS, UPS, FedEx, DHL Express) but availability is carrier-dependent, it may be null for regional carriers or for shipments before the carrier has finalized routing. Treat absence as informational, not as an error condition.

Find Trackable Packages

Call ListTransactions. Filter for object_status: SUCCESS. Each successful transaction has tracking_number and carrier info. Then call GetTrack for selected items.

Register a Tracking Webhook

Get the user's HTTPS webhook URL.
Call createWebhook with url and event: track_updated.
Optionally call CreateTrack with carrier and tracking number to register a specific shipment for push updates.

Quick Reference

Track a package: GetTrack with carrier + tracking number

Find past shipment tracking: ListTransactions -> filter SUCCESS -> GetTrack

原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。

追跡番号で追跡する

配送業者と追跡番号を特定する。配送業者は小文字の Shippo トークン（例: usps、ups、fedex、dhl_express）である必要があります。配送業者ごとの追跡番号形式については shippo/references/carrier-guide.md を参照してください。不確実な場合は、ユーザーに確認してください。

GetTrack を呼び出し、carrier（配送業者）と tracking_number（追跡番号）を指定します。

重要なレスポンス項目: tracking_status（ステータス、詳細、日時、場所）、tracking_history（履歴）、eta（予定到着日時）

各追跡イベントには substatus オブジェクト（詳細ステータス）が含まれており、code（コード）、text（説明）、action_required（対応が必要か）の情報があります。追跡履歴を表示する際は、各ステップで何が起きたかについてのより詳しい情報となるため、詳細ステータスも必ず含めてください。

現在のステータス、場所、予定到着日時、詳細ステータス、時系列の履歴イベント（最新順）を表示します。

ステータス値

配送業者固有のステータスの違いについては shippo/references/carrier-guide.md を参照してください。標準的な値は以下のとおりです:

ステータス

意味

PRE_TRANSIT

ラベル作成済み、配送業者がまだ荷物を受け取っていない

TRANSIT

配送中

DELIVERED

配達完了

RETURNED

返送中または返送済み

FAILURE

配達失敗

UNKNOWN

配送業者から追跡情報がない

Track by Number

Determine carrier and tracking number. Carrier must be a lowercase Shippo token (e.g., usps, ups, fedex, dhl_express). See shippo/references/carrier-guide.md for tracking number format hints per carrier. If uncertain, ask the user.

Call GetTrack with carrier and tracking_number.

Key response fields: tracking_status (status, status_details, status_date, location), tracking_history, eta.

Each tracking event includes a substatus object with code, text, and action_required (boolean). Include substatus details when presenting tracking history -- these provide more specific information about what happened at each step.

Present: current status, location, ETA, substatus details, and chronological event history (most recent first).

Status Values

See shippo/references/carrier-guide.md for carrier-specific status nuances. Standard values:

Status

Meaning

PRE_TRANSIT

Label created, carrier has not received the package

TRANSIT

Package is in transit

DELIVERED

Delivered

RETURNED

Being returned or returned to sender

FAILURE

Delivery failed

UNKNOWN

No tracking information from carrier