Thuê lập trình viên Amazon SP-API: Cần kiểm tra gì?
Đang thuê lập trình viên Amazon SP-API? Hãy kiểm tra quyền sở hữu tài khoản, các API sắp bị Amazon ngừng hỗ trợ và cách nhận diện ứng viên yếu.
Long Nguyen
Lập trình viên Fullstack · Kỹ sư AI · Nhà nghiên cứu
Cần kiểm tra gì trước khi thuê lập trình viên Amazon SP-API?
Gọi một REST endpoint là phần đơn giản; bất kỳ lập trình viên backend nào cũng có thể làm được. Những vấn đề phát sinh khi đưa hệ thống vào vận hành lại nằm ở bốn điểm: ai sở hữu đăng ký developer, hệ thống có dựa trên các API Amazon sắp ngừng hỗ trợ hay không, hoạt động tích hợp ra sao khi Amazon giới hạn lưu lượng và dữ liệu người mua được xử lý như thế nào.
Hướng dẫn này là checklist cho cả bốn vấn đề trên, giúp chủ doanh nghiệp hoặc người phụ trách vận hành trao đổi khi tuyển dụng mà không cần đọc từng trang tài liệu API. Các thông tin dưới đây đã được đối chiếu với tài liệu chính thức của Amazon vào .
- Quyền sở hữu: hồ sơ developer và thông tin xác thực ứng dụng phải nằm trong tài khoản của bạn, không phải tài khoản của bên nhận thầu.
- Tính cập nhật: phần việc mới phải sử dụng các phiên bản API hiện hành, không dùng API đã có ngày ngừng hỗ trợ.
- Khả năng chống gián đoạn: cơ chế xử lý giới hạn lưu lượng phải được thiết kế từ đầu, không phải đến khi triển khai mới phát hiện.
- Xử lý dữ liệu: chỉ yêu cầu những role cần thiết cho công việc và quản lý thông tin xác thực đúng cách.
Khi nào bạn thực sự cần lập trình viên SP-API?
Selling Partner API (SP-API) là REST API của Amazon, cho phép truy cập dữ liệu người bán theo cách lập trình, bao gồm listing, đơn hàng, khoản thanh toán, báo cáo và nhiều dữ liệu khác. Bạn cần lập trình viên khi một connector có sẵn không thể đáp ứng logic của mình, chẳng hạn như điều phối tồn kho giữa nhiều kho, đưa đơn hàng vào hệ thống ERP riêng hoặc xây dựng công cụ cho những người bán khác. Nếu connector có sẵn đã đáp ứng được luồng dữ liệu, việc xây dựng hệ thống riêng có thể tạo thêm gánh nặng bảo trì mà bạn không thực sự cần.
Bảng dưới đây liên kết các nhu cầu phổ biến với khu vực API liên quan và những điểm thường phát sinh vấn đề.
| Bạn muốn tự động hóa | Khu vực SP-API liên quan | Điểm phức tạp |
|---|---|---|
| Đưa đơn hàng vào hệ thống ERP hoặc hệ thống kho | Orders API, Notifications API | Xử lý PII của người mua, các giá trị trạng thái bị đổi tên và thời hạn của pagination token |
| Cập nhật listing, giá và tồn kho hàng loạt | Listings Items API, JSON-based Feeds API, Product Type Definitions API | Quy tắc thuộc tính khác nhau theo loại sản phẩm và marketplace; lỗi xác thực được báo riêng cho từng listing, vì vậy cần xử lý issue chứ không chỉ đánh dấu thành công hoặc thất bại |
| Đối soát phí, khoản chi trả và doanh thu | Finances API, Reports API | Finances v0 và báo cáo quyết toán V2 đều nằm trong lịch ngừng hỗ trợ của Amazon |
| Tự động hóa hàng nhập FBA | Fulfillment Inbound API | Các thao tác inbound v0 cũ đã bị gỡ bỏ vào tháng 1 năm 2025, nên hướng dẫn và đoạn mã mẫu cũ sẽ không hoạt động |
Ai sở hữu tài khoản developer SP-API?
Để gọi SP-API, bạn cần có developer profile trong Amazon's Solution Provider Portal và một ứng dụng đã đăng ký. Amazon chia developer thành hai loại. Private developer xây dựng ứng dụng chỉ tích hợp công ty của họ với Amazon, và các ứng dụng này được tự cấp quyền. Public developer xây dựng ứng dụng cho những người bán khác, nên ứng dụng công khai có các giới hạn cấp quyền riêng.
Nếu bạn thuê người xây dựng hệ thống cho cửa hàng của mình, bạn muốn trở thành private developer. Có ba điểm cần làm rõ trong cuộc trao đổi:
- Chỉ người dùng chính của tài khoản mới có thể hoàn tất đăng ký. Bên nhận thầu không thể tự đăng ký thay bạn từ phía họ, vì vậy chủ tài khoản phải tham gia.
- Amazon là bên quyết định phê duyệt. Quyết định dựa trên developer profile của bạn, bao gồm chức năng của ứng dụng và việc tuân thủ Acceptable Use Policy cũng như Data Protection Policy. Amazon cho biết họ không thể giải thích chi tiết cách xác định điều kiện đủ tư cách. Amazon cũng yêu cầu hồ sơ dưới 500 từ, dùng cách diễn đạt nguyên bản thay vì sao chép nội dung chính sách, đồng thời để đội ngũ kỹ thuật trả lời các câu hỏi bảo mật.
- Role bị giới hạn đồng nghĩa với PII. Những role cho phép truy cập thông tin nhận dạng cá nhân sẽ bị xem xét nghiêm ngặt hơn. Với public developer, việc này bao gồm đánh giá kiến trúc với đội ngũ SP-API Solutions Architecture của Amazon và có thể cần trình diễn qua chia sẻ màn hình.
Vì bạn không kiểm soát được thời điểm phê duyệt, hãy xây dựng các mốc dự án không phụ thuộc vào một ngày phê duyệt cụ thể. Đề nghị ứng viên cùng bạn soạn nội dung mô tả use case, đồng thời giữ việc đăng ký ứng dụng và thông tin xác thực trong chính tài khoản của mình. Amazon cung cấp tính năng quản lý người dùng trong Solution Provider Portal, vì vậy lập trình viên nên làm việc bằng user riêng thay vì dùng chung thông tin đăng nhập chính. Thông tin xác thực cũng cần được thay mới định kỳ, và Amazon cung cấp thông báo thay mới thông qua Application Management API.
Hãy cẩn trọng với đề xuất nói rằng chúng tôi sẽ dùng tài khoản developer của mình cho cửa hàng của bạn. Đây có thể là mô hình public app hợp lệ, nhưng đó là thuê quyền sử dụng chứ không phải sở hữu: nếu quan hệ hợp tác kết thúc, hệ thống tích hợp của bạn vẫn gắn với ứng dụng của họ.
Những thay đổi API mà một lập trình viên giỏi phải biết
Amazon công bố lịch ngừng hỗ trợ SP-API kèm các ngày gỡ bỏ. Trong lịch này, deprecated nghĩa là tài nguyên không còn được phát triển tích cực, còn removed nghĩa là các lệnh gọi sẽ thất bại kể từ ngày gỡ bỏ. Lịch được cập nhật lần cuối vào . Dưới đây là những mục quan trọng với một hệ thống mới, cùng trạng thái tại :
| Khu vực | Nội dung bị ngừng hỗ trợ | Ngày gỡ bỏ | Trạng thái |
|---|---|---|---|
| Feeds API | Các loại listing feed XML và flat-file như POST_PRODUCT_DATA và POST_FLAT_FILE_LISTINGS_DATA | Đã gỡ bỏ | |
| Notifications API | ORDER_STATUS_CHANGE | Đã gỡ bỏ | |
| Notifications API | LISTINGS_ITEM_ISSUES_CHANGE, payload phiên bản 1.0 | Đã gỡ bỏ | |
| Reports API | Báo cáo quyết toán V2 (GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE và _XML) | Sắp tới | |
| Orders API | Orders v0 (getOrders, getOrder, getOrderItems, các thao tác lấy thông tin người mua và địa chỉ) | Sắp tới | |
| Finances API | Finances v0 (các thao tác listFinancialEvents) | Sắp tới |
Điều gì thay đổi khi Orders v0 chuyển sang v2026-01-01?
Orders là API mà hầu hết hệ thống tích hợp chạm đến đầu tiên, vì vậy đây là đợt chuyển đổi nhiều khả năng sẽ đến với bạn nhất. Phiên bản thay thế là Orders API v2026-01-01, và khác biệt không chỉ nằm ở việc đổi tên lệnh gọi:
| Orders v0 | Orders v2026-01-01 |
|---|---|
| GetOrders | searchOrders |
| GetOrder cùng GetOrderItems | getOrder, trong đó items luôn được bao gồm |
| GetOrderBuyerInfo, GetOrderAddress | getOrder với includedData=BUYER hoặc RECIPIENT |
| Phân trang bằng NextToken | paginationToken, hết hạn sau 24 giờ |
| Các giá trị trạng thái như Canceled; giá trị channel MFN và AFN | CANCELLED, cùng MERCHANT và AMAZON; nếu không cập nhật, mọi ánh xạ trạng thái có thể âm thầm bị sai |
| Cần Restricted Data Token cho PII | Chỉ cần role; không cần Restricted Data Token cho PII trong Orders |
| Bộ lọc BuyerEmail | Không khả dụng |
Có hai hệ quả thực tế. Thứ nhất, một hệ thống tích hợp hiện có được viết trên Orders v0 hoặc XML feed là một dự án chuyển đổi có thời hạn bắt buộc, không phải chỉnh sửa nhỏ; hãy lập phạm vi và báo giá tương xứng. Thứ hai, bất kỳ đề xuất mới nào dựa trên v0 hoặc XML feed đều cho thấy ứng viên đang làm việc theo các hướng dẫn cũ.
Một dấu hiệu liên quan: kể từ , SP-API không còn yêu cầu AWS IAM hoặc AWS Signature Version 4 để gọi API. Một đề xuất dành nhiều ngày cho IAM role và ký request chỉ để thực hiện lệnh gọi là dấu hiệu đã lỗi thời. AWS vẫn được sử dụng nếu bạn dùng Amazon SQS hoặc EventBridge để nhận notification, vì vậy câu trả lời chính xác là IAM đã rời khỏi luồng request, chứ không phải khỏi toàn bộ kiến trúc.
Chi phí thuê lập trình viên Amazon SP-API năm 2026
Có hai nhóm chi phí, và nhóm đầu tiên đã giảm trong năm nay. Vào tháng 11 năm 2025, Amazon công bố phí developer cho SP-API, gồm phí thuê bao hằng năm và phí sử dụng dựa trên số lượng lệnh gọi GET. Đến , Amazon thông báo với các developer rằng họ sẽ chưa triển khai phí sử dụng và phí hằng năm vào thời điểm hiện tại, nên tại thời điểm bài viết này không cần dự trù phí từ phía Amazon.
Hãy xem cụm từ vào thời điểm hiện tại là lý do để hỏi ứng viên thiết kế của họ sẽ thích ứng thế nào nếu tính phí theo từng lệnh gọi. Một hệ thống tích hợp lắng nghe notification thay vì polling theo bộ hẹn giờ sẽ có chi phí vận hành thấp hơn dưới bất kỳ mô hình tính phí nào. Hướng dẫn riêng của Amazon dành cho ứng dụng bị giới hạn lưu lượng cũng đưa ra khuyến nghị tương tự: dùng push notification thay cho polling.
Nhóm chi phí thứ hai là phí của lập trình viên. Thay vì đưa ra mức giá dễ lỗi thời, dưới đây là những yếu tố thực sự làm thay đổi chi phí:
| Yếu tố chi phí | Vì sao làm thay đổi phạm vi |
|---|---|
| Số lượng luồng dữ liệu | Đơn hàng, tồn kho, listing và tài chính đều có API, quy tắc và cách phát sinh lỗi riêng |
| Marketplace và khu vực | Usage plan và quyền cấp phép gắn với nhóm cửa hàng; thông tin xác thực từ tài khoản khu vực khác có giới hạn riêng |
| PII của người mua và các role bị giới hạn | Cần xem xét nghiêm ngặt hơn, xử lý dữ liệu chặt chẽ hơn và bổ sung nhiều tài liệu bảo mật hơn |
| Đồng bộ theo thời gian thực hay theo lịch | Notification cần hạ tầng queue hoặc event; polling cần kiểm soát throttling cẩn thận |
| Chuyển đổi hệ thống hiện có | Orders v0, XML feed và Finances v0 đều cần được làm lại theo lịch nêu trên |
| Bảo trì liên tục | Lịch ngừng hỗ trợ có các mốc trong các năm 2025, 2026 và 2027, vì vậy công việc không bao giờ hoàn toàn kết thúc |
Hãy yêu cầu báo giá dựa trên phạm vi công việc được ghi rõ. Mức giá theo giờ nhưng không có phạm vi cụ thể sẽ khiến bạn phải gánh rủi ro từ mọi vấn đề phát sinh trong bảng trên. Nếu muốn có người cùng xây dựng phạm vi, dịch vụ tích hợp marketplace của Netalith bao gồm listing, tồn kho, đơn hàng và tracking trên Amazon SP-API, với chi phí được tính theo phạm vi luồng dữ liệu.
Câu hỏi giúp phân biệt kinh nghiệm SP-API thực tế với việc chỉ học theo tutorial
Những câu hỏi này đều có câu trả lời có thể kiểm chứng. Mỗi câu gắn với hành vi được mô tả trong tài liệu Amazon, vì vậy ứng viên từng vận hành thực tế sẽ trả lời nhanh và cụ thể.
| Câu hỏi | Câu trả lời tốt | Câu trả lời yếu |
|---|---|---|
| Bạn sẽ xử lý throttling như thế nào? | Dùng back-off khi nhận phản hồi 429, biết giới hạn áp dụng theo cặp application và seller, dùng notification thay cho vòng lặp polling, đồng thời đọc header x-amzn-RateLimit-Limit khi có nhưng không phụ thuộc vào header này | Dùng bộ hẹn giờ cố định hoặc dự định yêu cầu Amazon tăng giới hạn |
| Bạn sẽ kiểm thử rate limit trước khi triển khai thế nào? | Dùng sandbox chỉ để kiểm tra việc xử lý 429, sau đó xác minh giới hạn thực tế trong môi trường production | Nói rằng sandbox đã vượt qua kiểm thử nên giới hạn là ổn, dù mọi thao tác sandbox đều dùng chung một rate |
| Bạn sẽ xây dựng trên phiên bản Orders API nào? | v2026-01-01, chỉ yêu cầu includedData cần thiết | v0 hoặc không biết API có nhiều phiên bản |
| Listing sẽ được tạo và cập nhật như thế nào? | Listings Items API hoặc feed dựa trên JSON, điều khiển bằng product type definitions và có xử lý issue | XML hoặc flat-file feed |
| Chúng ta cần những role nào và vì sao? | Chỉ yêu cầu các role mà use case cần, đồng thời giải thích rõ role nào cho phép truy cập PII | Yêu cầu mọi role để cho an toàn |
| Thông tin xác thực được lưu ở đâu và thay mới thế nào? | Lưu trong secrets manager, có kế hoạch thay mới và không để secret trong code, ticket hoặc chat | Chia sẻ thông tin xác thực qua email hoặc commit vào repository |
| Sau khi triển khai, bạn sẽ theo dõi những gì? | Lệnh gọi thất bại, tỷ lệ throttling, issue của listing, chỉ số sử dụng API trong Solution Provider Portal và lịch ngừng hỗ trợ | Không theo dõi gì; hệ thống tự hoạt động |
Có một điểm cần nhấn mạnh vì thường khiến nhiều người bất ngờ. Với các thao tác sử dụng usage plan động, Amazon điều chỉnh rate limit cho từng selling partner dựa trên các chỉ số kinh doanh, không dựa trên số request mà ứng dụng gửi đi; gọi thường xuyên hơn cũng không làm tăng giới hạn. Cách khắc phục hệ thống bị throttling là giảm số lượng lệnh gọi và thiết kế chúng tốt hơn, chứ không phải gây áp lực lên Amazon.
Nên thuê freelancer, agency hay tuyển nội bộ?
Lựa chọn phù hợp phụ thuộc vào tính liên tục của công việc nhiều hơn là kỹ năng, vì một hệ thống tích hợp SP-API cần được duy trì. Các mốc ngừng hỗ trợ trong lịch của Amazon trải dài qua ba năm liên tiếp, nên nếu thuê xây dựng xong rồi kết thúc hợp tác, bạn có thể bị bỏ lại khi API tiếp theo bị gỡ bỏ.
| Tình huống của bạn | Lựa chọn thường phù hợp nhất | Điểm cần lưu ý |
|---|---|---|
| Một marketplace, một hoặc hai luồng dữ liệu, nhu cầu ít thay đổi | Freelancer giàu kinh nghiệm | Phụ thuộc vào một người; hãy yêu cầu quyền truy cập repository và runbook bằng văn bản |
| Nhiều marketplace hoặc luồng dữ liệu và cần duy trì liên tục | Agency hoặc studio nhỏ | Xác nhận người xây dựng hệ thống cũng là người phụ trách bảo trì |
| Amazon là kênh chủ lực và yêu cầu thay đổi thường xuyên | Tuyển nội bộ hoặc ký hợp đồng retainer dài hạn | Dự trù bảo trì như một khoản chi phí thường xuyên |
Điều khoản hợp đồng bảo vệ hệ thống tích hợp Amazon
- Code nằm trong repository của bạn. Mã nguồn và định nghĩa hạ tầng thuộc về bạn và được lưu trong tổ chức do bạn kiểm soát.
- Đăng ký và thông tin xác thực nằm trong tài khoản của bạn. Developer profile, đăng ký ứng dụng và thông tin xác thực phải thuộc doanh nghiệp của bạn; lập trình viên được thêm vào với tư cách user.
- Phân công rõ trách nhiệm theo dõi API sắp ngừng hỗ trợ. Hợp đồng phải nêu rõ ai theo dõi lịch ngừng hỗ trợ của Amazon và ai chuyển đổi hệ thống trước từng ngày gỡ bỏ.
- Có runbook. Tài liệu phải bao gồm throttling, feed thất bại hoặc issue của listing, thông tin xác thực hết hạn và cách cấp quyền lại.
- Điều khoản xử lý dữ liệu. Dữ liệu người mua được xử lý phù hợp với Data Protection Policy của Amazon và chỉ yêu cầu những role cần thiết cho công việc.
- Nghiệm thu bằng traffic thực tế. Các mốc thanh toán phải phụ thuộc vào việc đơn hàng hoặc listing thực sự đi qua production, không chỉ dựa trên bản demo sandbox.
Cách nhận báo giá có phạm vi rõ ràng cho hệ thống tích hợp Amazon
Để có thể so sánh các báo giá, hãy gửi cùng một bộ bốn thông tin cho mọi ứng viên: bạn đang bán trên những marketplace Amazon nào, muốn tự động hóa những luồng dữ liệu nào, dữ liệu cần được đưa đến hệ thống nào và liệu code hiện tại có chạy trên Orders v0 hoặc XML feed hay không. Bốn câu trả lời này quyết định phần lớn chi phí và rủi ro.
Nếu muốn Netalith xây dựng phạm vi cho dự án, hãy dùng biểu mẫu nhận báo giá miễn phí của Netalith và chọn dịch vụ tích hợp marketplace.
CÂU HỎI THƯỜNG GẶP
Câu hỏi thường gặp
Tôi có cần đăng ký developer để sử dụng Amazon SP-API cho cửa hàng của mình không?
Có. Bạn cần hoàn tất developer profile trong Amazon's Solution Provider Portal và đăng ký một ứng dụng. Với công ty của mình, bạn đăng ký dưới dạng private developer, và người dùng chính của tài khoản phải hoàn tất việc đăng ký. Amazon quyết định có cấp quyền hay không dựa trên hồ sơ, bao gồm chức năng của ứng dụng và mức độ tuân thủ Acceptable Use Policy cũng như Data Protection Policy.
Amazon có tính phí truy cập SP-API trong năm 2026 không?
Tính đến tháng 9 năm 2026 thì chưa. Amazon công bố phí developer vào tháng 11 năm 2025, sau đó thông báo với các developer vào ngày 12 tháng 5 năm 2026 rằng họ sẽ chưa triển khai phí sử dụng và phí hằng năm vào thời điểm hiện tại. Vì cách diễn đạt có cụm “vào thời điểm hiện tại”, hãy kiểm tra lại trang dành cho developer của Amazon trước khi ký hợp đồng dài hạn.
Private và public SP-API developer khác nhau thế nào?
Private developer xây dựng ứng dụng chỉ tích hợp công ty của họ với Amazon, và các ứng dụng này được tự cấp quyền. Public developer xây dựng ứng dụng cho những người bán khác; các ứng dụng này có giới hạn cấp quyền và khi yêu cầu những role bị giới hạn, cho phép truy cập PII, sẽ phải trải qua đánh giá kiến trúc với đội ngũ SP-API Solutions Architecture của Amazon.
Lập trình viên có thể dùng thông tin đăng nhập Seller Central của tôi không?
Nên tránh. Chỉ người dùng chính của tài khoản mới có thể hoàn tất đăng ký developer, nhưng Amazon cung cấp tính năng quản lý user trong Solution Provider Portal. Vì vậy, lập trình viên nên làm việc bằng user riêng thay vì dùng chung thông tin đăng nhập chính. Cách này cũng giúp thu hồi quyền truy cập khi kết thúc hợp tác.
SP-API có giống Amazon Ads API không?
Không. SP-API cung cấp dữ liệu của selling partner như listing, đơn hàng, tồn kho, báo cáo và tài chính. Chiến dịch quảng cáo được quản lý qua advertising API riêng của Amazon, với quy trình đăng ký riêng. Hãy xác nhận dự án của bạn cần API nào trước khi giao việc cho lập trình viên.
Ba câu hỏi nhanh nhất để kiểm tra một lập trình viên SP-API là gì?
Hãy hỏi họ sẽ xây dựng trên phiên bản Orders API nào (câu trả lời đúng là v2026-01-01, không phải v0), xử lý phản hồi throttling 429 ra sao (back-off và notification, không dùng bộ hẹn giờ cố định) và tạo listing như thế nào (Listings Items API hoặc feed dựa trên JSON, không phải XML feed đã bị Amazon gỡ bỏ).