Tích hợp Amazon

Hướng dẫn chi tiết

odoo amazon
amazon connector
FBA
FBM
amazon seller central
đồng bộ đơn hàng
amazon marketplace

Thuật ngữ

Table

Thuật ngữĐịnh nghĩa
Amazon Seller CentralNền tảng quản lý bán hàng trên Amazon
FBAFulfillment by Amazon - Amazon xử lý kho và giao hàng
FBMFulfillment by Merchant - Người bán tự xử lý kho và giao hàng
MarketplaceThị trường Amazon (US, UK, DE, JP, v.v.)
SKUStock Keeping Unit - Mã định danh sản phẩm
OfferSản phẩm được bán trên Amazon
FeedDữ liệu gửi lên Amazon (tồn kho, giá, v.v.)
SP-APISelling 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ỗiTriệu chứngGiải pháp
Lỗi đồng bộ đơn hàngNhận email thông báo lỗiKiểm tra sản phẩm, đặt lại Last Orders Sync, thử lại Sync Orders
Lỗi đồng bộ giao hàngDelivery order có status FailedKiểm tra Carrier và Tracking Reference, click Retry Amazon Sync
Lỗi đồng bộ tồn khoTồn kho không khớpKiểm tra Sync Stock đã bật, sản phẩm là Storable, click Sync Inventory
Kết nối bị mấtTrạng thái DisconnectedClick 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ânGiải pháp
Đơn hàng không tự động đồng bộCRON job không chạy hoặc tài khoản DisconnectedKiểm tra Scheduled Actions, kiểm tra trạng thái kết nối
Sản phẩm bị tạo trùngInternal Reference không khớp với SKUTạo offer trước, đảm bảo Internal Reference = SKU
Tồn kho không cập nhật trên AmazonSync Stock chưa bật hoặc sản phẩm không phải StorableBậ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ùngEmail hoặc tên không khớp chính xácMerge 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.