Shipping rates

Zonos Rateでは、carrier accountsが認可されている任意の配送先へのshipping ratesを確認できます。carrierとのAPI connectionsまたは提供されたrate sheetsを使用してこの情報を取得します。計算されたshipping responseで返されるshipment optionsは、Dashboardのshipping profilesに割り当てたserviceLevelsと対応します。responseにserviceLevelが含まれると期待しているのに表示されない場合、そのserviceLevelが配送先で有効になっていることを確認してください。

ratesを確認する 

特定の配送先のshipping ratesを確認するには、以下の手順に従ってAPIまたはDashboardで確認できます。

DashboardAPI with carton detailsAPI with cartonization

1. Dashboard -> Shipping -> Rates に移動します。
2. Check rates をクリックします。
3. Ship from location を選択します。
4. ratesを取得したいcountryを選択し、すべての詳細を入力します。
5. carton dimensionsとweightを入力します。
6. Calculate rates をクリックします。

Instant Rate 

Instant Rateはshipping historyを使用してshipping costsを即座に予測します。shipmentRatingCalculateWorkflowを使用してshipping ratesをリクエストすると、まずcached carrier dataに基づいてinstant rateが利用可能かを確認します。利用可能な場合は即座に返され、通常live carrier ratesより約1秒速くなります。利用できない場合は、carrierから新しいratesをリクエストし、AIを使用してキャッシュして将来の予測精度を向上させます。

メリット:

• より速い応答時間: Instant ratesはcarrier API responsesを待たずに返されます（約1秒速い）
• 信頼性の向上: carrier API availabilityとecommerce platform timeoutsへの依存を軽減
• 一貫したcheckout experience: 顧客は迅速かつ一貫して信頼できるshipping costsを受け取れます

rate accuracy

Instant ratesは予測であり、live carrier ratesと時折異なる場合があります。通常は数セント程度の差です。実際、instant ratesの96%はlive carrier ratesの10セント以内です。差異の一般的な理由:

• 最近変更されたcarrier discount ratesまたはfuel surcharges
• タイミングで変動するfees（例: Saturday pickup fees、holiday surchargesなど）
• まだ予測を学習中の珍しいsurcharges
• 時間に敏感なcarrier pricing adjustments

Instant ratesは、discounts、fuel surcharges、適用可能なfeesを含む、実際のnegotiated carrier ratesを反映します。新しいratesをリクエストすると、予測精度の継続的な改善に使用します。

accuracy threshold

accuracy thresholdは、持続的な不正確さから保護する安全網です。thresholdはグローバルに1つ設定しますが、システムはcarrierごとに監視・適用します。instant ratesとlive carrier rates間の平均偏差（絶対rate差の割合として計算）の最大許容値を定義し、特定のcarrierがInstant Rateから自動的に無効化される前の上限となります。

仕組み: システムは各carrierについてcached ratesとlive rates間の平均偏差を継続的に監視します。carrierの平均偏差がthresholdを超えると、そのcarrierはInstant Rateから自動的に無効化され、live ratesにfallbackします。threshold内に留まる他のcarrierはInstant Rateを通常どおり使用し続けます。carrierのaccuracyがthreshold以下に回復すると、そのcarrierのInstant Rateは自動的に再開されます。

例えば、accuracy thresholdが5%に設定され、FedEx ratesがlive ratesから平均6.2%の偏差がある場合、FedExはInstant Rateから自動無効化され、UPSとUSPS（threshold内の場合）はcached ratesの使用を継続します。FedExのaccuracyが5%未満に改善すると、Instant Rateの使用が自動的に再開されます。

accuracy thresholdの設定方法:

• Default: 5% — speedとaccuracyの良好なバランス。
• Minimum: 1% — 最も厳格な設定。carrierがより頻繁に無効化されますが、pricing accuracyが厳密に保たれます。
• Range: 1%から100%

marginが厳しい場合は下げることを検討してください。checkout speedが最優先で、小さなrate varianceが許容できる場合は上げることを検討してください。

Instant Rateが利用できない場合: Instant Rateには、類似shipmentからの十分なhistorical dataが必要です。特定のshipment scenarioに十分な最近のdataがない場合、自動的にlive carrier ratesをリクエストします。これはlow-volume accountsや珍しいshipment configurationsでより一般的です。

UPS accountsに関する重要な考慮事項: Instant RateにはUPS REST integrationが必要です。古いUPS SOAP integrationを使用している場合、Instant Rateを有効化する前にUPS RESTへアップグレードする必要があります。さらに、UPS accountがZonosから切断され、切断中にratesが変更された場合、Dashboardでaccountを再接続するまで、Instant Rateは古いpricingに基づくcached ratesを返し続けます。

Shopify merchants向け: Instant Rateは、carrier rate callsがタイムアウトした際にShopifyの高額backup ratesが表示されるのを防ぎ、顧客により正確なpricingを表示します。

Instant Rateを有効化する

Supported carriers: APC、DHL、FedEx、UPS、USPS（single-package shipmentsのみ）。Note: DHL Express 12pmはサポートされていますが、他のservicesより精度が低いです。

以下の手順に従ってDashboardでInstant Rateを有効化してください:

1. Dashboard -> Settings -> Manage rates に移動します。
2. Advanced settings を見つけます。
3. Enable Instant Rate をオンに切り替えます。
4. 希望する Accuracy threshold パーセンテージを設定します（デフォルトは5%）。
5. Save をクリックします。

以上です！Instant Rateがaccountで有効になります。システムはcarrierごとにrate accuracyを監視します。carrierの平均偏差がthresholdを超えると、そのcarrierはaccuracyが回復するまでInstant Rateから自動的に無効化されます。

Dashboard users: quoteまたはorderでInstant Rateが使用された場合、carrier service level nameの横に稲妻アイコンが表示されます。

Example:

API users は、rateがLIVEかCACHE（Instant Rate）かを示すresponse内のSOURCEフィールドを確認できます。

Example:

FAQs

shipping costsは変更されますか？

いいえ。Instant ratesは実際のnegotiated carrier ratesに基づいています。AIが学習を続ける中、live quotesと数セント程度異なる場合があります。carrierの平均偏差がaccuracy thresholdを超えると、そのcarrierは自動無効化され、live ratesにfallbackします。

carrier ratesが変更された場合はどうなりますか？

carrierから自動的に新しいratesをリクエストし、instant rate modelを更新します。model更新前の短い期間、accuracy threshold設定が安全網として機能します—carrierのcached ratesがlive ratesから大きく乖離すると、そのcarrierはaccuracyが回復するまで自動無効化されます。

custom shipping rulesは引き続き適用されますか？

はい。shipper buffersなどのcustom rulesはInstant Rateでも通常どおり機能します。

accuracy thresholdとは何ですか？どのように設定すべきですか？

accuracy thresholdは、carrierがInstant Rateから自動無効化される前の最大許容平均偏差を設定します。thresholdは1つ設定しますが、システムはcarrierごとに監視・適用します。デフォルトは5%で、範囲は1%から100%です。値を低くすると精度は厳密になりますが、carrierがより頻繁に無効化される場合があります。

carrierが自動無効化された場合はどうなりますか？

carrierの平均偏差がaccuracy thresholdを超えると、そのcarrierはInstant Rateから自動的に無効化され、代わりにlive ratesを使用します。threshold内の他のcarrierはInstant Rateを通常どおり使用し続けます。carrierのaccuracyがthreshold以下に回復すると、そのcarrierのInstant Rateは自動的に再開されます。

rateがinstantかliveかを確認する方法は？

Dashboardでは、instant ratesはservice level nameの横に稲妻アイコンでマークされます。APIでは、shipmentRatingCalculateWorkflow responseのsourceフィールドがinstant ratesの場合はCACHE、live carrier ratesの場合はLIVEを返します。