Bem-vindo ao guia de integração do Gelato Connect com o Cloudprinter. Esta integração permite uma comunicação perfeita entre as duas plataformas, possibilitando que você receba pedidos do Cloudprinter e os processe de forma eficiente através do GelatoConnect. Siga estes passos simples para configurar a integração e começar a gerenciar pedidos do Cloudprinter em minutos ou horas (em vez de meses)
Há 3 etapas para receber e processar pedidos do Cloudprinter com o GelatoConnect:
Configure a integração de API para permitir a comunicação.
Adicione o catálogo de produtos da Cloudprinter ao GelatoConnect.
Configure fluxos de trabalho de produção para um processamento sem complicações.
Etapa 1: Integração de API
O primeiro passo é conectar os sistemas via API. Assim, os pedidos e atualizações podem ser trocados entre GelatoConnect e Cloudprinter sem obstáculos.
Crie as interfaces de Produção e Sinais no Cloudprinter:
Na sua conta Cloudprinter, crie uma interface de produção chamada "GelatoConnect API - Dev": selecione o modelo "Sua própria API". No campo Host, basta informar "www.gelato.com", e no campo de endereços IP, informe "184.169.223.162". Configure o restante conforme as instruções de ajuda da Cloudprinter. Defina esta configuração para ficar em "modo de teste" e com baixa prioridade, assim os pedidos reais não começarão a passar por essa conexão.
Na sua conta Cloudprinter, crie uma interface de sinais chamada "GelatoConnect Signals - Dev". Defina como baixa prioridade, pois será usada apenas para testes.
Criar Cliente "Cloudprinter" no GelatoConnect:
Faça login no GelatoConnect.
Acesse a seção Clientes no menu à esquerda.
Clique em Criar cliente e nomeie o cliente como Cloudprinter.
Selecione Aplicar Predefinição para Cloudprinter para carregar as configurações automaticamente.
No pop-up exibido, copie e cole as chaves de API das interfaces de Produção e Sinais que você criou no Cloudprinter na etapa 1.
Autorizar comunicação:
O GelatoConnect vai gerar um host de endpoint assim que você inserir as chaves de API no pop-up.
Copie este endpoint e cole-o no campo "Host" da Interface de produção (substituindo o nome de host fictício "www.gelato.com" que você adicionou na etapa 1).
Crie o mapeamento do método de envio:
Crie uma tabela de consulta no GelatoConnect para mapear os métodos de envio do Cloudprinter para os métodos de envio do Gelato. Use as instruções aqui e o arquivo Excel anexo para fazer o mapeamento
Dentro do seu modelo de envio de pedidos, pode ser necessário substituir a seguinte linha na parte inferior do modelo:
\"shipmentMethodUid\": ##{{ order.shipping.method|js }},com:
"shipmentMethodUid": ##{{ lookups({"alias": order.shipping.method}, strict=False, default="")|js }},onde "alias" faz referência ao campo de modelo definido como ##{{alias}} em sua pesquisa.
Uma vez concluído, os sistemas são sincronizados. Os endpoints de API necessários para tarefas como enviar e atualizar pedidos são pré-configurados, garantindo comunicação automática.
Etapa 2: configurando produtos Cloudprinter
Em seguida, você vai importar o catálogo de produtos da Cloudprinter para o GelatoConnect.
1. Acesse os modelos de produtos:
Acesse a seção Produtos no menu à esquerda e clique em Modelos de produtos.
Clique em Adicionar do Catálogo > Adicionar do Cliente e selecione Cloudprinter.
2. Baixe os arquivos de referência do Cloudprinter:
Em uma nova aba, faça login na sua conta Cloudprinter.
Navegue até Catálogo de produtos > Referências para download.
Baixe os dois arquivos necessários: Referência de produtos e Referência de opções.
3. Faça o upload dos arquivos de referência no GelatoConnect:
Arraste e solte os arquivos baixados na área de upload no GelatoConnect.
O GelatoConnect exibirá todos os produtos para os quais a sua conta Cloudprinter está configurada.
4. Selecione as categorias de produtos:
Revise a lista de produtos (ela variará dependendo da sua conta Cloudprinter).
Escolha as categorias que você planeja produzir (por exemplo, papel timbrado, brochuras, etc.).
5. Relacione os tipos de papel:
Selecione os tipos de papel adequados para cada produto.
Se você tem acordos especiais com a Cloudprinter para estoque personalizado, pode ajustar o mapeamento aqui.
Caso contrário, recomendamos usar os mapeamentos padrão.
6. Gere produtos e variantes:
Clique em Continuar para gerar os modelos de produtos selecionados.
O GelatoConnect criará automaticamente produtos com atributos mapeados e UIDs internos de produto para a produção.
Depois de concluído, você pode visualizar o produto criado e inspecionar detalhes como mapeamento de papel, opções de acabamento e UIDs do produto.
Etapa 3: configurando fluxos de trabalho de produção
Por fim, configure ou atualize os fluxos de trabalho para combinar com as suas capacidades de produção.
Acesse a configuração de produção:
Use a ferramenta de Configuração de Produção no GelatoConnect para definir as etapas de produção (por exemplo, impressão, laminação, encadernação) para cada categoria de produto (por exemplo, cartões de visita, livros com costura).
Certifique-se de que todos os formatos do Cloudprinter tenham uma configuração de produção definida e ativa
Para orientações detalhadas e um vídeo sobre como configurar a produção, consulte a etapa correspondente no guia de integração aqui.
Etapa 4: Ative os pedidos ao vivo do Cloudprinter
Crie pedidos de teste pelo Test Center da Cloudprinter ou entre em contato diretamente com a equipe da Cloudprinter. Verifique o recebimento do pedido e do arquivo para garantir que tudo esteja pronto para a produção.
Enviar tabelas de taxas de envio para a Cloudprinter
Solicite o arquivo editável da tabela de preços da Cloudprinter ao seu Gerente de Implementação do GelatoConnect
Preencha e envie suas taxas de envio atualizadas para a Cloudprinter no início da integração (e anualmente após alterações nas taxas da transportadora).
Informe a equipe da Cloudprinter sobre o processo de teste e obtenha o consentimento deles para transferir pedidos ativos para o GelatoConnect.
Mude para receber pedidos em tempo real no GelatoConnect:
Crie uma nova interface de produção chamada "GelatoConnect API - Prod". Use os mesmos parâmetros da conexão "GelatoConnect API - Dev" feita anteriormente, mas selecione a prioridade mais alta e o "Modo ao vivo" para receber os pedidos em tempo real.
Altere todas as interfaces de produção anteriores para o "Modo de teste" para que os pedidos não sejam mais direcionados para lá.
Crie uma nova interface Signals chamada "GelatoConnect Signals - Prod". Use os mesmos parâmetros da conexão "GelatoConnect Signals - Dev" criada anteriormente, mas defina a prioridade mais alta para utilizá-la em pedidos ao vivo.