Hướng dẫn nhanh API Nhà cung cấp: Tạo, Cập nhật, Xóa Sản phẩm và Xử lý Đơn hàng
Nhóm nhà cung cấp đồng bộ danh mục vào Accplanet cần một vòng lặp rõ ràng: tạo hoặc cập nhật sản phẩm, giữ tồn kho chính xác, hoàn tất đơn hàng, và xử lý hoàn tiền hoặc ticket khi có sự cố. Hướng dẫn nhanh này đi qua vòng lặp đó bằng tài liệu Supplier API trực tiếp.
Accplanet là một marketplace tổng hợp nhà cung cấp. Bạn thực hiện tồn kho; nền tảng xử lý việc tìm kiếm người mua, thanh toán, theo dõi và công cụ hỗ trợ. Chỉ sử dụng các endpoint này cho các thao tác danh mục và đơn hàng hợp pháp — không dùng để né tránh chính sách hoặc tự động hóa không an toàn.
Tóm tắt
- Xác thực bằng
X-API-Key,Authorization: Bearer, bodykey/apikey, hoặc phiên đăng nhập dashboard nhà cung cấp đang hoạt động. - Sản phẩm: tải ảnh lên → tạo → liệt kê/cập nhật → thêm tài khoản giao hàng tự động → chỉ xóa khi quy tắc cho phép.
- Đơn hàng: liệt kê → lấy chi tiết → cập nhật thông tin giao hàng / tệp đính kèm → thay đổi trạng thái → hoàn tiền khi phù hợp.
- Niêm yết mới có thể cần phê duyệt của quản trị viên trước khi hiển thị công khai.
- Giữ tài liệu chính thức mở để tra cứu đường dẫn chính xác và bảng tham số khi bạn viết mã.
Xác thực
Sử dụng khóa API nhà cung cấp từ hồ sơ của bạn. Các lệnh gọi JSON sản phẩm/đơn hàng thường gửi:
X-API-Key: YOUR_API_KEY
Content-Type: application/jsonXác thực phiên trình duyệt cũng hoạt động khi bạn đã đăng nhập vào dashboard nhà cung cấp — hữu ích với bảng Test API trong tài liệu.
Vòng đời sản phẩm
1 · Đầu tiên
Tải ảnh lên
POST /products/api/supplier/upload-image/ với tệp ảnh multipart. Lưu image_path trả về cho mảng images khi tạo/cập nhật.
2 · Tạo
Tạo sản phẩm (hoặc upsert theo URL nguồn)
POST /products/api/supplier/create/ yêu cầu category_id, title, description, price. Tùy chọn: stock, min_quantity, images, source_product_id, source_product_url, warranty_period_days, status, và nhóm giao hàng tự động qua accounts hoặc accounts_text.
Nếu source_product_url khớp với một sản phẩm cũ trong tài khoản của bạn, API có thể cập nhật sản phẩm đó thay vì tạo bản trùng lặp (cờ created/updated trong phản hồi). Theo dõi approval_status.
3 · Duy trì
Liệt kê, tra cứu, cập nhật
GET /products/api/supplier/products/— danh sách phân trang với bộ lọc tìm kiếm, danh mục, trạng thái, giá.GET /products/api/supplier/products/by-source-id/<source_product_id>/— đường dẫn nhanh để đồng bộ nóng theo ID nguồn.POST /products/api/supplier/products/<product_id>/update/— cập nhật tiêu đề, giá, tồn kho, ảnh, trường nguồn, trạng thái hoặc trường nhóm giao hàng.
Xác định sản phẩm bằng ID danh mục số hoặc product_id từ phản hồi danh sách. Người mua sau đó thấy ID danh mục dưới dạng giá trị service của Customer API khi được gán.
4 · Nhóm giao hàng
Thêm tài khoản giao hàng tự động
POST .../products/<product_id>/accounts/ thêm thông tin đăng nhập vào nhóm giao hàng tự động mà không ghi đè tồn kho niêm yết. Sử dụng đối tượng accounts có cấu trúc hoặc dòng accounts_text (user:pass / user|pass). Xử lý accounts_imported trả về cẩn thận — đây là thông tin bí mật.
5 · Xóa
Xóa khi được phép
POST .../products/<product_id>/delete/ xóa vĩnh viễn một sản phẩm chưa có giao dịch hoàn tất. Ưu tiên thay đổi trạng thái khi bạn chỉ cần ngừng bán.
| Trọng tâm endpoint | Đường dẫn phương thức (host accplanet.com) | Cách dùng điển hình |
|---|---|---|
| Tải ảnh lên | POST /products/api/supplier/upload-image/ |
Lấy image_path |
| Tạo | POST /products/api/supplier/create/ |
Niêm yết mới / upsert theo URL nguồn |
| Liệt kê | GET /products/api/supplier/products/ |
Đồng bộ trạng thái |
| Theo ID nguồn | GET .../by-source-id/<id>/ |
Đồng bộ nóng |
| Cập nhật | POST .../products/<id>/update/ |
Giá, tồn kho, nội dung |
| Thêm tài khoản | POST .../products/<id>/accounts/ |
Nhóm giao hàng tự động |
| Xóa | POST .../products/<id>/delete/ |
Xóa SKU không dùng |
Vòng đời đơn hàng
Sau khi người mua thanh toán, hoàn tất qua Orders API:
- Liệt kê —
GET /orders/api/supplier/orders/với tùy chọnstatus,search, phân trang. - Lấy chi tiết —
GET /orders/api/<order_id>/khi bạn cần một ảnh chụp đơn hàng. - Giao hàng —
POST .../orders/<order_id>/delivered/vớidelivered_info(văn bản thường hoặc chuỗi mảng JSON). Đặtappend_delivered_info=trueđể thêm dòng. Hoặc tải tệp lên qua.../delivery-attachment/(multipartfile, ≤10MB). - Trạng thái —
POST .../orders/<order_id>/status/với các giá trị được phép nhưpending_order,running_order,completed_order,refunded_order.receipt_confirmed_orderkhông thể đặt qua API. - Hoàn tiền —
POST .../orders/<order_id>/refund/để hoàn tiền toàn phần khi quy trình của bạn yêu cầu.
Theo dõi delivered_units, remaining_to_deliver và các trường thanh toán từ phản hồi liệt kê/lấy chi tiết để logic kho của bạn khớp với dashboard.
Nhóm giao hàng tự động
Nạp sẵn tài khoản trên sản phẩm; Accplanet có thể xếp hàng đợi tác vụ giao hàng.
delivered_info thủ công
Đẩy thông tin đăng nhập hoặc khóa theo từng đơn hàng khi hoàn tất được quản lý thủ công.
Tệp đính kèm
Tải lên một tệp hoàn tất duy nhất khi trường văn bản không đủ.
Ticket, thanh toán, số dư
- Ticket — liệt kê, lấy chi tiết, tạo (
order_id+ tiêu đề + mô tả), cập nhật trạng thái/phản hồi tại/orders/api/supplier/tickets/. - Thanh toán —
GET /orders/api/supplier/payments/để lấy bản ghi thanh toán cho các đơn hàng bạn cung cấp. - Số dư —
GET /users/api/balance/trả về số dư ví khách hàng và nhà cung cấp cho tài khoản đã xác thực.
Trạng thái phê duyệt, tồn kho và trạng thái đơn hàng tuân theo quy tắc trực tiếp của nền tảng. Xác nhận hành vi với tài liệu Supplier API hiện tại khi bạn triển khai đồng bộ sản xuất.
Danh sách kiểm tra nhà cung cấp
Bài viết liên quan
