Broadleaf Microservices
  • v1.0.0-latest-prod

Avalara Tax Module

Avalara Tax Usage

Include the BLC Avalara dependency:

<dependency>
  <groupId>com.broadleafcommerce.microservices</groupId>
  <artifactId>broadleaf-avalara-tax</artifactId>
</dependency>

Define the following properties:

  1. broadleaf.tax.provider.avatax.appName (Optional) - The application name passed to AvaTax. Defaults to "Broadleaf Commerce"

  2. broadleaf.tax.provider.avatax.appVersion (Optional) - The application version. Defaults to "app-version-not-set"

  3. broadleaf.tax.provider.avatax.machineName (Optional) - The machine name. Defaults to "machine-name-not-set"

  4. broadleaf.tax.provider.avatax.environment (Required) - The AvaTax environment. Accepted values are 'Sandbox' or 'Production'. Ignores case.

  5. broadleaf.tax.provider.avatax.username (Required) - The AvaTax username.

  6. broadelaf.tax.provider.avatax.password (Required) - The AvaTax password.

Instantiate an instance of AvalaraTaxProvider:

@Bean
public TaxProvider<TaxRequest, TaxResponse> avaTaxProvider(AvaTaxProperties avaTaxProperties,
            TypeFactory typeFactory,
            ObjectMapper objectMapper) {
    return new AvalaraTaxProvider<>(avaTaxProperties, typeFactory, objectMapper);
}

Note: Tax commits, adjustments, voids, and refunds are disabled by default. To enable Avatax’s ability to commit, adjust, refund, and void transaction capabilities, see the order operations docs on post checkout tax operations.