Some merchants using TikTok Shop, Pipe17, Shopify, and Avalara have reported that TikTok Shop orders unexpectedly started appearing in Avalara, even though this did not occur previously.
Pipe17 does not connect directly to Avalara. Instead, the behaviour is the result of how Shopify and Avalara interpret tax information coming from marketplace orders (such as TikTok Shop).
This article explains:
When this situation applies
Why TikTok Shop orders may appear in Avalara
What Pipe17 has changed in your configuration
What you should expect going forward
When this applies
This article is relevant if all of the following are true:
You sell on TikTok Shop.
-
Your TikTok Shop orders flow through:
TikTok Shop → CedCommerce (or similar app) → Pipe17 → Shopify
You use Avalara connected to Shopify.
You recently noticed that TikTok Shop orders started showing up in Avalara, even though this did not happen before.
How the integration works
In this setup, a typical(but not limited to) Pipe17’s role is:
Import orders from TikTok Shop.
Send those orders to Shopify so they can be processed and fulfilled.
Send fulfillment updates back to TikTok Shop.
Pipe17 does not:
Connect directly to Avalara.
Send any data directly to Avalara’s API.
Avalara receives order information from Shopify, and Avalara’s behaviour depends on how Shopify classifies the order and its tax lines.
What changed and why TikTok Shop orders appear in Avalara
For marketplace channels like TikTok Shop, there is an important concept called tax liability:
In many cases, the marketplace (TikTok Shop) is the tax-liable party, not the merchant.
Shopify and Avalara use a setting (sometimes referred to as a “channel liable” flag on tax lines) to determine whether the sales channel or the merchant is responsible for tax on a given order.
Recently, changes in how marketplace orders are handled between Shopify / CedCommerce / Avalara mean that:
If TikTok Shop orders are not clearly marked as “channel liable” for tax,
Avalara may treat those orders as merchant-taxable and pull them into tax calculations and reporting.
Our standard configuration for TikTok Shop orders in the Shopify connector did not fully align with this updated expectation, which could cause TikTok Shop orders to start appearing in Avalara where they did not before.
How this is configured in Pipe17 (Shopify connector)
TikTok Shop → Pipe17 → Shopify tax behaviour is controlled in the Shopify connector mapping in your Pipe17 account.
For many setups, the tax lines mapping for orders looks similar to this:
{
"name": "tax_lines",
"enabled": true,
"source": "((process) => { return (process ? [{ price: sourcedoc.orderTax, rate: 0.00, title: 'Sales Tax', channel_liable: false }] : undefined) })(sourcedoc.orderTax > 0)",
"target": "tax_lines"
}Key points:
price: sourcedoc.orderTax– the tax amount coming from the source order (e.g., TikTok Shop).title: 'Sales Tax'– the label for the tax line in Shopify.channel_liable: false– tells Shopify/Avalara that the merchant is considered tax-liable for this tax line.
Depending on your Avalara + Shopify setup and how marketplace orders are supposed to be handled, you may want to treat TikTok Shop as the channel-liable party instead.
Where to find this mapping
Log in to your Pipe17 account.
Go to Connections → Shopify (select the relevant Shopify connector if you have multiple).
Open the Order mapping (sometimes labeled “Order Flow” or “Order mapping configuration”).
Look for the mapping entry named
tax_lines.You should see a JSON snippet similar to the example above.
If you do not see a
tax_linesmapping or are unsure which mapping applies to TikTok Shop orders, please contact Pipe17 Support and include example order IDs.
How you (or Pipe17 Support) can adjust it
If, based on guidance from your tax advisor and Avalara/Shopify, TikTok Shop should be treated as channel liable for tax, the mapping can be updated so that channel_liable is set to true:
{
"name": "tax_lines",
"enabled": true,
"source": "((process) => { return (process ? [{ price: sourcedoc.orderTax, rate: 0.00, title: 'Sales Tax', channel_liable: true }] : undefined) })(sourcedoc.orderTax > 0)",
"target": "tax_lines"
}
This tells Shopify/Avalara that the sales channel (e.g., TikTok Shop) is tax-liable for these orders, rather than the merchant.
Important:
This is a per-connector, per-merchant configuration.
Pipe17 has not made this change globally for all merchants.
Any update is done only for the specific connector(s) where it is appropriate and approved.
If you are comfortable editing the mapping, you can make this change yourself. If not, you can contact Pipe17 Support and request that we:
Review your current tax mapping, and
Update
channel_liablefor TikTok Shop orders if it matches your intended tax treatment.
What to expect if this mapping is changed
For new orders
Once the tax_lines mapping is updated so that TikTok Shop tax lines are marked as channel-liable:
New TikTok Shop orders flowing through Pipe17 into Shopify should be classified according to the updated tax liability setting.
In many cases, this may result in Avalara no longer treating TikTok Shop orders as merchant-taxable in the same way, and may change how (or whether) those orders appear in Avalara.
For historical orders
Orders that have already been created in Shopify and processed by Avalara are not automatically changed by editing this mapping.
Any adjustments or cleanup for past periods typically must be handled within Avalara and/or Shopify, guided by your tax advisor.
What you may want to do
1. Monitor upcoming TikTok Shop orders
After you or Pipe17 Support adjust the mapping:
-
Review a sample of new TikTok Shop orders in:
TikTok Shop
Shopify
Avalara
Confirm that they now behave as expected from a tax and reporting perspective.
2. Review your tax reporting with your tax advisor
If TikTok Shop orders were previously being treated as merchant-taxable in Avalara:
You may want to confirm with your tax advisor whether any adjustments are needed to your reporting or filings.
Pipe17 cannot provide tax advice or determine the correct tax treatment for your business.
3. Check your Shopify / Avalara configuration
In addition to the mapping:
Ensure your Avalara configuration in Shopify follows Avalara’s recommendations for marketplace or “channel-liable” orders.
If you’re unsure, Avalara Support or your tax advisor can help validate that setup.
FAQ
Does Pipe17 integrate directly with Avalara?
No. Pipe17 sends order data to Shopify. Avalara connects to Shopify and interprets order and tax information from there.Did Pipe17 change anything that would cause TikTok Shop orders to appear in Avalara?
Pipe17 did not introduce any direct Avalara integration and has not made a global change across all merchants.
However, your Shopify connector may be configured so that TikTok Shop tax lines treat the merchant as tax-liable. Depending on recent changes in how marketplace orders are handled by Shopify/Avalara, this configuration can influence whether TikTok Shop orders appear in Avalara. This can be adjusted on a per-connector basis if appropriate for your setup.Will changing this mapping affect my other channels (e.g., Shopify native, Amazon, etc.)?
No, not automatically. The mapping is configured per connector. Changes made to the Shopify connector that handles TikTok Shop orders apply only to that connector configuration. If you have other connectors or separate flows, they are not affected unless you edit those mappings as well.Can Pipe17 remove or modify historical orders in Avalara?
No. Pipe17 cannot modify data inside Avalara. Any cleanup, reclassification, or historical corrections must be done within Avalara and/or Shopify, according to guidance from your tax advisor or Avalara.
If you are still seeing unexpected behaviour in Avalara after reviewing this and (if appropriate) updating your mapping, please provide:
One or more example order IDs, and
Screenshots or details from Shopify and/or Avalara showing how the order appears,
and Pipe17 Support can help review your configuration and mapping.
Need Help?
If you need additional assistance:
- Use Ask Pippen, our AI agent, located at the top of the app page.
- Submit a support request with as much relevant detail as possible. Learn how to submit a request.
- For urgent issues, email us directly at support@pipe17.com.
We're here to help you succeed with your operations.
Comments
0 comments