Migração para o novo editor visual de comprovantes
O editor de código de comprovantes foi descontinuado para a maioria dos lojistas e substituído pelo novo editor visual de comprovantes. A maior parte das personalizações de comprovantes em código Liquid é migrada automaticamente do editor de código para o visual.
Se o seu local tiver a assinatura do Shopify POS Pro e houver personalizações complexas de comprovantes em código Liquid, é possível que elas não migrem automaticamente, sendo necessário fazer a migração manual. Esta página descreve as considerações para alternar entre o editor de código e o editor visual de comprovantes, bem como as etapas para migrar as personalizações de comprovantes em código Liquid.
É possível alternar entre o editor de código e o editor visual de comprovantes até a ativação do editor visual no canal de vendas POS, ou até 1º de janeiro de 2027, quando a migração de todas as lojas será concluída.
Nesta página
Considerações sobre a transição do editor de código para o editor visual de comprovantes
Caso as personalizações de comprovantes não tenham sido migradas automaticamente do editor de código para o editor visual de comprovantes, ainda é possível alternar entre eles.
Analise as seguintes considerações ao alternar entre o editor visual e o editor de código de comprovantes.
Elegibilidade para o editor de código
- O editor de código se aplica apenas aos locais com POS Pro.
- O editor de código não está disponível para nenhum local na Itália ou na França. Na Itália, todo o conteúdo e a formatação do comprovante são gerenciados pela impressora Epson RT.
Limitações de acesso
- Só é possível alternar entre os editores no admin da Shopify.
- O editor de código só pode ser usado no admin da Shopify para desktop.
Gerenciamento de personalizações
- As personalizações são salvas separadamente para cada editor. Por exemplo, se você adicionar informações de SKU aos comprovantes no editor visual, mas ainda estiver usando o editor de código, o SKU não aparecerá nos comprovantes. No entanto, se você voltar ao editor visual, a configuração para exibir o SKU continuará ativada e ele será mostrado nos comprovantes.
Requisitos de versão do app Shopify POS
Antes de migrar para o editor visual de comprovantes, verifique as versões do app Shopify POS usadas pelos dispositivos da loja. A versão do app determina se um dispositivo imprime o novo modelo do editor visual ou se continua imprimindo o modelo de comprovante anterior:
- O modelo de comprovante unificado é impresso a partir da versão 11.10 do app Shopify POS. Os dispositivos com versões anteriores continuam imprimindo o modelo anterior.
- Se os dispositivos tiverem versões diferentes do app Shopify POS, a loja imprimirá dois modelos de comprovante até que todos os dispositivos sejam atualizados. A mesma venda será impressa no novo modelo por um dispositivo com a versão 11.10 ou mais recente e no modelo antigo por um dispositivo com uma versão anterior.
- Se algum dispositivo POS usado pela loja nos últimos 90 dias executar uma versão do app Shopify POS anterior à 11.10, o editor de comprovantes impressos exibirá um banner solicitando a atualização do app. Dispositivos e simuladores arquivados não entram nessa contagem.
Para visualizar os comprovantes em dispositivos POS com versões anteriores, consulte a seção Visualizar comprovantes em versões do app Shopify POS anteriores à 11.10 nesta página.
Migração para o editor visual de comprovantes
É necessário revisar os comprovantes e migrar manualmente as personalizações antes de ativar o editor visual de comprovantes. Após a ativação do editor visual, o editor de código será removido da loja e não poderá ser restaurado.
Método de migração
A forma como a loja migrará para o editor visual de comprovantes dependerá das personalizações de comprovantes atuais:
- Se você não tiver nenhum código Liquid personalizado de comprovante, a loja será migrada automaticamente para o editor visual sem necessidade de nenhuma ação.
- Se você tiver um código Liquid personalizado de comprovante em um local com Shopify POS Pro, manterá o editor de código até a ativação do editor visual de comprovantes, ou até 1º de janeiro de 2027, quando a migração de todas as lojas será concluída.
Analisar os modelos de comprovante
Ao migrar para o editor visual de comprovantes, as personalizações que podem ser convertidas com segurança, como blocos de texto, conteúdo específico do local e formatação padrão de devolução e troca, são migradas automaticamente. As personalizações que não podem ser convertidas de forma automática são sinalizadas para serem recriadas no editor visual.
Analise todos os modelos de comprovante e confirme quais personalizações foram migradas automaticamente e quais exigem recriação manual.
As seguintes personalizações do editor de código estão disponíveis como campos padrão no editor visual:
| Personalização do editor de código | Equivalente no editor visual |
|---|---|
| Identificador de IVA ou outro identificador da empresa (por exemplo, Número de registro comercial australiano (ABN, na sigla em inglês), GST) | Bloco de informações da empresa no corpo da transação, extraído das configurações de tributos. |
| Informações específicas do local, como endereço ou número de telefone da loja | Extraídas diretamente das informações inseridas na configuração do local. |
| Texto da política de devolução | Bloco da política de devolução no rodapé. |
| Linha de captura de assinatura | Bloco de captura de assinatura no rodapé. O conteúdo da captura de assinatura é personalizável. |
| Metacampos personalizados | Bloco personalizado do Liquid no cabeçalho ou no rodapé. |
| Logo personalizado por local | Substituição de logo por local. |
| Mensagem de agradecimento condicional | Substituição por local no bloco da mensagem de agradecimento. |
Migrar manualmente elementos personalizados de comprovantes para o editor visual de comprovantes
Use o editor visual de comprovantes para recriar as personalizações sinalizadas durante a migração. Para recriar personalizações complexas em Liquid, é possível adicionar um bloco personalizado do Liquid ao cabeçalho ou rodapé do comprovante.
Visualizar comprovantes de versões do app Shopify POS anteriores à 11.10
Ative o editor visual de comprovantes apenas após atualizar o app Shopify POS para a versão 11.10 ou posterior em todos os dispositivos. Até que todos eles sejam atualizados, aqueles em versões anteriores imprimirão o modelo de comprovante anterior.
É possível visualizar a aparência dos comprovantes em dispositivos POS que usam uma versão do app Shopify POS anterior à 11.10.
No admin da Shopify, acesse Canais de vendas > Ponto de venda.
Na seção Personalizar a experiência na loja, clique em Editar em Comprovantes.
Clique em Visualizar e selecione o tipo de comprovante que deseja visualizar.
Ativar o editor visual de comprovantes
Após analisar os comprovantes e migrar todos os elementos personalizados para o editor visual de comprovantes, será possível ativá-lo clicando em Ativar editor visual na configuração Visualizar comprovantes.