Lỗi Offer “Product Not in Catalog” trên Amazon SP-API: Cách xử lý

Khi đăng sản phẩm qua Amazon SP-API (Listings Items / Feeds), catalog item và offer là hai bước riêng biệt. Nếu bạn gửi offer trước khi Amazon hoàn tất việc tạo và phê duyệt bản ghi catalog, API sẽ từ chối offer với lỗi "product not in catalog" hoặc "can't find a matching ASIN" — ngay cả khi dữ liệu gửi lên hoàn toàn chính xác.

Các thông báo lỗi

Các lỗi này được trả về theo ngôn ngữ của marketplace, vì vậy bạn có thể thấy cùng một vấn đề được hiển thị bằng tiếng Thụy Điển, tiếng Đức hoặc ngôn ngữ khác:

Ditt erbjudande till SKU kan inte läggas till eftersom produkten inte finns i katalogen. Kontrollera dina inlämningsdata... Om du hade tagit bort din SKU tidigare kan du försöka skicka in den ursprungliga UPC/GTIN istället för en föreslagen ASIN.

Deine Angebotszuordnung zur SKU kann nicht hinzugefügt werden, da das Produkt nicht im Katalog enthalten ist. Überprüfe deine übermittelten Daten... versuche, sie mit dem ursprünglichen UPC/GTIN statt einer vorgeschlagenen ASIN erneut einzureichen.

Deine Produktdetails sind nicht vollständig genug, um eine passende ASIN zu finden oder eine neue zu erstellen... überprüfe, ob deine Produktkennzeichnungen (UPCs 12 Ziffern, EANs 13 Ziffern, ISBNs 10 Ziffern) korrekt sind. Attributes: ["externally_assigned_product_identifier"]

Vì sao lỗi này xảy ra?

Catalog item và offer được Amazon xử lý tách biệt. Khi bạn đăng sản phẩm, trước tiên Amazon phải tạo hoặc đối chiếu bản ghi catalog cho mã định danh của bạn, sau đó đồng bộ và phê duyệt bản ghi này trên marketplace mục tiêu. Quá trình đồng bộ không diễn ra ngay lập tức — có thể mất vài giờ đến 24–48 giờ. Nếu yêu cầu gửi offer đến trước khi bản ghi catalog được kích hoạt và phê duyệt, Amazon chưa có sản phẩm để gắn offer vào. Vì vậy, hệ thống báo sản phẩm "not in catalog" hoặc cho rằng thông tin chưa đủ để xác định ASIN. Bản thân dữ liệu gửi lên thường không có vấn đề; nguyên nhân nằm ở thời điểm gửi.

Biến thể lỗi "not complete enough to find an ASIN" cũng liên quan đến externally_assigned_product_identifier vì cùng một lý do — Amazon chưa thể đối chiếu UPC/EAN/GTIN của bạn với một bản ghi catalog đã tồn tại trên marketplace đó.

Cách xử lý

Trước tiên, hãy xác nhận định dạng mã định danh chính xác: UPC = 12 chữ số, EAN = 13 chữ số, ISBN = 10 chữ số. Nếu mã định danh hợp lệ nhưng lỗi vẫn xuất hiện, đây là độ trễ đồng bộ chứ không phải lỗi dữ liệu:

1. Không liên tục gửi lại ngay lập tức — việc này không giúp ích và có thể khiến các lỗi feed bị dồn lại.
2. Chờ 24–48 giờ để Amazon hoàn tất việc tạo và phê duyệt bản ghi catalog trên marketplace mục tiêu.
3. Gửi lại offer. Khi catalog item đã được kích hoạt, chính payload đó thường sẽ được xử lý thành công.
4. Nếu trước đó bạn đã xóa SKU, hãy gửi lại bằng UPC/GTIN ban đầu thay vì ASIN được đề xuất.
5. Khi đăng sản phẩm từ marketplace này sang marketplace khác, hãy kiểm tra để chắc chắn việc tạo SKU trên marketplace mục tiêu đã hoàn tất trước khi gắn dữ liệu offer.

Đây là một trong nhiều trường hợp đặc biệt liên quan đến thời điểm và trình tự mà bạn có thể gặp khi đăng sản phẩm trên Amazon và các marketplace khác. Sau khi xây dựng các hệ thống tích hợp đa kênh trên hơn 20 kênh bán hàng — gồm Amazon SP-API, eBay, Shopify, TikTok Shop và nhiều nền tảng khác — tôi đã gặp và xử lý phần lớn các trường hợp này. Nếu bạn cần hỗ trợ eCommerce hoặc tích hợp marketplace API, hãy tham khảo dịch vụ hỗ trợ eCommerce của Netalith hoặc liên hệ trực tiếp với tôi trên LinkedIn.