Plataforma de programadores MerchandAise
Ligue o seu percurso à MerchandAise.
Encontre documentação API e especificações OpenAPI para percursos de merchandising personalizado. Ligue sites, comunidades, operações de fornecedores ou contas empresariais a informação partilhada de design, orçamento e encomenda.
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.
01 — Contratos
Interfaces de API e integração
01
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.
Guia de implementação
Leia a documentação de ferramentas de assistentesContrato para máquinas
OpenAPI das ferramentas de assistentes em JSON/api/docs/openapi.jsonReferê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.
02
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.
Contrato para máquinas
OpenAPI de comunidades em JSON/api/v1/community/public/openapi/v1Contrato público com versões para lojas incorporadas, descoberta de comunidades e passagens que preservam o idioma.
03
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.
Contrato para máquinas
OpenAPI de fornecedores em JSON/api/v1/supplier/openapi/v1Contrato público para planeamento e geração de clientes. O acesso operacional de fornecedores continua sujeito a permissões.
04
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.
Contrato para máquinas
OpenAPI de identidade empresarial em JSON/api/v1/enterprise/identity/openapi/v1Contrato protegido para espaços empresariais aprovados; peça acesso antes de usar este ponto de acesso.
Planeie uma integração02 — Guia de implementação
Escolha o contrato antes do código
- 01
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.
- 02
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.
- 03
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.
03 — O que cada integração deve preservar
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.
04
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.