Plataforma de desarrolladores de MerchandAise
Conecta tu proceso con MerchandAise.
Encuentra documentación API y especificaciones OpenAPI para procesos de merchandising personalizado. Conecta webs, comunidades, operaciones de proveedores o cuentas de empresa con información compartida de diseños, presupuestos y pedidos.
Elige la conexión que necesita tu proyecto
Utiliza las referencias de abajo para evaluar endpoints, formatos de solicitudes y requisitos de autorización. Las especificaciones públicas permiten planificar y generar clientes. El acceso operativo depende de la API, la cuenta y el entorno.
Cuando MerchandAise procesa la transacción del comprador, Hutter Products GmbH es el vendedor contratante y el Merchant of Record bajo la marca MerchandAise. La identidad y los contactos del proveedor permanecen privados salvo cuando sea obligatoria su divulgación. La producción sigue requiriendo la aprobación de la prueba digital, la confirmación de la viabilidad, las comprobaciones técnicas obligatorias y las aprobaciones de muestras aplicables al pedido exacto aceptado.
01 — Contratos
Interfaces API y de integración
01
Documentación API y OpenAPI
Encuentra la referencia API para herramientas de asistentes y sesiones de diseño. Después, elige el contrato de comunidad, proveedor o empresa para tu proceso.
Guía de implementación
Leer documentación de herramientas para asistentesContrato para máquinas
OpenAPI de herramientas para asistentes en JSON/api/docs/openapi.jsonReferencia pública para API de asistentes y herramientas. El acceso a producción y las operaciones que afectan a pedidos siguen requiriendo la autorización aplicable.
02
API de comunidades
Conecta la web de un club o comunidad con información pública de la comunidad, envío de diseños, votaciones y procesos de aprobación de pedidos.
- Qué cubre el contrato
- Contexto público de comunidades, publicaciones de diseños y votos, publicación de artículos, pedidos pendientes y aprobación o rechazo por parte del propietario de la comunidad.
- Un punto de partida práctico
- Consulta el contexto público de una comunidad para una web de club. Después, identifica qué acciones necesitan una sesión de miembro o permisos de propietario antes de añadir envíos de diseños o accesos a la compra.
- Acceso
- La especificación es pública. Las consultas públicas, las acciones de miembros y las operaciones exclusivas del propietario tienen requisitos de autorización distintos. Utiliza las reglas de seguridad de cada endpoint.
Contrato para máquinas
OpenAPI de comunidades en JSON/api/v1/community/public/openapi/v1Contrato público versionado para tiendas integradas, descubrimiento de comunidades y transiciones entre páginas adaptadas al idioma.
03
API de proveedores
Conecta los sistemas de proveedores aprobados con paquetes de producción publicados, el estado de incorporación y procesos de webhooks de ERP o PLM.
- Qué cubre el contrato
- Estado de incorporación del proveedor, paquetes de producción publicados, descargas auditadas de archivos, analítica, suscripciones a webhooks y puntos de control de sincronización.
- Un punto de partida práctico
- Planifica la conexión entre tu ERP o sistema de gestión del ciclo de vida del producto y el Centro de proveedores. Revisa los datos de webhooks, los reintentos y el estado de sincronización antes de gestionar un pedido asignado.
- Acceso
- Lee la especificación OpenAPI sin iniciar sesión. Las solicitudes operativas requieren una cuenta de proveedor y los permisos adecuados. La documentación pública no da de alta a un proveedor ni concede acceso a los datos de otro.
Contrato para máquinas
OpenAPI de proveedores en JSON/api/v1/supplier/openapi/v1Contrato público para planificar y generar clientes. El acceso operativo de proveedores sigue sujeto a permisos.
04
API de identidad empresarial
Conecta los espacios empresariales aprobados con el inicio de sesión único, el aprovisionamiento de usuarios y grupos y los registros de auditoría de identidad.
- Qué cubre el contrato
- Inicio de sesión único con OpenID Connect (OIDC), operaciones de ciclo de vida de usuarios y grupos con SCIM, rotación de tokens SCIM y eventos de auditoría de aprovisionamiento.
- Un punto de partida práctico
- Conecta tu proveedor de identidad con el espacio aprobado. Planifica el inicio de sesión, las altas y bajas de usuarios y verifica después las correspondencias de grupos y los registros de auditoría en el entorno de pruebas acordado.
- Acceso
- La especificación de identidad empresarial está protegida. Contacta con el equipo de integraciones para revisar el espacio y los requisitos de acceso antes de implementar. La identidad empresarial es opcional para las compras habituales de productos.
Contrato para máquinas
OpenAPI de identidad empresarial en JSON/api/v1/enterprise/identity/openapi/v1Contrato protegido para espacios empresariales aprobados. Solicita acceso antes de utilizar este endpoint.
Planificar una integración02 — Guía de implementación
Elige el contrato antes que el código
- 01
Define el recorrido del usuario
Decide quién entra en el proceso y dónde: un comprador en una tienda integrada, un proveedor aprobado, un usuario empresarial o un asistente con autorización explícita.
- 02
Confirma el límite de acceso
Utiliza contratos públicos para evaluar y generar clientes. Después, confirma las credenciales, los ámbitos de acceso, los entornos, callbacks y endpoints protegidos antes de implementar.
- 03
Demuestra la continuidad del estado
Comprueba que diseños, presupuestos, aprobaciones, errores y traspasos de pedidos mantienen sus versiones actualizadas durante la integración, incluidos los reintentos y la reversión.
03 — Qué debe conservar toda integración
Qué debe conservar toda integración
Un único estado versionado
El diseño, la intención de compra, el presupuesto respaldado por el proveedor, la aprobación y el estado del pedido permanecen conectados. Los cambios obsoletos deben activar una nueva cotización o un estado de revisión visible.
Privacidad comercial y del proveedor
MerchandAise sigue siendo el vendedor y el responsable de soporte para el comprador. Las identidades, contactos y datos internos de los proveedores no se muestran mediante integraciones públicas.
Aprobación antes de la producción
Una vista en 3D no es una prueba física. El presupuesto confirmado explica las opciones de muestras para el cliente disponibles, sus costes, limitaciones y plazos. Aprueba la prueba digital exacta y completa las comprobaciones técnicas obligatorias y las aprobaciones de muestras necesarias o elegidas antes de la producción en serie. Los requisitos ya aceptados del pedido siguen siendo vinculantes.
04
Antes del tráfico de producción
Un archivo OpenAPI publicado es una herramienta de planificación, no una promesa de acceso anónimo a producción. Revisamos los entornos, las credenciales, la gestión de errores y las responsabilidades operativas antes de la puesta en marcha.
Acceso y entornos
Confirma la versión del contrato, el espacio aprobado, los ámbitos de autenticación, el entorno de pruebas, las credenciales de producción y los destinos de callbacks.
Errores y recuperación
Define reintentos, idempotencia, tiempos de espera, errores visibles para el cliente, observabilidad, responsabilidades de soporte y reversión antes del lanzamiento.
Pruebas de principio a fin
Verifica el recorrido previsto en preproducción desde la entrada y los cambios de estado hasta el presupuesto, la aprobación, el traspaso y la recuperación.
Preguntas frecuentes
¿Por qué API de merchandising debería empezar?
Empieza por la persona y el cambio de estado. Utiliza comunidades integradas para los recorridos de compradores de clubes o comunidades, operaciones de proveedores para procesos aprobados de suministro, identidad empresarial para SSO y SCIM y herramientas para asistentes solo en procesos de IA autorizados explícitamente.
¿Un contrato público implica acceso público a producción?
No. Un contrato OpenAPI público permite el descubrimiento, la revisión de arquitectura y la generación de clientes. Las credenciales de producción, operaciones de escritura, procesos de proveedores, identidad empresarial y ejecución de asistentes pueden seguir requiriendo un espacio aprobado y una autorización limitada.
¿Una integración puede mostrar proveedores o saltarse las aprobaciones?
No. La identidad y los contactos del proveedor permanecen privados salvo cuando sea obligatoria su divulgación. MerchandAise gestiona la relación con el comprador y las acciones que afectan a pedidos deben conservar los requisitos configurados de prueba digital, comprobaciones técnicas y aprobación de muestras específicos del pedido.
Planifica tu integración con nosotros.
Cuéntanos quién utilizará la integración, qué estado necesita leer o cambiar y dónde estará la experiencia. Definiremos contigo el contrato, el modelo de acceso y la forma más segura de ponerla en marcha.