# Uploading tax certificates (US TEMS)

The Digital River Salesforce B2B Commerce App supports tax-exempt purchases on US storefronts. Authenticated customers will be able to add or upload one or more tax certificates to their profile from the User Info page and My Account page. The following list shows Digital River's Tax Certificate Validation once a shopper uploads a tax certificate.

1. Validation of the tax certificate is a manual process done by Digital River employees. It is not a real-time determination.
2. Pending that validation, the customer can place their order and that order will be treated as if there was a valid certificate (that is, tax-free).
3. If the shopper’s certificate fails validation, when that shopper places another order, their order will not be tax-free.

## Upload a tax certificate from the My account page <a href="#upload-a-tax-certificate-from-the-my-account-page" id="upload-a-tax-certificate-from-the-my-account-page"></a>

To upload a tax certificate from the My Account page:

1. Sign in to the storefront.
2. Go to **My Account**.
3. Click the **My Tax Certificates** link in the **My Account Navigation Bar** to open a window listing the customer’s uploaded tax certificates. \
   ![](https://2309602074-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuPvN3iGOwRD0PjQh%2F-MRVXtouuzQHy4dYmBqs%2F-MRVYBIXkeqTGv5N1tOk%2FInstall%20DR%20B2B%20API%20Connector95.png?alt=media\&token=61e33b69-dba1-4676-9709-92123e398268)
4. Click **Manage Tax Exemption** and complete the details on the form (such as Company Name, Tax Authority, Start Date, Expiry Date, and the actual Tax Certificate file).\
   ![](https://2309602074-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuPvN3iGOwRD0PjQh%2F-MRVYEA6zfb0i5KbP0bm%2F-MRVYNCFxtAVNEs9BT9e%2FInstall%20DR%20B2B%20API%20Connector96.png?alt=media\&token=23abf657-68cc-4e52-8014-2d7d392810bb)
5. Click **Submit** to upload the tax certificate to Digital River. \
   ![](https://2309602074-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuPvN3iGOwRD0PjQh%2F-MRVYPESlH_QXjLJLcGx%2F-MRVYVnhfZj3ghm5vffi%2FInstall%20DR%20B2B%20API%20Connector97.png?alt=media\&token=32c06f49-1f92-4014-b98a-1491ef3ff410) \
   After you successfully submit the tax certificate to Digital River, the page refreshes and the newly uploaded tax certificate will appear on the Existing Tax Certificates page. \
   ![](https://2309602074-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuPvN3iGOwRD0PjQh%2F-MRVYPESlH_QXjLJLcGx%2F-MRVYcCjx5JAtDTTXAVc%2FInstall%20DR%20B2B%20API%20Connector98.png?alt=media\&token=e4d1441b-2e2f-4520-98d7-a18b8073a441)
6. Click the close button (**X**) to close this window and return to the My Account page.\
   ![](https://2309602074-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuPvN3iGOwRD0PjQh%2F-MRVYdNoYYkJw1znSiXf%2F-MRVYimG8ms8JYVfCpq0%2FInstall%20DR%20B2B%20API%20Connector99.png?alt=media\&token=10355d4e-964c-49e3-95a6-6a52eafc7b74) \
   If there is an issue while uploading the tax certificate, a generic error message will appear on the screen and the error information will be logged to the custom DCM Application Log object.

## Upload a tax certificate from the Order Review page <a href="#upload-a-tax-certificate-from-the-user-information-page" id="upload-a-tax-certificate-from-the-user-information-page"></a>

To upload a tax certificate from the Order Review page:

1. Sign in to the storefront.
2. Add products to your cart and click `Checkout`. The User Information page appears.
3. Click `Continue` to open the Shipping page.
4. On the Shipping page, click `Accept Terms and Proceed` to open the Order Review page.
5. The purchase type will be set to `individual` by default and the shopper can change it to business by clicking `Change to Business` . This information is stamped on the **DR Customer Type** field on the CC Cart object.\
   ![](https://2309602074-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuPvN3iGOwRD0PjQh%2F-MXlp-YVZlajyOC_SAyQ%2F-MXlqg4RnUYXXVjPaMhg%2Forder_review2.png?alt=media\&token=51123b97-9dd6-430d-9d74-a0d6dd013140)
6. To make a tax-exempt purchase, click `Business` as the Purchase Type. The **Click here to Manage your Tax Certificates** link appears.\
   &#x20;<img src="https://2309602074-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuPvN3iGOwRD0PjQh%2F-MXlp-YVZlajyOC_SAyQ%2F-MXlqmXa4PvnJF2ipd9T%2Ftax_certificate_link2.png?alt=media&#x26;token=86ae11c1-5f1d-4620-9cea-bfdcedb5610c" alt="" data-size="original">&#x20;
7. Click the link. A window appears and lists previously uploaded tax certificates.
8. Repeat steps 4–6 under [**Upload a Tax Certificate from the My Account page**](#upload-a-tax-certificate-from-the-my-account-page) to upload a new certificate from the User Info page.

**Notes**

* To make a tax-exempt purchase, you must select **Business** for Purchase Type on the Order Review page.
* Tax certificate files are not stored in Salesforce.
* Tax certificate information like the File Name, Digital River Tax Certificate File Id, Company Name, Tax Authority, Start Date, Expiry Date, Contact Id, and Account Id of the User who uploaded the tax certificate are captured in a custom object **DR US Tax Certificate (digitalriverv2\_\_DR\_US\_Tax\_Certificate\_\_c)** in Salesforce.&#x20;

<div align="left"><img src="https://2309602074-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuPvN3iGOwRD0PjQh%2F-MRV_2rplNPHlZ6V4jCW%2F-MRV_YU28RnAEXtJTrTu%2FInstall%20DR%20B2B%20API%20Connector101.png?alt=media&#x26;token=9f8a520b-3228-4f2a-8d48-a875669467c0" alt=""></div>

## Sequence diagram

The following sequence diagram explains the Tax Exemption Subprocess flow supported by the connector.

{% file src="<https://2309602074-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuPvN3iGOwRD0PjQh%2F-MXlp-YVZlajyOC_SAyQ%2F-MXlqY_xNVmWZZovU9CN%2Fsfb2b_taxexemptflow-2.1.1B.png?alt=media&token=3f143d17-8661-49fa-8c17-b0616c9b8777>" %}
