Visão geral do fluxo de pedidos

Independentemente de como os pedidos são enviados, todos seguem o mesmo fluxo principal dentro do GelatoConnect:

1. Envio do pedido

Os pedidos podem entrar no sistema por diversos canais:

Envio via API: Os pedidos são enviados por meio de solicitações POST. O sistema valida o formato da solicitação e retorna um ID de pedido.
Envio pela vitrine: Os pedidos feitos por plataformas de e-commerce conectadas são importados automaticamente.
Envio por FTP: Os arquivos dos pedidos são enviados e verificados em intervalos regulares, depois transformados em pedidos.
Envio Direto pela Plataforma: Integrações (por exemplo, Cloudprinter, Redbubble) enviam pedidos formatados diretamente para o GelatoConnect.

2. Validação e processamento iniciais

Assim que recebidos, os pedidos passam pelas seguintes etapas:

Validação de Dados: Verifica a integridade, formatação, referências de clientes e UIDs de produtos.
Validação do Arquivo para impressão: Os URLs dos arquivos são verificados e os arquivos passam por uma checagem de compatibilidade, resolução, dimensões e incorporação de fontes.
Validação de regras de negócios: Inclui verificações sobre restrições de envio, disponibilidade, quantidades e exigências para vendas internacionais.

Transições de status do pedido

Os pedidos no GelatoConnect passam por vários status ao longo do seu ciclo de vida:

Status Iniciais

Rascunho: O pedido está salvo, mas não foi enviado.
Recebido: Pedido enviado para o GelatoConnect.
Aprovado: O pedido passou por todas as validações.
Falha: O pedido não passou na validação.
Criado: O pedido foi validado e está pronto para a produção.

Status de produção

Em Produção: O pedido está sendo produzido.
Impresso: A produção do pedido está concluída.
Embalado: O pedido está embalado e pronto para envio.

Status de envio

Enviado: O pedido saiu da instalação.
Em Trânsito: Pedido está a caminho.
Entregue: O pedido foi entregue ao cliente.
Devolvido: O pedido foi devolvido.

Status de erro

Falha: Falha na validação ou no processamento.
Cancelado: O pedido foi cancelado.

Eventos e notificações

Eventos do sistema: Todas as alterações de status são registradas internamente.
Notificações externas: Os clientes são avisados por postbacks, e-mails e eventos de Webhook.
Atualizações de Status da API: O status pode ser obtido através das APIs de Obter Pedido e Pesquisar Pedidos.

Motivos e soluções comuns para falhas de pedidos

O GelatoConnect fornece motivos específicos de falha para ajudar a resolver problemas.

"Não conectado"

O que significa: O produto nas Vitrines não está vinculado a uma especificação do GelatoConnect.
Solução:

Acesse Storefronts, encontre o produto e clique em Conectar produto.
Faça o upload dos arquivos de design, se necessário.
Conclua a conexão e envie o pedido novamente.

"Entrega não disponível"

O que isso significa: A transportadora não consegue entregar no endereço informado.
Solução:

Valide o endereço e o país de destino compatível.
Considere métodos de envio alternativos.
Em pedidos via API, utilize métodos de envio separados por vírgula em shipmentMethodUid.

Falhas no download de arquivos

O que significa: Não é possível acessar os URLs dos arquivos para impressão.
Solução:

Certifique-se de que as URLs sejam públicas e válidas.
Formate URLs corretamente para serviços como Dropbox, Google Drive ou OneDrive.

Problemas de formato e qualidade do arquivo

O que isso significa: Os arquivos não atendem às especificações de produção.
Solução:

Use a resolução correta (geralmente 300 DPI).
Incluir sangria (normalmente 3mm).
Use cores CMYK e incorpore todas as fontes.

Identificação de produto inválida

O que significa: UID do Produto inválido ou não reconhecido ou Produto do Cliente.
Solução:

Verifique exatamente o productUid, o productName e o productVariant.
Use pesquisas para combinar códigos de produtos.

Preços de varejo ausentes (pedidos internacionais)

O que significa: Dados de preços alfandegários estão faltando.
Solução:

Inclua retailCurrency, retailShippingPriceInclVat e items[i].retailPriceInclVat na solicitação da API.

Falhas de Autenticação da API

O que isso significa: As credenciais da API são inválidas.
Solução:

Verifique sua chave e segredo.
Garanta o formato adequado nos cabeçalhos.
Use HTTPS.

Processo de solução de problemas para pedidos não concluídos

Verifique o status e o motivo da falha
Acesse Fluxo de trabalho > Recebimento de pedidos > Gerenciar pedidos, abra o pedido com falha e veja o motivo da falha.
Revisar solicitações de API (se aplicável)
Em Fluxo de Trabalho > Entrada de Pedidos > Solicitações, verifique os detalhes de solicitação/resposta do pedido.
Aplique a correção adequada
Use as orientações acima para resolver o problema.
Reenviar o Pedido
Uma vez corrigido, reenvie ou crie um novo pedido.
Monitore com Postbacks
Configure postbacks para receber atualizações de status em tempo real e reduzir o tempo de resolução de problemas.

Monitoramento e Gerenciamento de Pedidos

O GelatoConnect oferece várias ferramentas pra ajudar você a gerenciar seus pedidos de forma eficiente:

Página de Solicitações: Visualize pedidos recebidos e filtre por status.
Gestão de pedidos: Encontre pedidos e realize ações como cancelar ou reprocessar.
Análise de Dados de Pedidos: Acompanhe o volume de pedidos, taxas de falha e tendências.

Quer saber mais?

Para aprimorar ainda mais sua compreensão e garantir operações tranquilas:

Revise a Documentação do Fluxo de Pedidos para uma análise detalhada de cada etapa.
Explore Endpoints da API de Pedidos para integrações baseadas em API.
Use Template Mappers se os seus dados precisarem de transformação.

[Entrada de Pedidos - GCW] Fluxos e Status de Pedidos - Como Funciona