概要
ShipStation Directは、配送ラベルに記録された実際の出荷費用を取り込み、Dashboardlyの一件または複数のTikTok注文に関連付けます。注文の収益性、P&L、Sales & Profit、エクスポートでは、見積もりに代わってプロバイダーの費用を使用します。
Dashboardlyは次の費用を取り込みます。
- 発送時の送料
- ラベルの保険料
- 返品ラベルの送料
- 返品ラベルの保険料
無効化されたラベルと返金されたラベルは合計に含まれません。ShipStationは、このラベル連携を通じて別途請求される3PLのピッキング・梱包費用や保管費用を提供しません。該当する費用は別途入力してください。
接続前の準備
ShipStationの注文処理で、少なくとも一つの確実な識別子を保持してください。
- 推奨: TikTok注文IDをShipStationのカスタムフィールド1、2、3のいずれかに入力します。
- ShipStationの外部注文IDがTikTok注文IDと完全一致する場合も、DashboardlyはそのIDを利用できます。
- どちらも利用できない場合、完全一致する追跡番号が一件だけあれば、Dashboardlyはそれを利用できます。
一つのラベルで複数注文をまとめて出荷する場合、すべてのTikTok注文IDをカスタムフィールドに含めてください。Dashboardlyは、それらの注文間で送料と保険料を均等に分配します。ラベル費用の一部を適用する前に、すべてのIDが同じ接続済みショップの注文と一致する必要があります。一つの追跡番号が複数の注文に曖昧に一致する場合は、費用の分け方を特定できないため、競合のままとなります。
開始前にShipStationのV2 API key（APIキー）を作成してください。Dashboardlyではキーは書き込み専用で、保存時に暗号化され、後から再表示できません。Dashboardlyはラベルと出荷情報を読み取り専用で取得し、ラベルの購入、作成、無効化、返金は行いません。
ShipStationを接続する
- 接続するショップを選択し、設定 → 配送を開きます。
- ShipStation Directの欄にV2 APIキーを貼り付けます。
- ShipStationに接続を選択します。
- Dashboardlyがキーを検証し、安全な同期期間に分割して、直近七日間の処理をキューに登録します。
- 状態を更新で結果を確認します。
接続は、選択したショップに紐付きます。同じShipStationアカウントからDashboardlyの三つのショップの注文を発送する場合は、それぞれのショップを選択して、同じアカウントを個別に接続してください。最初のショップを接続しても、ほかの二つは接続されません。費用の照合対象は、接続したショップに属する注文のみです。
既存の商品原価と配送費
ShipStationを接続しても、単位当たりの原価（Unit COG）の値や、適用日別の原価履歴は変更されません。商品原価と配送費は別々の設定です。
在庫に設定した単位当たりの配送費（FBS shipping / unit）は、注文に適用済みの配送費上書きがない場合の見積もりとして引き続き利用できます。完全なShipStation費用を注文に適用すると、その注文では実際のラベル費用が優先され、在庫の見積もりは再加算されません。例えば、保存済みの見積額$4.00は在庫に残り、照合済みラベルの$5.15がその注文の実際の配送費になります。
既存の注文単位の手動配送調整やCSV配送調整は、別のソースが管理する費用です。Dashboardlyはその費用を保持し、無断で上書きする代わりに、ShipStation側の注文を競合として扱います。既存の調整を変更する前に、サポートと競合を確認してください。ShipStationを接続したという理由だけで、Unit COGを削除したり、配送費の見積もりをすべて消したりしないでください。
一つのショップを管理できる直接配送プロバイダーは、一度に一つだけです。ShipStationを接続する前にShipHeroを切断し、ShipHeroを接続する前にShipStationを切断してください。接続を切断しても、以前に取り込んだ費用は監査可能な状態で残ります。
ステータスの見方
- 適用済み注文（Applied orders）: 完全なプロバイダー費用が、一件のTikTok注文に関連付けられています。
- 未照合（Unmatched）: 完全一致するTikTok注文が見つかりません。
- 注文との照合がないラベル（Labels missing order match）: ラベルの証拠は存在しますが、安全に照合できる注文がありません。
- 注文の競合（Order conflicts）: TikTok注文は見つかりましたが、別の配送ソースが費用を所有している、通貨が異なる、または注文に配賦できないため、安全に費用を適用できません。
- ラベルの競合（Label conflicts）: 識別子が曖昧、または通貨の証拠が矛盾しているため、一つ以上のShipStationラベルを安全に照合できません。一件の注文に複数のラベルが付くことがあるため、注文の競合とは別に数えます。
- 不完全（Incomplete）: 少なくとも一つの有効なラベルで、必要な費用データが不足しています。
- 無効化・返金済みラベル（Voided or refunded labels）: 合計から除外され、監査用に保持されているプロバイダーのラベルです。
ShipStation Directは送料と保険料を合計します。例えば、送料がUSD 4.55、保険料がUSD 0.00なら、注文の配送料はUSD 4.55です。後から作成された返品ラベルは、同じ注文に加算されます。その後にラベルが無効化された場合、または返金が 承認済み（approved） になった場合、次の照合でそのラベルを合計から取り除きます。それが最後の有効なラベルだった場合、注文からShipStation所有の配送料を完全に取り除きます。保留中または却下された返金申請では、費用を取り除きません。
二件のTikTok注文IDを持つまとめ出荷ラベルでは、送料USD 4.55をUSD 2.28とUSD 2.27に分け、配賦額の合計を正確にUSD 4.55に保ちます。三件以上の注文の場合、端数のセントを一定の順序で割り当て、合計を常に維持します。完全な監査証跡を残すため、送料と保険料は別々に分配します。
一件のTikTok注文にFBTの商品と販売者出荷の商品が混在する場合、Dashboardlyはラベルの追跡番号を使い、その番号で出荷された明細商品だけにShipStation費用を適用します。TikTokから明細ごとの区別可能な追跡番号が提供されない場合、利用可能なデータで安全に商品を区別できないため、注文の配賦対象SKU全体に費用を分配します。TikTokが個別パッケージの追跡情報を提供していても、ShipStationラベルと一致するものがない場合、または一致するパッケージに配賦可能なSKUがない場合は、推測や一部商品の内訳を適用せず、注文を競合として扱います。
過去の履歴を同期する
開始日 （開始日）とTo（終了日）を選び、 配送費用を同期 （配送料を同期）を選択します。一回のリクエストで最大93日間を対象にでき、プロバイダーに安全な、より小さい期間へ自動分割されます。さらに古い履歴を対象にするには、隣接する日付範囲をキューに登録してください。
長い期間は、配送ラベルの件数に応じてさらに分割されます。取り込みは完了した部分を随時保存し、中断後は保存済みの進捗から再開します。未完了の小さな部分を安全に再処理する場合があります。再試行する部分があっても、配送費は注文ごとに一度だけ照合・適用されます。
過去の期間の処理が続いていても、接続のステータスは有効（Active）と表示される場合があります。適用済み注文数が示すのは現時点で利用できる費用であり、リクエストした過去の全期間の処理完了を確認するものではありません。Unit COGの設定と在庫（Inventory）の平均配送料は保存されたままです。実際の配送費がまだ適用されていない注文には、引き続き平均配送料を利用できます。
Dashboardlyは15分ごとに最近のラベルを自動確認し、既知のラベルについても、後日の無効化、返金、修正を再確認します。この再確認では、出荷情報のカスタムフィールドも再取得します。ShipStationでTikTok注文IDを修正すると、次の再確認が成功した時点で、以前の照合先から費用を取り除き、修正後の注文に適用します。
トラブルシューティング
注文が未照合になっている
ShipStationの出荷カスタムフィールドに、完全なTikTok注文IDが含まれていることを確認してください。29518のようなShopify注文番号は、TikTok注文IDではありません。TikTokのIDは通常18–24桁の値です。
ラベルが、ShipStationで削除された、または利用できなくなった出荷を参照していても、Dashboardlyはほかのラベルの同期を続けます。その出荷のカスタムフィールドが唯一の確実な識別子だった場合、そのラベルは未照合のままになります。照合にカスタムフィールドが引き続き必要なら、ShipStationで出荷を復元するか、作成し直してください。
まとめ出荷が未照合になっている
ShipStationのカスタムフィールドにあるすべてのTikTok注文IDが完全で、接続済みショップに属していることを確認してください。注文IDの一部しか照合できない場合、Dashboardlyはまとめ出荷ラベルを部分的に適用しません。不足していた注文が利用可能になるか、IDが修正されると、次の再確認で照合済みの全注文に均等配分を適用します。
注文またはラベルが競合になっている
次の点を確認してください。
- 同じ追跡番号を複数の注文に再利用していないか
- ShipHeroがまだ接続されていないか
- 手入力またはCSVの配送調整が、すでにその注文の配送料を所有していないか
- ShipStationの通貨がTikTok注文の通貨と異ならないか
Dashboardlyは、手入力、CSVインポート、ShipHeroが所有する配送料を上書きしません。以前はShipStationが所有していた値について、証拠が矛盾または不完全になった場合は、競合が解決するまで、そのShipStation所有の値だけを取り除きます。
ピッキング・梱包費用がない
この連携は、ShipStationからラベルの送料と保険料を読み取ります。別途請求される倉庫のピッキング・梱包、取扱い、保管費用はラベルの項目ではなく、別途記録する必要があります。