Tra cứu mã vạch sản phẩm
Tự động điền dữ liệu sản phẩm từ barcode bằng API barcodelookup.com, hỗ trợ nhập nhanh và lấy ảnh hàng loạt.
Module product_barcodelookup kết nối Odoo với dịch vụ barcodelookup.com để lấy dữ liệu sản phẩm theo mã UPC hoặc EAN. Khi barcode hợp lệ và API key đã cấu hình, hệ thống có thể tự động bổ sung tên sản phẩm, ảnh, trọng lượng, mô tả, danh mục và nhiều thuộc tính khác.
Tính năng này đặc biệt hữu ích khi doanh nghiệp nhập số lượng lớn sản phẩm mới, cần đồng bộ thông tin cơ bản nhanh và muốn giảm thời gian nhập tay cho đội sản phẩm hoặc kho.
Giá trị chính của tính năng
Điểm chính
• Tự động điền tên sản phẩm, ảnh, trọng lượng, giá bán tham khảo, mô tả và danh mục từ barcode.
• Tạo thuộc tính sản phẩm như màu sắc, kích thước, thương hiệu hoặc chất liệu khi dữ liệu đầu vào có sẵn.
• Hỗ trợ wizard lấy ảnh hàng loạt cho nhiều sản phẩm có barcode nhưng chưa có hình.
• Dùng CRON để xử lý nền theo lô, phù hợp với danh sách sản phẩm lớn và giới hạn API hằng ngày.
• Giảm sai sót nhập liệu khi đội vận hành cần chuẩn hóa nhiều sản phẩm mới trong thời gian ngắn.
Trường và thông báo quan trọng
| Fields | Trường dữ liệu | Description |
|---|---|---|
| Barcode Database | Cơ sở dữ liệu mã vạch | Tên nhóm cấu hình để nhập API key. |
| API Key | Mã khóa API | Khóa xác thực được lưu trong cấu hình hệ thống. |
| Get Pictures from Barcode Lookup | Lấy ảnh từ Tìm kiếm mã vạch | Action để tải ảnh hàng loạt cho sản phẩm đủ điều kiện. |
| Is Image Fetch Pending | Đang chờ tìm nạp hình ảnh | Cờ đánh dấu sản phẩm sẽ được CRON xử lý tiếp. |
| Products are processed in the background | Sản phẩm đang được xử lý trong nền | Thông báo sau khi wizard chuyển phần việc còn lại cho CRON. |
| The Barcode Lookup API key is not set properly or it is invalid | Khóa API Tìm kiếm mã vạch không hợp lệ | Lỗi phổ biến khi cấu hình API key sai hoặc hết hiệu lực. |
Cấu hình API key
Điểm chính
• Free tier thường có giới hạn 1000 requests mỗi ngày.
• Nếu không có API key hợp lệ, wizard sẽ chặn và yêu cầu quay lại phần cấu hình.
Các bước thực hiện
1. Đăng ký tài khoản tại barcodelookup.com và lấy API key.
2. Vào Settings → General Settings trong Odoo.
3. Tìm section Barcode Database và nhập API Key.
4. Lưu cấu hình để hệ thống ghi vào ir.config_parameter.
5. Kiểm tra lại quyền người dùng vì chỉ nhóm Settings hoặc System mới thấy và dùng đầy đủ chức năng này.
Tự động điền thông tin khi nhập barcode
Khi người dùng có quyền phù hợp nhập barcode dài hơn ngưỡng tối thiểu và rời khỏi trường barcode, hệ thống gọi dịch vụ barcode lookup và cập nhật các trường đang còn trống hoặc chưa được chuẩn hóa.
Các bước thực hiện
1. Vào Inventory → Products → Products và tạo hoặc mở sản phẩm.
2. Nhập barcode hợp lệ như UPC-A hoặc EAN-13.
3. Rời khỏi trường Barcode để kích hoạt onchange.
4. Kiểm tra dữ liệu hệ thống tự điền và chỉnh lại những điểm cần chuẩn hóa theo danh mục nội bộ.
5. Lưu sản phẩm sau khi xác nhận dữ liệu đủ chính xác để dùng trong giao dịch.
Các trường thường được tự động điền
| Trường | Nguồn dữ liệu | Ghi chú |
|---|---|---|
| Name | title | Chỉ điền khi tên sản phẩm chưa có hoặc cần chuẩn hóa |
| Image | images[] | Lấy ảnh đầu tiên hợp lệ từ phản hồi API |
| Weight | weight | Hỗ trợ chuyển đổi giữa lb và kg theo cấu hình |
| List Price | stores[].price | Có thể chuyển đổi tiền tệ về currency của công ty |
| Attributes | brand, color, size, material, ... | Chỉ tạo khi sản phẩm phù hợp và người dùng có quyền variant |
| Category / Description | category, description, features | Dùng để làm giàu dữ liệu sản phẩm mới |
Lấy ảnh hàng loạt bằng wizard
Điểm chính
• Wizard chỉ ưu tiên các sản phẩm có barcode và chưa có ảnh.
• Hệ thống cảnh báo về vấn đề bản quyền hình ảnh, vì vậy không nên đăng công khai mọi ảnh tải về mà không rà soát.
Các bước thực hiện
1. Mở danh sách Products hoặc Product Variants.
2. Chọn nhiều sản phẩm rồi dùng Action → Get Pictures from Barcode Lookup.
3. Wizard sẽ thống kê tổng sản phẩm được chọn, số đủ điều kiện xử lý và số không thể xử lý.
4. Nhấn Get Pictures để xử lý ngay một phần nhỏ danh sách.
5. Phần còn lại sẽ được đánh dấu pending và giao cho CRON chạy nền.
Xử lý nền và CRON
Các tình huống trigger CRON
| Tình huống | Thời gian trigger | Ý nghĩa |
|---|---|---|
| Còn sản phẩm chờ xử lý | Ngay hoặc sau 1 phút | Tiếp tục xử lý batch kế tiếp |
| API rate limit 429 | Sau 1 ngày | Chờ quota ngày mới |
| Timeout hoặc lỗi kết nối lặp lại | Sau 1 giờ | Cho dịch vụ bên ngoài thời gian hồi phục |
| Xử lý nền thông thường | ASAP | Đẩy ảnh về nhanh khi hệ thống sẵn sàng |
Mã lỗi và cách hệ thống phản ứng
| Mã lỗi | Phản ứng | Điều cần kiểm tra |
|---|---|---|
| 403 | Dừng và báo API key không hợp lệ | Kiểm tra API key trong Settings |
| 429 | Hoãn CRON sang ngày hôm sau | Theo dõi quota API hằng ngày |
| 404 | Bỏ qua mục lỗi và tiếp tục | Một barcode cụ thể có thể không có dữ liệu |
| Timeout / Connection Error | Retry rồi hoãn nếu cần | Kiểm tra mạng và dịch vụ bên ngoài |
Thuộc tính và chuyển đổi tự động
Điểm chính
• Module có thể tạo trước các attribute phổ biến như color, gender, material, brand, size và age group.
• Nếu attribute chưa tồn tại trong master data, hệ thống có thể bổ sung dữ liệu tương ứng hoặc đẩy một phần thông tin xuống phần mô tả.
• Khối lượng, kích thước và thể tích có thể được chuyển đổi theo hệ đo đang dùng trong hệ thống.
• Giá tham khảo từ cửa hàng bên ngoài chỉ nên xem là dữ liệu khởi tạo, không phải chính sách giá cuối cùng của doanh nghiệp.
Lưu ý vận hành
Điểm chính
• Chỉ nên dùng dữ liệu tra cứu làm bước khởi tạo nhanh, sau đó đội sản phẩm vẫn cần rà soát lại tên, danh mục và mô tả theo chuẩn nội bộ.
• Theo dõi quota API để tránh tình trạng wizard dừng vì vượt giới hạn request trong ngày.
• Không phải mọi hình ảnh trên dịch vụ đều có quyền sử dụng thương mại, nên cần kiểm duyệt trước khi đưa ra website hoặc catalog.
• Khi gặp thông báo một tác vụ nền đang chạy, hãy chờ CRON hoàn tất thay vì kích hoạt thêm nhiều lần.