Mandatory and Required Fields
The API, like all APIs, has mandatory fields that are required to complete the schema and successfully send a request. If you do not complete these fields, the API returns an error that indicates the schema is complete. These are referred to as mandatory fields.
In addition, specific products and features can require specific fields. For example, if you want to calculate a tax rate for Canada, you need to include the region in the request. These are referred to as required fields.
Required Fields for Vertex for e-Commerce and Advantage Plus
Vertex for e-Commerce and Advantage Plus require that you include specific fields for certain countries for calculating tax and storing transactions. These are outlined in the following table. This is only relevant for customers using the direct API integration.
| Country | Calculate Tax Fields | Store Transaction Fields |
|---|---|---|
| United Arab Emirates (AE) | None | invoice_address.region |
| Canada (CA) | invoice_address.region | invoice_address.cityinvoice_address.postal_code |
| India (IN) | None | invoice_address.region |
| Japan (JP) | None | buyer_name |
| Norway (NO) | None | buyer_nameinvoice_address.cityinvoice_address.postal_code |
| United States of America (USA) | invoice_address.regioninvoice_address.cityinvoice_address.postal_code | None |
Required Fields for B2B Validation
Canada requires that you include the name of the business in requests where you want to validate a Canadian Tax ID.
Updated 12 months ago