Plateforme développeurs MerchandAise
Connectez votre parcours à MerchandAise.
Découvrez la documentation API et les spécifications OpenAPI pour les produits personnalisés. Reliez les sites, communautés, opérations fournisseurs ou comptes d’entreprise aux mêmes informations de design, de devis et de commande.
Choisissez la connexion adaptée à votre projet
Utilisez les références ci-dessous pour examiner les points d’accès, formats de requêtes et exigences d’autorisation. Les spécifications publiques aident à préparer l’intégration et à générer des clients ; l’accès opérationnel dépend de l’API, du compte et de l’environnement.
Lorsque MerchandAise traite la transaction de l’acheteur, Hutter Products GmbH est le vendeur contractuel et Merchant of Record sous la marque MerchandAise. L’identité et les coordonnées des fournisseurs restent privées, sauf divulgation obligatoire. La production nécessite toujours la validation du bon à tirer numérique, la confirmation de faisabilité, les contrôles techniques obligatoires et les validations d’échantillons applicables à la commande exacte acceptée.
01 — Contrats
API et interfaces d’intégration
01
Documentation API et OpenAPI
Consultez la référence API des outils pour assistants et sessions de design, puis choisissez le contrat communauté, fournisseur ou entreprise adapté à votre parcours.
Guide d’implémentation
Consulter la documentation des outils pour assistantsContrat pour les systèmes
OpenAPI des outils pour assistants · JSON/api/docs/openapi.jsonRéférence publique des API pour assistants et outils. L’accès en production et les opérations qui affectent une commande nécessitent toujours les autorisations applicables.
02
API communautés
Connectez le site d’un club ou d’une communauté aux informations publiques, propositions de design, votes et passages vers la validation des commandes.
- Ce que couvre le contrat
- Contexte public des communautés, publications de designs et votes, publication des annonces, commandes en attente et acceptation ou refus par le propriétaire de la communauté.
- Un point de départ concret
- Lisez le contexte public d’une communauté pour un site de club. Identifiez ensuite les actions qui nécessitent une session membre ou des droits propriétaire avant d’ajouter les propositions de design ou les passages à la commande.
- Accès
- La spécification est publique. Les lectures publiques, actions membres et opérations réservées au propriétaire ont des exigences d’autorisation différentes ; suivez les règles de sécurité de chaque point d’accès.
Contrat pour les systèmes
OpenAPI communautés · JSON/api/v1/community/public/openapi/v1Contrat public versionné pour les boutiques intégrées, la découverte de communautés et les passages entre pages avec la bonne langue.
03
API fournisseurs
Connectez les systèmes des fournisseurs agréés aux dossiers de production publiés, au statut d’intégration et aux parcours de webhooks ERP ou PLM.
- Ce que couvre le contrat
- État d’intégration fournisseur, dossiers de production publiés, téléchargements de fichiers audités, analyses, abonnements aux webhooks et points de contrôle de synchronisation.
- Un point de départ concret
- Préparez la connexion de votre ERP ou système de gestion du cycle de vie des produits au Supplier Center. Examinez les données des webhooks, les nouvelles tentatives et l’état de synchronisation avant de traiter une commande attribuée.
- Accès
- Consultez OpenAPI sans vous connecter. Les requêtes opérationnelles nécessitent le compte fournisseur et les droits adaptés ; la documentation publique n’inscrit pas un fournisseur et ne donne pas accès aux données d’un autre fournisseur.
Contrat pour les systèmes
OpenAPI fournisseurs · JSON/api/v1/supplier/openapi/v1Contrat public pour préparer l’intégration et générer des clients. L’accès aux opérations fournisseurs reste soumis à autorisation.
04
API identité d’entreprise
Connectez les espaces d’entreprise approuvés à l’authentification unique, au provisionnement des utilisateurs et groupes et aux journaux d’audit d’identité.
- Ce que couvre le contrat
- Authentification unique OpenID Connect (OIDC), gestion du cycle de vie des utilisateurs et groupes SCIM, rotation des jetons SCIM et événements d’audit du provisionnement.
- Un point de départ concret
- Associez votre fournisseur d’identité à l’espace approuvé. Préparez la connexion, le provisionnement et la suppression d’accès des utilisateurs, puis vérifiez les correspondances de groupes et les journaux d’audit dans l’environnement de test convenu.
- Accès
- La spécification d’identité d’entreprise est protégée. Contactez l’équipe intégrations pour examiner l’espace et les exigences d’accès avant l’implémentation. L’identité d’entreprise est facultative pour les achats ordinaires de produits.
Contrat pour les systèmes
OpenAPI identité d’entreprise · JSON/api/v1/enterprise/identity/openapi/v1Contrat protégé pour les espaces d’entreprise approuvés ; demandez l’accès avant d’utiliser ce point d’accès.
Préparer une intégration02 — Guide d’implémentation
Choisissez le contrat avant de coder
- 01
Définissez le parcours utilisateur
Déterminez qui entre dans le parcours et où : un acheteur dans une boutique intégrée, un fournisseur agréé, un utilisateur d’entreprise ou un assistant disposant d’une autorisation explicite.
- 02
Confirmez les règles d’accès
Utilisez les contrats publics pour l’évaluation et la génération de clients, puis confirmez les identifiants, portées d’accès, environnements, rappels et points d’accès protégés avant l’implémentation.
- 03
Vérifiez la continuité des informations
Testez que les designs, devis, validations, erreurs et passages à la commande conservent leur version actuelle dans toute l’intégration, y compris lors des nouvelles tentatives et retours arrière.
03 — Ce que chaque intégration doit préserver
Ce que chaque intégration doit préserver
Un même état versionné
Design, intention d’achat, devis étayé par le fournisseur, validation et statut de commande restent liés. Toute modification devenue obsolète doit déclencher un état visible de nouveau devis ou de révision.
Confidentialité commerciale et fournisseurs
MerchandAise reste l’interlocuteur commercial et le responsable de l’assistance de l’acheteur. Les intégrations publiques n’exposent pas les identités, coordonnées ni données internes des fournisseurs.
Validation avant la production
Une vue 3D ne constitue pas une preuve physique. Le devis confirmé précise les choix d’échantillons clients disponibles, leurs coûts, limites et délais. Approuvez le bon à tirer numérique exact et effectuez les contrôles techniques obligatoires ainsi que toute validation d’échantillon requise ou choisie avant la production en série. Les exigences d’une commande déjà acceptée restent obligatoires.
04
Avant d’activer le trafic de production
Un fichier OpenAPI publié aide à préparer l’intégration ; il ne promet pas un accès anonyme à la production. Nous examinons les environnements, identifiants, traitements des échecs et responsabilités opérationnelles avant le lancement.
Accès et environnements
Confirmez la version du contrat, l’espace approuvé, les portées d’authentification, l’environnement de test, les identifiants de production et les destinations des rappels.
Échecs et reprise
Définissez les nouvelles tentatives, l’idempotence, les délais d’expiration, les erreurs visibles par le client, le suivi opérationnel, les responsabilités d’assistance et les retours arrière avant la mise en service.
Vérification du parcours complet
Vérifiez le parcours prévu dans l’environnement de préparation, de l’entrée et des changements d’état jusqu’au devis, à la validation, au transfert et à la reprise après échec.
Questions fréquentes
Par quelle API de produits personnalisés commencer ?
Commencez par l’utilisateur et le changement d’état visé. Utilisez les communautés intégrées pour les parcours d’achat des clubs et communautés, les opérations fournisseurs pour les parcours autorisés côté production, l’identité d’entreprise pour SSO et SCIM, et les outils pour assistants uniquement pour les parcours IA explicitement autorisés.
Un contrat public donne-t-il accès à la production ?
Non. Un contrat OpenAPI public facilite la découverte, l’examen de l’architecture et la génération de clients. Les identifiants de production, opérations d’écriture, parcours fournisseurs, identité d’entreprise et actions des assistants peuvent toujours nécessiter un espace approuvé et une autorisation limitée au besoin.
Une intégration peut-elle exposer les fournisseurs ou contourner les validations ?
Non. L’identité et les coordonnées des fournisseurs restent privées, sauf divulgation obligatoire. MerchandAise gère la relation avec l’acheteur et les actions qui affectent une commande doivent préserver les exigences prévues de validation du bon à tirer numérique, de contrôles techniques et d’échantillons propres à la commande.
Préparons votre intégration ensemble.
Précisez qui utilisera l’intégration, quelles informations il faudra lire ou modifier et où se déroulera l’expérience. Nous définirons avec vous le contrat, le modèle d’accès et les étapes d’un lancement sûr.