Saltar para o conteúdo principal

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.

Acesso: Público/api/docs/openapi.json

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.

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.
Acesso: Público

Contrato para máquinas

OpenAPI de comunidades em JSON
/api/v1/community/public/openapi/v1

Contrato 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.
Acesso: Público

Contrato para máquinas

OpenAPI de fornecedores em JSON
/api/v1/supplier/openapi/v1

Contrato 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.
Acesso: Protegido

Contrato para máquinas

OpenAPI de identidade empresarial em JSON
/api/v1/enterprise/identity/openapi/v1

Contrato protegido para espaços empresariais aprovados; peça acesso antes de usar este ponto de acesso.

Planeie uma integração

02 — Guia de implementação

Escolha o contrato antes do código

  1. 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.

  2. 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.

  3. 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.

01

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.

02

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.

03

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.