Skip to Content
Menu

Tiktok Shop Connector

by
Odoo

68.40

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 4997
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 4997
Technical Name d_tiktok_shop_connector
LicenseOPL-1
Websitehttps://duong-odoo-apps.odoo.com
Versions 17.0 18.0

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, fulfillment by seller (request pickup package and print shipping label) and manage returns all from your Odoo system, eliminating the need to switch between platforms.

Product Management

Complete product lifecycle management on TikTok Shop:

  • Create new products on TikTok directly from Odoo
  • Update product information and sync changes automatically
  • Monitor product audit status with real-time notifications
  • Delete products from TikTok when needed
  • Automatic product deletion when removed from Odoo

The product management system gives you full control over your TikTok product catalog while ensuring data consistency between Odoo and TikTok Shop.

TikTok Shop Product Management TikTok Shop Product Management

Product Audit & Status Tracking

Efficiently manage the TikTok product approval process:

  • Real-time tracking of product audit status
  • Immediate notifications for rejected products with detailed reasons
  • Easy product updates to address audit rejections
  • Manual and automatic status checking
  • Smart filtering and search for products by status

Never lose track of your products in the TikTok audit process, and quickly respond to any approval issues.

TikTok Shop Product Audit

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

Package Arrangement & Shipping Documents

Effortlessly manage shipping packages, arrange shipment and download documents from TikTok Shop:

  • Arrange shipment for delivery orders either for a pickup or drop off shipment
  • Download shipping documents in various formats
  • Support for multiple document types including:
    • Shipping Labels (PDF or PNG formats)
    • Packing Slips
    • Combined Shipping Labels & Packing Slips
    • Hazmat Labels for dangerous goods
    • Invoice Labels (for Brazil market)
    • Customs Declaration documents
    • Physical Labels and Shipping Label Indication Slips
  • Choose document sizes (A4, A5, A6, 4x6 inches) and formats (PDF/PNG)
  • Automatically update tracking numbers in Odoo from TikTok

The package management system streamlines your shipping workflow and ensures all required documentation is easily accessible for your TikTok Shop orders.

TikTok Shop Arrange Shipment TikTok Shop Shipping Documents

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 DELIVERED or COMPLETED, 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

4.5. Arrange Shipment & Print Shipping Documents

After packing the order and preparing for delivery, you need to notify TikTok Shop to arrange transportation:

  1. Arrange Shipment:
    • Go to Inventory -> Operations -> Transfers or the Delivery Smart Button of tiktok order
    • Locate the delivery order related to the TikTok Shop order
    • Click the Arrange Shipment button
    • In the wizard that appears, you have two delivery method options: - Pickup: The carrier will come to your warehouse to pick up the goods. This is a common choice for large order volumes. - Drop Off: You will bring the package to the carrier’s drop-off point. Suitable for smaller order quantities.
    • After confirmation, the order status on TikTok Shop will change to Awaiting Collection, indicating that the carrier has been notified and will pick up the goods according to the scheduled time.
TikTok Odoo Arrange Shipment
  1. Download Shipping Documents:

    • After arranging the shipment, you need to print the shipping documents

    • In the delivery screen, click the Download TikTok Shipping Document button

    • In the wizard that appears, you can configure: - Document Type:

      • SHIPPING_LABEL: Shipping label in PDF format (default)
      • PACKING_SLIP: Packing slip in PDF format
      • SHIPPING_LABEL_AND_PACKING_SLIP: Both shipping label and packing slip
      • SHIPPING_LABEL_PICTURE: Shipping label in PNG image format
      • HAZMAT_LABEL: Hazardous material label (applicable only for packages containing hazardous materials)
      • INVOICE_LABEL: Invoice label (applicable only for the Brazil market)
      • SHIPPING_LABEL_INDICATION_SLIP: Shipping label indication slip
      • CUSTOMS_DECLARATION: Customs declaration
      • PHYSICAL_LABEL: Physical label
      • Document Size: A4, A5, A6 (default), or 4x6 inches
      • Document Format: PDF (default) or ZPL (only for the Brazil market)
    • Click Download Document to download the shipping documents

    • The system will automatically update the tracking number from TikTok Shop if available

TikTok Downloadn Shipping Document

Note: The shipping label must be printed and attached to the package before handing it over to the carrier. This ensures a smooth tracking and delivery process.

After the carrier picks up the package, the package status will automatically update to "FULFILLING" (In transit) on the TikTok Shop system and will sync to Odoo during the next order synchronization.

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. Product Management

6.1. Product Creation and Management

The module provides comprehensive tools for managing your products on TikTok Shop, including:

  1. Automatic Product Creation: When you assign a TikTok Shop to a product in Odoo, the system will automatically mark it for creation on TikTok. This happens through a scheduled job that runs every 15 minutes.
  2. Manual Product Creation: You can manually trigger product creation by clicking the Create on TikTok button on the product form.
  3. Product Updates: Any changes to product information (name, description, price, etc.) are automatically detected and scheduled for synchronization with TikTok Shop.
  4. Product Deletion: You can delete products from TikTok by clicking the Delete from TikTok button or by deleting the product in Odoo, which will automatically remove it from TikTok as well.
TikTok Shop Product Management Buttons TikTok Shop Product Management Buttons

6.2. Product Audit Process

All products on TikTok Shop go through an audit process:

  1. Audit Status Tracking: After creating a product on TikTok, it enters the audit process. The audit status is automatically tracked and updated in Odoo.
  2. Audit Notifications: The system displays notifications on the product form showing the current audit status: - Under Review: The product is being reviewed by TikTok - Approved: The product has passed audit and can be activated - Failed: The product failed audit with detailed reasons
  3. Automatic Status Updates: A scheduled job runs every 5 minutes to check the audit status of products under review, updating their status in Odoo.
  4. Manual Status Check: You can manually check the audit status by clicking the Check Audit Status button on the product form.
TikTok Shop Product Audit Status

6.3. Product Synchronization Flow

The product synchronization follows this workflow:

  1. Assign TikTok Shop: Select a TikTok Shop on the product form
  2. Auto-Creation: The system marks the product for creation on TikTok
  3. Audit Process: Product enters TikTok's audit queue
  4. Status Updates: Audit status is automatically checked and updated
  5. Automatic Updates: Any changes to the product in Odoo are synchronized to TikTok including inventory update

This automated system ensures that your product catalog stays in sync between Odoo and TikTok Shop with minimal manual intervention.

7. Returns Management

7.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

8. Financial Management

8.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

8.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

8.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

9. Troubleshooting

9.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

9.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

9.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.4. Product Audit Errors

Issue: Products fail TikTok audit

Solution: - Review the audit failure reasons displayed on the product form - Make necessary corrections to comply with TikTok's requirements - Update the product and resubmit for audit - Ensure your brand is authorized if required

10. Additional Support

For additional support:

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

11. 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