Personalize Seu Recibo
Para alterar a aparência do seu recibo, há três opções. Escolha a mais simples que atenda à sua necessidade — a maioria das lojas nunca precisa ir além da primeira.
Três formas de personalizar
1. Escolha um modelo diferente
Use um dos modelos prontos na galeria. Nenhum código necessário. Ideal para: um layout diferente, ocultar preços, uma fatura A4, um ticket de cozinha.
2. Peça à IA para ajustar
Cole o modelo no ChatGPT ou Claude e descreva o que deseja. Não é necessário saber programar — basta descrever em linguagem simples. Ideal para: pequenos ajustes como textos, cores ou reorganização de elementos.
3. Edite manualmente
O editor integrado permite alterar o modelo diretamente. Ideal para: controle preciso ou para quem já conhece HTML.
As três opções começam no mesmo lugar: WP Admin → POS → Modelos. A página tem duas partes — Seus Modelos no topo (os que estão em uso no momento) e a Galeria de Modelos abaixo (a biblioteca de modelos iniciais).
Opção 1 — Escolher um modelo diferente
Este é o caminho mais fácil e cobre a maioria das necessidades.
Abrir a galeria de modelos
No WP Admin, vá para POS → Modelos. Role além de Seus Modelos até a seção Galeria de Modelos — essa é a biblioteca inicial.
Navegar e visualizar
Filtre por categoria (Recibo, Fatura, Recibo de Presente, Comanda de Cozinha, Orçamento / Ordem de Compra), formato (HTML para impressão no navegador, ESC/POS para impressoras térmicas) ou direção (Esquerda para direita ou Direita para esquerda). Clique na miniatura de qualquer cartão — ou no link Visualizar no rodapé — para abrir uma visualização ao vivo com os dados reais da sua loja.
Usar
Clique em Usar Modelo no cartão. O WCPOS cria uma cópia editável e a adiciona em Seus Modelos no topo da página. Ative o botão Ativo na linha para começar a usar nos recibos; arraste a alça da linha para reordenar. Você pode ter vários ativos ao mesmo tempo — o operador de caixa escolhe no ponto de venda.
Clicar em Usar Modelo sempre cria uma nova cópia. O modelo original da galeria permanece intacto, então você pode voltar e escolher um ponto de partida diferente a qualquer momento. Se vários modelos de recibo estiverem ativos, a tela de recibo exibe um menu suspenso para que o operador de caixa possa alternar entre eles rapidamente.
Os modelos incluídos
| Modelo | Formato | Para que serve |
|---|---|---|
| Recibo Padrão | HTML | Padrão — logotipo, itens, totais, pagamento. Atende a maioria das lojas |
| Recibo Padrão (RTL) | HTML | Igual ao Padrão, espelhado para árabe / hebraico / persa / urdu |
| Minimalista / Moderno | HTML | Mesmas informações do Padrão, compactadas em menos espaço vertical |
| Recibo Detalhado | HTML | Nota fiscal completa — coluna de SKU, preço unitário, discriminação de impostos por alíquota, endereços |
| Recibo de Presente | HTML | Apenas itens — preços ocultos. Inclui mensagem de presente e política de devolução |
| Fatura | HTML | Fatura em página inteira A4/Carta. Adiciona um painel "Como pagar" para pedidos não pagos |
| Romaneio | HTML | Complemento para o depósito — itens + quantidades, endereço de entrega, sem preços |
| Orçamento / Estimativa | HTML | Documento de pré-venda com preços e condições — sem seção de pagamento |
| Recibo Estreito | HTML | Recibo monoespaçado para papel estreito ou impressoras térmicas compatíveis com HTML |
| Recibo Térmico Simples (58mm) | Térmico | Layout térmico limpo de 58mm |
| Recibo Térmico Simples (80mm) | Térmico | Layout térmico limpo de 80mm — o mais comum |
| Recibo Térmico Simples 80mm (RTL) | Térmico | Versão RTL para 80mm. Requer uma impressora com codepage árabe |
| Recibo Térmico Detalhado (58mm / 80mm) | Térmico | Adiciona detalhamento de impostos, endereços, reembolsos, pagamentos, termos e código de barras |
| Comanda de Cozinha | Térmico | Somente itens, fonte grande, sem preços — para estações de preparo |
A maioria dos modelos inclusos se adapta automaticamente às configurações de impostos da sua loja — lojas com impostos inclusos exibem preços brutos e uma linha "Impostos inclusos"; lojas com impostos exclusos exibem preços líquidos com os impostos adicionados em uma linha separada. A família Detalhado sempre exibe o detalhamento completo de impostos, independentemente da configuração.
Atribuições por loja
Se você tiver mais de uma loja (Pro), cada loja pode ter sua própria seleção e ordenação de modelos, separada dos padrões globais do site. O café na outra rua pode usar um recibo térmico pequeno com logotipo e endereço diferentes; o depósito pode usar uma guia de remessa; a loja principal pode manter o recibo padrão — tudo a partir da mesma galeria de modelos.
Configure em WP Admin → POS → Lojas e abra a loja que deseja configurar. A página Editar Loja possui uma seção Modelos de Recibo com uma opção "Modelos de recibo específicos da loja":
- Desativado (padrão) — a loja herda a lista de modelos global da página principal POS → Modelos.
- Ativado — a loja recebe sua própria seleção e ordenação de modelos, separada dos padrões globais do site. A reordenação por arrastar funciona da mesma forma.
A mesma página Editar Loja também é onde fica o cabeçalho de cada loja (logotipo, endereço, dados de contato e o bloco Mensagens do Recibo — Saudação de Encerramento, Política de Devoluções, Rodapé). Os modelos inclusos utilizam esses campos específicos de cada loja, permitindo que um único modelo "Recibo Padrão" tenha identidade visual diferente em cada unidade.
Quando um operador de caixa faz login em uma loja, apenas os modelos ativos daquela loja aparecem no menu de seleção de recibos.
A página Modelos no WP Admin define o padrão para todo o site. A substituição por loja existe para que um único modelo (por exemplo, um Recibo Padrão) possa ter uma identidade visual diferente em cada local, ou para que um local use um layout que os outros não usam. Se todas as suas lojas utilizam os mesmos modelos, basta deixar as atribuições por loja vazias e os padrões globais serão aplicados.
Opção 2 — Peça à IA para ajustar
Se a galeria está próxima do que você precisa, mas não é exatamente o que deseja, um assistente de IA pode fazer as alterações em minutos — e você não precisa saber HTML.
Copie o modelo
Abra o modelo que deseja usar como base em WP Admin → POS → Modelos, clique no editor e selecione todo o texto do lado esquerdo (Ctrl/Cmd + A). Copie.
Descreva o que alterar
Diga à IA exatamente o que você deseja. Exemplos que funcionam bem:
- "Deixe o nome da loja maior e centralizado."
- "Adicione uma mensagem de agradecimento em itálico na parte inferior."
- "Oculte o nome do cliente. Adicione o número de telefone abaixo do número do pedido."
- "Altere o código de barras para um QR code que redirecione para minha página de devoluções."
- "Adicione um slogan 'Empresa familiar desde 1987' abaixo do nome da loja."
A IA retornará um modelo modificado.
Cole de volta
Copie a resposta da IA. De volta no editor de modelos do WCPOS, selecione tudo (Ctrl/Cmd + A), cole a nova versão e clique em Atualizar. A pré-visualização à direita é atualizada para que você possa ver o resultado. Se não parecer correto, peça à IA para corrigir — descreva o que deu errado.
Cada clique em Usar Modelo na galeria cria uma nova cópia editável, então o original permanece seguro. Se estiver experimentando, você pode usar o mesmo modelo da galeria mais de uma vez — renomeie suas cópias (Recibo v1, Recibo v2) e alterne entre elas enquanto decide.
Os trechos como {{store.name}} e {{order.number}} são espaços reservados para seus dados reais. A IA entende esses trechos — você não precisa entender. Se quiser conhecer todos os espaços reservados disponíveis, consulte a Referência de Dados do Recibo.
Opção 3 — Edite manualmente
Se você conhece um pouco de HTML (ou está trabalhando com um desenvolvedor), é possível editar o modelo diretamente no editor integrado do aplicativo. O editor possui pré-visualização ao vivo, destaque de sintaxe, seletor de campos com busca, desfazer/refazer e localizar e substituir.
Escolha seu mecanismo:
- Modelos HTML — Placeholders no estilo Mustache
{{variable}}. Renderiza no lado do cliente, funciona offline. Recomendado para a maioria das lojas. - Modelos Térmicos — XML para impressoras térmicas ESC/POS. O mesmo modelo produz tanto a pré-visualização na tela quanto a saída na impressora.
- Referência de Dados do Recibo — Todos os placeholders disponíveis, agrupados por seção.
Se você costumava sobrescrever o recibo com um arquivo PHP no seu tema (yourtheme/woocommerce-pos/receipt.php), isso ainda funciona. Agora ele aparece como Modelo PHP Legado na galeria, ao lado dos novos mecanismos logicless e térmico. Novas personalizações devem usar a galeria ou o editor integrado — eles funcionam offline, oferecem pré-visualização ao vivo e não precisam de uma ida e volta ao servidor.
Personalizações comuns
Respostas rápidas para as perguntas mais frequentes.
Como adiciono o logotipo da minha loja?
Os logotipos vêm das configurações da sua loja, não do modelo em si. Acesse WP Admin → POS → Configurações → Lojas, edite sua loja e envie um logotipo lá. Todos os modelos incluídos que exibem um logotipo o utilizarão automaticamente.
Se você deseja alterar onde o logotipo aparece no modelo, edite o modelo e mova o {{#store.logo}}<img src="{{store.logo}}" ...>{{/store.logo}} bloco para onde desejar.
Como altero o texto do rodapé (por exemplo, 'Obrigado pela sua compra!')?
Duas opções:
- Mais fácil — defina uma vez para todos os recibos em WP Admin → POS → Configurações → Lojas → Detalhes da loja → Rodapé do recibo / nota pessoal. Os modelos incluídos utilizam automaticamente; se nenhum rodapé estiver definido, eles exibem um padrão amigável como "Obrigado pela sua compra!".
- Em um único modelo — edite o modelo e substitua o texto do rodapé diretamente. Procure por
{{store.personal_notes}}ou a linha literal de agradecimento.
Como adiciono um slogan ou frase de efeito abaixo do nome da loja?
Edite o modelo e adicione uma linha abaixo de {{store.name}}:
<div style="font-style: italic; color: #6b7280;">Family-owned since 1987</div>
Em um modelo térmico:
<align mode="center"><text>Family-owned since 1987</text></align>
Como oculto os preços (para um recibo de presente)?
Clique em Usar Modelo no cartão Recibo de Presente na galeria — ele oculta todos os preços e totais, mas ainda exibe os itens, SKU, atributos e a mensagem de presente. Nenhuma edição necessária.
Se preferir criar seu próprio recibo sem preços, copie qualquer modelo e exclua os blocos {{...total...}}, {{...price...}} e {{#totals}}...{{/totals}}.
Como altero o código de barras para um QR code?
Encontre o <barcode> elemento no seu modelo e altere o type atributo:
<!-- Default: Code 128 barcode of the order number -->
<barcode type="code128">{{order.number}}</barcode>
<!-- Switch to a QR code -->
<barcode type="qrcode">{{order.number}}</barcode>
<!-- Or encode something else, like a returns URL -->
<barcode type="qrcode">https://example.com/returns?order={{order.number}}</barcode>
A mesma <barcode> sintaxe funciona tanto em templates HTML quanto em templates térmicos. Outros tipos suportados incluem ean13, ean8, upca, pdf417 e tudo que o bwip-js suporta.
Como envio um modelo diferente para uma impressora específica?
No aplicativo POS, vá para Configurações → Roteamento de Impressão. Você verá cada um dos seus templates ativos com um menu suspenso de impressora ao lado. Escolha a impressora desejada ou deixe como Automático.
- Automático associa templates a impressoras automaticamente — templates térmicos são enviados para impressoras térmicas, templates HTML são enviados para o diálogo de impressão do sistema.
- Uma impressora específica substitui o Automático e sempre envia o template para ela.
- No momento da impressão, o operador de caixa pode substituir qualquer uma das opções acima usando o menu suspenso de impressora na tela de recibo.
O roteamento é armazenado por dispositivo, então cada iPad ou computador pode ter sua própria configuração.
Meu recibo ainda exibe a versão antiga depois que eu o edito
Clique no botão Atualizar do WordPress na tela de edição do modelo. O editor não salva automaticamente — suas alterações só são mantidas quando você clica em Atualizar.
Para modelos PHP legados, a pré-visualização no editor mostra a última versão salva, não o que você está digitando. Salve primeiro e depois atualize a pré-visualização.
A pré-visualização está em branco ou exibe 'No POS orders found'
Isso só acontece com modelos PHP legados, que precisam de um pedido real para gerar a pré-visualização. Processe um único pedido no POS — mesmo uma venda de teste de R$ 0 — e a pré-visualização começará a funcionar.
Modelos logicless (HTML) e térmicos sempre têm dados de exemplo como fallback, então a pré-visualização funciona normalmente mesmo em uma loja recém-criada.
Fiz uma bagunça — como recomeço do zero?
Três redes de segurança:
- O editor possui Desfazer (Ctrl/Cmd + Z) para alterações feitas durante a sessão.
- Cada salvamento cria uma revisão no WordPress — abra Revisões na tela de edição para comparar e restaurar qualquer versão anterior.
- Se você partiu de um modelo da galeria, clique em Excluir na sua cópia em Seus Modelos e depois clique em Usar Modelo no mesmo card da galeria novamente. Você obterá uma cópia nova e intacta.
Quando pedir ajuda
- O editor de modelos não carrega ou os salvamentos não são mantidos.
- O recibo imprime corretamente em um dispositivo, mas não em outro.
- Você precisa de um layout fiscal/legal para um país específico (Itália, Brasil, Espanha, etc.) — esses casos geralmente são tratados pelo WCPOS Pro ou por uma integração específica do país.
- Você está tentando fazer algo personalizado e a IA não consegue acertar completamente.
Abra um ticket de suporte e cole o template com o qual está trabalhando — isso nos dá tudo o que precisamos para ajudar.