Skip to Content

Tiktok Shop Connector

by
Odoo

$ 66.52

v 18.0 Third Party
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Invoicing (account)
• Discuss (mail)
• Inventory (stock)
Community Apps Dependencies
Lines of code 2468
Technical Name d_tiktok_shop_connector
LicenseOPL-1
Websitehttps://duong-odoo-apps.odoo.com
Versions 17.0 18.0
You bought this module and need support? Click here!
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Invoicing (account)
• Discuss (mail)
• Inventory (stock)
Community Apps Dependencies
Lines of code 2468
Technical Name d_tiktok_shop_connector
LicenseOPL-1
Websitehttps://duong-odoo-apps.odoo.com
Versions 17.0 18.0

TikTok Shop Connector

Here is the demo video

Integrate Your Odoo with TikTok Shop

Connect your Odoo system with TikTok Shop to manage your e-commerce operations seamlessly. This module provides a complete integration solution for businesses selling on TikTok Shop platform.

With TikTok Shop Connector, you can synchronize orders, inventory, and manage returns all from your Odoo system, eliminating the need to switch between platforms.

Order Synchronization

Automatically import orders from TikTok Shop:

  • Orders are created in Odoo with all details
  • Customer information is imported
  • Order status is synchronized
  • Delivery information is updated
  • Automatic invoice creation for completed orders

The synchronization runs automatically via scheduled jobs, but you can also trigger it manually when needed.

TikTok Shop Orders

Inventory Management

Keep your TikTok Shop inventory in sync with Odoo:

  • Stock levels are automatically updated to TikTok Shop
  • Prevent overselling by keeping accurate inventory
  • TikTok warehouses are created in Odoo for proper tracking
  • Real-time synchronization when stock moves occur
  • Scheduled synchronization ensures up-to-date stock levels

The inventory synchronization ensures your TikTok Shop always shows accurate stock availability.

TikTok Shop Inventory Sync

Returns Management

Complete returns and refunds handling:

  • Automatically import return requests from TikTok Shop
  • Create return pickings in Odoo
  • Track return status and reason
  • Process returns in batch for efficiency
  • Full visibility of return history on sales orders

The returns management system ensures you have full control over the return process while maintaining accurate inventory records.

TikTok Shop Returns

Financial Integration

Track TikTok Shop fees and financial data:

  • Automatically retrieve financial data for each order
  • Create vendor bills for TikTok platform fees
  • View detailed financial breakdown
  • Accurate accounting for TikTok Shop operations

This integration ensures your accounting records accurately reflect all costs associated with selling on TikTok Shop.

TikTok Shop Financial Data

Multi-Shop Support

Manage multiple TikTok Shops from a single Odoo instance:

  • Connect multiple seller accounts
  • Configure each shop individually
  • Separate synchronization settings per shop
  • Assign different sales teams to different shops

Perfect for businesses operating in multiple regions or with multiple TikTok Shop storefronts.

TikTok Multiple Shops

Documentation

Please go to documentation tab in the right side to see how to configure tiktok developer app and in odoo as well

Documentation Tab

SUPPORT EMAIL

Contact me for support at duongodooapps@gmail.com

TikTok Shop Connector Usage Guide

This guide will help you set up and use the d_tiktok_shop_connector module in Odoo to manage your TikTok Shop.

For setting up your TikTok Shop app on TikTok Shop Partner Center, you need to create tiktok partner account at: TikTok Shop Partner Center: https://partner.tiktokshop.com/

1. Module Overview

The d_tiktok_shop_connector module integrates TikTok Shop with Odoo, allowing you to:

  • Synchronize orders from TikTok Shop to Odoo
  • Synchronize inventory between Odoo and TikTok Shop
  • Manage return requests from TikTok customers
  • Automatically create customer invoices and vendor bills
  • Track TikTok Shop commission fees
  • Manage multiple TikTok Shops from a single Odoo instance

2. Installation and Configuration

2.1. Register TikTok Shop App

Before configuring in Odoo, you need to create an app on TikTok Shop Partner Center:

  1. Go to https://partner.tiktokshop.com , create new account if you do not have one
Signup tiktok shop partner center
  1. You will enter home screen like this -> hit button Add category and market
Titkok partner center screen
  1. Choosing Bussiness guide, i suggest For app developer to easily configuration
Titkok partner center Bussiness guide
  1. After that fill in the information in this form
Titkok partner center category market
  1. For bussiness category, choose Tiktok shop parter and App Developer
Titkok partner center bussiness category

6. Go to App & Service to create a new app like following image, remember to choose correct market and enable api and the callback url must follow https://your-odoo-domain.com/tiktok_account/authentication

Titkok create developer app Titkok create developer app

7. Activate the scope, go to Manage API and activate following scopes: Finance Information, Global Product Delete, Global Product Information, Global Product Modify, Global Shop Information, Logistics Basic, Order Information, Product Basic, Product Delete & Recover, Product Modify, Return & Refund Basic, Shop Authorized Information, TikTok Shop Analytics, Awaiting submission, Update Delivery Status

Activate Tiktok shop scopes

2.3. Configure in Odoo

  1. Install the d_tiktok_shop_connector module
  2. Go to Sales -> Configuration -> Settings
  3. Find the TikTok Shop section and enter the following information:
    • App Key: From TikTok Shop Partner Center
    • App Secret: From TikTok Shop Partner Center
    • Service ID: From TikTok Shop Partner Center
    • Region: Choose US or Non-US depending on your region
Configure TikTok Shop in Odoo
  1. Click Connect TikTok Shop to authenticate
Connect TikTok Shop in Odoo

2.4. Connect Seller Account

After authentication, you will be redirected to the TikTok Shop authentication page:

  1. Log in to your TikTok Shop account
  2. Select the correct market of your tiktok shop, ex: you are selling in Vietnam you should select Vietnam
  3. Grant permissions to the app
  4. After successful authentication, you will be redirected back to Odoo
  5. Seller account and shops will be automatically synchronized
TikTok Shop Authorize TikTok Shop Authorize

3. Managing TikTok Shops

3.1. View Shop List

  1. Go to Sales -> Configuration -> TikTok Shop -> Shops
  2. You will see a list of synchronized TikTok Shops
  3. Each shop will display:
    • Shop name
    • Shop ID
    • Region
    • Seller type
TikTok Shop List

3.2. Configure Shop

Open the shop form to configure:

  1. Sync Inventory: Enable/disable inventory synchronization, this option will help you sync all product with variant and inventory (quantity) from tiktok shop to odoo
  2. Sales Team: Choose default sales team
  3. Salesperson: Choose default salesperson
  4. Last Order Sync Date: This field shows when the last order synchronization was performed. The system uses this date to fetch only new orders since the last sync, improving performance and avoiding duplicate orders.
  5. Last Inventory Sync Date: This field shows when the last inventory synchronization was performed. Similar to order sync, this helps track when inventory levels were last updated between Odoo and TikTok Shop.

These date fields are automatically updated whenever a synchronization occurs, either manually or through scheduled jobs. They are useful for troubleshooting and monitoring the synchronization process.

Configure TikTok Shop

4. Order Synchronization

4.1. Manual Synchronization

  1. Open the TikTok Shop form
  2. Click the Sync Orders button
  3. Odoo will fetch new orders from TikTok Shop

4.2. Automatic Synchronization

The module has pre-configured scheduled jobs to synchronize orders every hour. You can adjust the synchronization frequency at:

  1. Go to Settings -> Technical -> Automation -> Scheduled Actions
  2. Find the job start with TikTok
  3. Adjust the frequency as needed

4.3. View TikTok Orders

  1. Go to Sales -> Orders
  2. Use the "TikTok Orders" filter to view orders from TikTok Shop
  3. Each order will display: - TikTok Order ID - TikTok Status - TikTok Shop
TikTok Shop Orders

4.4. Order Processing Flow

When an order is synchronized from TikTok Shop to Odoo, the following automated workflow takes place:

  1. Order Creation:
    • A sales order is created in Odoo with all product lines from TikTok Shop
    • Customer information is imported and linked to the order
    • TikTok order status is recorded on the Odoo order
  2. Delivery Processing:
    • A delivery order (outgoing picking) is automatically created
    • When TikTok status changes to "IN_TRANSIT", the delivery is marked as done
    • Tracking information is synchronized between systems
  3. Return Handling (if applicable):
    • If a return request exists in TikTok Shop, it's imported to Odoo
    • For undelivered orders: The original delivery order is updated to remove returned items
    • For delivered orders: A return picking (incoming) is created to receive returned products
    • Return reason and status are tracked in the system
  4. Invoice Generation (when order is completed):
    • When TikTok status changes to "COMPLETED": - A customer invoice is automatically created - The invoice is validated - Payment is registered
  5. TikTok Fee Processing:
    • Financial data is retrieved from TikTok Shop API
    • A vendor bill is created with "TikTok Platform" as vendor
    • The bill records commission fees charged by TikTok Shop
    • This ensures accurate accounting of all TikTok-related expenses

This automated workflow ensures that all aspects of order processing are handled efficiently, from initial order creation through delivery, returns, invoicing, and fee management, with minimal manual intervention required.

TikTok Shop Order Processing Flow

5. Inventory Management

5.1. Manual Inventory Synchronization

  1. Open the TikTok Shop form
  2. Click the Sync Inventory button
  3. Odoo will update inventory to TikTok Shop
Synchronize TikTok Shop Inventory

5.2. Automatic Inventory Synchronization

The module has pre-configured scheduled jobs to synchronize inventory every hour. You can adjust the frequency similar to order synchronization.

5.3. TikTok Warehouse in Odoo

When synchronizing, the module creates TikTok warehouses in Odoo to track inventory accurately:

  1. Go to Inventory -> Configuration -> Warehouses
  2. Find warehouses with names starting with "TikTok Shop"

6. Returns Management

6.1. View Return Requests

  1. Go to Sales -> Configuration -> TikTok Shop -> Returns
  2. You will see a list of return requests from TikTok Shop
  3. Each request will display: - Return ID - Related order - Return status - Return type - Return reason
TikTok Shop Return Requests

7. Financial Management

7.1. Automatic Customer Invoices

When a TikTok order changes to "COMPLETED" status, the module will automatically:

  1. Create a customer invoice
  2. Confirm the invoice
  3. Create payment

7.2. Vendor Bills for TikTok Fees

The module also automatically creates vendor bills for TikTok fees:

  1. Call TikTok financial API to get fee information
  2. Create vendor bill with "TikTok Platform" as the vendor
  3. Record TikTok commission fees
TikTok Shop Financial Management

7.3. View Financial Data

  1. Open a TikTok order
  2. Go to the "TikTok Shop Order" tab
  3. View the "Finance Data" section for details about TikTok fees

8. Troubleshooting

8.1. Authentication Errors

Issue: Cannot connect to TikTok Shop

Solution: - Check App Key and App Secret - Ensure Callback URL is correctly configured - Check app permissions

8.2. Order Synchronization Errors

Issue: Orders are not synchronized

Solution: - Check authentication token (may have expired) - Check error logs in Odoo - Ensure TikTok Shop is active

8.3. Inventory Synchronization Errors

Issue: Inventory is not updated to TikTok Shop

Solution: - Check inventory synchronization configuration - Ensure products have SKUs matching TikTok Shop - Check error logs in Odoo

9. Additional Support

For additional support:

  • Email: duongodooapps@gmail.com
  • Refer to TikTok Shop API documentation: https://partner.tiktokshop.com/docv2/page/6789f74c786253031518c225

10. Security Notes

  • Keep API credentials secure
  • Regularly review app permissions
  • Monitor API usage limits
  • Comply with TikTok Shop terms of service and content guidelines
Odoo Proprietary License v1.0

This software and associated files (the "Software") may only be used (executed,
modified, executed after modifications) if you have purchased a valid license
from the authors, typically via Odoo Apps, or if you have received a written
agreement from the authors of the Software (see the COPYRIGHT file).

You may develop Odoo modules that use the Software as a library (typically
by depending on it, importing it and using its resources), but without copying
any source code or material from the Software. You may distribute those
modules under the license of your choice, provided that this license is
compatible with the terms of the Odoo Proprietary License (For example:
LGPL, MIT, or proprietary licenses similar to this one).

It is forbidden to publish, distribute, sublicense, or sell copies of the Software
or modified copies of the Software.

The above copyright notice and this permission notice must be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author or have a question related to your purchase, please use the support page.
There are no ratings yet!
do you have 14 version?
by
adi bagus malik
on 3/17/25, 2:12 AM

do you have 14 version?

Re: do you have 14 version?
by
Dương Nguyễn
on 3/17/25, 3:08 AM Author

Currently i don't but you can give me what do you want for version 14 and i will do that
For example do you need all of the feature like in version 17, 18 or you just need to sync order bla bla
Feel free to contact my email for further information