# Global tax identifiers

The Digital River Salesforce B2B Commerce App supports Tax Identifiers. Tax Identifiers are used for tax assessment and invoicing purposes. In most value-added tax (VAT) schemes, domestic sales to business customers are assessed tax and customers then take a credit for this tax paid when they complete their monthly or quarterly VAT return. In these cases, customers need the invoice to display their tax identifier so they can obtain this credit.

Alternatively, *cross-border sales* to business customers are not assessed tax in most VAT schemes. Instead, in a practice called reverse charge, customers self-assess the tax while simultaneously taking a credit for the tax when they complete their monthly or quarterly VAT return. In these cases, the tax identifier is used to determine whether or not a reverse charge applies to a specific order.

Additionally, in a limited number of cases, tax identifiers are collected because they are [required by a specific country’s tax authority](https://docs.digitalriver.com/digital-river-api/checkouts-and-orders/tax-identifiers#supported-tax-identifiers) for invoicing purposes.

Authenticated Non-US customers will be able to add one or more tax Identifiers to their profile from the **Order Review** page in the checkout flow and also from the **My Account** page.

## Add tax identifiers from the My Account page

1. Log in to the Storefront.
2. Go to **My Account**.
3. Click the **My Tax Identifiers** link.\ <img src="https://2309602074-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuPvN3iGOwRD0PjQh%2F-MXlqqrWdWjQ5Tzh-k_6%2F-MXlsy8XcAN-L7e0hVy7%2FMyTaxIdentifiers.png?alt=media&#x26;token=10569a73-0851-4e7d-a93e-111d2152b424" alt="" data-size="original">&#x20;
4. Click **New Tax Identifiers** to add new tax identifiers.\ <img src="https://2309602074-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuPvN3iGOwRD0PjQh%2F-MXlqqrWdWjQ5Tzh-k_6%2F-MXlsr9Efml5sgAdhVLv%2FMyTaxIdentifiers2.png?alt=media&#x26;token=81cf964f-a931-48e8-a8d9-bb7b93c3fb36" alt="" data-size="original">&#x20;
5. Select a country from the dropdown list.\ <img src="https://2309602074-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuPvN3iGOwRD0PjQh%2F-MXlqqrWdWjQ5Tzh-k_6%2F-MXlslhc_y6pJ8vhpZv2%2FMyTaxIdentifiers3.png?alt=media&#x26;token=7c04a178-8f47-470d-8e45-630cef708bc9" alt="" data-size="original">&#x20;
6. If the selected country is eligible for adding tax identifiers, boxes appear for entering the VAT Id(s).
7. Enter a valid Tax identifier. If the Tax Id passes the format validation, a green box displays with a tick mark as shown. Click **Save** to add the tax identifier to your profile.\
   &#x20;<img src="https://2309602074-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuPvN3iGOwRD0PjQh%2F-MXlqqrWdWjQ5Tzh-k_6%2F-MXlsf7jq-lP-aMVyJgW%2FMyTaxIdentifiers10.png?alt=media&#x26;token=5138d683-97dc-44bd-82d9-25e84d778e28" alt="" data-size="original">\
   &#x20;<img src="https://2309602074-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuPvN3iGOwRD0PjQh%2F-MXlqqrWdWjQ5Tzh-k_6%2F-MXlsZ3k0iS-5zqxxKWK%2FMyTaxIdentifiers5.png?alt=media&#x26;token=34a983c1-f02d-4603-96d4-57d94e283122" alt="" data-size="original">&#x20;

## Delete tax identifiers from the My Account page

The app also supports the deletion of Tax Identifiers that were previously added to the user profile from the My Account page.

1. Log in to the Storefront.
2. Go to **My Account**.
3. Click the **My Tax Identifiers** link.
4. All the Tax Identifiers that were previously added to your profile display. To delete an identifier, click **Delete** at the end of its row in the list, which opens a message asking for confirmation.\ <img src="https://2309602074-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuPvN3iGOwRD0PjQh%2F-MXlqqrWdWjQ5Tzh-k_6%2F-MXlsSQf0RrWnS7ylNYJ%2FMyTaxIdentifiers6.png?alt=media&#x26;token=8038c48a-cd87-4f17-8577-f2ff43a6c539" alt="" data-size="original">\ <img src="https://2309602074-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuPvN3iGOwRD0PjQh%2F-MXlqqrWdWjQ5Tzh-k_6%2F-MXlsKThCJZnjKVFK-z-%2FMyTaxIdentifiers7.png?alt=media&#x26;token=b428d5b9-8a6b-4229-880c-503945477732" alt="" data-size="original"> <br>
5. Click **Confirm** to delete the tax identifier from your user profile.

{% hint style="info" %}
**Note:** If there is any issue while adding or deleting the tax identifier, a generic error message appears and the error information is logged to the custom DCM Application Log object.
{% endhint %}

## Tax identifiers on the Order Review page

The authenticated shopper must enter their tax identifier each time an order is placed. Unlike the US Tax Certificates, the tax identifiers which are saved to the user’s profile will not be applied automatically to the order. Within the checkout flow, the authenticated user will be able to apply a saved tax identifier and/or apply a tax identifier directly to the order without saving it.

You will be able to add or delete a tax identifier from your user profile from the Order Review page as well.

1. Log in to the Storefront.
2. Add products to the cart and click **Checkout** to open the User Information page.
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 Business by default and the shopper can change it to Individual by clicking **Change to Individual**. This information is stamped on the DR Customer Type field on the CC Cart object.
6. On the Order Review page, under the Apply Saved Tax Identifiers section, find and click the **Manage Tax Identifiers** link, which opens a window where you can add or delete tax identifiers.\ <img src="https://2309602074-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuPvN3iGOwRD0PjQh%2F-MXlqqrWdWjQ5Tzh-k_6%2F-MXlsCVJI2KE5DDqp01f%2FMyTaxIdentifiers8.png?alt=media&#x26;token=b85bbcc0-30ed-48f9-9584-109709053249" alt="" data-size="original">\ <img src="https://2309602074-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuPvN3iGOwRD0PjQh%2F-MXlqqrWdWjQ5Tzh-k_6%2F-MXls73Io1furmbwY7zp%2FMyTaxIdentifiers10.png?alt=media&#x26;token=35488db0-03ce-4301-a3e1-1190f7825a79" alt="" data-size="original"> <br>
7. Tax identifiers can be added or deleted by following the steps under Add/Delete Tax Identifiers on the My Account page.

{% hint style="info" %}
**Note:** The tax identifier section will be displayed on the Order Review page only for a non-US shopper, that is:

1. The cart contains only a physical product or a combination of physical and digital products and the Ship To address is non-US.
2. The cart contains only a digital product and the Bill-To address in SF is non-US.
   {% endhint %}

An authenticated shopper can apply a saved tax identifier and/or apply a tax identifier directly to the order without saving it.

1. Log in to the Storefront.
2. Add the products to the cart and click **Checkout** to open the User Information page.
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 Business by default and the shopper can change it to Individual by clicking **Change to Individual**. This information is stamped on the DR Customer Type field on the CC Cart object.
6. On the Order Review page, the shopper can select previously saved tax identifier(s) from the **Apply Saved Tax Identifier** section and/or apply a tax identifier directly to the order without saving it by adding the **Tax Identifier from Other Tax Identifier** section. \ <img src="https://2309602074-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuPvN3iGOwRD0PjQh%2F-MXlqqrWdWjQ5Tzh-k_6%2F-MXlrrsrg7nlJ0F9VBgN%2FMyTaxIdentifiers10.png?alt=media&#x26;token=94ea1c6a-baa9-484f-97dd-6ef23cca5b0c" alt="" data-size="original"> <br>
7. After selecting the existing tax identifier and/or adding a tax identifier directly to this order, click **Apply Tax Identifiers**.\
   &#x20;<img src="https://2309602074-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuPvN3iGOwRD0PjQh%2F-MXlqqrWdWjQ5Tzh-k_6%2F-MXlrlhFysL35d959a10%2FMyTaxIdentifiers11.png?alt=media&#x26;token=af4c48f8-a63d-46fc-b149-de6bd2a30489" alt="" data-size="original">&#x20;
8. The Amounts section is now refreshed on the Order Review page. \ <img src="https://2309602074-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuPvN3iGOwRD0PjQh%2F-MXlqqrWdWjQ5Tzh-k_6%2F-MXlrdVBQfUEu8J611FM%2FMyTaxIdentifiers12.png?alt=media&#x26;token=3b8cbef4-0bcc-44a1-989e-c4439deb19d1" alt="" data-size="original">&#x20;
9. The user can now proceed to the payment page and place an order. Once the order is placed, the tax identifiers will be stamped on the **Digital River Tax Identifiers** field of the CC Order object.

{% hint style="info" %}
**Note:** If there is an issue while applying tax identifiers on the Order Review page, a generic error message appears on the Order Review page and the detailed error information is logged to the DCM Application Log object. The shopper will still be able to proceed to the payment page and make a purchase.
{% endhint %}

## Sequence diagram

The following sequence diagram explains the tax identifier flow.

{% file src="<https://2309602074-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuPvN3iGOwRD0PjQh%2F-MXlqqrWdWjQ5Tzh-k_6%2F-MXlrWJUpPElpmk5KjI9%2Fsfb2b_taxidentifierflow-2.1.1B.png?alt=media&token=05dfe6c7-9582-4e0b-a3b3-314cc8f73d14>" %}
