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.

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ções do editor de código e respectivos equivalentes no editor visual de comprovantes
Personalização do editor de códigoEquivalente 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 lojaExtraídas diretamente das informações inseridas na configuração do local.
Texto da política de devoluçãoBloco da política de devolução no rodapé.
Linha de captura de assinaturaBloco de captura de assinatura no rodapé. O conteúdo da captura de assinatura é personalizável.
Metacampos personalizadosBloco personalizado do Liquid no cabeçalho ou no rodapé.
Logo personalizado por localSubstituição de logo por local.
Mensagem de agradecimento condicionalSubstituiçã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.

  1. No admin da Shopify, acesse Canais de vendas > Ponto de venda.

  2. Na seção Personalizar a experiência na loja, clique em Editar em Comprovantes.

  3. 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.