税免税

再販業者、政府機関、非営利団体に販売している場合、そうした購入者は特定の州で売上税を免除する免税証明書を保有しています。Zonosはこれらの証明書を顧客プロファイルに対して保存するため、Checkoutで免税対象の購入者を認識できます。

免税は管轄区域ごとに記録されます。サウスカロライナ州で免税されている顧客が、テキサス州でも自動的に免税されるわけではありません。そのため、顧客が証明書を保有する各州は、それぞれ独自の日付と証明書番号を持つ別個のレコードになります。

免税は既存の顧客に紐づくため、同期は2つの呼び出しで行います。まず顧客を作成し、次にその証明書を同期します。どちらもお客様自身の顧客IDでキー付けされます。これはCheckoutの他の場所で使用しているものと同じcustomerIdです。Zonosが内部IDの保存を要求することはありません。

この機能は、カスタムAPI統合のみで利用可能です。

顧客の作成または更新 

checkoutCustomerUpsertは顧客プロファイルを作成します。そのcustomerIdに対して既にプロファイルが存在する場合は更新します。checkoutCustomerProfileAuthenticateとは異なり、これは購入者が操作中である必要がないため、事前に顧客リストをプロビジョニングできます。フィールドの完全な挙動については、購入者不在でのプロファイルの作成または更新を参照してください。

customerIdで一致させるため、繰り返し呼び出しても同じプロファイルが更新されるだけで、重複が作成されることはありません。同期のたびに顧客リスト全体に対して実行しても安全です。

税免税の同期 

checkoutCustomerTaxExemptionsSyncは複数の顧客を一度に受け付けます。各エントリはその顧客の免税セット全体を置き換えます。

expiresAtを省略すると、証明書に有効期限がないことを意味します。exemptionReasonを省略すると、デフォルトでUNSPECIFIEDになります。

同期の仕組み 

すべての同期は3つのルールに従います。

リストが正となります。 taxExemptionsは変更差分ではなく、顧客の完全なセットです。すでに記録されている免税がリストから漏れている場合、それは削除されます。これが、取り下げられた証明書が無効になる仕組みです。一部だけのリストを送信すると、そこに含まれていないものはすべて無言で削除されます。

すべてのレコードは免税です。 ある顧客がどこかの地域で免税対象外であることを記録する方法はありません。以下の注記を参照してください。

すべての免税を削除する場合は空のリストになります。 顧客の証明書をクリアするには、"taxExemptions": []を付けて送信します。顧客をペイロードから完全に除外した場合は、既存のレコードは変更されません。

免税理由 

exemptionReasonは、顧客が免税対象となっている理由を表します。任意項目でデフォルトはUNSPECIFIEDですが、指定しておく価値は十分にあります。詳細は以下を参照してください。

理由は2つのグループに分かれ、その違いが重要です。エンティティベースの理由 — 政府、慈善、宗教、教育 — は、購入内容にかかわらず購入者を免税します。用途ベースの理由、とりわけRESALEは、対象となる商品のみをカバーします。再販証明書は買い手が再販する在庫をカバーするものであり、同じ注文に含まれるオフィス家具までは対象になりません。

理由が指定されていない場合、Zonosはこの2つを区別できず、注文全体を免税するしかありません。これは再販証明書にとって最も正当化が難しいケースです。免税の大半が再販によるものであれば、デフォルトとしてRESALEを送信し、例外を個別にリストする方が、すべての顧客を個別に分類するよりもはるかに手間がかかりません。

免税参照番号 

exemptionReferenceは、顧客の免税書類に記載されている番号です。州や免税の種類によって、再販許可証または販売許可証の番号、州の免税証明書番号、ダイレクトペイ許可証番号、または連邦税ID番号のいずれかになります。

これはすべてのレコードで必須です。証明書に記載されている通り、そのままの形式で保存・送信してください。フォーマットは管轄区域によって大きく異なります(SR EAA 12-345678、85-8012345678C-9、12-3456789)。Zonosは前後の空白をトリムする以外は、送信された値をそのまま保持します。大文字・小文字やハイフン、スペースを変更しないでください。

拒否されたレコード 

レコードは1件ずつ検証されます。拒否されたレコードはrejectedに報告され、バッチの残りの処理を失敗させることはなく、その管轄区域に既に記録されている免税にも影響しません。

不明な顧客は作成されるのではなく拒否されるため、customerIdの入力ミスは、実在の購入者に一致しないプロファイルを作成する代わりに、レスポンスに表れます。

検証されるのは米国の州域のみです。他の国の下位区分は、送信された通りに受け付けられます。

読み取りと削除 

同期が反映されたことを確認するために、顧客の免税情報を読み取ります。

顧客がアカウントを解約した場合など、その顧客のすべての免税を削除するには、checkoutCustomerTaxExemptionsDeleteを使用します。顧客に免税があってもなくてもSUCCESSを返すため、複数回呼び出しても安全です。