HomeDocumentationCode SamplesAPI ReferenceAnnouncementsModelsRelease NotesFAQGitHubVideos
Developer HubAPI StatusSupport
Documentation
Developer HubAPI StatusSupport

Example Use Cases

VAT Calculation Service example use cases

The VIDR gives sellers complete VAT calculation data to help them create Invoices on time. One invoice is required per shipment. Some sample use cases, along with VIDR data, are described in the following sections. Note that sellers are free to choose their own format of creating invoices. However, an invoice must contain all of the required information. The following use cases demonstrate how the data should be presented in an invoice, regardless of the visual format the seller chooses.

Use Case: One order, one ASIN, one shipment

For brevity, Shipping Promotion and Gift Wrap Promotion have not been shown.

Sample report

Order IDASINShipping IDQuantityItem price (VAT incl)Item price (VAT excl)Item price (VAT)Item price (VAT rate)Shipping (VAT incl)Shipping (VAT excl)Shipping (VAT)Shipping (VAT rate)Gift wrap (VAT incl)Gift wrap (VAT excl)Gift wrap (VAT)Gift wrap (VAT rate)Item promo (VAT incl)Item promo (VAT excl)Item promo (VAT)Item promo (VAT rate)
123-1111111-2222222BYU738349K82349303341120100200.2121020.26510.2-60-50-100.2

In this case, the seller must create one invoice, because there is only one shipping ID for this order. Item VAT exclusive and VAT inclusive price should be clearly mentioned. Item VAT rate should be displayed along with VAT amount. Gift Wrap, Shipping, and Promotions (if applicable) should be displayed separately and clearly, as shown in the following invoice. This is not a complete invoice, but only a section of the invoice, demonstrating the line items. An invoice must contain many other details.

Sample invoice

QuantityItem DescriptionUnit Price (excl. VAT)VAT RateUnit Price (incl. VAT)Total Price (incl. VAT)
1BYU738349K€ 100.0020%€ 120.00€ 120.00
Shipping charge€ 10.0020%€ 12.00€ 12.00
Gift wrap€ 5.0020%€ 6.00€ 6.00
Promotions- € 50.0020%- € 60.00- € 60.00
Total:€ 78.00

📘

Note

If the shipment contains item and shipping promotions together, they all can be grouped under the Promotions line on the invoice.

Use case: 1 order, 2 ASINS, 1 shipment

For brevity, shipping Promotion and Gift Wrap Promotion have not been shown.

Sample report

Order IDASINShipping IDQuantityItem Price (VAT incl)Item Price (VAT excl)Item Price (VAT)Item Price (VAT rate)Shipping (VAT incl)Shipping (VAT excl)Shipping (VAT)Shipping (VAT rate)Gift Wrap (VAT incl)Gift Wrap (VAT excl)Gift Wrap (VAT)Gift Wrap (VAT rate)Item Promo (VAT incl)Item Promo (VAT excl)Item Promo (VAT)Item Promo (VAT rate)
123-1111111-2222222BYU738349K82349303341120100200.2121020.26510.2-60-50-100.2
123-1111111-2222222B7TERKS937482349303342240200400.2121020.26510.2-60-50-100.2

In this case, the seller must create one invoice because there is only one shipping ID for this order ID. Item VAT exclusive and VAT inclusive price should be clearly mentioned. Item VAT rate should be displayed along with VAT amount. Gift Wrap, Shipping, and Promotions (if applicable) can be grouped together in three separate line items as shown in the following sample invoice. This is not a complete invoice, but only a section of the invoice, demonstrating the line items. An invoice must contain many other details.

Sample invoice:

QuantityItem DescriptionUnit Price (excl. VAT)VAT RateUnit Price (incl. VAT)Total Price (incl. VAT)
1BYU738349K€ 100.0020%€ 120.00€ 120.00
2B7TERKS9374€ 100.0020%€ 120.00€ 240.00
Shipping charge€ 20.0020%€ 24.00€ 24.00
Gift wrap€ 10.0020%€ 12.00€ 12.00
Promotions- € 100.0020%- € 120.00- € 120.00
Total:€ 276.00

Tip

Here, the shipping charges from both ASINs have been combined into one line item. The same is applicable for Gift Wrap. You can keep separate line items for separate ASINs or combine them for simplification. Note that if the shipment contains item and shipping promotions together, they can be grouped under the Promotions line on the invoice.

Use case: 1 order, 1 ASIN, 2 shipments

For brevity, Shipping Promotion and Gift Wrap Promotion have not been shown.

Sample report

Order IDASINShipping IDQuantityItem Price (VAT incl)Item Price (VAT excl)Item Price (VAT)Item Price (VAT rate)Shipping (VAT incl)Shipping (VAT excl)Shipping (VAT)Shipping (VAT rate)Gift Wrap (VAT incl)Gift Wrap (VAT excl)Gift Wrap (VAT)Gift Wrap (VAT rate)Item Promo (VAT incl)Item Promo (VAT excl)Item Promo (VAT)Item Promo (VAT rate)
123-1111111-2222222BYU738349K82349303341120100200.2121020.26510.2-60-50-100.2
123-1111111-2222222BYU738349K0218930762240200400.2121020.26510.2-60-50-100.2

In this case, the seller must create two Invoices because there two shipping IDs for this order ID, even though there is only one ASIN in the order. This scenario can occur if one quantity is dispatched from one fulfillment center while the other is dispatched from a fulfillment center in a different country. This can result in different taxation and the seller VAT number applicable in the invoices will be different. The scenario is demonstrated in the following example. This is not a complete invoice, but only a section of the invoice, demonstrating the line items. An invoice must contain many other details. Refer to section 5.2 to determine which details must be included in an invoice.

Sample invoice for shipping ID 8234930334

QuantityItem DescriptionUnit Price (excl. VAT)VAT RateUnit Price (incl. VAT)Total Price (incl. VAT)
1ASIN€ 100.0020%€ 120.00€ 120.00
Shipping charge€ 10.0020%€ 12.00€ 12.00
Gift wrap€ 5.0020%€ 6.00€ 6.00
Promotions- € 50.0020%- € 60.00- € 60.00
Total:€ 78.00

Sample invoice for shipping ID 021893076

QtyItem DescriptionUnit Price (excl. VAT)VAT RateUnit Price (incl. VAT)Total Price (incl. VAT)
2ASIN€ 100.0020%€ 120.00€ 240.00
Shipping charge€ 10.0020%€ 12.00€ 12.00
Gift wrap€ 5.0020%€ 6.00€ 6.00
Promotions- € 50.0020%- € 60.00- € 60.00
Total:€ 198.00

📘

Note

If the shipment contains item and shipping promotions together, they can be grouped under 'Promotions' line on the invoice.