Skip to main content
Metronome supports dynamic calculation of sales tax when invoicing with Metronome or another system like Stripe.

​
Configure tax with Metronome invoicing

Metronome integrates with providers like Avalara or Anrok to calculate tax for invoices. Metronome calculates tax at the line item level, but records the total amount on the external_invoice object on the invoice. To calculate tax Metronome needs two mappings:
  • Mapping of Metronome customer to the customer in your tax provider to get information like customer address and tax code.
  • Mapping of Metronome products to items in your tax provider to get the tax rates for each line item on your customers’ invoice.
Private BetaMetronome invoicing is currently in Private Beta. Contact your Metronome representative for early access.

​
Calculate tax with Avalara

Connect Metronome and Avalara Provide Metronome with an Avalara user account by providing credentials to the /upsertAvalaraCredentials end point. Example request shown below: 
{
    "delivery_method_ids": ["8e7eed63-2b70-4772-a3cc-929b7582eea7"],
    "avalara_environment": "PRODUCTION",
    "avalara_username": "my-username",
    "avalara_password": "my-password"
}
Map Metronome products to Avalara items Create a custom field on your Metronome product called avalara_item_code. For each product in Metronome, set the value of this field to the corresponding item code in Avalara. Using the entity mapping feature in Metronome, map the Metronome product to the avalara_item_code. This is how Metronome will know what tax rate to apply to each line item. Configure customer Once Metronome has an Avalara credential and correctly mapped products, you are ready to calculate taxes for your customers’ invoices. You must now specify avalara and the avalara_customer_code on the customer’s billing configuration. Here is an example call to /setCustomerBillingConfiguration: 
{
	"billing_provider": "stripe",
	"delivery_method": "direct_to_billing_provider",
	"tax_provider": "avalara",
	"configuration": {
	  "stripe_customer_id": "cus_T4uJnLBmxYGdcL",
	  "stripe_collection_method": "auto_charge_payment_intent",
      "avalara_customer_code": "avalara-customer"
  }
}

​
Configure tax with Stripe invoicing

Stripe tax calculation works with Anrok and Avalara. Metronome integrates with these tax providers via connections to Stripe. To conigure tax with these providers, set up the appropriate entity mapping in the Metronome app:
  1. Click Connections in the left sidebar.
  2. Under Integrations, go to Stripe, click Edit Mapping.
  3. Use the modal dialog to populate the mappings using the values below.
  4. Click Save.
INFOContact your Metronome representative to enable sales tax calculations.

​
Required entity mappings

Calculation of taxes in Stripe requires entity mapping in Metronome. Use this table of values to configure the correct entity mappings for your chosen tax service (Anrok or Avalara).
Metronome EntityStripe EntityNotes
Line iteminvoiceitemCreated by invoicer upon issuance
InvoiceinvoiceCreated by invoicer upon issuance
”Product ID” custom field on Line iteminvoiceitem.price.productStripe product ID is stored in a line item custom field. This field is used for the Anrok integration and is passed as part of the invoice item from Stripe during invoice issuance.
Any custom field on Line iteminvoiceitem.metadata.*Any metadata key that’s stored on a line item custom field. This field can be used for the Avalara integration, specifically to provide TaxCode metadata. This metadata is also passed as part of the invoice item from Stripe during invoice issuance.
Any custom field on Customerinvoice.metadata.*Any metadata key that’s stored on a customer custom field. This field can be used for the Avalara integration, specifically to provide TaxCode metadata. This metadata is also passed as part of the invoice from Stripe during invoice issuance.
⌘I