Connec TikTok Shop to Acumatica

Acumatica is configured in fulfillment mode - it's the downstream system of record, not a sales channel. Authentication uses OAuth 2.0, and the Pipe17 customization project must be installed in your Acumatica instance.

What syncs

TikTok Shop product push is US/UK only. Outside those regions, manage the TikTok catalog directly in TikTok Shop.

Before you begin

• Connect TikTok Shop first. See Connect TikTok to Pipe17.
• Acumatica admin access.
• Your Acumatica instance URL (e.g. https://server_name/instance_name).
• A default Acumatica customer for TikTok Shop orders, and a dedicated payment method (such as TTS).

Step 1: Prepare Acumatica

Install the Pipe17 customization project. Download the project from https://connector-webhooks-master.service.pipe17.com/connector_acumatica/project. In Acumatica, open Customization Projects, upload the file, and publish it.

Create a Connected Application. In Acumatica, open Connected Applications and create a new app using the OAuth 2.0 Authorization Code flow. Set Redirect URI to:

<https://connector-webhooks-master.service.pipe17.com/connector_acumatica/token>

Save and copy the Client ID and Client Secret.

Step 2: Confirm TikTok Shop is connected

Open the TikTok Shop connector and confirm Pull orders and Push fulfillments are enabled.

Step 3: Connect Acumatica in the app

Add the Acumatica connector and enter:

• API URL - your Acumatica instance URL.
• API EndPoint - Pipe17/001.
• API Client ID and API Client Secret - from your Connected Application.

Save and click Connect to complete OAuth.

Step 4: Configure the default customer

TikTok Shop doesn't share buyer information, so all TikTok orders use a single generic Acumatica customer.

In the Acumatica connector settings, set the customer matching strategy to Use a generic customer for all orders, then enter the Generic Customer Id of the Acumatica customer you created.

Step 5: Match SKUs

If a product uses a different SKU in Acumatica than in TikTok Shop, map it on the product record:

1. Open the product in Products.
2. Scroll to Channel Options.
3. In the Acumatica row, enter the Acumatica SKU in the Channel SKU column.
4. Save.

The TikTok Shop row has no Channel SKU column - TikTok SKUs must match the master SKU in the app directly.

Step 6: Map shipment and payment methods

In the Acumatica connector's Orders to Acumatica mapping:

• Map each TikTok shipping option to a real Acumatica shipping method.
• Map the payment method to the TikTok Shop payment method ID you created (e.g. TTS).

Acumatica rejects orders that don't reference a valid shipping method and payment method.

Step 7: Configure order types (optional)

By default, TikTok Shop orders push to Acumatica with order type SO. To send TikTok orders to a different Acumatica order type (useful for channel-level reporting), use Use order type defined below when pushing sales orders to Acumatica on the Acumatica connector and add an entry in the format channel:orderType for TikTok Shop.

Step 8: Enable sync settings

On the Acumatica connector, enable:

• Push orders to Acumatica
• Push canceled orders to Acumatica
• Pull product catalog information from Acumatica
• Pull shipping requests from Acumatica
• Pull fulfillments from Acumatica
• Process inventory information - pick Pull inventory updates from Acumatica or Push inventory updates to Acumatica.
• Process locations information - pick the direction you need.

Optional:

• Push orders to Acumatica only for specific order sources - scope the connector to TikTok Shop only.
• Mark orders as "Sent to Fulfillment" when pushing to Acumatica - auto-transition orders once created.
• Allow push refund orders to Acumatica - enable refund push (off by default).

Make sure Push fulfillments is enabled on the TikTok Shop connector.

Best practices

• Install the customization project and create the Connected Application before opening the Pipe17 connector.
• Use one generic Acumatica customer for all TikTok Shop orders.
• Map every TikTok shipping option to a real Acumatica shipping method before going live.
• Use Push orders to Acumatica only for specific order sources if you have multiple sales channels but only want TikTok orders in Acumatica.
• Test with one order before enabling full sync.

Troubleshooting

• Acumatica connection fails
  Verify API URL, API EndPoint, API Client ID, and API Client Secret. Confirm the Pipe17 customization project is published and the Connected Application's Redirect URI matches the value in Step 1.
• OAuth authorization page doesn't load
  The customization project isn't published. Open Customization Projects in Acumatica and publish it.
• Orders aren't being pushed to Acumatica
  Confirm Push orders to Acumatica is enabled. Check whether Push orders to Acumatica only for specific order sources excludes TikTok Shop.
• Acumatica rejects orders (customer / shipping method / payment method)
  Confirm Steps 4, 6, and 7 are complete. Each rejection points to whichever mapping is missing.
• Canceling on TikTok Shop doesn't cancel in Acumatica
  Enable Push canceled orders to Acumatica.
• Refunds aren't pushing
  Enable Allow push refund orders to Acumatica - off by default.
• Acumatica products aren't appearing in the app
  Confirm Pull product catalog information from Acumatica is enabled. If totals still look off, enable Force product catalog resync.
• Inventory totals look wrong
  Confirm Process inventory information is set to Pull inventory updates from Acumatica or Push inventory updates to Acumatica as appropriate. Check Process only inventory items with matched SKUs and Exclude inventory items with specific SKUs for unintended scoping. Enable Force inventory resync to refresh.
• Fulfillment data isn't reaching TikTok Shop
  Confirm Pull fulfillments from Acumatica is enabled on the Acumatica connector and Push fulfillments is enabled on the TikTok Shop connector.
• Products aren't matching
  Check that SKUs match exactly (including case and whitespace). Map mismatches in the Acumatica row of Channel Options.
• The Channel SKU column is missing on the TikTok Shop row
  Expected - TikTok Shop doesn't support per-channel SKU mapping.
• The Channel SKU column is hidden on a parent product
  Open a child or variant to set channel SKUs.

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.