# Tài liệu API Hàng hóa & Tích hợp OpenAPI | MerchandAise

- slug: developers-api-integrations
- locale: vi
- localeResolved: vi
- canonical: https://www.merchandaise.com/vi/developers/api-integrations

Khám phá MerchandAise tài liệu API và thông số kỹ thuật OpenAPI cho các sản phẩm tùy chỉnh, phần nhúng cộng đồng, quy trình làm việc của nhà cung cấp và bản sắc doanh nghiệp.

## Chọn kết nối mà dự án của bạn cần
Sử dụng các tài liệu tham khảo bên dưới để đánh giá điểm cuối, định dạng yêu cầu và yêu cầu ủy quyền. Thông số kỹ thuật công cộng hỗ trợ lập kế hoạch và tạo khách hàng; quyền truy cập hoạt động phụ thuộc vào API, tài khoản và môi trường.
Trong đó MerchandAise xử lý giao dịch của người mua thì Hutter Products GmbH là người bán theo hợp đồng và Người bán có hồ sơ dưới thương hiệu MerchandAise. Thông tin nhận dạng và thông tin liên hệ của nhà cung cấp được giữ kín trừ khi cần tiết lộ và việc sản xuất vẫn yêu cầu phê duyệt bằng chứng kỹ thuật số, khả năng sản xuất được xác nhận, kiểm tra kỹ thuật bắt buộc và phê duyệt mẫu áp dụng cho đơn hàng chính xác được chấp nhận.

## Bề mặt API và tích hợp
- **Tài liệu API & OpenAPI:** Tìm tài liệu tham khảo API cho các phiên thiết kế và công cụ trợ lý, sau đó chọn hợp đồng cộng đồng, nhà cung cấp hoặc doanh nghiệp cho quy trình làm việc của bạn. Hướng dẫn thực hiện: Đọc tài liệu công cụ trợ lý (/api/docs). Hợp đồng máy móc: Công cụ trợ lý OpenAPI JSON (/api/docs/openapi.json). Truy cập: công cộng. Tài liệu tham khảo công khai về API trợ lý và công cụ. Việc tiếp cận sản xuất và các hoạt động ảnh hưởng đến đơn hàng vẫn cần có giấy phép hiện hành. Trang chuẩn: /vi/developers/api-integrations. Phần kinh điển: /vi/developers/api-integrations#api-docs.
- **API cộng đồng:** Kết nối câu lạc bộ hoặc trang web cộng đồng với thông tin cộng đồng công khai, đệ trình thiết kế, bỏ phiếu và chuyển giao phê duyệt đơn hàng. Hợp đồng bao gồm những gì: Bối cảnh cộng đồng công khai, thiết kế bài đăng và phiếu bầu, công bố danh sách, lệnh chờ xử lý và sự chấp thuận hoặc từ chối của chủ sở hữu cộng đồng. Điểm khởi đầu thực tế: Đọc bối cảnh cộng đồng công cộng cho trang web câu lạc bộ. Sau đó, ánh xạ những hành động nào yêu cầu phiên thành viên hoặc quyền của chủ sở hữu trước khi thêm nội dung gửi thiết kế hoặc bàn giao kiểm tra. Truy cập: Thông số kỹ thuật được công khai. Các lần đọc công khai, hành động của thành viên và hoạt động chỉ dành cho chủ sở hữu có các yêu cầu ủy quyền khác nhau; sử dụng các quy tắc bảo mật trên mỗi điểm cuối. Hướng dẫn thực hiện: Khám phá API cộng đồng (/vi/developers/api-integrations#community-integrations). Hợp đồng máy móc: Cộng đồng OpenAPI JSON (/api/v1/community/public/openapi/v1). Truy cập: công cộng. Hợp đồng được phiên bản công khai để nhúng mặt tiền cửa hàng, khám phá cộng đồng và chuyển giao nhận thức về miền địa phương. Trang chuẩn: /vi/developers/api-integrations. Phần kinh điển: /vi/developers/api-integrations#community-integrations.
- **API nhà cung cấp:** Kết nối hệ thống nhà cung cấp đã được phê duyệt với các gói sản xuất đã phát hành, trạng thái triển khai và quy trình làm việc webhook ERP hoặc PLM. Hợp đồng bao gồm những gì: Trạng thái giới thiệu của nhà cung cấp, các gói sản xuất đã phát hành, nội dung tải xuống tạo phẩm đã được kiểm tra, số liệu phân tích, đăng ký webhook và điểm kiểm tra đồng bộ hóa. Điểm khởi đầu thực tế: Lập kế hoạch kết nối giữa ERP hoặc hệ thống quản lý vòng đời sản phẩm và Trung tâm nhà cung cấp. Xem lại tải trọng webhook, số lần thử lại và trạng thái đồng bộ hóa trước khi xử lý đơn hàng được chỉ định. Truy cập: Đọc đặc tả OpenAPI mà không cần đăng nhập. Các yêu cầu hoạt động yêu cầu phải có tài khoản và quyền phù hợp của nhà cung cấp; tài liệu công khai không đăng ký nhà cung cấp hoặc cấp quyền truy cập vào dữ liệu của nhà cung cấp khác. Hướng dẫn thực hiện: Khám phá API nhà cung cấp (/vi/developers/api-integrations#supplier-integrations). Hợp đồng máy móc: Nhà cung cấp OpenAPI JSON (/api/v1/supplier/openapi/v1). Truy cập: công cộng. Hợp đồng công khai về lập kế hoạch và tạo khách hàng. Quyền truy cập của nhà cung cấp hoạt động vẫn được cho phép. Trang chuẩn: /vi/developers/api-integrations. Phần kinh điển: /vi/developers/api-integrations#supplier-integrations.
- **API nhận dạng doanh nghiệp:** Kết nối không gian làm việc của công ty đã được phê duyệt với đăng nhập một lần, cấp phép người dùng và nhóm cũng như hồ sơ kiểm tra danh tính. Hợp đồng bao gồm những gì: Đăng nhập một lần OpenID Connect (OIDC), hoạt động trong vòng đời của nhóm và người dùng SCIM, xoay vòng mã thông báo SCIM và cung cấp các sự kiện kiểm tra. Điểm khởi đầu thực tế: Ánh xạ nhà cung cấp danh tính của bạn tới không gian làm việc được phê duyệt. Lập kế hoạch đăng nhập, cấp phép và hủy cung cấp người dùng, sau đó xác minh ánh xạ nhóm và hồ sơ kiểm tra trong môi trường thử nghiệm đã thống nhất. Truy cập: Đặc tả nhận dạng doanh nghiệp được bảo vệ. Hãy liên hệ với nhóm tích hợp để xem xét các yêu cầu về không gian làm việc và quyền truy cập trước khi triển khai. Danh tính doanh nghiệp là tùy chọn khi mua sản phẩm thông thường. Hướng dẫn thực hiện: Khám phá bản sắc doanh nghiệp (/vi/developers/api-integrations#enterprise-integrations). Hợp đồng máy móc: Nhận dạng doanh nghiệp OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Truy cập: Được bảo vệ. Hợp đồng được bảo vệ đối với không gian làm việc của doanh nghiệp đã được phê duyệt; yêu cầu quyền truy cập trước khi sử dụng điểm cuối này. Trang chuẩn: /vi/developers/api-integrations. Phần kinh điển: /vi/developers/api-integrations#enterprise-integrations.

## Chọn hợp đồng trước mã
- **Bước 1: Lập bản đồ hành trình của người dùng:** Quyết định ai tham gia quy trình làm việc và ở đâu: người mua trong mặt tiền cửa hàng được 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.
- **Bước 2: Xác nhận ranh giới truy cập:** Sử dụng hợp đồng công khai để đánh giá và tạo khách hàng, sau đó xác nhận thông tin xác thực, phạm vi, môi trường, lệnh gọi lại và điểm cuối được bảo vệ trước khi triển khai.
- **Bước 3: Chứng minh tính liên tục của trạng thái:** Kiểm tra xem các thiết kế, báo giá, phê duyệt, lỗi và chuyển giao đơn hàng có giữ nguyên phiên bản hiện tại trong quá trình tích hợp hay không, bao gồm cả số lần thử lại và đường dẫn khôi phục.

## Những gì mọi sự tích hợp phải bảo tồn
- **Một trạng thái được phiên bản:** Thiết kế, mục đích 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. Những thay đổi cũ phải kích hoạt trạng thái báo giá lại hoặc đánh giá rõ ràng.
- **Quyền riêng tư thương mại và nhà cung cấp:** MerchandAise vẫn là người bán và chủ sở hữu hỗ trợ đối mặt với người mua. Danh tính, địa chỉ liên hệ và dữ liệu nội bộ của nhà cung cấp không bị lộ thông qua tích hợp công khai.
- **Phê duyệt trước khi sản xuất:** Chế độ xem 3D không phải là bằng chứng vật lý. Báo giá được xác nhận giải thích mọi lựa chọn mẫu, chi phí, giới hạn và thời gian có sẵn của khách hàng. Phê duyệt bản duyệt kỹ thuật số chính xác và hoàn thành các bước kiểm tra kỹ thuật bắt buộc cũng như mọi phê duyệt mẫu được yêu cầu hoặc được chọn trước khi sản xuất hàng loạt. Các yêu cầu về đơn đặt hàng được chấp nhận hiện tại vẫn có tính ràng buộc.

## Trước khi sản xuất lưu thông
Tệp OpenAPI được xuất bản là một bề mặt lập kế hoạch, không phải là lời hứa về quyền truy cập sản xuất ẩn danh. Chúng tôi xem xét môi trường, thông tin xác thực, xử lý lỗi và quyền sở hữu hoạt động trước khi đưa vào hoạt động.
- **Quyền 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 được phê duyệt, phạm vi xác thực, hộp cát, thông tin xác thực sản xuất và đích gọi lại.
- **Thất bại và phục hồi:** Xác định số lần thử lại, tính tạm thời, thời gian chờ, lỗi mà khách hàng có thể nhìn thấy, 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 từ đầu đến cuối:** Xác minh hành trình dự định trong giai đoạn từ mục nhập và thay đổi trạng thái thông qua hành vi báo giá, phê duyệt, chuyển giao và khôi phục.

## FAQ
- **Tôi nên bắt đầu với API hàng hóa nào?:** Bắt đầu với quá trình chuyển đổi con người và trạng thái. Sử dụng nội dung nhúng cộng đồng cho các hành trình của 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 quy trình công việc bên cung cấp đã được phê duyệt, danh tính doanh nghiệp cho SSO và SCIM cũng như 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 có nghĩa là quyền tiếp cận sản xuất công cộng?:** Không. Hợp đồng OpenAPI công khai hỗ trợ khám phá, đánh giá kiến trúc và tạo ứng dụng khách. Thông tin xác thực sản xuất, hoạt động ghi, quy trình làm việc của nhà cung cấp, danh tính 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 trong phạm vi.
- **Việc tích hợp có thể làm lộ nhà cung cấp hoặc bỏ qua phê duyệt không?:** Không. Thông tin liên hệ và danh tính của nhà cung cấp vẫn được giữ kín trừ khi cần 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 duy trì các yêu cầu phê duyệt mẫu theo đơn đặt hàng, kỹ thuật và bằng chứng kỹ thuật số đã được định cấu hình.

## Lập kế hoạch tích hợp của bạn với chúng tôi.
Hãy cho chúng tôi biết ai sẽ sử dụng tiện ích tích hợp, họ cần đọc hoặc thay đổi trạng thái nào và trải nghiệm sẽ diễn ra ở đâu. Chúng tôi sẽ 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 với bạn.
- **Lập kế hoạch hội nhập:** /vi/contact?intent=api-integration-review
- **Khám phá các tác nhân AI và MCP:** /vi/developers/ai-agents-mcp
