Nền tảng nhà phát triển MerchandAise

Một quy trình sản phẩm. Bốn cách kết nối.

Kết nối trang web, cộng đồng, hoạt động của nhà cung cấp hoặc không gian làm việc của doanh nghiệp với cùng một trạng thái thiết kế, báo giá, phê duyệt và đơn hàng được quản lý phiên bản. Bắt đầu với hợp đồng đã công bố, sau đó cùng chúng tôi lập kế hoạch truy cập và triển khai sản xuất.

Duy trì một nguồn dữ liệu gốc duy nhất

Một tích hợp nên mở rộng quy trình làm việc của MerchandAise chứ không phải phân nhánh nó. Các giao diện trang web, nhúng, nhà cung cấp, doanh nghiệp và trợ lý trong tương lai phải đọc và cập nhật cùng một trạng thái thiết kế, ý định thương mại, báo giá, phê duyệt và đơn hàng được quản lý phiên bản.

Khi MerchandAise xử lý giao dịch của người mua, Hutter Products GmbH là bên bán ký kết hợp đồng và là Đơn vị ghi nhận giao dịch (Merchant of Record) dưới thương hiệu MerchandAise. Danh tính và thông tin liên hệ của nhà cung cấp được giữ kín trừ trường hợp bắt buộc phải tiết lộ, và việc sản xuất vẫn yêu cầu phê duyệt bản duyệt mẫu kỹ thuật số và mẫu thực tế.

01 — Hợp đồng

Các giao diện tích hợp và API

Tài liệu API công cụ trợ lý

Khám phá các điểm cuối của trợ lý và công cụ hiện tại cho các phiên thiết kế và đánh giá tích hợp. Tài liệu tham khảo công khai này không cấp quyền ẩn danh để báo giá hoặc đặt hàng.

Quyền truy cập: public

Hướng dẫn triển khai

Mở tài liệu công cụ trợ lý

Hợp đồng máy

Tệp JSON OpenAPI cho công cụ trợ lý

/api/docs/openapi.json

Tài liệu tham khảo công khai cho các API trợ lý và công cụ. Quyền truy cập sản xuất và các hoạt động ảnh hưởng đến đơn hàng vẫn yêu cầu ủy quyền tương ứng.

API nhúng cộng đồng

Kết nối các trải nghiệm câu lạc bộ, cộng đồng hoặc cửa hàng được bản địa hóa với các bước chuyển giao thiết kế và thương mại do MerchandAise sở hữu mà không cần xây dựng lại quy trình làm việc cơ bản.

Quyền truy cập: public

Hợp đồng máy

Tệp JSON OpenAPI cho cộng đồng

/api/v1/community/public/openapi/v1

Hợp đồng phiên bản công khai cho các phần nhúng cửa hàng, khám phá cộng đồng và chuyển giao nhận biết ngôn ngữ.

API nhà cung cấp

Kết nối các nhà cung cấp đã được phê duyệt với các hoạt động tiếp nhận, danh mục, báo giá và hoàn tất đơn hàng sau khi mối quan hệ nhà cung cấp và mô hình truy cập được xác minh.

Quyền truy cập: public

Hợp đồng máy

Tệp JSON OpenAPI cho nhà cung cấp

/api/v1/supplier/openapi/v1

Hợp đồng công khai để lập kế hoạch và tạo mã nguồn máy khách (client). Quyền truy cập hoạt động của nhà cung cấp vẫn cần được cấp phép.

API định danh doanh nghiệp

Lập kế hoạch SSO, cấp phát SCIM và các luồng định danh sẵn sàng cho kiểm toán cho các chương trình quà tặng công ty đã được phê duyệt và triển khai có kiểm soát.

Quyền truy cập: protected

Hợp đồng máy

Tệp JSON OpenAPI cho định danh doanh nghiệp

/api/v1/enterprise/identity/openapi/v1

Hợp đồng được bảo vệ cho các không gian làm việc doanh nghiệp đã được phê duyệt; vui lòng yêu cầu quyền truy cập trước khi sử dụng điểm cuối này.

02 — Hướng dẫn triển khai

Chọn hợp đồng trước khi viết mã

01
Bản đồ hóa hành trình người dùng
Quyết định ai sẽ tham gia vào quy trình làm việc và ở đâu: người mua trong cửa hàng nhúng, nhà cung cấp đã được phê duyệt, người dùng doanh nghiệp hoặc trợ lý hoạt động với sự ủy quyền rõ ràng.
02
Xác nhận ranh giới truy cập
Sử dụng các hợp đồng công khai để đánh giá và tạo mã nguồn máy khách, sau đó xác nhận thông tin đăng nhập, phạm vi (scope), môi trường, callback và các điểm cuối được bảo vệ trước khi triển khai.
03
Chứng minh tính liên tục của trạng thái
Kiểm tra để đảm bảo các thiết kế, báo giá, phê duyệt, lỗi và chuyển giao đơn hàng luôn duy trì đúng phiên bản hiện tại trong suốt quá trình tích hợp, bao gồm cả các đường dẫn thử lại và khôi phục (rollback).

03 — Những điều mọi tích hợp bắt buộc phải bảo toàn

Những điều mọi tích hợp bắt buộc phải bảo toàn

Một trạng thái được quản lý phiên bản duy nhất

Thiết kế, ý định thương mại, báo giá do nhà cung cấp hỗ trợ, phê duyệt và trạng thái đơn hàng luôn được kết nối. Các thay đổi cũ phải kích hoạt trạng thái báo giá lại hoặc xem xét rõ ràng.

Bảo mật thương mại và nhà cung cấp

MerchandAise vẫn là đơn vị bán hàng trực tiếp với người mua và là bên sở hữu dịch vụ hỗ trợ. Danh tính, thông tin liên hệ và dữ liệu nội bộ của nhà cung cấp không bị lộ qua các tích hợp công khai.

Phê duyệt trước khi sản xuất

Chế độ xem 3D gốc của sản phẩm và bản duyệt mẫu kỹ thuật số hỗ trợ việc ra quyết định, nhưng chúng không thay thế mẫu sản xuất thực tế bắt buộc phải có trước khi sản xuất hàng loạt.

Trước khi chạy lưu lượng sản xuất thực tế

Tệp OpenAPI được công bố là một giao diện lập kế hoạch, không phải là lời hứa cấp quyền truy cập sản xuất ẩn danh. Chúng tôi sẽ xem xét các môi trường, thông tin đăng nhập, xử lý lỗi và quyền sở hữu vận hành trước khi đưa vào hoạt động chính thức.

Truy cập và môi trường

Xác nhận phiên bản hợp đồng, không gian làm việc đã phê duyệt, phạm vi xác thực, môi trường thử nghiệm (sandbox), thông tin đăng nhập sản xuất và đích đến của callback.

Lỗi và phục hồi

Xác định các lượt thử lại, tính không đổi (idempotency), thời gian chờ (timeout), lỗi hiển thị cho khách hàng, khả năng quan sát, quyền sở hữu hỗ trợ và khôi phục trước khi phát hành.

Bằng chứng toàn trình (end-to-end)

Xác minh hành trình dự kiến trong môi trường staging từ điểm bắt đầu và thay đổi trạng thái cho đến báo giá, phê duyệt, chuyển giao và hành vi phục hồi.

FAQ

Tôi nên bắt đầu với giao diện tích hợp nào?

Hãy bắt đầu với đối tượng người dùng và sự chuyển đổi trạng thái. Sử dụng các phần nhúng cộng đồng cho hành trình câu lạc bộ hoặc cộng đồng hướng tới người mua, hoạt động của nhà cung cấp cho các quy trình phía cung ứng đã được phê duyệt, định danh doanh nghiệp cho SSO và SCIM, và công cụ trợ lý chỉ dành cho các luồng do AI dẫn dắt được ủy quyền rõ ràng.

Hợp đồng công khai có đồng nghĩa với quyền truy cập sản xuất công khai không?

Không. Hợp đồng OpenAPI công khai hỗ trợ việc tìm hiểu, đánh giá kiến trúc và tạo mã nguồn máy khách. Thông tin đăng nhập sản xuất, hoạt động ghi, quy trình làm việc của nhà cung cấp, định danh doanh nghiệp và việc thực thi trợ lý vẫn có thể yêu cầu không gian làm việc được phê duyệt và ủy quyền theo phạm vi.

Tích hợp có thể làm lộ thông tin nhà cung cấp hoặc bỏ qua các bước phê duyệt không?

Không. Danh tính và thông tin liên hệ của nhà cung cấp được giữ kín trừ trường hợp bắt buộc phải tiết lộ, MerchandAise sở hữu mối quan hệ với người mua, và các hành động ảnh hưởng đến đơn hàng phải bảo toàn các cổng phê duyệt và mẫu thực tế đã được cấu hình.

Hãy mang đến cho chúng tôi quy trình làm việc, không phải một kiến trúc đã hoàn thiện.

Hãy cho chúng tôi biết ai sẽ sử dụng tích hợp, trạng thái nào họ cần đọc hoặc thay đổi, và trải nghiệm đó sẽ nằm ở đâu. Chúng tôi sẽ cùng bạn thiết lập bản đồ hợp đồng, mô hình truy cập và lộ trình triển khai an toàn nhất.

Lập kế hoạch tích hợp Khám phá các tác nhân AI và MCP

Duy trì một nguồn dữ liệu gốc duy nhất

Các giao diện tích hợp và API

Tài liệu API công cụ trợ lý

API nhúng cộng đồng

API nhà cung cấp

API định danh doanh nghiệp

Chọn hợp đồng trước khi viết mã

Bản đồ hóa hành trình người dùng

Xác nhận ranh giới truy cập

Chứng minh tính liên tục của trạng thái

Những điều mọi tích hợp bắt buộc phải bảo toàn

Một trạng thái được quản lý phiên bản duy nhất

Bảo mật thương mại và nhà cung cấp

Phê duyệt trước khi sản xuất

Trước khi chạy lưu lượng sản xuất thực tế

Truy cập và môi trường

Lỗi và phục hồi

Bằng chứng toàn trình (end-to-end)

FAQ

Hãy mang đến cho chúng tôi quy trình làm việc, không phải một kiến trúc đã hoàn thiện.