Introdução

Este guia explica a terminologia essencial e os conceitos que você vai encontrar ao trabalhar com os sistemas de order intake da GelatoConnect. Entender esses termos vai ajudar você a navegar pela plataforma com mais facilidade e a se comunicar de forma mais clara sobre os processos de gestão de pedidos.

Conceitos Fundamentais de Pedidos

Pedido

Um pedido é uma solicitação para que um ou mais produtos sejam produzidos e enviados para um endereço específico. O pedido é a unidade fundamental de trabalho no GelatoConnect.

ID de referência do pedido

Seu identificador exclusivo para um pedido. Isso deve corresponder a um ID de pedido no seu sistema e permite que você acompanhe a relação entre os pedidos do GelatoConnect e seus sistemas internos.

ID de referência do cliente

Seu identificador exclusivo para o cliente que está fazendo o pedido. Isso ajuda a vincular os pedidos a clientes específicos em seu sistema.

Tipo de Pedido

Define como um pedido deve ser processado. Os dois tipos principais são:

Pedido: Um pedido padrão que será processado imediatamente
Rascunho: Um pedido salvo para edição e envio futuros

Order Status

Indica a etapa atual de um pedido no processo de Atendimento de Pedidos. Os principais status incluem:

Rascunho: Pedido criado, mas não enviado para processamento
Recebido: Pedido enviado e em validação inicial
Aprovado: O pedido passou nas verificações de validação
Falhou: O pedido não passou nas verificações de validação
Criado: Pedido validado e pronto para produção
Em produção: O pedido está sendo processado
Impresso: a produção foi concluída
Embalado: O pedido está embalado e pronto para envio
Enviado: O pedido foi entregue à transportadora
Entregue: O pedido foi entregue ao destinatário
Cancelado: Pedido foi cancelado por solicitação ou pelo sistema

Item do pedido

Um produto individual dentro de um pedido. Cada item possui suas próprias especificações, quantidades e arquivos. Vários itens podem ser incluídos em um único pedido.

ID de Referência do Item

Seu identificador exclusivo para um item específico dentro de um pedido. Isso ajuda a rastrear produtos individuais dentro de um pedido maior.

Métodos de identificação de produtos

UID do produto

Um identificador exclusivo para uma configuração específica de produto no sistema GelatoConnect. Os UIDs de produto seguem um formato estruturado que codifica os atributos do produto.

Exemplo: flat_product_pf_a4_pt_200-g/m² (Gramatura)-não revestido_cl_4-0_ct_none_prt_none_sft_none_set_none_hor

Este identificador contém informações codificadas sobre:

Tipo de produto (flat_product)
Formato do papel (pf_a4)
Tipo de papel (pt_200-g/m² (Gramatura)-não revestido)
Configuração de cor (cl_4-0 significa 4 cores na frente, 0 cores no verso)
Outras especificações (corte, impressão, etc.)
Orientação (hor para horizontal)

Produto do Cliente

Uma forma simplificada de identificar produtos usando uma estrutura de nome de produto e variante. Essa abordagem é mais legível para humanos e mais fácil de gerenciar para catálogos de produtos complexos.

Exemplo:

{"productName": "Cartão de visita","productVariant": {\"Tamanho\": \"Padrão\",\"Papel\": \"Fosco Premium\","Color": "Colorido frente e verso"}}

Gerenciamento de arquivos

Arquivo para impressão

O arquivo de origem que contém a arte a ser impressa. Normalmente, é um arquivo PDF, PNG ou JPEG, dependendo dos requisitos do produto.

URL do arquivo

O local onde o arquivo para impressão pode ser acessado. Deve ser uma URL publicamente acessível da qual o GelatoConnect possa fazer o download.

Tipo de arquivo

Define o papel do arquivo no produto. Os tipos mais comuns incluem:

padrão: O principal arquivo para impressão do produto
frente: O arquivo para a frente de um produto personalizado
verso: O arquivo para o verso de um produto
capa: O arquivo para a capa de um livro
miolo: O arquivo para as páginas internas de um livro

Arquivo processado

A versão pronta para produção do Arquivo para impressão, após o GelatoConnect aplicar todas as transformações necessárias.

Antevisão

Uma representação visual de como o produto final ficará com base nos arquivos para impressão fornecidos.

Shipping Information

Endereço para envio

O endereço de destino para onde o pedido deve ser entregue, incluindo os dados do destinatário.

UID do método de envio

Um identificador para o método de envio a ser utilizado no pedido. Pode ser específico (fed_ex_2_day) ou geral (express).

Endereço de devolução

O endereço que será usado como remetente na embalagem e para eventuais devoluções.

Código de rastreamento

Um identificador único fornecido pela transportadora para rastrear o progresso de entrega do pacote.

URL de rastreamento

Um endereço na web onde o cliente pode acompanhar o status atual da sua entrega.

Conceitos de integração

API

Interface de Programação de Aplicações - o método para interagir programaticamente com o GelatoConnect. Utiliza métodos HTTP padrão (GET, POST, PUT, etc.) para manipular pedidos.

Chave e segredo da API

Credenciais de segurança utilizadas para autenticar solicitações à API GelatoConnect. Consiste em um par de chave e segredo que deve ser fornecido no cabeçalho X-API-KEY no formato \"chave:segredo\".

Webhook

Um callback HTTP que envia notificações sobre eventos no GelatoConnect para o seu sistema em tempo real.

Postback

Uma notificação enviada pelo GelatoConnect para o seu sistema (ou para os seus clientes) sempre que o status de um pedido for alterado.

Mapeador de Modelos

Uma ferramenta para transformar dados entre o seu formato e o formato do GelatoConnect, utilizando a linguagem de modelagem Jinja2.

Consulta

Uma tabela de mapeamento que converte valores do seu sistema (como SKUs de produtos) em valores do GelatoConnect (como UIDs de Produto).

Vitrine da loja

Uma plataforma de e-commerce (como Shopify, Etsy ou WooCommerce) que pode ser conectada ao GelatoConnect para importar pedidos automaticamente.

FTP

Protocolo de Transferência de Arquivos - um método para carregar arquivos de pedidos no GelatoConnect para processamento em lote.

Termos Financeiros e de Faturamento

Moeda

A unidade monetária na qual os pedidos serão cobrados. Deve ser especificada para cada pedido usando os códigos de moeda ISO (por exemplo, USD, EUR, GBP).

Preço de Varejo

O preço cobrado ao cliente final por um produto, normalmente utilizado para declarações alfandegárias em remessas internacionais.

Conceitos avançados

Solicitação de Pedido

O envio inicial de um pedido antes de ser totalmente processado e validado.

Metadados

Informações adicionais anexadas a um pedido como pares de chave-valor, utilizadas para rastreamento, análise ou fins de integração. Os metadados podem ser aplicados a itens individuais do pedido ou ao pedido completo.

Verificação prévia

Validação automatizada de arquivos para impressão para garantir que atendam aos requisitos de produção.

Construtor de fluxos de trabalho

Uma ferramenta para definir as etapas de produção para cada tipo de produto.

Glossário de abreviações

Abreviação	Definição
PSP	Provedor de Serviços de Impressão
API	Interface de Programação de Aplicações (API)
FTP	Protocolo de Transferência de Arquivos
UID	Identificador único
IU	Interface do usuário
SLA	Acordo de Nível de Serviço
EDI	Intercâmbio Eletrônico de Dados
B2B	Business to Business
B2C	Business to Consumer
CSV	Valores separados por vírgula
JSON	Notação de Objetos JavaScript
XML	Linguagem de Marcação Extensível

Quer saber mais?

Agora que você está familiarizado com os termos e conceitos comuns usados nos sistemas de recebimento de pedidos do GelatoConnect, você está mais bem preparado para:

Entenda a documentação e as mensagens de erro
Navegue pela plataforma com mais confiança

Para obter informações mais detalhadas sobre aspectos específicos da entrada de pedidos, consulte as seções relevantes em nossa Central de Ajuda.

[Entrada de Pedidos - GCW] Termos e Conceitos de Entrada de Pedidos