Tích hợp Odoo với TikTok Shop: Đồng bộ gì, giới hạn nào?
Giải thích tích hợp Odoo với TikTok Shop: dữ liệu đồng bộ, tần suất, cách thiết lập, giới hạn và lựa chọn cho Odoo Community.
Long Nguyen
Lập trình viên Fullstack · Kỹ sư AI · Nhà nghiên cứu
Odoo có tích hợp với TikTok Shop không?
Có. Odoo cung cấp TikTok Shop Connector tích hợp sẵn. Công cụ này đưa các đơn hàng TikTok Shop do người bán tự xử lý vào Odoo dưới dạng đơn bán hàng, đẩy số lượng tồn kho khả dụng từ Odoo lên TikTok Shop, đồng thời gắn nhãn vận chuyển và mã theo dõi vào các phiếu giao hàng tương ứng.
Ba yếu tố sau quyết định connector có phù hợp với cửa hàng của bạn hay không:
- Phiên bản: Odoo công bố connector cho phiên bản 19.0 và các bản phát hành sau đó. Tài liệu Odoo 18 không có trang hướng dẫn TikTok Shop.
- Phiên bản sản phẩm: connector không nằm trong mã nguồn Community mở. Nhánh 19.0 của kho mã công khai Odoo không có module TikTok (kiểm tra vào ), vì vậy bạn cần dự trù sử dụng Odoo Enterprise.
- Phạm vi: đây là công cụ đồng bộ đơn hàng và tồn kho, không phải hệ thống quản trị TikTok Shop hoàn chỉnh. Refund, tranh chấp và báo cáo phí vẫn được xử lý trên TikTok.
Phần còn lại của hướng dẫn sẽ trình bày dữ liệu nào được đồng bộ và tần suất ra sao, các bước thiết lập, những giới hạn dễ bị bỏ sót, cũng như lựa chọn dành cho Odoo Community hoặc các phiên bản cũ hơn.
Odoo TikTok Shop Connector đồng bộ gì và bao lâu một lần?
Quá trình đồng bộ không diễn ra theo thời gian thực. Odoo chạy từng loại dữ liệu theo lịch riêng:
| Dữ liệu | Chiều đồng bộ | Tần suất | Cách thức hoạt động |
|---|---|---|---|
| Đơn hàng (người bán tự xử lý) | TikTok Shop → Odoo | Mỗi 5 phút | Chỉ lấy các đơn ở trạng thái AWAITING_SHIPMENT hoặc AWAITING_COLLECTION. Odoo tạo đơn bán hàng, phiếu lấy hàng trong Inventory và một liên hệ nếu chưa có liên hệ tương ứng. |
| Thay đổi trạng thái đơn hàng (webhook) | TikTok Shop → Odoo | Xử lý mỗi 5 phút | Khi đơn hàng bị hủy trên TikTok Shop, trạng thái đơn trong Odoo cũng được cập nhật. |
| Nhãn vận chuyển và mã theo dõi | TikTok Shop → Odoo | Mỗi 15 phút | Được lấy khi đơn chuyển sang trạng thái Awaiting Collection và gắn vào phiếu giao hàng. Nếu không thể tạo tệp PDF, Odoo sẽ lưu liên kết đến nhãn. |
| Số lượng tồn kho | Odoo → TikTok Shop | Mỗi 30 phút | Chỉ thực hiện khi đã bật đồng bộ tồn kho trên cửa hàng và chỉ lấy dữ liệu từ các kho được thiết lập trong trường FBS Warehouse. |
| Danh mục sản phẩm | TikTok Shop → Odoo | Theo yêu cầu (Sync Catalog) | Lấy các sản phẩm đang hoạt động trên TikTok Shop và đối chiếu với sản phẩm trong Odoo theo SKU. |
Đơn hàng, nhãn vận chuyển, tồn kho và danh mục sản phẩm cũng có thể được đồng bộ thủ công bằng các nút tương ứng trên bản ghi cửa hàng. Các khoảng thời gian này được nêu trong tài liệu quản lý đơn hàng TikTok Shop của Odoo.
Có hai điểm dễ gây hiểu nhầm trong tài liệu chính thức:
- FBS và FBM có cùng ý nghĩa trong trường hợp này. Một trang dùng cụm Fulfilled By Seller, trang khác dùng Fulfilled By Merchant. Cả hai đều có nghĩa là bạn tự vận chuyển kiện hàng.
- Partner Center là cổng dành cho nhà phát triển. Bạn tạo ứng dụng API tại đây. Các công việc bán hàng hằng ngày như sắp xếp giao hàng hoặc chỉnh sửa hàng loạt sản phẩm diễn ra trong Seller Center, tức các trang seller-xx.tiktok.com được tài liệu liệt kê theo từng quốc gia.
Odoo hỗ trợ những thị trường TikTok Shop nào?
Odoo liệt kê 16 marketplace TikTok Shop được connector hỗ trợ:
| Khu vực | Marketplace |
|---|---|
| Châu Mỹ | Hoa Kỳ, Mexico, Brazil |
| Châu Âu | Vương quốc Anh, Đức, Pháp, Tây Ban Nha, Ý, Ireland |
| Châu Á | Indonesia, Nhật Bản, Malaysia, Philippines, Singapore, Thái Lan, Việt Nam |
Connector hỗ trợ nhiều tài khoản người bán, với mỗi tài khoản chỉ gắn với một marketplace. Vì vậy, nếu thương hiệu của bạn bán hàng tại Đức, Pháp và Tây Ban Nha, bạn cần tạo ba bản ghi cửa hàng trong Odoo, mỗi bản ghi có quy tắc kho và đội ngũ bán hàng riêng.
Cách kết nối TikTok Shop với Odoo
Bạn cần có tài khoản TikTok Shop Seller, một tài khoản TikTok Shop Partner Center riêng, mô tả ngắn về mục đích tích hợp, cùng URL cơ sở dữ liệu Odoo và tài khoản tester để đăng nhập.
- Đăng ký trên Partner Center. Chọn Add category and market, chọn App developers (ISV) ở mục ngành nghề kinh doanh, điền khu vực và thị trường mục tiêu, sau đó nhấp Get app key now và chờ phê duyệt.
- Tạo ứng dụng. Trong App & Service, đặt loại ứng dụng là Custom và danh mục dịch vụ là eCommerce Management / Connectors. Bật Enable API.
- Thiết lập URL chuyển hướng thành
https://<your database url>.odoo.com/tiktok/return_from_authorization. - Bật tám API scope trong Manage API: Finance Information, Fulfillment Basic, Logistics Basic, Order Information, Product Basic, Product Modify, Shop Authorized Information, Global Shop Information.
- Phát hành ứng dụng rồi sao chép Service ID, App key và App secret.
- Cài connector trong Odoo. Trong Apps, tìm TikTok Shop Connector và kích hoạt.
- Kết nối cửa hàng. Vào Sales → Configuration → Shops, nhấp Connect New Shop và nhập ba thông tin xác thực. Đăng nhập bằng tài khoản người bán mà bạn muốn liên kết.
- Ủy quyền lại. Quay lại Odoo, nhấp Re-authorize Shop để lấy refresh token mới.
- Cấu hình trước khi vận hành chính thức. Thiết lập FBS Warehouse, chạy Sync Catalog, sau đó mới bật đồng bộ tồn kho.
Tên trường và ảnh chụp màn hình được trình bày trong hướng dẫn cấu hình TikTok Shop Connector của Odoo.
Những điểm cần lên kế hoạch khi thiết lập
- Quá trình phê duyệt cần thời gian. Hồ sơ đăng ký Partner sẽ được xem xét, và tài khoản mới có thể phải gửi ứng dụng để duyệt trước khi API hoạt động. Hãy bắt đầu bước này sớm, không nên chờ đến tuần ra mắt.
- Đăng nhập đúng tài khoản người bán. Việc ủy quyền sẽ liên kết cửa hàng mà bạn đang đăng nhập. Agency và người bán nhiều cửa hàng nên sử dụng một phiên trình duyệt sạch.
- Bật đồng bộ tồn kho sau cùng. Tồn kho được truyền từ Odoo sang TikTok Shop. Nếu số lượng tồn thực tế trong Odoo không chính xác hoặc vẫn bằng 0 khi bạn bật tính năng, TikTok Shop sẽ nhận chính những số liệu đó.
Đối chiếu SKU: quy tắc giúp tồn kho chính xác
Seller SKU trên TikTok Shop phải trùng khớp tuyệt đối với Internal Reference của sản phẩm hoặc biến thể trong Odoo. Chỉ cần thừa một dấu cách ở cuối hoặc khác kiểu chữ hoa, chữ thường cũng bị xem là không khớp.
Lỗi này thường không hiển thị rõ ràng. Khi không tìm thấy sản phẩm, Odoo sẽ ghi nhận dòng đơn hàng vào một sản phẩm mặc định. Đơn hàng vẫn xuất hiện nên bạn có thể không nhận ra vấn đề, nhưng tồn kho của sản phẩm thực tế không được trừ; lần đẩy tồn kho tiếp theo có thể gửi lên TikTok Shop số lượng cao hơn thực tế.
Hãy kiểm tra mã tham chiếu trước lần đồng bộ đầu tiên. Trên cơ sở dữ liệu self-hosted hoặc Odoo.sh, chạy đoạn lệnh sau trong Odoo shell:
from collections import Counter
products = env['product.product'].search([('sale_ok', '=', True)])
refs = products.mapped('default_code')
missing = [p.display_name for p in products if not p.default_code]
duplicates = [r for r, n in Counter(r for r in refs if r).items() if n > 1]
padded = [r for r in refs if r and r != r.strip()]
print('No Internal Reference:', len(missing))
print('Duplicate references:', duplicates)
print('References with stray spaces:', padded)
Trên Odoo Online, hãy nhóm danh sách biến thể sản phẩm theo Internal Reference để có kết quả tương tự. Cả ba danh sách đều phải trống đối với những sản phẩm bạn bán trên TikTok Shop.
Cách bắt đầu sẽ tùy thuộc vào nơi lưu danh mục sản phẩm:
- Sản phẩm đã có trong Odoo: chạy Sync Catalog để đối chiếu các listing TikTok Shop đang hoạt động với sản phẩm tương ứng.
- Sản phẩm chỉ có trên TikTok Shop: xuất danh mục bằng tính năng chỉnh sửa hàng loạt ở phía TikTok, nhập vào Odoo, rồi ánh xạ TikTok Shop Item ID với external ID của sản phẩm.
Giới hạn của Odoo TikTok Shop Connector
Mỗi giới hạn dưới đây đều dựa trên tài liệu của Odoo. Cột giải pháp là khuyến nghị của chúng tôi.
| Giới hạn | Ý nghĩa đối với bạn | Giải pháp |
|---|---|---|
| Tồn kho được đẩy lên mỗi 30 phút | Trong một buổi livestream hoặc đợt flash sale, TikTok Shop có thể bán những sản phẩm mà Odoo đã cam kết cho kênh khác. | Giữ một lượng tồn dự phòng trong kho không được chọn ở FBS Warehouse, để TikTok Shop không bao giờ nhìn thấy những sản phẩm cuối cùng. |
| Chỉ nhập các đơn đang chờ giao hoặc chờ lấy hàng | Các đơn ở trạng thái UNPAID, SHIPPED, CANCEL và COMPLETED sẽ bị bỏ qua. Lịch sử đơn hàng trước thời điểm kết nối cũng không được đưa vào. |
Xem thời điểm vận hành chính thức là ngày bắt đầu ghi nhận báo cáo. Nếu cần, hãy nhập riêng các giao dịch cũ vào Odoo. |
| Chỉ hỗ trợ đơn do người bán tự xử lý | Tài liệu chỉ mô tả đơn FBS và tồn kho. Các đơn do TikTok xử lý không được liệt kê là dữ liệu được đồng bộ. | Hãy xác nhận bằng một đơn thử nghiệm trước khi phụ thuộc vào Odoo để ghi nhận doanh thu FBT. |
| Hủy đơn chỉ đồng bộ một chiều | Hủy trong Odoo không làm đơn hàng trên TikTok Shop bị hủy. | Luôn hủy trên TikTok Shop rồi để trạng thái được truyền ngược về Odoo. |
| Không xử lý refund, tranh chấp và báo cáo phí | Các nội dung này vẫn nằm trên những cổng quản trị riêng của TikTok. | Ghi nhận refund trong Odoo dưới dạng credit note thủ công hoặc tự động hóa bằng module tùy chỉnh. |
| Không thể gửi hóa đơn qua email | TikTok Shop không chia sẻ email của người mua, nên Odoo không thể gửi hóa đơn. | Tạo hóa đơn trong Odoo rồi tải lên phía TikTok khi người mua yêu cầu. |
| Khoản thanh toán được trả theo từng đợt | Một giao dịch ngân hàng có thể bao gồm nhiều đơn hàng. | Sử dụng một sổ nhật ký ngân hàng riêng cùng tài khoản tạm giữ và đối soát theo từng đợt thanh toán. |
| Bắt buộc phải có mã theo dõi | TikTok Shop yêu cầu mọi đơn giao hàng phải có mã theo dõi. | Nếu đơn vị vận chuyển không trả về mã, hãy nhập thủ công ở phía TikTok. |
Còn một điểm thiếu cần lưu ý: tài liệu chỉ đề cập việc nhập danh mục từ TikTok Shop và ánh xạ danh mục đó, chứ không đề cập việc đăng hoặc chỉnh sửa listing từ Odoo. Để đưa sản phẩm từ Odoo lên TikTok Shop, tài liệu hướng dẫn sử dụng tính năng tải lên hàng loạt trong Seller Center. Tiêu đề, hình ảnh và giá vẫn được quản lý trên TikTok.
Tích hợp TikTok Shop cho Odoo Community, 17 hoặc 18
Nếu bạn chưa sử dụng Odoo 19 Enterprise hoặc phiên bản mới hơn, connector tích hợp sẵn không khả dụng. Bạn có bốn lựa chọn:
| Lựa chọn | Phù hợp khi | Chi phí chính |
|---|---|---|
| Nâng cấp lên Odoo 19+ Enterprise | Phạm vi của connector tích hợp sẵn đáp ứng nhu cầu và bạn vốn đã có kế hoạch nâng cấp. | Chi phí bản quyền Enterprise, cộng với việc di chuyển toàn bộ module tùy chỉnh đang sử dụng. |
| Module bên thứ ba từ Odoo Apps Store | Bạn tiếp tục dùng Community hoặc phiên bản cũ hơn và module hỗ trợ thị trường của mình. | Giá module và sự phụ thuộc vào một nhà cung cấp trong việc cập nhật theo thay đổi API của TikTok. |
| Module Odoo tùy chỉnh trên TikTok Shop API | Bạn cần những tính năng mà các lựa chọn đóng gói không có: refund, dòng thanh toán, đơn FBT, cập nhật tồn kho nhanh hơn hoặc quản lý listing. | Chi phí phát triển và bảo trì. |
| Công cụ đa kênh làm lớp trung gian | Bạn cũng bán hàng trên Amazon, eBay hoặc Shopify và muốn quản lý listing tại một nơi. | Phí thuê bao hằng tháng và thêm một hệ thống cần duy trì đồng bộ. |
Trước khi cài đặt bất kỳ connector bên thứ ba nào, hãy kiểm tra năm điểm sau:
- Giấy phép. Module trả phí thường được bán theo Odoo Proprietary License (OPL-1). Hãy xác nhận bạn được phép chỉnh sửa mã và triển khai trên mọi cơ sở dữ liệu cần dùng.
- Thông tin xác thực được lưu ở đâu. App secret và token nên nằm trong cơ sở dữ liệu của bạn. Nếu module chuyển các API call qua máy chủ của nhà cung cấp, nhà cung cấp đó sẽ có quyền truy cập vào cửa hàng.
- Mã nguồn có thể đọc được. Bạn hoặc nhà phát triển thuê ngoài phải có khả năng kiểm tra và vá lỗi cho module.
- Thị trường và phiên bản Odoo. Hãy xác nhận chính xác quốc gia và phiên bản Odoo của bạn được hỗ trợ, thay vì chỉ kiểm tra chung chung rằng module hỗ trợ TikTok Shop.
- Lịch sử bảo trì. Xem ngày cập nhật gần nhất. Một integration không được duy trì sẽ ngừng hoạt động khi TikTok thay đổi API.
Module tùy chỉnh sử dụng những thành phần nền tảng giống thiết lập tích hợp sẵn: một ứng dụng Custom trong Partner Center, các scope bạn bật và quy trình ủy quyền người bán. Điểm khác biệt là bạn quyết định dữ liệu nào được đồng bộ và thời điểm đồng bộ. Netalith cung cấp loại connector này trong dịch vụ phát triển Odoo và module tùy chỉnh, cho cả Community và Enterprise.
Connector tích hợp sẵn có đủ cho cửa hàng của bạn không?
| Tình huống của bạn | Đánh giá |
|---|---|
| Odoo 19+ Enterprise, một hoặc hai thị trường, bạn giao hàng từ kho của mình | Dùng connector tích hợp sẵn. Công cụ này đáp ứng vòng lặp vận hành hằng ngày về đơn hàng và tồn kho. |
| Bạn bán hàng livestream hoặc giữ tồn kho thấp cho từng SKU | Giải pháp tích hợp sẵn vẫn phù hợp nếu bạn giữ tồn kho dự phòng ngoài FBS warehouse. Nếu không, bạn cần cập nhật tồn kho nhanh hơn. |
| Bạn phụ thuộc vào dịch vụ Fulfilled by TikTok | Hãy thử nghiệm trước. Phạm vi được tài liệu mô tả là các đơn do người bán tự xử lý. |
| Bộ phận tài chính muốn ghi nhận phí, refund và khoản thanh toán theo từng đơn | Connector tích hợp sẵn chưa đủ. Bạn cần phát triển tùy chỉnh cho dữ liệu tài chính. |
| Odoo Community, phiên bản 17 hoặc 18 | Không thể dùng connector tích hợp sẵn. Hãy chọn module bên thứ ba đã được kiểm chứng hoặc phát triển module tùy chỉnh. |
| Thị trường TikTok Shop của bạn không nằm trong 16 thị trường được liệt kê | Connector tích hợp sẵn không khả dụng cho cửa hàng đó. |
Trình tự triển khai thực tế nên là: làm sạch Internal Reference, bắt đầu đăng ký Partner Center từ sớm, kết nối một cửa hàng, đồng bộ danh mục, kiểm tra số sản phẩm không đối chiếu được bằng 0, rồi mới bật đồng bộ tồn kho.
Nếu những khoảng trống trên là các tính năng bạn cần, hoặc bạn đang dùng Community, hãy cho chúng tôi biết phiên bản Odoo, các thị trường TikTok Shop và số đơn hàng hằng tháng của bạn. Dịch vụ tích hợp TikTok Shop API của Netalith sẽ xác định phạm vi connector theo đúng nhu cầu thực tế của cửa hàng và báo giá theo phạm vi công việc.
CÂU HỎI THƯỜNG GẶP
Câu hỏi thường gặp
Odoo có tích hợp TikTok Shop sẵn không?
Có. Odoo có tài liệu về TikTok Shop Connector tích hợp sẵn cho Odoo 19.0 và các phiên bản sau đó. Connector nhập đơn hàng do người bán tự xử lý vào Odoo, đẩy tồn kho khả dụng lên TikTok Shop, lấy nhãn vận chuyển và mã theo dõi, đồng thời đồng bộ hoặc đối chiếu danh mục sản phẩm.
TikTok Shop Connector có dùng được trên Odoo Community không?
Không. Mã nguồn Community mở của Odoo 19 không có module TikTok, nên connector tích hợp sẵn yêu cầu Odoo Enterprise. Trên Community, bạn cần dùng module bên thứ ba từ Odoo Apps Store hoặc module tùy chỉnh xây dựng trên TikTok Shop API.
Odoo đồng bộ với TikTok Shop bao lâu một lần?
Đơn hàng và webhook trạng thái đơn được xử lý mỗi 5 phút, nhãn vận chuyển mỗi 15 phút và tồn kho mỗi 30 phút. Bạn cũng có thể kích hoạt thủ công từng quá trình từ bản ghi cửa hàng trong Sales, Configuration, Shops.
Connector Odoo hỗ trợ những quốc gia TikTok Shop nào?
Odoo liệt kê 16 marketplace: Hoa Kỳ, Mexico và Brazil; Vương quốc Anh, Đức, Pháp, Tây Ban Nha, Ý và Ireland; cùng Indonesia, Nhật Bản, Malaysia, Philippines, Singapore, Thái Lan và Việt Nam.
Tôi có thể kết nối nhiều TikTok Shop vào một cơ sở dữ liệu Odoo không?
Có. Connector hỗ trợ nhiều tài khoản người bán, với mỗi tài khoản gắn với một marketplace TikTok Shop. Mỗi cửa hàng có một bản ghi riêng trong Odoo, nơi bạn có thể thiết lập kho và chỉ định đội ngũ bán hàng riêng để báo cáo tách biệt.
Odoo có xử lý refund và trả hàng trên TikTok Shop không?
Không. Odoo nêu rõ rằng việc phát hành refund, xử lý tranh chấp và tải báo cáo phí hằng tháng phải thực hiện ở phía TikTok. Connector chỉ giới hạn ở đơn bán hàng và tồn kho, vì vậy refund phải được ghi nhận thủ công trong Odoo hoặc xử lý thông qua phát triển tùy chỉnh.
Tôi có cần tài khoản nhà phát triển để kết nối TikTok Shop với Odoo không?
Có. Bạn cần một tài khoản TikTok Shop Partner Center riêng với tài khoản Seller. Tại đó, bạn tạo ứng dụng Custom, bật các API scope cần thiết, sau đó nhập Service ID, App key và App secret vào Odoo.