# Documentação API e integrações OpenAPI | MerchandAise

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

Explore documentação API e especificações OpenAPI da MerchandAise para merchandising personalizado, comunidades incorporadas, percursos de fornecedores e identidade empresarial.

## Escolha a ligação de que o projeto precisa
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.

## Interfaces de API e integração
- **Documentação API e OpenAPI:** 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.
- **API de comunidades:** 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.
- **API de fornecedores:** 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.
- **API de identidade empresarial:** 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.

## Escolha o contrato antes do código
- **Step 1: Mapeie o percurso do utilizador:** 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.
- **Step 2: Confirme o limite de acesso:** 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.
- **Step 3: Comprove a continuidade do estado:** 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.

## O que cada integração deve preservar
- **Um estado com versões:** 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.
- **Privacidade comercial e de fornecedores:** 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.
- **Aprovação antes da produção:** 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.

## Antes do tráfego de produção
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.
- **Acesso e ambientes:** 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.
- **Falha e recuperação:** 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.
- **Provas do percurso completo:** 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.

## Perguntas frequentes
- **Por que API de merchandising devo começar?:** 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.
- **Um contrato público implica acesso público de produção?:** 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.
- **Uma integração pode expor fornecedores ou contornar aprovações?:** 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.

## Planeie a integração connosco.
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.
- **Planeie uma integração:** /pt/contact?intent=api-integration-review
- **Explore agentes de IA e MCP:** /pt/developers/ai-agents-mcp
