{"pageKey":"Developers","slug":"developers-api-integrations","locale":"pt","localeResolved":"pt","fallbackApplied":false,"version":"developers-api-integrations@2026-11-21T00:04:57.595Z","lastModified":null,"canonicalUrl":"https://www.merchandaise.com/pt/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"Documentação API e integrações OpenAPI | MerchandAise","description":"Explore documentação API e especificações OpenAPI da MerchandAise para merchandising personalizado, comunidades incorporadas, percursos de fornecedores e identidade empresarial.","sections":[{"heading":"Escolha a ligação de que o projeto precisa","paragraphs":["Use as referências abaixo para avaliar pontos de acesso, formatos de pedido e requisitos de autorização. As especificações públicas apoiam o planeamento e a geração de clientes; o acesso operacional depende da API, da conta e do ambiente.","Quando a MerchandAise processa a transação do comprador, a Hutter Products GmbH é o vendedor contratante e responsável pela transação sob a marca MerchandAise. A identidade e os contactos dos fornecedores permanecem privados, exceto quando a divulgação é obrigatória. A produção continua a exigir aprovação da prova digital, viabilidade de produção confirmada, verificações técnicas obrigatórias e as aprovações de amostra aplicáveis à encomenda exata aceite."]},{"heading":"Interfaces de API e integração","items":[{"title":"Documentação API e OpenAPI","description":"Encontre a referência API para ferramentas de assistentes e sessões de design. Depois, escolha o contrato de comunidade, fornecedor ou empresa para o seu percurso. Human guide: Leia a documentação de ferramentas de assistentes (/api/docs). Machine-readable contract: OpenAPI das ferramentas de assistentes em JSON (/api/docs/openapi.json). Acesso: Público. Referência pública para API 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: /pt/developers/api-integrations. Canonical section: /pt/developers/api-integrations#api-docs."},{"title":"API de comunidades","description":"Ligue o site de um clube ou comunidade a informação pública da comunidade, envio de designs, votação e passagens para aprovação de encomendas. O que abrange o contrato: Contexto público de comunidades, publicações de designs e votos, publicação de listagens, encomendas pendentes e aprovação ou rejeição pelo proprietário da comunidade. Um ponto de partida prático: Leia o contexto público de uma comunidade para o site de um clube. Depois, identifique as ações que exigem uma sessão de membro ou permissões de proprietário antes de adicionar envios de designs ou passagens para finalizar compras. Acesso: A especificação é pública. As leituras públicas, as ações de membros e as operações exclusivas de proprietários têm requisitos de autorização diferentes; siga as regras de segurança de cada ponto de acesso. Human guide: Explore a API de comunidades (/pt/developers/api-integrations#community-integrations). Machine-readable contract: OpenAPI de comunidades em JSON (/api/v1/community/public/openapi/v1). Acesso: Público. Contrato público com versões para lojas incorporadas, descoberta de comunidades e passagens que preservam o idioma. Canonical page: /pt/developers/api-integrations. Canonical section: /pt/developers/api-integrations#community-integrations."},{"title":"API de fornecedores","description":"Ligue sistemas de fornecedores aprovados a pacotes de produção disponibilizados, estado de adesão e percursos de webhooks ERP ou PLM. O que abrange o contrato: Estado de adesão de fornecedores, pacotes de produção disponibilizados, transferências auditadas de ficheiros, análises, subscrições de webhooks e pontos de controlo de sincronização. Um ponto de partida prático: Planeie uma ligação entre o seu ERP ou sistema de gestão do ciclo de vida de produto e o Centro de fornecedores. Analise os dados dos webhooks, as novas tentativas e o estado de sincronização antes de tratar uma encomenda atribuída. Acesso: Leia a especificação OpenAPI sem iniciar sessão. Os pedidos operacionais exigem a conta e permissões de fornecedor adequadas; a documentação pública não inscreve um fornecedor nem dá acesso aos dados de outro fornecedor. Human guide: Explore a API de fornecedores (/pt/developers/api-integrations#supplier-integrations). Machine-readable contract: OpenAPI de fornecedores em JSON (/api/v1/supplier/openapi/v1). Acesso: Público. Contrato público para planeamento e geração de clientes. O acesso operacional de fornecedores continua sujeito a permissões. Canonical page: /pt/developers/api-integrations. Canonical section: /pt/developers/api-integrations#supplier-integrations."},{"title":"API de identidade empresarial","description":"Ligue espaços empresariais aprovados ao início de sessão único, ao aprovisionamento de utilizadores e grupos e aos registos de auditoria de identidade. O que abrange o contrato: Início de sessão único OpenID Connect (OIDC), operações de ciclo de vida de utilizadores e grupos SCIM, rotação de tokens SCIM e eventos de auditoria de aprovisionamento. Um ponto de partida prático: Associe o fornecedor de identidade ao espaço aprovado. Planeie o início de sessão, o aprovisionamento e a remoção de utilizadores. Depois, verifique as associações de grupos e os registos de auditoria no ambiente de teste acordado. Acesso: A especificação de identidade empresarial é protegida. Contacte a equipa de integrações para analisar o espaço e os requisitos de acesso antes da implementação. A identidade empresarial é opcional para compras habituais de produtos. Human guide: Explore a identidade empresarial (/pt/developers/api-integrations#enterprise-integrations). Machine-readable contract: OpenAPI de identidade empresarial em JSON (/api/v1/enterprise/identity/openapi/v1). Acesso: Protegido. Contrato protegido para espaços empresariais aprovados; peça acesso antes de usar este ponto de acesso. Canonical page: /pt/developers/api-integrations. Canonical section: /pt/developers/api-integrations#enterprise-integrations."}]},{"heading":"Escolha o contrato antes do código","items":[{"title":"Step 1: Mapeie o percurso do utilizador","description":"Defina quem entra no percurso e onde: um comprador numa loja incorporada, um fornecedor aprovado, um utilizador empresarial ou um assistente com autorização explícita."},{"title":"Step 2: Confirme o limite de acesso","description":"Use contratos públicos para avaliação e geração de clientes. Depois, confirme as credenciais, os âmbitos, os ambientes, os callbacks e os pontos de acesso protegidos antes da implementação."},{"title":"Step 3: Comprove a continuidade do estado","description":"Teste se os designs, orçamentos, aprovações, erros e passagens de encomendas se mantêm atualizados na integração, incluindo novas tentativas e percursos de reversão."}]},{"heading":"O que cada integração deve preservar","items":[{"title":"Um estado com versões","description":"O design, a intenção de compra, o orçamento confirmado pelo fornecedor, a aprovação e o estado da encomenda permanecem ligados. Alterações desatualizadas devem gerar visivelmente um novo orçamento ou estado de análise."},{"title":"Privacidade comercial e de fornecedores","description":"A MerchandAise continua a ser o vendedor perante o comprador e o responsável pelo apoio. 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":"Uma vista 3D não é uma prova física. O orçamento confirmado explica as opções de amostra disponíveis para o cliente, os custos, as limitações e os prazos. Aprove a prova digital exata e conclua as verificações técnicas obrigatórias e qualquer aprovação de amostra exigida ou selecionada antes da produção em série. Os requisitos de encomendas já aceites continuam a ser vinculativos."}]},{"heading":"Antes do tráfego de produção","paragraphs":["Um ficheiro OpenAPI publicado é uma interface de planeamento, não uma promessa de acesso anónimo de produção. Analisamos os ambientes, as credenciais, o tratamento de falhas e a responsabilidade operacional antes do lançamento."],"items":[{"title":"Acesso e ambientes","description":"Confirme a versão do contrato, o espaço aprovado, os âmbitos de autenticação, o ambiente de teste, as credenciais de produção e os destinos de callback."},{"title":"Falha e recuperação","description":"Defina novas tentativas, idempotência, limites de tempo, erros visíveis para o cliente, observabilidade, responsabilidade de apoio e reversão antes do lançamento."},{"title":"Provas do percurso completo","description":"Verifique o percurso previsto em pré-produção, desde a entrada e alteração de estado ao orçamento, aprovação, passagem e comportamento de recuperação."}]},{"heading":"Perguntas frequentes","items":[{"title":"Por que API de merchandising devo começar?","description":"Comece pela pessoa e pela transição de estado. Use comunidades incorporadas para percursos de compradores em clubes ou comunidades, operações de fornecedores para percursos aprovados de produção, identidade empresarial para SSO e SCIM e ferramentas de assistentes apenas para percursos de IA explicitamente autorizados."},{"title":"Um contrato público implica acesso público de produção?","description":"Não. Um contrato OpenAPI público apoia a descoberta, a análise de arquitetura e a geração de clientes. As credenciais de produção, operações de escrita, percursos de fornecedores, identidade empresarial e execução por assistentes podem continuar a exigir um espaço aprovado e autorização limitada ao âmbito adequado."},{"title":"Uma integração pode expor fornecedores ou contornar aprovações?","description":"Não. A identidade e os contactos dos fornecedores permanecem privados, exceto quando a divulgação é obrigatória. A MerchandAise gere a relação com o comprador, e as ações que afetam encomendas devem preservar os requisitos configurados de prova digital, verificações técnicas e aprovações de amostra específicas da encomenda."}]},{"heading":"Planeie a integração connosco.","paragraphs":["Diga-nos quem irá usar a integração, que estado precisa de ler ou alterar e onde estará a experiência. Mapeamos consigo o contrato, o modelo de acesso e o percurso de lançamento mais seguro."],"items":[{"title":"Planeie uma integração","description":"/pt/contact?intent=api-integration-review"},{"title":"Explore agentes de IA e MCP","description":"/pt/developers/ai-agents-mcp"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"route-owned-source","schema":"2025-11-05"}}