# Contratos de integración y API de merchandise | MerchandAise

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

Explora los contratos de MerchandAise para herramientas de asistencia, integraciones comunitarias, operaciones de proveedores y gestión de identidad empresarial, con límites claros de acceso público y protegido.

## Mantén una única fuente de verdad
Una integración debe ampliar el flujo de trabajo de MerchandAise, no bifurcarlo. Las interfaces de sitios web, complementos, proveedores, empresas y futuros asistentes deben leer y actualizar el mismo estado versionado de diseño, intención comercial, presupuesto, aprobación y pedido.
Donde MerchandAise procesa la transacción del comprador, Hutter Products GmbH actúa como el vendedor contratante y comerciante registrador bajo la marca MerchandAise. La identidad y los datos de contacto de los proveedores se mantienen en privado, excepto cuando la normativa exija su divulgación, y la producción sigue requiriendo la aprobación de una muestra digital y una muestra física real.

## Interfaces de integración y API
- **Documentación API de herramientas de asistencia:** Explora los endpoints actuales de asistencia y herramientas para sesiones de diseño y revisión de integración. Esta referencia pública no otorga autoridad anónima para presupuestar ni realizar pedidos. Human guide: Abrir documentación de herramientas de asistencia (/es/developers/api-integrations). Machine-readable contract: OpenAPI de herramientas de asistencia JSON (/api/docs/openapi.json). Access: public. Referencia pública para API de asistencia y herramientas. El acceso de producción y las operaciones que afectan a pedidos siguen requiriendo la autorización correspondiente. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs.
- **Complemento comunitario API:** Conecta experiencias localizadas de clubes, comunidades o tiendas a procesos de diseño y comercio gestionados por MerchandAise sin necesidad de reconstruir el flujo de trabajo subyacente. Human guide: Revisar guía de integración comunitaria (/es/developers/api-integrations#community-integrations). Machine-readable contract: OpenAPI comunitario JSON (/api/v1/community/public/openapi/v1). Access: public. Contrato público versionado para complementos de tiendas, descubrimiento de comunidades y transiciones adaptadas al idioma. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations.
- **API de proveedores:** Conecta a proveedores aprobados con las operaciones de incorporación, catálogo, presupuestos y gestión de pedidos una vez que se hayan validado la relación con el proveedor y el modelo de acceso. Human guide: Revisar guía de integración de proveedores (/es/developers/api-integrations#supplier-integrations). Machine-readable contract: OpenAPI de proveedores JSON (/api/v1/supplier/openapi/v1). Access: public. Contrato público para la planificación y generación de clientes. El acceso operativo de proveedores sigue sujeto a permisos. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations.
- **Identidad empresarial API:** Planifica SSO, el aprovisionamiento de SCIM y flujos de identidad listos para auditorías destinados a programas de merchandise corporativo aprobados y despliegues controlados. Human guide: Revisar guía de integración empresarial (/es/developers/api-integrations#enterprise-integrations). Machine-readable contract: OpenAPI de identidad empresarial JSON (/api/v1/enterprise/identity/openapi/v1). Access: protected. Contrato protegido para espacios de trabajo empresariales aprobados; solicita acceso antes de utilizar este endpoint. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations.

## Elige el contrato antes que el código
- **Step 1: Mapea el recorrido del usuario:** Decide quién entra en el flujo de trabajo y por dónde: un comprador en una tienda integrada, un proveedor aprobado, un usuario empresarial o un asistente que opera con autorización explícita.
- **Step 2: Confirma el límite de acceso:** Utiliza contratos públicos para la evaluación y generación de clientes; a continuación, confirma las credenciales, los ámbitos, los entornos, las devoluciones de llamada y los endpoints protegidos antes de la implementación.
- **Step 3: Demuestra la continuidad del estado:** Comprueba que los diseños, presupuestos, aprobaciones, errores y transferencias de pedidos mantengan la versión actual en toda la integración, incluidos los reintentos y las rutas de reversión.

## Lo que toda integración debe preservar
- **Un estado versionado:** El diseño, la intención comercial, el presupuesto respaldado por el proveedor, la aprobación y el estado del pedido permanecen conectados. Los cambios obsoletos deben activar un nuevo presupuesto visible o un estado de revisión.
- **Privacidad comercial y de proveedores:** MerchandAise sigue siendo el comerciante y responsable de soporte cara al comprador. Las identidades de los proveedores, los contactos y los datos internos no se exponen a través de integraciones públicas.
- **Aprobación previa a la producción:** Una vista de 3D nativa del producto y una prueba digital respaldan la decisión, pero no reemplazan la muestra de producción real requerida antes de la fabricación en masa.

## Antes del tráfico de producción
Un archivo OpenAPI publicado es una superficie de planificación, no una promesa de acceso de producción anónimo. Revisamos los entornos, las credenciales, la gestión de fallos y la titularidad operativa antes del lanzamiento.
- **Acceso y entornos:** Confirma la versión del contrato, el espacio de trabajo aprobado, los ámbitos de autenticación, el entorno de pruebas, las credenciales de producción y los destinos de devolución de llamada.
- **Fallos y recuperación:** Define los reintentos, la idempotencia, los tiempos de espera, los errores visibles para el cliente, la observabilidad, la responsabilidad de soporte y la reversión antes del lanzamiento.
- **Evidencia de extremo a extremo:** Verifica el recorrido previsto en el entorno de pruebas, desde la entrada y la mutación de estados hasta el presupuesto, la aprobación, la transferencia y el comportamiento de recuperación.

## Preguntas frecuentes
- **¿Con qué interfaz de integración debo empezar?:** Comienza por la persona y la transición de estado. Utiliza complementos comunitarios para recorridos de clubes o comunidades orientados al comprador, operaciones de proveedores para flujos de trabajo aprobados del lado de la cadena de suministro, identidad empresarial para SSO y SCIM, y herramientas de asistencia exclusivamente para flujos dirigidos por AI con autorización explícita.
- **¿Significa un contrato público acceso público a producción?:** No. Un contrato OpenAPI público sirve para el descubrimiento, la revisión de arquitectura y la generación de clientes. Las credenciales de producción, las operaciones de escritura, los flujos de trabajo de proveedores, la identidad empresarial y la ejecución de asistentes pueden requerir igualmente un espacio de trabajo aprobado y una autorización delimitada.
- **¿Puede una integración exponer a los proveedores o saltarse las aprobaciones?:** No. La identidad y los datos de contacto de los proveedores se mantienen en privado, excepto cuando la normativa exija su divulgación; MerchandAise gestiona la relación con el comprador, y las acciones que afecten a los pedidos deben preservar la aprobación configurada y los controles de muestras reales.

## Tráenos el flujo de trabajo, no una arquitectura terminada.
Indícanos quién utilizará la integración, qué estado necesitan leer o modificar y dónde vivirá la experiencia. Mapearemos contigo el contrato, el modelo de acceso y la ruta de despliegue más segura.
- **Planificar una integración:** /es/contact?intent=api-integration-review
- **Explorar agentes y MCP de AI:** /es/developers/ai-agents-mcp