Element type: Required

Endpoints/models used: TransactionLineParamenterModel

Your integration must provide users with a method for specifying the name of the merchant selling an item.

Keep in mind the following when using VAT input fields in marketplace transactions:

The MerchantVatId indicates the merchant’s VAT number. Most marketplaces collect this kind of information as part of an onboarding process. Users pass this value at the line level.

The merchantSellerIdentifier, MerchantEstablishmentCountry, MerchantName, and MerchantVatId fields should only ever contain the values of the merchant on the marketplace that are relevant to the goods referenced on that transaction line. These fields should never refer to the Avalara client.
- If the Avalara client is set up as a marketplace and is selling its own products, leave the above fields blank or omit them from the request. This is because AvaTax will assume that when these fields are blank, the items belong to the Avalara client and, therefore, won’t apply the deemed supplier logic.

Regardless of the taxCode type (freight, physical, digital, and so on), the MerchantEstablishmentCountry will always be the same whenever the related merchantSellerIdentifier is used. For example, if Line 1 has merchantSellerIdentifier = "Seller123" and MerchantEstablishmentCountry = "CH", then those values should be used for every line where the merchant is Seller123.

View example

Merchant name