Saltar al contenido principal

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.

Acceso: Público/api/docs/openapi.json

Referencia 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.
Acceso: Público

Contrato para máquinas

OpenAPI de comunidades en JSON
/api/v1/community/public/openapi/v1

Contrato 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.
Acceso: Público

Contrato para máquinas

OpenAPI de proveedores en JSON
/api/v1/supplier/openapi/v1

Contrato 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.
Acceso: Protegido

Contrato para máquinas

OpenAPI de identidad empresarial en JSON
/api/v1/enterprise/identity/openapi/v1

Contrato protegido para espacios empresariales aprobados. Solicita acceso antes de utilizar este endpoint.

Planificar una integración

02 — Guía de implementación

Elige el contrato antes que el código

  1. 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.

  2. 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.

  3. 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.

01

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.

02

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.

03

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.