{"pageKey":"Developers","slug":"developers-api-integrations","locale":"es","localeResolved":"es","fallbackApplied":false,"version":"developers-api-integrations@2026-07-21T09:39:17.914Z","lastModified":"2026-07-21T09:39:17.914Z","canonicalUrl":"https://www.merchandaise.com/es/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"Contratos de integración y API de merchandise | MerchandAise","description":"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.","sections":[{"heading":"Mantén una única fuente de verdad","paragraphs":["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."]},{"heading":"Interfaces de integración y API","items":[{"title":"Documentación API de herramientas de asistencia","description":"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."},{"title":"Complemento comunitario API","description":"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."},{"title":"API de proveedores","description":"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."},{"title":"Identidad empresarial API","description":"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."}]},{"heading":"Elige el contrato antes que el código","items":[{"title":"Step 1: Mapea el recorrido del usuario","description":"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."},{"title":"Step 2: Confirma el límite de acceso","description":"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."},{"title":"Step 3: Demuestra la continuidad del estado","description":"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."}]},{"heading":"Lo que toda integración debe preservar","items":[{"title":"Un estado versionado","description":"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."},{"title":"Privacidad comercial y de proveedores","description":"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."},{"title":"Aprobación previa a la producción","description":"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."}]},{"heading":"Antes del tráfico de producción","paragraphs":["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."],"items":[{"title":"Acceso y entornos","description":"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."},{"title":"Fallos y recuperación","description":"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."},{"title":"Evidencia de extremo a extremo","description":"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."}]},{"heading":"Preguntas frecuentes","items":[{"title":"¿Con qué interfaz de integración debo empezar?","description":"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."},{"title":"¿Significa un contrato público acceso público a producción?","description":"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."},{"title":"¿Puede una integración exponer a los proveedores o saltarse las aprobaciones?","description":"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."}]},{"heading":" Tráenos el flujo de trabajo, no una arquitectura terminada.","paragraphs":["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."],"items":[{"title":"Planificar una integración","description":"/es/contact?intent=api-integration-review"},{"title":"Explorar agentes y MCP de AI","description":"/es/developers/ai-agents-mcp"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}