Editor de código de comprovante impresso do Shopify POS

O editor de código do comprovante permite personalizar os comprovantes impressos com HTML, CSS e Liquid. É possível editar os modelos de comprovante, que são os tipos que você pode imprimir na loja, e os modelos de seção, que são partes reutilizáveis, como o cabeçalho e o rodapé.

Nesta página

Considerações sobre o uso do editor de código do comprovante

Antes de usar o editor de código do comprovante, analise as seguintes considerações:

Restrições de acesso

O editor de código só pode ser usado no admin da Shopify no desktop.
O editor de código não está disponível para nenhum local de POS na Itália ou na França.
Não é possível adicionar novas lojas ou locais ao editor de código. O recurso continuará disponível para as lojas que possuem personalizações não migradas.

Onde as alterações são aplicadas

As alterações de código que você faz se aplicam apenas ao local selecionado.
As personalizações no editor de código são aplicadas somente a locais com POS Pro. Se você usa o editor de código e tem locais sem o POS Pro, é possível usar o editor visual para personalizar o cabeçalho e o rodapé desses locais.
É possível personalizar comprovantes impressos que tenham um modelo no editor de código, como os de vendas, de presente, de cartão-presente e de devolução e troca.

Linguagens de código

Os arquivos que compõem os comprovantes contêm Liquid, a linguagem de modelos da Shopify. Saiba mais sobre o uso do Liquid.
Para editar os modelos no editor de código do comprovante, é preciso ter conhecimentos em HTML, CSS e Liquid. O Atendimento ao cliente de temas da Shopify não faz edições extensas nos modelos de comprovante, mas talvez possa ajudar com pequenos ajustes em temas gratuitos da Shopify no escopo da Política de design da Shopify. Para alterações mais complexas, considere contratar um parceiro da Shopify.

Limitações de personalização

Não é possível pré-visualizar comprovantes em tamanhos de impressora diferentes no editor de código. Para conferir uma pré-visualização por tamanho de impressora, use o editor visual.
As descrições de produtos não estão disponíveis como variável nos modelos de comprovante e não podem ser adicionadas a comprovantes impressos.

Manutenção de modelos

Os modelos de comprovante no editor de código não recebem mais atualizações. As propriedades adicionadas após 1º de junho de 2026 estarão disponíveis apenas no editor visual.
Não é mais possível reinicializar o modelo para a versão padrão. Para voltar a um modelo padrão, migre para o editor visual.

Acessar o editor de código

As etapas para alternar entre os editores diferem um pouco dependendo se todos ou apenas alguns dos locais de POS estão qualificados para o editor de código, por exemplo, alguns dos locais de POS não usam o POS Pro ou estão localizados na Itália ou na França.

Etapas:

Todos os locais do POS Pro

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 no ícone na barra lateral esquerda.
Clique em Editar código.
Na caixa de diálogo Editar código dos comprovantes impressos, altere o código desejado.
Clique em Salvar.
Opcional: para continuar a edição de mais páginas do Shopify POS no editor do POS, volte na janela do navegador.

Com locais no plano Lite/na Itália/na França

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.
Na página Personalização de comprovantes, clique em Editor de código.

Usar arquivos personalizados no modelo de comprovante

É possível usar arquivos, como recursos de imagem, carregados no admin da Shopify para personalizar os comprovantes impressos.

É preciso fazer upload de um arquivo para o admin da Shopify para que ele possa ser usado em um comprovante impresso. Saiba mais sobre uploads de arquivos.

Etapas:

No admin da Shopify, acesse Conteúdo > Arquivos.
Ao lado do arquivo que você quer incluir no código do comprovante impresso, clique em para copiar o link.
Navegar até o editor de código.
Inclua o link do recurso no modelo.

Redefinir o modelo de comprovante para o padrão

O editor de código do comprovante não aceita a reinicialização de um modelo para o padrão. Para voltar ao modelo padrão de comprovante impresso, migre para o editor visual de comprovantes, que inclui todos os campos padrão.

Variáveis do Liquid disponíveis no editor de código do comprovante

As variáveis do Liquid a seguir são fornecidas como referência para ajudar você a entender as personalizações de comprovantes atuais durante a migração. Novas personalizações devem ser criadas no editor visual de comprovantes.

Os seguintes objetos de dados estão disponíveis para o editor de código do comprovante:

Objetos de comprovante

Descrição dos objetos de dados do comprovante
Objeto	Descrição
shop	Contém as informações da loja, como o nome da loja.
location	Contém as informações da loja física, como endereço e número de telefone.
order	Contém os dados do pedido, incluindo os itens de linha, os descontos, os tributos e as informações da transação.
return	Disponível apenas no modelo `return-and-exchange-receipt.liquid` e em seus modelos parciais associados. Contém dados de devolução e troca, incluindo os itens de linha devolvidos, os novos itens de linha, o total líquido e as informações da transação.
gift_card	Disponível apenas no modelo `gift-card.liquid`. Contém os dados do cartão-presente, incluindo o saldo, o código alfanumérico e o conteúdo de um código QR que pode ser lido pelo app POS.

Objeto do pedido

Descrição do objeto do pedido
Propriedade	Descrição
id	ID do pedido.
created_at	A data e a hora de criação do pedido no formato ISO 8601.
source_identifier	Um identificador de pedido exclusivo do POS ou de terceiros.
change_due	Troco do pedido.
balance_due	Valor devido neste pedido.
name	O identificador exclusivo do pedido, exibido na página de pedidos no admin da Shopify e na página de status do pedido. Por exemplo, "#1001", "EN1001" ou "1001-A". Esse valor não é exclusivo em várias lojas.
note	O conteúdo da observação associada ao pedido.
line_items	Uma lista dos itens de linha do pedido.
subtotal_price	A soma dos preços de todos os itens de linha após os descontos e antes das devoluções. Se `taxesIncluded` for verdadeiro, o subtotal também incluirá os tributos.
total_price	O preço total do pedido, antes das devoluções. Inclui tributos e descontos.
total_tip_received	A soma de todos os valores de gorjeta do pedido.
discounts	O valor total de descontos.
transactions	Uma lista de transações associadas ao pedido.
taxes_included	Informa se os tributos estão incluídos no subtotal do pedido.
tax_lines	Uma lista de todas as linhas de tributo aplicadas aos itens de linha no pedido, antes das devoluções. Os preços da linha de tributo representam o preço total de todas as linhas de tributo com a mesma alíquota e título.
customer	O cliente que fez o pedido.
shipping_address	O endereço de entrega do pedido.
shipping_groups	A lista de grupos de frete do pedido. Cada grupo contém itens de linha que são processados juntos.

Objeto de devolução

Descrição do objeto de devolução
Propriedade	Descrição
name	O identificador exclusivo da devolução, exibido na página de pedidos no admin da Shopify e na página de status do pedido. Por exemplo, "#1000-R1". Esse valor não é exclusivo em várias lojas.
created_at	A data e a hora no formato ISO 8601 de quando a devolução foi criada.
is_unverified	Um booleano que indica se a devolução foi criada como uma devolução não verificada.
is_exchange	Um booleano que indica se a devolução inclui uma troca. Isso inclui reembolsos feitos em um cartão-presente.
exchange_type	O tipo da troca, se a devolução incluir uma troca. Os valores possíveis são `LIKE_FOR_LIKE`, `NET_REFUNDABLE` e `NET_PAYABLE`.
return_discount	O valor total dos descontos do pedido que foram reembolsados.
return_subtotal	A soma dos preços de todos os itens de linha da devolução antes dos descontos. Se `taxesIncluded` for verdadeiro, o subtotal também incluirá os tributos.
return_total	O valor total possível de reembolso. Isso inclui tributos, descontos, frete e gorjetas. Pode não ser o valor real reembolsado.
exchange_subtotal	A soma dos preços de todos os novos itens de linha na troca antes dos descontos. Se `taxesIncluded` for verdadeiro, o subtotal também incluirá os tributos.
exchange_total	O valor total de todos os novos itens de linha na troca. Inclui tributos e descontos.
total_cash_rounding_adjustment	O ajuste de arredondamento de valor aplicado à devolução ou troca.
total_adjusted_amount	O valor total da devolução ou troca, ajustado pelo ajuste de arredondamento de valor.
net_total	O valor total real pago ou reembolsado pela devolução ou troca e antes do arredondamento de valor.
return_line_items	Os itens de linha devolvidos.
exchange_line_items	Os novos itens de linha na troca.
return_tax_lines	As linhas de tributo para os itens de linha devolvidos.
exchange_tax_lines	As linhas de tributo para os novos itens de linha na troca.
shipping_refund_amount	O valor do frete que foi reembolsado.
tip_refund_amount	O valor da gorjeta que foi reembolsado.
transactions	As transações associadas à devolução ou troca.

Objeto de grupo de frete

Descrição do objeto de grupo de frete
Propriedade	Descrição
destination	O destino dos produtos que estão sendo enviados.
products	Uma lista dos produtos que estão sendo enviados.

Objeto de item de linha

Descrição do objeto de item de linha
Propriedade	Descrição
id	O ID do item de linha.
name	O título do produto, com o título da variante anexado opcionalmente (se aplicável).
variant_title	O título da variante no momento da criação do pedido.
price	O preço unitário do item de linha quando o pedido foi criado. Esse valor não inclui descontos.
is_gift_card	Informa se o item de linha representa a compra de um cartão-presente.
discount	O desconto total alocado ao item de linha por aplicativos de desconto, incluindo descontos alocados a quantidades reembolsadas e removidas.
total_price	O total deste item de linha.
selling_plan_name	O nome do plano de assinatura atribuído ao item de linha.
tax_rates	As linhas de tributo para este item de linha.
custom_attributes	Uma lista de características que representam recursos personalizados ou solicitações especiais.
variant_title	O título da variante.
variant_id	O ID da variante.
variant_metafields	Uma lista de campos personalizados que um lojista associou à variante.
staff_member_description	Membro da equipe atribuído ao item de linha.
product_metafields	Uma lista de campos personalizados que um lojista associou ao produto.

Objeto de item de linha de devolução

Inclui tudo do objeto de item de linha, além das seguintes propriedades:

Descrição do objeto de item de linha
Propriedade	Descrição
return_reason	O motivo da devolução para o item de linha.
return_reason_note	Uma observação opcional para acompanhar o motivo da devolução.

Filtros do Liquid disponíveis no editor de código do comprovante

É possível usar filtros do Liquid para ajustar informações nos modelos de comprovante. Por exemplo, você pode alterar a formatação da moeda ou o uso de maiúsculas em um texto específico, como um código de tributo.

Para aplicar um filtro, adicione um caractere de barra vertical | e o filtro dentro do bloco de código do Liquid, entre chaves duplas {{ }}. Os filtros só podem ser aplicados a blocos de código do Liquid.

No exemplo a seguir, o filtro ajusta o código de tributo de letras minúsculas para maiúsculas.

{{ tax_line.title | upcase }}

No bloco de código de exemplo, product é o objeto, title é sua propriedade e upcase é o filtro aplicado. O filtro upcase altera as letras do valor de tax_line.title para maiúsculas. Por exemplo, se tax_line.title tem o valor Hst, o filtro upcase altera o valor para HST.

Consulte a seção Filtros na referência sobre Liquid para temas da Shopify para ver informações sobre como usar os filtros do Liquid.

Os filtros a seguir estão disponíveis no editor de código do comprovante:

Descrição dos filtros do comprovante
Propriedade	Descrição
t	Traduz etiquetas predefinidas para o idioma atribuído ao seu local.
money	Formata o preço na moeda do seu local.
escape	Faz o escape de caracteres especiais em HTML, como `<>`, `'` e `&`, e converte os caracteres em sequências de escape.
barcode	Gera um SVG de código de barras 1D.
qrcode	Gera um SVG de código de barras 2D.

Exemplo de personalização do código do modelo de comprovante impresso

É possível usar o Liquid para adicionar mensagens condicionais. Essa funcionalidade é semelhante a salvar em um único local com o editor visual. Por exemplo, se a sua empresa começou com um único local e agora tem vários locais novos, é possível destacar a loja original nos comprovantes impressos.

É possível adicionar uma mensagem personalizada ao modelo header.liquid na pasta Sections do editor de código e usar o Liquid para exibir a mensagem apenas no local principal.

O código a seguir verifica o nome do local (neste caso, o local original chamado “Início”) e exibe a mensagem “Bem-vindo à nossa loja original, inaugurada em 1972.” se o nome do local corresponder. Os comprovantes impressos de outros locais exibirão a mensagem “Bem-vindo à nossa loja.”.

{% if location.name == 'Home' %}
  Welcome to our original store, opened in 1972.
{% else %}
  Welcome to our store.
{% endif %}

Visualização das alterações de código no editor de código

Você pode pré-visualizar as alterações nos comprovantes impressos no editor de código do POS no admin da Shopify.

Dependendo do arquivo Liquid selecionado, a janela de visualização destaca o design ou a seção do comprovante afetada pelo arquivo. Por padrão, a janela de visualização exibe o conteúdo do pedido de POS mais recente. É possível selecionar um pedido específico para usar como conteúdo do comprovante na janela de visualização de todos os arquivos Liquid, exceto o gift-card.liquid, que exibe apenas os diferentes locais como opções de visualização selecionáveis.

Etapas:

Todos os locais do POS Pro

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 Personalizar os comprovantes.
Clique em Editar código.
Clique no arquivo de código que você quer visualizar. O comprovante é exibido na janela do editor mais à direita.
Opcional: para selecionar um pedido específico para usar como conteúdo do comprovante na janela de visualização, faça o seguinte:
1. Clique no ícone .
2. As vendas realizadas no canal de vendas Ponto de venda em todos os locais são exibidas na caixa de diálogo Escolher pedido para visualizar. Selecione um pedido da lista ou pesquise por pedidos e locais específicos na barra de pesquisa.
3. Clique em Confirmar.
Opcional: se estiver visualizando o arquivo gift-card.liquid, clique no ícone e selecione o local para o qual você quer visualizar o modelo.

Com locais no plano Lite/na Itália/na França

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.
Na página Personalização de comprovantes, clique em Editor de código.
Clique no arquivo de código que você quer visualizar. O comprovante é exibido na janela do editor mais à direita.
Opcional: para selecionar um pedido específico para usar como conteúdo do comprovante na janela de visualização, faça o seguinte:
1. Clique no ícone .
2. As vendas realizadas no canal de vendas Ponto de venda em todos os locais são exibidas na caixa de diálogo Escolher pedido para visualizar. Selecione um pedido da lista ou pesquise por pedidos e locais específicos na barra de pesquisa.
3. Clique em Confirmar.
Opcional: se estiver visualizando o arquivo gift-card.liquid, clique no ícone e selecione o local para o qual você quer visualizar o modelo.