Provedores de impressão - Prodigi
Este artigo foi traduzido automaticamente e pode conter imprecisões.
Ver o original em inglês
Usando o atendimento de impressão da Prodigi com o DPG
Este guia abrange a primeira versão do atendimento de impressão do DPG. Nesta versão, Prodigi é o fornecedor com o fluxo completo de envio de pedidos de ponta a ponta em funcionamento.
Abrir Services Abrir Sales Documentação da API da Prodigi
O que essa integração faz
Com a Prodigi conectada, o DPG pode:
- exibir opções de produto com impressão habilitada no site
- coletar o endereço de entrega e o número de telefone de entrega no checkout
- criar o pedido normal do site DPG após o pagamento com Stripe ou PayPal
- enviar o pedido de impressão para a Prodigi automaticamente
- exibir o status do atendimento, a referência do fornecedor e o rastreamento na visualização de pedidos do DPG Sales
O pagamento do cliente continua passando pelo checkout do seu site DPG. A Prodigi é usada para o atendimento após o pagamento, não como processadora de pagamento do cliente.
Antes de começar
- Você precisa estar conectado como administrador. Somente administradores podem ver Services > Print Providers.
- Você precisa de uma conta Prodigi e de uma chave de API.
- Para testes, a Prodigi oferece ambientes Sandbox e Live separados.
- Sua opção de produto normalmente deve usar Type: Standard. Não use Image para uma opção de impressão, a menos que você queira intencionalmente o comportamento de imagem digital do DPG.
Se nenhuma conta de fornecedor de impressão ativa tiver sido conectada em Services, o DPG oculta os controles de fornecedor de impressão em outros lugares para evitar confusão.
Etapa 1: Conectar a Prodigi em Services
- Abra Services.
- Abra a seção Print Providers.
- Clique em Connect.
- Escolha Provider: Prodigi.
- Preencha os campos:
- Label: nome interno opcional para esta conexão
- Environment: Sandbox / Test para testes, ou Production para pedidos reais
- Provider account reference: id de conta externo ou observação opcional
- API key: obrigatória
- Webhook secret: opcional na versão atual do DPG
- Active: habilitada para uso real dentro do DPG
- Salve a conexão.
O DPG permite uma conta Prodigi por conta DPG e por ambiente. Isso significa que você pode manter uma conexão de sandbox e uma conexão de produção, se necessário.
Etapa 2: Criar ou editar a opção de produto
- Abra Sales.
- Edite o produto que você quer vender como impressão.
- Em Product Options, adicione ou edite a opção que deve ser enviada à Prodigi.
- Configure a opção assim:
- Type: Standard
- Fulfilment: Print provider
- Cost: seu preço de venda voltado ao cliente
- Status: por exemplo, In stock
- Salve o produto.
- Reabra o editor de produto.
Depois de mudar uma opção para Print provider, o DPG a trata como um item enviado. O checkout exigirá um endereço de entrega, e o número de telefone de entrega passará a ser obrigatório quando o item estiver no carrinho.
Etapa 3: Adicionar o mapeamento da Prodigi
Depois que o produto for salvo com uma opção de fornecedor de impressão, a seção Print Provider Mappings aparece.
Para cada opção de impressão que você quer atender com a Prodigi:
- Provider: escolha sua conexão Prodigi
- Mode: escolha Remote asset URL
- SKU: insira o SKU da Prodigi a ser atendido
- Product id: opcional no fluxo atual da Prodigi
- Variant id: opcional no fluxo atual da Prodigi
- Print area: geralmente default
- Sizing: Fill print area, Fit print area ou Stretch to print area
Salve o produto novamente após adicionar o mapeamento.
O adaptador da Prodigi atualmente usa os valores SKU, Print area e Sizing. Product id e Variant id ainda podem ser armazenados para sua própria referência, mas não são necessários para o fluxo inicial de envio à Prodigi.
Como a arte é enviada para a Prodigi
O DPG envia à Prodigi a URL do recurso de imagem original no momento do pedido.
Isso significa que:
- a imagem DPG pedida ainda deve ter uma versão de imagem original disponível
- a opção de impressão deve ter um SKU da Prodigi válido
- a opção de produto deve permanecer mapeada para uma conta de fornecedor Prodigi ativa
Se a URL do recurso de imagem original estiver ausente, o DPG não poderá enviar o pedido de impressão para a Prodigi. O pedido permanecerá no DPG e a seção de atendimento de impressão mostrará o erro.
Etapa 4: Testar o fluxo completo
Para um teste seguro:
- Conecte uma conta Prodigi Sandbox / Test em Services.
- Mapeie uma opção de produto para um SKU da Prodigi compatível com o sandbox.
- Adicione o produto a um site de teste ou a uma página de teste onde ele fique visível.
- Faça um pedido no site.
- Conclua o checkout e inclua um número de telefone de entrega.
- Abra o pedido em Sales.
Na visualização do pedido, procure a seção Print fulfilment. Você deve ver:
- nome do fornecedor
- referência do DPG ou do fornecedor
- status do atendimento
- rastreamento, quando disponível
- qualquer erro retornado pelo DPG ou pela Prodigi
Status de pedido esperados
Você pode ver estes status no DPG:
- pending submission: o DPG criou o registro do pedido do fornecedor, mas ainda não o enviou
- configuration required: falta ao DPG um SKU, uma URL de arte ou um mapeamento válidos
- submission failed: o DPG tentou enviar o pedido e a Prodigi o rejeitou, ou a solicitação falhou
- submitted: a Prodigi aceitou o pedido
- in production: a Prodigi começou a processar o pedido
- dispatched: a remessa foi criada
- completed: o fornecedor concluiu o pedido
- cancelled: o fornecedor marcou o pedido como cancelado
Solução de problemas
A seção Print Providers está ausente
- Verifique se você está conectado como administrador.
A opção de atendimento Print provider está ausente em Product Options
- O DPG só mostra essa opção depois que pelo menos uma conta de fornecedor de impressão ativa for conectada.
A opção de produto não aparece no site
- A opção deve estar ativa.
- Ela deve ter Fulfilment: Print provider.
- Ela deve ter um mapeamento de fornecedor ativo.
O pedido foi pago, mas nenhum pedido da Prodigi foi criado
- Verifique se há um erro de Print fulfilment na página do pedido em Sales.
- As causas mais comuns são um SKU ausente ou uma URL do recurso de imagem original ausente.
O número de telefone de entrega foi exigido no checkout
- Isso é esperado para pedidos de fornecedor de impressão na versão atual do DPG.
O que devo usar em Type?
- Para um produto de impressão, use Type: Standard.
- Use Type: Image apenas para o comportamento de pedido de imagem ou imagem digital do DPG, não para o atendimento por fornecedor de impressão.
Processo de lançamento recomendado
- Teste primeiro com o sandbox da Prodigi.
- Mantenha uma opção de impressão simples no ar antes de expandir para muitos tamanhos ou materiais.
- Use rótulos internos claros para suas contas de fornecedor para que a equipe consiga diferenciar as contas de teste das reais.
- Verifique manualmente os primeiros pedidos no DPG e na Prodigi antes de uma implementação mais ampla.