HomeDocumentationCode SamplesAPI ReferenceAnnouncementsModelsRelease NotesFAQGitHubVideos
Developer HubAPI StatusSupport
Documentation
Developer HubAPI StatusSupport

Use Cases

Review example use cases for VCS and VIDR data.

The VIDR provides complete VAT calculation data that you can use to create invoices on time. One invoice is required per shipment. Some sample use cases, along with VIDR data, are described in the following sections. You can choose their own invoice format, as long as the invoice contains all of the required information.

Use case: Amazon Prime Wardrobe

Amazon Prime Wardrobe is an Amazon Prime-exclusive program where customers order up to six items (clothing, shoes, and accessories) from their Amazon Prime Wardrobe cart without being charged when the shipment is dispatched. Customers get seven days to try on the items at home, and are only charged for the items they decide to keep after the seven-day try-on period.

Because customers are not charged at the time of shipment, the invoice is not due until after the seven-day trial period. You can view these transactions in the VIDR after the customer is charged at the end of the trial period. You must upload invoices within one business day from the end of the trial period.

Tip

Because Amazon Prime Wardrobe orders are not placed by B2B customers, they don't affect the Invoice Defect Rate calculation.

Transaction IDs are required for shipments and reversals for Amazon Prime Wardrobe orders. Your invoice upload is rejected if it doesn't have the transaction ID for a shipment. A credit note upload for a reversal is also rejected if it doesn't have a transaction ID.

Use case: One order, one ASIN, one shipment

For brevity, shipping promotion and gift wrap promotion are not 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

Because there is only one shipping ID for this order, you must create one invoice. Item VAT-exclusive and VAT-inclusive price must be clearly mentioned. Item VAT rate must be displayed along with VAT amount. Gift wrap, shipping, and promotions (if applicable) must be displayed separately and clearly. Refer to the following invoice excerpt example that shows the section of the invoice that contains these line items.

Sample invoice excerpt

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, these can be grouped under the promotions line on the invoice.

Use case: One order, two ASINs, one shipment

For brevity, shipping promotion and gift wrap promotion are not 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

Because there is only one shipping ID for this order, you must create one invoice. Item VAT-exclusive and VAT-inclusive prices must be clearly mentioned. Item VAT rate must be displayed along with VAT amount. Gift wrap, shipping, and promotions (if applicable) can be grouped together in three separate line items. Refer to the following invoice excerpt example that shows the section of the invoice that contains these line items.

Sample invoice excerpt

QuantityItem descriptionUnit price (VAT excl)VAT rateUnit price (VAT incl)Total price (VAT incl)
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 are 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. If the shipment contains item and shipping promotions together, they can be grouped under the promotions line on the invoice.

Use case: One order, one ASIN, two shipments

For brevity, shipping promotion and gift wrap promotion are not 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

Because there are two shipping IDs for this order, you must create two invoices (even thought there is only one ASIN). This scenario can occur if one quantity is dispatched from a fulfillment center in one country and another quantity is dispatched from a fulfillment center in a different country. This can result in different taxation on items and the seller VAT number on the invoices is different. Refer to the following invoice excerpt examples that show the sections of the invoices that contain these line items.

Sample invoice excerpt 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 excerpt 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, these can be grouped under the promotions line on the invoice.