Overview
Este artigo explica como criar Produtos do Cliente na Gelato e usá-los ao fazer pedidos pela API da Gelato. Os Produtos do Cliente permitem personalizar as configurações dos produtos para diferentes clientes, conectando os requisitos específicos de formato de dados de cada um a um Modelo de Produto padrão.
Um modelo de produto define seu produto internamente (por exemplo, suas partes, atributos e atributos derivados), enquanto um produto para cliente permite que você personalize como os clientes enviam dados e interagem com seu produto ao fazerem pedidos.
Passos para criar produtos personalizados para clientes
1. Configure o modelo de produto
Antes de criar um Produto do Cliente, certifique-se de que já existe um Modelo de Produto configurado. Por exemplo, imagine que o Modelo de Produto se chama Poster Product e tem 9 atributos e vários atributos derivados. (Veja o guia "Criando um Modelo de Produto" para mais detalhes.)
2. Criando o Produto do Cliente
Um produto do cliente é uma versão personalizada do seu modelo de produto, adaptada às preferências do seu cliente para envio de dados (por exemplo, tamanho, cor etc.). Veja como configurar um produto do cliente:
Passo 1: Acesse a seção Produtos do cliente.
Passo 2: Selecione o modelo de produto (por exemplo, Pôsteres) e dê um nome ao produto do seu cliente. Esse nome é fundamental, pois será utilizado ao fazer um pedido pela API.
Por exemplo, vamos chamar este produto de Pôster SP para o cliente Sandbox Customer.
Nota: O nome do produto do cliente pode ser usado diretamente nas solicitações de pedidos enviadas através da API da Gelato.
Passo 3: Configure Atributos Base e Variantes:
Atributos base são atributos fixos que permanecem iguais em todas as variantes do produto.
Variantes representam as opções personalizáveis, como tamanho, cor ou tipo de papel, que o cliente pode escolher.
3. Definindo atributos básicos
Os atributos base têm um único valor fixo para todas as variantes. Por exemplo:
Orientação: Sempre vertical
Revestimento: Sem revestimento
Esses atributos básicos não mudam de um produto personalizado para outro.
4. Definindo variantes
Variantes são as opções de produto que seu cliente pode selecionar, como tamanho e cor. Veja como configurá-las:
Passo 1: Adicione as opções do cliente (por exemplo, tamanho e cor) e vincule-as aos atributos do modelo do produto.
Exemplo: O cliente deseja enviar atributos denominados Tamanho, Tipo de Papel e Cor.
Passo 2: Relacione os valores fornecidos pelo cliente aos atributos internos do modelo de produto:
Cor: O cliente pode chamar a opção de cor de "Preto e Branco" para impressões em preto e branco e "Colorido" para impressões coloridas. Dá pra mapear essas opções para os valores internos da Gelato: "1/1" para preto e branco e "4/4" para colorido.
Tamanho: O cliente pode enviar as dimensões em polegadas, enquanto você precisa converter esses valores para o sistema métrico interno (por exemplo, 20x28 polegadas = 508x711 mm).
Passo 3: Defina um valor padrão para os atributos, se necessário. Por exemplo:
Se o cliente não informar uma opção de cor, você pode definir o padrão como Colorido (4/4).
Passo 4: Configure vários valores de opção:
Você pode mapear vários valores do cliente para um único valor interno. Por exemplo, um cliente pode usar "Black White" ou "BW" para indicar a mesma impressão em preto e branco, e você pode mapear ambos para o seu valor interno "1/1".
5. Salvando o Produto do Cliente
Depois que todos os atributos e variantes estiverem configurados, salve o Produto do Cliente. Agora você tem um Produto do Cliente vinculado ao Modelo de Produto interno, o que permite receber e processar pedidos no formato preferido do cliente.
Como fazer um pedido pela API usando produtos personalizados
Depois que o produto do cliente estiver configurado, o cliente poderá fazer pedidos pela API da Gelato. Veja como funciona:
1. A estrutura da solicitação da API
Ao fazer um pedido, o nome do produto personalizado do cliente (por exemplo, Pôster SP) será utilizado na solicitação da API junto com as opções selecionadas. Veja um exemplo de solicitação de API:
{ \"items\": [ { "productName": "Pôster SP", "productVariant": { \"color\": \"preto-branco\", "paper-size": "20x28 polegadas" } } ]}
Neste exemplo:
O productName está definido como Poster SP.
O productVariant inclui os valores das opções de variante selecionadas, como \"preto-branco\" para cor e \"20x28 polegadas\" para tamanho do papel.
2. Gerenciando vários produtos de clientes
Você pode configurar diferentes produtos do cliente para diferentes clientes, cada um vinculado ao mesmo modelo de produto, mas com configurações diferentes. Por exemplo:
O cliente A pode enviar "tamanho do papel" e "cor" como opções.
O cliente B pode enviar "tipo de papel" e "tamanho" em vez disso.
Apesar dessas diferenças, ambos os produtos do cliente apontarão para o mesmo Product UID interno no sistema da Gelato, garantindo processos de produção consistentes nos bastidores.
3. Compatibilidade com versões anteriores
O sistema da Gelato oferece compatibilidade com fluxos de trabalho existentes, o que significa que você pode continuar usando UIDs de Produto de configurações mais antigas enquanto adota novas configurações de produtos do cliente no configurador de fluxo.