{"pageKey":"Developers","slug":"developers-api-integrations","locale":"vi","localeResolved":"vi","fallbackApplied":false,"version":"developers-api-integrations@2026-07-21T09:39:17.914Z","lastModified":"2026-07-21T09:39:17.914Z","canonicalUrl":"https://www.merchandaise.com/vi/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"Hợp đồng tích hợp & API quà tặng doanh nghiệp | MerchandAise","description":"Khám phá các hợp đồng MerchandAise dành cho công cụ trợ lý, nhúng cộng đồng, hoạt động của nhà cung cấp và định danh doanh nghiệp, với ranh giới truy cập công khai và được bảo vệ rõ ràng.","sections":[{"heading":"Duy trì một nguồn dữ liệu gốc duy nhất","paragraphs":["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ế."]},{"heading":"Các giao diện tích hợp và API","items":[{"title":"Tài liệu API công cụ trợ lý","description":"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. Human guide: Mở tài liệu công cụ trợ lý (/vi/developers/api-integrations). Machine-readable contract: Tệp JSON OpenAPI cho công cụ trợ lý (/api/docs/openapi.json). Access: public. 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. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs."},{"title":"API nhúng cộng đồng","description":"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. Human guide: Xem hướng dẫn tích hợp cộng đồng (/vi/developers/api-integrations#community-integrations). Machine-readable contract: Tệp JSON OpenAPI cho cộng đồng (/api/v1/community/public/openapi/v1). Access: public. 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ữ. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations."},{"title":"API nhà cung cấp","description":"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. Human guide: Xem hướng dẫn tích hợp nhà cung cấp (/vi/developers/api-integrations#supplier-integrations). Machine-readable contract: Tệp JSON OpenAPI cho nhà cung cấp (/api/v1/supplier/openapi/v1). Access: public. 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. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations."},{"title":"API định danh doanh nghiệp","description":"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. Human guide: Xem hướng dẫn tích hợp doanh nghiệp (/vi/developers/api-integrations#enterprise-integrations). Machine-readable contract: Tệp JSON OpenAPI cho định danh doanh nghiệp (/api/v1/enterprise/identity/openapi/v1). Access: protected. 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. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations."}]},{"heading":"Chọn hợp đồng trước khi viết mã","items":[{"title":"Step 1: Bản đồ hóa hành trình người dùng","description":"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."},{"title":"Step 2: Xác nhận ranh giới truy cập","description":"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."},{"title":"Step 3: Chứng minh tính liên tục của trạng thái","description":"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)."}]},{"heading":"Những điều mọi tích hợp bắt buộc phải bảo toàn","items":[{"title":"Một trạng thái được quản lý phiên bản duy nhất","description":"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."},{"title":"Bảo mật thương mại và nhà cung cấp","description":"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."},{"title":"Phê duyệt trước khi sản xuất","description":"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."}]},{"heading":"Trước khi chạy lưu lượng sản xuất thực tế","paragraphs":["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."],"items":[{"title":"Truy cập và môi trường","description":"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."},{"title":"Lỗi và phục hồi","description":"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."},{"title":"Bằng chứng toàn trình (end-to-end)","description":"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."}]},{"heading":"FAQ","items":[{"title":"Tôi nên bắt đầu với giao diện tích hợp nào?","description":"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."},{"title":"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?","description":"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."},{"title":"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?","description":"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."}]},{"heading":"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.","paragraphs":["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."],"items":[{"title":"Lập kế hoạch tích hợp","description":"/vi/contact?intent=api-integration-review"},{"title":"Khám phá các tác nhân AI và MCP","description":"/vi/developers/ai-agents-mcp"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}