Overview
Once you’ve integrated Anrok & Stripe, configured your Stripe account, and reviewed our best practices for manual invoicing in Stripe, we understand you may encounter situations you haven't experienced before, which can bring about a few questions. Let's work through some of these commonly asked questions together.
Why is the tax amount showing as $0.00 on a manually created invoice?
1. Check if the accounting date is before the jurisdiction's tax collection start date.
If you've confirmed that the invoice has been saved and is present on your Transactions page, there is a chance that the accounting date listed is before your tax collection date.
To check a jurisdiction's tax collection start date:
-
In the Anrok app
, go to Jurisdictions. Take me there!
- Select the Remitting tab, then select the jurisdiction.
- Under Jurisdiction details, review the Tax calculation state date.
2. Make sure you've turned on Stripe's automatic tax calculation.
Stripe's automatic tax calculation will enable Anrok’s tax calculation on your transactions. It’s important to ensure automatic tax calculation is turned on for your Stripe account. To turn on automatic tax calculation:
-
In the Stripe app
, go to Tax settings. Take me there!
- Under Automatic tax calculation, toggle on Use automatic tax calculation.
- If you are using an integration, make sure your integration has
automatic_tax[enabled]=true
in your Stripe API calls.
3. Make sure you've archived the product's default tax rate.
Default tax rates on your products will block Anrok’s tax calculation from appearing on your invoice. You are required to archive any custom tax rates present on your Stripe products. To archive a product's default tax rate:
-
In the Stripe app
, go to Products, then select the Tax rates tab. Take me there!
- Next to an
Active
tax rate, click the options menu button, then select Archive tax rate.
Why am I receiving an "Unknown product ID" error on my Unprocessed Transactions page?
Configure the Stripe product in Anrok as a product ID.
This error occurs when Anrok receives a Stripe item that does not have a corresponding Anrok product ID. For Anrok to calculate tax on an item in your invoice, you will need to configure the item as a product ID in Anrok. Doing so ensures that the correct tax rate and taxability are applied to the item — based on the configured product type and tax category. To configure a Stripe product into Anrok as a product ID:
-
In the Anrok app
, go to Data sources. Take me there!
-
Under Integration sources, click the options menu button
next to Stripe, then select Configure new products.
- Under New products detected, select a corresponding Product type and Tax category for each product detected. See What tax configuration should I select?
- If you'd like to assign a Product type and Tax category to multiple products at once, click the checkbox
next to each product, then select Batch assign.
- When you are finished, scroll down and click Add products.
How does Anrok process Stripe's discounts, credit notes, and voids?
Anrok's Stripe integration assesses taxability for your transactions by taking into account discounts, credit notes, and voided invoices. The following is intended as a guide to help you understand the tax implications for each of these behaviors.
Discounts
All discounts in Stripe must be applied prior to the invoice being finalized; any price adjustments made after that point are considered credit notes (see below).
Discounts applied in Stripe are pre-tax and are applied proportionally across the line items on an invoice. Pre-tax means that tax will be calculated based on the discounted value of the line item rather than the full value. Note: the implications of this may be significant in cases where you have multiple line items for different product types on the same invoice (e.g. a SaaS product with an additional services fee), especially if the discount is thought of as discounting or refunding a particular cost that has higher taxability than the other item(s).
If you want a discount to apply to a specific subset of line items, we recommend using negative line items associated with those products in order for tax to be assessed based on the distinct product categories of those line items.
Credit Notes
When issuing credit notes in Stripe, we recommend that you specify the line item(s) being credited, so we can take into account any differences in the taxability of line items on the invoice. You should not credit any tax amount that was added by Anrok; we will do this automatically via our Stripe integration. Tax credits will be reflected in Anrok and filed accordingly on your returns.
Please note that Stripe uses credit notes for refunds and Anrok updates the original transaction when they are received. For this reason, invoice credit notes are a required way of recording credits/refunds.
Voids
If an invoice is in dispute or considered uncollectible and you don't want to owe taxes on it, you need to void the invoice in Stripe. If the invoice is voided in the same tax filing period in which it was created, tax will be adjusted within that same period. If the void occurs after tax has already been reported and remitted, you will see a credit in the next filing period for the amount previously paid.
What address information does Anrok collect from Stripe?
Stripe stores address information in several different places. Anrok checks each of these locations in the following order:
- Invoice physical shipping address:
invoice.shipping_details.address
- Invoice shipping address:
invoice.customer_shipping
- Invoice billing address:
invoice.customer_address
- Invoice payment method address:
invoice.payment_intent.payment_method.billing_details.address
- Customer shipping address:
customer.shipping.address
- Customer billing address:
customer.address
- Customer card payment method address:
customer.payment_method.billing_details.address
Why when using Stripe test clock does my recurring subscription invoice not have tax applied?
If you’d like to test the behavior of the Anrok <> Stripe integration using Stripe test clock, please keep in mind the following:
- Anrok will provide a tax calculation to invoices dated up to 31 days in the future so your test cases must be dated within a 31-day future window.