{"pageKey":"Developers","slug":"developers-api-integrations","locale":"pt","localeResolved":"pt","fallbackApplied":false,"version":"developers-api-integrations@2026-07-21T09:39:17.914Z","lastModified":"2026-07-21T09:39:17.914Z","canonicalUrl":"https://www.merchandaise.com/pt/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"Contratos de API e integração de merchandising | MerchandAise","description":"Explore os contratos MerchandAise para ferramentas de assistentes, incorporações comunitárias, operações de fornecedores e identidade empresarial, com limites claros de acesso público e protegido.","sections":[{"heading":"Mantenha uma única fonte de verdade","paragraphs":["Uma integração deve estender o fluxo da MerchandAise, não bifurcá-lo. As superfícies de site, incorporação, fornecedor, empresa e futuros assistentes devem ler e atualizar o mesmo estado versionado de design, intenção comercial, orçamento, aprovação e encomenda.","Where MerchandAise processes the buyer transaction, Hutter Products GmbH is the contracting seller and Merchant of Record under the MerchandAise brand. Supplier identity and contact details stay private except where disclosure is required, and production still requires digital-proof approval, confirmed producibility, mandatory technical checks, and the sample approvals applicable to the exact accepted order."]},{"heading":"Superfícies de API e integração","items":[{"title":"Documentação da API de ferramentas de assistentes","description":"Explore os endpoints atuais de assistentes e ferramentas para sessões de design e revisão de integração. Esta referência pública não concede autoridade anónima para orçamentar ou efetuar uma encomenda. Human guide: Abrir docs de ferramentas de assistentes (/pt/developers/api-integrations). Machine-readable contract: OpenAPI JSON de ferramentas de assistentes (/api/docs/openapi.json). Acesso: Público. Referência pública para APIs de assistentes e ferramentas. O acesso de produção e as operações que afetam encomendas continuam a exigir a autorização aplicável. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs."},{"title":"API de incorporação comunitária","description":"Ligue experiências localizadas de clubes, comunidades ou montras às transferências de design e comércio geridas pela MerchandAise sem reconstruir o fluxo subjacente. Human guide: Rever guia de integração comunitária (/pt/developers/api-integrations#community-integrations). Machine-readable contract: OpenAPI JSON comunitário (/api/v1/community/public/openapi/v1). Acesso: Público. Contrato público versionado para incorporações em montras, descoberta comunitária e transferências sensíveis ao idioma. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations."},{"title":"API de fornecedores","description":"Ligue fornecedores aprovados a operações de integração, catálogo, orçamento e atendimento após a qualificação da relação de fornecedor e do modelo de acesso. Human guide: Rever guia de integração de fornecedores (/pt/developers/api-integrations#supplier-integrations). Machine-readable contract: OpenAPI JSON de fornecedor (/api/v1/supplier/openapi/v1). Acesso: Público. Contrato público para planeamento e geração de clientes. O acesso operacional de fornecedores permanece sujeito a permissões. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations."},{"title":"API de identidade empresarial","description":"Planeie fluxos de identidade SSO, provisionamento SCIM e prontos para auditoria para programas de merchandising empresarial aprovados e implementações governadas. Human guide: Rever guia de integração empresarial (/pt/developers/api-integrations#enterprise-integrations). Machine-readable contract: OpenAPI JSON de identidade empresarial (/api/v1/enterprise/identity/openapi/v1). Acesso: Protegido. Contrato protegido para espaços de trabalho empresariais aprovados; solicite acesso antes de utilizar este endpoint. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations."}]},{"heading":"Escolha o contrato antes do código","items":[{"title":"Step 1: Mapeie a jornada do utilizador","description":"Decida quem entra no fluxo e onde: um comprador numa montra incorporada, um fornecedor aprovado, um utilizador empresarial ou um assistente a operar com autorização explícita."},{"title":"Step 2: Confirme o limite de acesso","description":"Utilize contratos públicos para avaliação e geração de clientes, depois confirme as credenciais, âmbitos, ambientes, callbacks e endpoints protegidos antes da implementação."},{"title":"Step 3: Comprove a continuidade de estado","description":"Teste se os designs, orçamentos, aprovações, erros e transferências de encomendas se mantêm atualizados com a versão ao longo da integração, incluindo tentativas e caminhos de reversão."}]},{"heading":"O que cada integração deve preservar","items":[{"title":"Um estado versionado","description":"O design, a intenção comercial, o orçamento garantido pelo fornecedor, a aprovação e o estado da encomenda permanecem conectados. Alterações desatualizadas devem acionar um novo orçamento visível ou um estado de revisão."},{"title":"Privacidade comercial e de fornecedores","description":"A MerchandAise continua a ser a comerciante e responsável pelo apoio perante o comprador. As identidades, contactos e dados internos dos fornecedores não são expostos através de integrações públicas."},{"title":"Aprovação antes da produção","description":"A 3D view is not physical evidence. The confirmed quote explains any available customer-sample choices, costs, limitations, and timing. Approve the exact digital proof and complete mandatory technical checks and any required or selected sample approval before mass production. Existing accepted-order requirements remain binding."}]},{"heading":"Antes do tráfego de produção","paragraphs":["Um ficheiro OpenAPI publicado é uma superfície de planeamento, não uma promessa de acesso anónimo à produção. Analisamos ambientes, credenciais, tratamento de falhas e titularidade operacional antes do lançamento."],"items":[{"title":"Acesso e ambientes","description":"Confirme a versão do contrato, o espaço de trabalho aprovado, os âmbitos de autenticação, o sandbox, as credenciais de produção e os destinos de callback."},{"title":"Falha e recuperação","description":"Defina tentativas, idempotência, tempos limite, erros visíveis para o cliente, observabilidade, responsabilidade de suporte e reversão antes do lançamento."},{"title":"Evidência de ponta a ponta","description":"Verifique a jornada pretendida no ambiente de staging, desde a entrada e mutação de estado até ao orçamento, aprovação, transferência e comportamento de recuperação."}]},{"heading":"FAQ","items":[{"title":"Com que superfície de integração devo começar?","description":"Comece pela pessoa e pela transição de estado. Utilize incorporações comunitárias para jornadas de clubes ou comunidades orientadas para o comprador, operações de fornecedores para fluxos aprovados do lado da oferta, identidade empresarial para SSO e SCIM, e ferramentas de assistentes apenas para fluxos orientados por AI explicitamente autorizados."},{"title":"Um contrato público significa acesso público à produção?","description":"Não. Um contrato OpenAPI público apoia a descoberta, a revisão de arquitetura e a geração de clientes. As credenciais de produção, operações de escrita, fluxos de fornecedores, identidade empresarial e execução de assistentes ainda podem exigir um espaço de trabalho aprovado e autorização com âmbito definido."},{"title":"Pode uma integração expor fornecedores ou contornar aprovações?","description":"No. Supplier identity and contact details remain private except where disclosure is required, MerchandAise owns the buyer relationship, and order-affecting actions must preserve the configured digital-proof, technical, and order-specific sample approval requirements."}]},{"heading":"Traga-nos o fluxo de trabalho, não uma arquitetura acabada.","paragraphs":["Diga-nos quem vai utilizar a integração, que estado precisa de ler ou alterar e onde a experiência vai decorrer. Mapearemos o contrato, o modelo de acesso e o caminho de implementação mais seguro consigo."],"items":[{"title":"Planear integração","description":"/pt/contact?intent=api-integration-review"},{"title":"Explorar agentes AI e MCP","description":"/pt/developers/ai-agents-mcp"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}