Store Platforms

Tích hợp Odoo WooCommerce: Dùng connector, API riêng hay chuyển đổi?

Giải thích cách tích hợp Odoo WooCommerce: giới hạn connector, gói Odoo hỗ trợ, đồng bộ qua API, ánh xạ dữ liệu và các lỗi thường gặp.

Ảnh đại diện Long Nguyen

Long Nguyen

Lập trình viên Fullstack · Kỹ sư AI · Nhà nghiên cứu

• • 5 phút đọc •

Odoo có connector WooCommerce tích hợp sẵn không?

Không. Tích hợp Odoo WooCommerce luôn dựa trên một giải pháp mà Odoo không cung cấp trực tiếp: module bên thứ ba, module tùy chỉnh hoặc dịch vụ đồng bộ bên ngoài. Tài liệu Sales của Odoo phiên bản 19 liệt kê các connector tích hợp sẵn cho Amazon, Shopee, Lazada và TikTok Shop. WooCommerce không nằm trong danh sách này.

Giải pháp bán hàng trực tuyến chính thức của Odoo là ứng dụng eCommerce, sử dụng chung một cơ sở dữ liệu với tồn kho và kế toán. Lựa chọn này được đề cập ở cuối bài, vì với một số cửa hàng, đây có thể là hướng đi phù hợp hơn.

Nếu vẫn muốn sử dụng WooCommerce, dự án sẽ phụ thuộc vào ba câu hỏi sau, theo đúng thứ tự:

  1. Gói Odoo và hình thức hosting của bạn có cho phép tích hợp hay không?
  2. Hướng triển khai nào phù hợp: connector có sẵn, đồng bộ tùy chỉnh hay công cụ no-code?
  3. Hệ thống nào sẽ là nơi quản lý dữ liệu chính?

Gói Odoo và hình thức hosting nào có thể tích hợp với WooCommerce?

Đây là bước mà nhiều hướng dẫn thường bỏ qua, dù nó có thể loại trừ nhiều lựa chọn trước khi bạn so sánh connector. Có hai giới hạn cần xét: code tùy chỉnh có thể chạy ở đâu và bên ngoài có được phép gọi Odoo API hay không.

Cấu hình Odoo Module bên thứ ba hoặc module tùy chỉnh API bên ngoài Khả năng triển khai thực tế
Odoo Online, One App Free hoặc Standard Không Không Chỉ có thể nhập và xuất CSV thủ công. Muốn tự động hóa, trước hết phải đổi gói hoặc hình thức hosting.
Odoo Online, gói Custom Không Có Sử dụng dịch vụ đồng bộ bên ngoài gọi cả hai API.
Odoo.sh hoặc on-premise, gói Custom Có Có Dùng connector, module tùy chỉnh hoặc dịch vụ đồng bộ bên ngoài.
Odoo Community, tự hosting Có Có Tương tự lựa chọn trên. Hãy kiểm tra module có hỗ trợ Community hay không.

Hai điểm quan trọng đằng sau bảng trên:

  • Quyền truy cập API phụ thuộc vào gói dịch vụ. Tài liệu Odoo External JSON-2 API nêu rõ quyền truy cập dữ liệu qua external API chỉ có ở các gói Custom, không có ở One App Free hoặc Standard.
  • Odoo Online không lưu trữ module tùy chỉnh. Trang giá của Odoo mô tả Odoo Online là dịch vụ hosting cho cơ sở dữ liệu không có module tùy chỉnh. Vì vậy, dù trả tiền cho gói nào, connector dạng module vẫn cần Odoo.sh hoặc máy chủ riêng.

Hạn chót XML-RPC cần hỏi mọi nhà cung cấp

Odoo 19 giới thiệu JSON-2 API và đánh dấu các endpoint XML-RPC và JSON-RPC cũ là deprecated. Tài liệu dự kiến loại bỏ chúng ở Odoo 22 (mùa thu năm 2028), và trên Odoo Online từ phiên bản 21.1 (mùa đông năm 2027).

Trên thực tế, điều này có nghĩa là mọi tích hợp gọi Odoo từ bên ngoài qua XML-RPC, chẳng hạn plugin cài ở phía WordPress, đều có thời hạn sử dụng hữu hạn. Các module chạy bên trong Odoo sử dụng trực tiếp ORM của Odoo nên không bị ảnh hưởng. Hãy hỏi rõ bạn đang mua giải pháp nào.

Ba cách kết nối WooCommerce với Odoo

  Connector dạng module trên Apps Store Module tùy chỉnh hoặc dịch vụ đồng bộ Nền tảng tự động hóa no-code
Nơi chạy Bên trong Odoo Bên trong Odoo hoặc dưới dạng dịch vụ riêng gọi cả hai API Đám mây bên thứ ba
Hoạt động với Odoo Online Không Chỉ dịch vụ đồng bộ, với gói Custom Chỉ gói Custom vì sử dụng external API
Phù hợp khi Danh mục tiêu chuẩn và quy trình xử lý đơn hàng thông thường Có trường tùy chỉnh, giá B2B, nhiều kho hoặc quy trình đơn hàng đặc thù Số lượng đơn thấp và chỉ có một hoặc hai luồng, chẳng hạn từ đơn mới đến báo giá bán hàng nháp
Rủi ro chính Chất lượng code không đồng đều và mỗi lần nâng cấp Odoo đều phụ thuộc vào nhà cung cấp Chi phí ban đầu cao hơn và bạn phải tự chịu trách nhiệm bảo trì Khả năng đối soát tồn kho, thử lại và ngăn đơn trùng sẽ yếu dần khi quy mô tăng
Chi phí ban đầu Thấp nhất Cao nhất Thấp

Odoo Apps Store có nhiều module bên thứ ba cho nhu cầu này, phần lớn được đặt tên khá trực tiếp là WooCommerce Connector. Hãy bắt đầu từ đây nếu quy trình của bạn ở mức tiêu chuẩn. Một connector đáp ứng được 90% luồng nghiệp vụ và chỉ cần tùy chỉnh nhỏ thường rẻ hơn xây dựng từ đầu.

Hãy chọn giải pháp tùy chỉnh khi connector có sẵn gần như phải viết lại toàn bộ, chẳng hạn khi bạn có quy tắc giá theo nhóm khách hàng, tồn kho phân bổ ở nhiều kho, sản phẩm bundle hoặc bước phê duyệt trước khi xác nhận đơn. Netalith cung cấp cả hai hướng: đánh giá hoặc mở rộng connector hiện có và xây dựng đồng bộ tùy chỉnh, trong dịch vụ phát triển và tích hợp Odoo.

Cách đánh giá connector Odoo WooCommerce trước khi mua

Có hàng chục listing dùng cùng một tên, vì vậy hãy so sánh theo tiêu chí thay vì chỉ nhìn vào danh sách tính năng. Những yếu tố sau thường dự báo các vấn đề phát sinh:

  • Phiên bản và edition. Module được phát hành theo từng phiên bản chính của Odoo. Hãy xác nhận module có bản cho đúng phiên bản bạn đang dùng, cũng như cho Community nếu đó là hệ thống của bạn.
  • Giấy phép. Module trả phí thường được cung cấp theo Odoo Proprietary License. Hãy đọc kỹ xem bạn có được sửa code hay không và một lần mua áp dụng cho bao nhiêu cơ sở dữ liệu.
  • Rủi ro chuỗi cung ứng. Module chạy bên trong ERP, có quyền truy cập cơ sở dữ liệu và lưu các khóa đọc, ghi cho cửa hàng. Hãy nhờ developer đọc code và cài thử trên bản staging trước.
  • Cơ chế đồng bộ. Thiết kế đáng tin cậy nên kết hợp webhook với cơ chế đối soát định kỳ. Chỉ dùng tác vụ định kỳ sẽ gây chậm; chỉ dùng webhook có thể tạo ra các khoảng trống không được phát hiện.
  • Phạm vi dữ liệu. Hãy kiểm tra sản phẩm biến thể, hoàn tiền, ánh xạ thuế, dòng phí vận chuyển, coupon và nhiều cửa hàng có phù hợp với dữ liệu thực tế bạn sử dụng hay không.
  • Phụ thuộc máy chủ. Một số connector cần cài thêm package Python trên máy chủ Odoo. Đây là dấu hiệu cho thấy chúng không thể chạy trên Odoo Online.
  • Chính sách nâng cấp. Hỏi xem bản Odoo tiếp theo có được bao gồm trong giá hay không và thông thường nhà cung cấp phát hành bản tương thích sau bao lâu.
  • Log và cơ chế thử lại. Bạn cần log lỗi theo từng bản ghi và khả năng chạy lại một đơn thất bại mà không phải nhập lại toàn bộ dữ liệu.

Nên đồng bộ dữ liệu nào giữa Odoo và WooCommerce, theo hướng nào?

Quy tắc giúp ngăn phần lớn lỗi đồng bộ: mỗi trường dữ liệu chỉ có đúng một hệ thống sở hữu. Đồng bộ hai chiều cùng một trường sẽ tạo vòng lặp và ghi đè dữ liệu. Đồng bộ hai chiều với các trường khác nhau thì hoàn toàn có thể thực hiện.

Dữ liệu Hệ thống thường sở hữu Hướng đồng bộ Kích hoạt
Mức tồn kho Odoo Odoo sang WooCommerce Khi phát sinh biến động kho, cộng thêm một lần đẩy toàn bộ theo lịch
Đơn hàng WooCommerce WooCommerce sang Odoo Webhook khi tạo đơn, cộng thêm polling đối soát
Khách hàng WooCommerce WooCommerce sang Odoo Tạo cùng đơn hàng, đối chiếu bằng email
Trạng thái xử lý và mã vận đơn Odoo Odoo sang WooCommerce Khi giao hàng được xác nhận
Nội dung sản phẩm, hình ảnh, danh mục Tùy chọn một hệ thống Một chiều từ hệ thống sở hữu Khi có thay đổi
Giá Tùy chọn một hệ thống Một chiều từ hệ thống sở hữu Khi có thay đổi
Hoàn tiền WooCommerce WooCommerce sang Odoo dưới dạng credit note Khi hoàn tiền

Nội dung sản phẩm là quyết định quan trọng nhất. Chọn Odoo làm hệ thống sở hữu nếu bạn cũng bán hàng qua điểm bán hoặc các marketplace. Giữ WooCommerce làm hệ thống sở hữu nếu đội marketing viết trang sản phẩm trong WordPress. Mã vận đơn cần thêm một lựa chọn, vì WooCommerce core không có trường tracking trên đơn hàng: ghi vào ghi chú đơn hàng, metadata của đơn hàng hoặc plugin theo dõi giao hàng.

Ánh xạ trạng thái đơn hàng

WooCommerce REST API sử dụng bảy trạng thái đơn hàng. Hãy quyết định hành động tương ứng trong Odoo trước khi viết bất kỳ dòng code nào.

Trạng thái WooCommerce Hành động Odoo đề xuất
pending Không nhập. Khoản thanh toán chưa đến.
on-hold Nhập dưới dạng báo giá hoặc chờ xử lý. Thường dùng khi thanh toán chuyển khoản ngân hàng.
processing Nhập và xác nhận đơn bán hàng. Đây là điểm bắt đầu chính.
completed Để Odoo thiết lập sau khi giao hàng, không nhập như một đơn mới.
cancelled Hủy đơn bán hàng nếu đơn chưa được giao.
refunded Tạo credit note và tạo phiếu trả hàng nếu hàng được gửi trả.
failed Bỏ qua.

Đồng bộ API giữa Odoo và WooCommerce hoạt động như thế nào?

Kiến trúc tích hợp Odoo WooCommerce: đơn hàng và khách hàng đi từ cửa hàng WooCommerce qua lớp đồng bộ vào Odoo bằng webhook; tồn kho và mã vận đơn được gửi ngược lại, còn polling đối soát theo lịch sẽ xử lý các sự kiện bị bỏ sót

Phía WooCommerce

WooCommerce cung cấp dữ liệu tại /wp-json/wc/v3/. Các chi tiết định hình một hệ thống tích hợp, theo tài liệu WooCommerce REST API, gồm:

  • Key. Consumer key và secret được tạo trong WooCommerce > Settings > Advanced > REST API, với quyền read, write hoặc read/write. Qua HTTPS, chúng được gửi dưới dạng HTTP Basic Auth.
  • Phân trang. Danh sách mặc định trả về 10 mục và tối đa 100 mục mỗi trang. Tổng số được gửi trong các header X-WP-Total và X-WP-TotalPages.
  • Lấy dữ liệu gia tăng. Danh sách đơn hàng và sản phẩm chấp nhận modified_after, nên mỗi lần polling chỉ lấy phần đã thay đổi.
  • Ghi theo lô. Endpoint batch mặc định chấp nhận tối đa 100 đối tượng mỗi request, phù hợp để đẩy tồn kho cho danh mục lớn.
  • Webhook. Các topic như order.created và order.updated gửi JSON đến URL của bạn. Dữ liệu được ký trong header X-WC-Webhook-Signature bằng HMAC-SHA256 được mã hóa base64.

Phía Odoo

Từ Odoo 19, một dịch vụ bên ngoài gọi POST /json/2/<model>/<method> bằng API key dưới dạng bearer token. Có một đặc điểm quan trọng hơn cú pháp: mỗi lệnh gọi JSON-2 chạy trong một transaction cơ sở dữ liệu riêng, và các lệnh gọi không thể nối chuỗi bên trong cùng một transaction. Nếu tạo phần thông tin đầu đơn hàng trong một lệnh gọi rồi tạo các dòng hàng trong lệnh gọi thứ hai, lỗi xảy ra giữa chừng sẽ để lại một đơn hàng dang dở trong ERP.

Cách xử lý là gửi đơn hàng cùng các dòng hàng trong một lệnh gọi create duy nhất hoặc tạo một method tùy chỉnh thực hiện toàn bộ quy trình. Đoạn minh họa dưới đây cho thấy mô hình này. Phần tìm kiếm partner và sản phẩm được lược bỏ.

import base64, hashlib, hmac, requests

def woo_signature_ok(raw_body, header_sig, secret):
    digest = hmac.new(secret.encode(), raw_body, hashlib.sha256).digest()
    expected = base64.b64encode(digest).decode()
    return hmac.compare_digest(expected, header_sig)

def odoo(model, method, **params):
    r = requests.post(
        f'{ODOO_URL}/json/2/{model}/{method}',
        headers={'Authorization': f'bearer {ODOO_API_KEY}',
                 'X-Odoo-Database': ODOO_DB},
        json=params, timeout=30)
    r.raise_for_status()
    return r.json()

def import_order(woo):               # woo = parsed order.created payload
    ref = 'WC-' + str(woo['id'])
    domain = [['client_order_ref', '=', ref]]
    if odoo('sale.order', 'search_count', domain=domain):
        return                       # already imported, deliveries can repeat
    odoo('sale.order', 'create', vals_list=[{
        'partner_id': find_or_create_partner(woo['billing']),
        'client_order_ref': ref,
        'order_line': [[0, 0, {
            'product_id': product_id_for_sku(line['sku']),
            'product_uom_qty': line['quantity'],
            'price_unit': float(line['price']),
        }] for line in woo['line_items']],
    }])

Xung quanh phần lõi này, một hệ thống đồng bộ production cần thêm bốn yếu tố: xác minh chữ ký trước khi thực hiện bất kỳ tác vụ nào, phản hồi webhook nhanh rồi xử lý từ hàng đợi, lưu mapping ID WooCommerce với ID Odoo, và chạy polling theo lịch với modified_after để bắt các sự kiện webhook bỏ sót.

Những gì thường hỏng khi vận hành thực tế và cách xử lý

Triệu chứng Nguyên nhân Cách xử lý
Sản phẩm bị trùng hoặc không đối chiếu được SKU trong WooCommerce là tùy chọn, còn Odoo không bắt buộc Internal Reference phải duy nhất. Làm sạch và bắt buộc SKU ở cả hai hệ thống trước lần đồng bộ đầu tiên, sau đó đối chiếu bằng ID đã lưu thay vì chỉ dựa vào SKU.
Biến thể không khớp Sản phẩm biến thể trong WooCommerce là một sản phẩm cha với các variation được lưu riêng. Odoo tạo biến thể từ các dòng thuộc tính và có thể tạo ra những tổ hợp mà cửa hàng không có. Ánh xạ từng variation với một biến thể Odoo bằng SKU và kiểm soát các tổ hợp mà Odoo tạo ra.
Tổng đơn chênh vài xu WooCommerce gửi kết quả thuế riêng dưới dạng chuỗi có hai chữ số thập phân. Odoo tính lại thuế từ các bản ghi thuế của chính nó. Ánh xạ từng mức thuế WooCommerce với một mức thuế Odoo, đồng nhất thiết lập giá đã gồm thuế và quy định cách xử lý chênh lệch làm tròn.
Bán vượt tồn kho Hệ thống đồng bộ số lượng đang có, trong đó vẫn bao gồm hàng đã được giữ chỗ cho các đơn khác. Đẩy số lượng khả dụng của các kho xử lý đơn online. Thêm mức tồn an toàn cho sản phẩm bán nhanh.
Đơn hàng đột ngột không được gửi sang Odoo WooCommerce vô hiệu hóa webhook sau năm lần gửi liên tiếp thất bại, chẳng hạn trong lúc nâng cấp Odoo. Theo dõi trạng thái webhook, duy trì polling đối soát và cảnh báo khi không có đơn mới trong một khoảng thời gian bất thường.
Đơn bán hàng bị trùng Cùng một đơn đến hai lần do gửi lặp hoặc do webhook và polling cùng xử lý. Dùng ID đơn hàng WooCommerce làm khóa idempotency và kiểm tra tính duy nhất trong Odoo.
Tích hợp ngừng hoạt động sau khi nhân sự thay đổi WooCommerce API key thuộc về một người dùng WordPress và ngừng hoạt động khi người dùng đó bị xóa. Tạo một người dùng tích hợp riêng trên cả hai hệ thống, chỉ cấp các quyền cần thiết cho việc đồng bộ.
Thiếu đơn hàng quanh thời điểm nửa đêm Ngày giờ WooCommerce sử dụng múi giờ của website nếu không dùng các trường GMT. Odoo lưu dữ liệu theo UTC. Đọc các trường ngày _gmt và đặt dates_are_gmt trong các request có bộ lọc.

Không lỗi nào trong số này xuất hiện ở bản demo chỉ có mười sản phẩm. Chúng thường lộ ra vào tuần thứ ba. Vì vậy, chạy staging bằng bản sao danh mục thực tế và dữ liệu đơn hàng thật trong một tháng có giá trị hơn bất kỳ danh sách tính năng nào.

Chi phí tích hợp Odoo WooCommerce là bao nhiêu?

Chi phí license connector thường là khoản nhỏ nhất. Hãy lập ngân sách cho cả năm khoản sau:

Khoản chi phí Module connector Giải pháp tùy chỉnh
Phần mềm Mua một module cho mỗi phiên bản Odoo Thời gian phát triển
Gói Odoo Cần gói Custom nếu bạn dùng Odoo Enterprise, vì Standard không cho phép module tùy chỉnh cũng như external API
Hosting Cần Odoo.sh hoặc máy chủ riêng cho mọi thành phần chạy bên trong Odoo
Thiết lập Làm sạch SKU, ánh xạ thuế, ánh xạ trạng thái và chạy thử trên dữ liệu thật. Mọi hướng triển khai đều cần bước này.
Bảo trì Nhà cung cấp cập nhật cho từng phiên bản Odoo, cùng các bản sửa khi WooCommerce hoặc plugin thay đổi hành vi Developer của bạn đảm nhận cả hai phần

Thiết lập là nơi các dự toán thường sai lệch. Danh mục có SKU sạch, duy nhất và chỉ một mức thuế sẽ kết nối nhanh. Danh mục thiếu SKU, có sản phẩm biến thể và nhiều nhóm thuế cần được xử lý dữ liệu trước khi bất kỳ công cụ nào có thể hỗ trợ; không connector nào làm thay phần việc đó.

Nên tích hợp WooCommerce với Odoo hay chuyển cửa hàng sang Odoo eCommerce?

Odoo eCommerce sử dụng chung cơ sở dữ liệu với tồn kho, bán hàng và kế toán, nên không có dữ liệu cần đồng bộ. Điều này loại bỏ toàn bộ nhóm vấn đề ở trên, nhưng đồng thời có nghĩa là bạn phải xây dựng lại giao diện cửa hàng.

Nên giữ WooCommerce và tích hợp khi Nên chuyển sang Odoo eCommerce khi
Lưu lượng organic phụ thuộc vào nội dung và URL WordPress Cửa hàng chỉ là một danh mục sản phẩm đơn giản kèm bước thanh toán
Bạn phụ thuộc vào các extension WooCommerce như subscription hoặc booking Quy tắc về giá, tồn kho và sản phẩm đã nằm trong Odoo
Đội ngũ của bạn làm việc trên WordPress mỗi ngày Bạn muốn duy trì một hệ thống duy nhất thay vì một lớp đồng bộ

Chuyển đổi cũng có các chi phí riêng: tạo redirect cho từng URL đã được lập chỉ mục, xây dựng lại theme và kiểm tra nhà cung cấp thanh toán có được hỗ trợ hay không. Hãy so sánh chi phí một lần này với chi phí duy trì tích hợp trong nhiều năm.

Nếu chưa chắc mình thuộc nhóm nào trong bảng trên, hãy gửi cho Netalith phiên bản Odoo, hình thức hosting và số lượng sản phẩm, đơn hàng ước tính thông qua form nhận báo giá miễn phí. Bạn sẽ nhận được đề xuất có phạm vi rõ ràng: connector, đồng bộ tùy chỉnh hoặc chuyển đổi, với mức giá dựa trên 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ó connector WooCommerce tích hợp sẵn không?

Không. Odoo 19 có tài liệu về các connector tích hợp sẵn cho Amazon, Shopee, Lazada và TikTok Shop, nhưng không có WooCommerce. Tích hợp Odoo WooCommerce phải sử dụng module bên thứ ba từ Odoo Apps Store, module tùy chỉnh hoặc dịch vụ đồng bộ bên ngoài.

Có thể kết nối WooCommerce với Odoo Online không?

Chỉ với gói Custom và thông qua một dịch vụ đồng bộ bên ngoài gọi Odoo API. Odoo Online không lưu trữ module bên thứ ba hoặc module tùy chỉnh, đồng thời tài liệu Odoo giới hạn quyền truy cập external API ở các gói Custom. Với One App Free hoặc Standard, không thể triển khai tích hợp tự động.

Odoo Community có hoạt động với WooCommerce không?

Có. Máy chủ Odoo Community tự hosting có thể chạy connector và module tùy chỉnh, còn API là một phần của chính Odoo. Hãy kiểm tra connector bạn chọn có được phát hành cho Community và đúng phiên bản Odoo đang sử dụng hay không.

Đồng bộ Odoo WooCommerce có theo thời gian thực không?

Có thể gần như theo thời gian thực đối với đơn hàng nếu sử dụng webhook WooCommerce, vì mỗi đơn mới sẽ được gửi đến hệ thống đồng bộ ngay khi phát sinh. Connector chỉ dựa vào tác vụ định kỳ sẽ đồng bộ theo khoảng thời gian đã thiết lập. Cấu hình đáng tin cậy nên kết hợp webhook với đối soát theo lịch, vì WooCommerce sẽ vô hiệu hóa webhook sau năm lần gửi liên tiếp thất bại.

Hệ thống nào nên là nguồn dữ liệu chính cho tồn kho?

Odoo. Odoo ghi nhận hàng nhập, hàng giữ chỗ, giao hàng và hàng trả lại, nên biết chính xác số lượng thực sự có thể bán. WooCommerce nên nhận dữ liệu tồn kho từ Odoo và gửi đơn hàng về Odoo, thay vì duy trì một số lượng tồn kho riêng.

Connector sử dụng XML-RPC có tiếp tục hoạt động không?

Trong thời gian hiện tại thì có. Odoo đã đánh dấu các endpoint XML-RPC và JSON-RPC là deprecated ở phiên bản 19 để chuyển sang JSON-2 API; tài liệu dự kiến loại bỏ chúng ở Odoo 22 (mùa thu năm 2028) và Odoo Online 21.1 (mùa đông năm 2027). Các tích hợp gọi Odoo từ bên ngoài cần chuyển sang JSON-2 trước thời hạn đó. Module chạy bên trong Odoo không bị ảnh hưởng.

Cập nhật cùng Netalith

Nhận kiến thức công nghệ, cập nhật sản phẩm và ưu đãi đặc biệt qua email.