Tích hợp Amazon
Hướng dẫn chi tiết
Thuật ngữ
Table
| Thuật ngữ | Định nghĩa |
|---|---|
| Amazon Seller Central | Nền tảng quản lý bán hàng trên Amazon |
| FBA | Fulfillment by Amazon - Amazon xử lý kho và giao hàng |
| FBM | Fulfillment by Merchant - Người bán tự xử lý kho và giao hàng |
| Marketplace | Thị trường Amazon (US, UK, DE, JP, v.v.) |
| SKU | Stock Keeping Unit - Mã định danh sản phẩm |
| Offer | Sản phẩm được bán trên Amazon |
| Feed | Dữ liệu gửi lên Amazon (tồn kho, giá, v.v.) |
| SP-API | Selling Partner API - API của Amazon |
Điều kiện tiên quyết
Điểm chính
• Cài đặt module **Sale Amazon** (sale_amazon)
• Có tài khoản **Amazon Seller Central** đang hoạt động
• Đăng ký **SP-API Developer** trên Amazon
• Thiết lập **Internal Reference** (SKU) cho sản phẩm trong Odoo
• Cấu hình kho FBA trong Odoo (nếu sử dụng FBA)
• Thiết lập carrier và tracking cho FBM
Kết nối Tài khoản Amazon
Các bước thực hiện
1. Vào **Sales → Configuration → Amazon → Accounts**
2. Click **New** để tạo tài khoản mới
3. Chọn **Home Marketplace** (thị trường chính)
4. Chọn **Company** (công ty sở hữu)
5. Thiết lập **Salesperson** và **Sales Team** (tùy chọn)
6. Click **Save**
7. Click nút **Connect** trên thanh công cụ
8. Đăng nhập Amazon Seller Central và cấp quyền cho Odoo
9. Sau khi cấp quyền, hệ thống tự động lưu token và lấy danh sách marketplace
10. Trạng thái chuyển sang **Connected**
Cấu hình Marketplace
Các bước thực hiện
1. Mở tài khoản Amazon đã kết nối
2. Tại tab **Marketplaces**, xem danh sách marketplace khả dụng
3. Chọn các marketplace muốn đồng bộ đơn hàng
4. Bỏ chọn marketplace không sử dụng để tránh đồng bộ thừa
5. Click **Save** để lưu cấu hình
Quản lý Sản phẩm (Offers)
Các bước thực hiện
1. Vào **Sales → Configuration → Amazon → Offers**
2. Click **New** để tạo offer mới
3. Chọn **Account** (tài khoản Amazon)
4. Chọn **Marketplace** (thị trường bán sản phẩm)
5. Nhập **SKU** (mã SKU trên Amazon)
6. Chọn **Product** (sản phẩm Odoo tương ứng)
7. Tích **Sync Stock** nếu muốn đồng bộ tồn kho (chỉ FBM)
8. Click **Save**
Ghép Sản phẩm Tự động
Điểm chính
• Hệ thống tự động ghép sản phẩm khi đồng bộ đơn hàng
• SKU trên Amazon = **Internal Reference** trong Odoo
• Nếu không tìm thấy sản phẩm, hệ thống tạo sản phẩm mới
• Khuyến nghị: Thiết lập Internal Reference trước khi đồng bộ
• Kiểm tra và điều chỉnh sản phẩm tự động tạo nếu cần
Đồng bộ Đơn hàng
Các bước thực hiện
1. Hệ thống tự động đồng bộ mỗi 15 phút qua CRON job
2. Để đồng bộ thủ công: Mở tài khoản Amazon
3. Click nút **Sync Orders**
4. Hệ thống lấy đơn hàng mới từ Amazon
5. Tự động tạo sales order trong Odoo
6. Tìm/tạo khách hàng dựa trên email hoặc tên
7. Ghép SKU với sản phẩm Odoo
8. Tạo delivery order (nếu có kho)
9. Đơn hàng tự động chuyển sang trạng thái **Sales Order**
Xác nhận Giao hàng (FBM)
Các bước thực hiện
1. Vào **Inventory → Operations → Delivery Orders**
2. Mở delivery order của đơn hàng Amazon
3. Điền **Carrier** (đơn vị vận chuyển)
4. Điền **Tracking Reference** (mã vận đơn)
5. Click **Validate** để xác nhận giao hàng
6. Hệ thống tự động đánh dấu để đồng bộ lên Amazon
7. CRON job tự động gửi xác nhận giao hàng mỗi 1 giờ
8. Kiểm tra **Amazon Sync Status** để xác nhận thành công
Đồng bộ Tồn kho (FBM)
Các bước thực hiện
1. Bật **FBM Stock** trong cấu hình tài khoản Amazon
2. Tích **Sync Stock** cho từng offer cần đồng bộ
3. Đảm bảo sản phẩm là **Storable Product**
4. Hệ thống tự động đồng bộ mỗi 1 giờ
5. Tồn kho gửi lên = Available Quantity (On Hand - Reserved)
6. Để đồng bộ thủ công: Click **Sync Inventory** trên tài khoản
7. Click **Sync Feeds Status** để kiểm tra trạng thái
Quản lý Kho FBA
Điểm chính
• Tạo **Stock Location** riêng cho FBA trong Odoo
• Thiết lập **FBA Stock Location** trong cấu hình tài khoản
• Đơn hàng FBA tự động liên kết với kho FBA
• Không cần xác nhận giao hàng (Amazon xử lý)
• Theo dõi tồn kho FBA trong Odoo để báo cáo
• Không đồng bộ tồn kho FBA lên Amazon (Amazon quản lý)
Khôi phục Đơn hàng
Các bước thực hiện
1. Mở tài khoản Amazon
2. Click nút **Recover Order**
3. Nhập **Amazon Order Reference** (mã đơn hàng Amazon)
4. Định dạng: XXX-XXXXXXX-XXXXXXX
5. Click **Recover**
6. Hệ thống lấy đơn hàng từ Amazon và tạo/cập nhật trong Odoo
Xử lý Lỗi Đồng bộ
Table
| Loại lỗi | Triệu chứng | Giải pháp |
|---|---|---|
| Lỗi đồng bộ đơn hàng | Nhận email thông báo lỗi | Kiểm tra sản phẩm, đặt lại Last Orders Sync, thử lại Sync Orders |
| Lỗi đồng bộ giao hàng | Delivery order có status Failed | Kiểm tra Carrier và Tracking Reference, click Retry Amazon Sync |
| Lỗi đồng bộ tồn kho | Tồn kho không khớp | Kiểm tra Sync Stock đã bật, sản phẩm là Storable, click Sync Inventory |
| Kết nối bị mất | Trạng thái Disconnected | Click Connect lại, đăng nhập và cấp quyền lại |
Best Practices
Điểm chính
• Thiết lập **Internal Reference** cho tất cả sản phẩm = SKU Amazon
• Tạo **offer** trước khi đồng bộ đơn hàng để tránh tạo sản phẩm trùng
• Chỉ chọn **marketplace** thực sự bán hàng
• Tạo **kho FBA** riêng để theo dõi tồn kho tại Amazon
• Luôn điền **Carrier** và **Tracking Reference** trước khi validate delivery
• Kiểm tra **Amazon Sync Status** định kỳ
• Để CRON job tự động đồng bộ, không cần thủ công
• Backup database trước khi thay đổi cấu hình lớn
• Phân quyền đúng: chỉ Sales Manager cấu hình tài khoản
• Theo dõi email lỗi để xử lý kịp thời
Sự cố Thường gặp
Table
| Vấn đề | Nguyên nhân | Giải pháp |
|---|---|---|
| Đơn hàng không tự động đồng bộ | CRON job không chạy hoặc tài khoản Disconnected | Kiểm tra Scheduled Actions, kiểm tra trạng thái kết nối |
| Sản phẩm bị tạo trùng | Internal Reference không khớp với SKU | Tạo offer trước, đảm bảo Internal Reference = SKU |
| Tồn kho không cập nhật trên Amazon | Sync Stock chưa bật hoặc sản phẩm không phải Storable | Bật Sync Stock, kiểm tra product type |
| Giao hàng không đồng bộ | Thiếu Carrier hoặc Tracking Reference | Điền đầy đủ thông tin trước khi validate |
| Khách hàng bị tạo trùng | Email hoặc tên không khớp chính xác | Merge khách hàng trùng, chuẩn hóa dữ liệu |
FAQ
Điểm chính
• **Làm thế nào để kết nối nhiều tài khoản Amazon?** Tạo nhiều Amazon Account trong Odoo, mỗi tài khoản kết nối riêng với Seller Central.
• **FBA và FBM khác nhau như thế nào?** FBA: Amazon xử lý kho và giao hàng. FBM: Người bán tự xử lý, cần đồng bộ tồn kho và xác nhận giao hàng.
• **SKU và Internal Reference có bắt buộc phải giống nhau không?** Không bắt buộc nhưng khuyến nghị để tự động ghép sản phẩm chính xác.
• **Có thể đồng bộ tồn kho FBA không?** Không, FBA do Amazon quản lý. Chỉ đồng bộ tồn kho FBM.
• **Làm sao để xem đơn hàng Amazon trong Odoo?** Vào Sales → Orders, lọc theo Amazon Order Reference hoặc click smart button Orders trên tài khoản Amazon.
• **Có thể chỉnh sửa đơn hàng Amazon không?** Không nên chỉnh sửa đơn hàng đã đồng bộ. Thay đổi trên Amazon sẽ được đồng bộ lại.
• **Làm thế nào để ngừng đồng bộ tài khoản?** Archive tài khoản Amazon, hệ thống tự động ngắt kết nối và dừng đồng bộ.
• **CRON job chạy bao lâu một lần?** Đơn hàng: 15 phút. Giao hàng và tồn kho: 1 giờ.
• **Có thể đồng bộ đơn hàng cũ không?** Có, đặt Last Orders Sync về ngày cần đồng bộ, sau đó click Sync Orders.
• **Làm sao để kiểm tra lỗi đồng bộ?** Kiểm tra email thông báo, xem Settings → Technical → Logging, hoặc xem Amazon Sync Status trên delivery order.