Availability |
Odoo Online
Odoo.sh
On Premise
|
Odoo Apps Dependencies |
•
Invoicing (account)
• Discuss (mail) • Inventory (stock) |
Community Apps Dependencies | Show |
Lines of code | 4997 |
Technical Name |
d_tiktok_shop_connector |
License | OPL-1 |
Website | https://duong-odoo-apps.odoo.com |
Versions | 17.0 18.0 |
Availability |
Odoo Online
Odoo.sh
On Premise
|
Odoo Apps Dependencies |
•
Invoicing (account)
• Discuss (mail) • Inventory (stock) |
Community Apps Dependencies | Show |
Lines of code | 4997 |
Technical Name |
d_tiktok_shop_connector |
License | OPL-1 |
Website | https://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.


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.

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.

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.

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.

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.


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.

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.

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

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:
- Go to https://partner.tiktokshop.com , create new account if you do not have one

- You will enter home screen like this -> hit button Add category and market

- Choosing Bussiness guide, i suggest For app developer to easily configuration

- After that fill in the information in this form

- For bussiness category, choose Tiktok shop parter and App Developer

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


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

2.3. Configure in Odoo
- Install the d_tiktok_shop_connector module
- Go to Sales -> Configuration -> Settings
- 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

- Click Connect TikTok Shop to authenticate

2.4. Connect Seller Account
After authentication, you will be redirected to the TikTok Shop authentication page:
- Log in to your TikTok Shop account
- Select the correct market of your tiktok shop, ex: you are selling in Vietnam you should select Vietnam
- Grant permissions to the app
- After successful authentication, you will be redirected back to Odoo
- Seller account and shops will be automatically synchronized


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

3.2. Configure Shop
Open the shop form to configure:
- Sync Inventory: Enable/disable inventory synchronization, this option will help you sync all product with variant and inventory (quantity) from tiktok shop to odoo
- Sales Team: Choose default sales team
- Salesperson: Choose default salesperson
- 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.
- 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.

4. Order Synchronization
4.1. Manual Synchronization
- Open the TikTok Shop form
- Click the Sync Orders button
- 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:
- Go to Settings -> Technical -> Automation -> Scheduled Actions
- Find the job start with TikTok
- Adjust the frequency as needed
4.3. View TikTok Orders
- Go to Sales -> Orders
- Use the "TikTok Orders" filter to view orders from TikTok Shop
- Each order will display: - TikTok Order ID - TikTok Status - TikTok Shop

4.4. Order Processing Flow
When an order is synchronized from TikTok Shop to Odoo, the following automated workflow takes place:
- 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
- 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
- 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
- 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
- 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:
- 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.

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

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
- Open the TikTok Shop form
- Click the Sync Inventory button
- Odoo will update inventory to TikTok Shop

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:
- Go to Inventory -> Configuration -> Warehouses
- 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:
- 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.
- Manual Product Creation: You can manually trigger product creation by clicking the Create on TikTok button on the product form.
- Product Updates: Any changes to product information (name, description, price, etc.) are automatically detected and scheduled for synchronization with TikTok Shop.
- 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.


6.2. Product Audit Process
All products on TikTok Shop go through an audit process:
- Audit Status Tracking: After creating a product on TikTok, it enters the audit process. The audit status is automatically tracked and updated in Odoo.
- 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
- Automatic Status Updates: A scheduled job runs every 5 minutes to check the audit status of products under review, updating their status in Odoo.
- Manual Status Check: You can manually check the audit status by clicking the Check Audit Status button on the product form.

6.3. Product Synchronization Flow
The product synchronization follows this workflow:
- Assign TikTok Shop: Select a TikTok Shop on the product form
- Auto-Creation: The system marks the product for creation on TikTok
- Audit Process: Product enters TikTok's audit queue
- Status Updates: Audit status is automatically checked and updated
- 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
- Go to Sales -> Configuration -> TikTok Shop -> Returns
- You will see a list of return requests from TikTok Shop
- Each request will display: - Return ID - Related order - Return status - Return type - Return reason

8. Financial Management
8.1. Automatic Customer Invoices
When a TikTok order changes to "COMPLETED" status, the module will automatically:
- Create a customer invoice
- Confirm the invoice
- Create payment
8.2. Vendor Bills for TikTok Fees
The module also automatically creates vendor bills for TikTok fees:
- Call TikTok financial API to get fee information
- Create vendor bill with "TikTok Platform" as the vendor
- Record TikTok commission fees

8.3. View Financial Data
- Open a TikTok order
- Go to the "TikTok Shop Order" tab
- 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
Report comment
Any abuse of this reporting system will be penalizedThere are no ratings yet!
do you have 14 version?
do you have 14 version?
Re: do you have 14 version?
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