Personalize Seu Recibo
Se você deseja 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. Sem nenhum código. Ideal para: um layout diferente, ocultar preços, uma fatura A4, uma comanda 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 reposicionamento de elementos.
3. Edite manualmente
O editor integrado permite alterar o modelo diretamente. Ideal para: controle preciso ou se você já conhece HTML.
Todos os três começam no mesmo lugar: WP Admin → POS → Modelos. A página tem duas partes — Seus Modelos no topo (os que você está usando 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 atende a maioria das necessidades.
Abrir a galeria de modelos
No WP Admin, acesse POS → Modelos. Role a página além de Seus Modelos até a seção Galeria de Modelos — essa é a biblioteca inicial.
Explorar 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 pré-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 usá-lo nos recibos; arraste a alça da linha para reordenar. É possível ter vários ativos ao mesmo tempo — o operador de caixa escolhe no momento da venda.
Clicar em Usar Modelo sempre cria uma nova cópia. O modelo original da galeria permanece intacto, permitindo 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 alterne entre eles na hora.
Os modelos inclusos
| Modelo | Formato | Finalidade |
|---|---|---|
| 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, em menos espaço vertical |
| Recibo Detalhado | HTML | Nota fiscal completa — coluna de SKU, preço unitário, detalhamento 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 | Documento para o depósito — itens + quantidades, endereço de entrega, sem preços |
| Orçamento / Estimativa | HTML | Documento pré-venda com preços e condições — sem seção de pagamento |
| Recibo Estreito | HTML | Recibo em fonte monoespaçada 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érmica | Layout térmico limpo de 80mm — o mais comum |
| Recibo Térmico Simples 80mm (RTL) | Térmica | Versão RTL para 80mm. Requer uma impressora com codepage árabe |
| Recibo Térmico Detalhado (58mm / 80mm) | Térmica | Inclui detalhamento de impostos, endereços, reembolsos, pagamentos, termos e código de barras |
| Comanda de Cozinha | Térmica | Apenas 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 não inclusos exibem preços líquidos com os impostos adicionados em uma linha separada. A família Detailed sempre exibe um detalhamento completo de impostos, independentemente da configuração.
Modelos de fatura e romaneio do WP Overnight
Se o seu site também utiliza o PDF Invoices & Packing Slips for WooCommerce do WP Overnight, o WCPOS adiciona automaticamente dois modelos extras em Seus Modelos:
| Modelo | Formato | Finalidade |
|---|---|---|
| Invoice (WP Overnight) | HTML renderizado no servidor | Utiliza o documento de fatura configurado no WP Overnight para o pedido do POS |
| Packing Slip (WP Overnight) | HTML renderizado no servidor | Utiliza o documento de romaneio configurado no WP Overnight para o pedido do POS |
Esses modelos não copiam os layouts de fatura ou romaneio integrados do WCPOS. Eles solicitam que o WP Overnight renderize o documento para o pedido do POS, de modo que seus números de fatura existentes, identidade visual, campos legais/fiscais e personalizações de modelos do WP Overnight permaneçam consistentes entre pedidos online e na loja.
Eles aparecem apenas enquanto o plugin WP Overnight estiver ativo. A saída é aberta como HTML na tela de impressão do WCPOS, em vez de um download separado em PDF. Como o documento é renderizado no servidor, o POS precisa de uma conexão com o seu site para imprimir esses modelos; use os modelos HTML ou térmicos incluídos para impressão offline.
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é ao lado pode usar um recibo térmico pequeno com um 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 a partir de WP Admin → POS → Lojas e abra a loja que deseja configurar. A página Editar Loja possui uma seção Modelos de Recibo com a 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 papel timbrado de cada loja (logotipo, endereço, dados de contato e o bloco Mensagens do Recibo — Encerramento, Política de Devolução, Rodapé). Os modelos incluídos utilizam esses campos por loja, de modo que um único modelo "Recibo Padrão" pode ter identidades visuais diferentes em locais diferentes.
Quando um operador de caixa faz login em uma loja, apenas os modelos ativos daquela loja aparecem no menu suspenso 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 identidades visuais diferentes em locais diferentes, ou para que um local use um layout que os outros não usam. Se todas as suas lojas desejam os mesmos modelos, basta deixar as atribuições por loja vazias e os padrões globais do site serão aplicados.
Opção 2 — Peça à IA para ajustar
Se a galeria estiver próxima do que você precisa, mas não exatamente certa, um assistente de IA pode alterá-la para você em minutos — e você não precisa saber HTML.
Copiar o modelo
Abra o modelo que deseja usar como base em WP Admin → POS → Modelos, clique no editor e selecione todo o texto no lado esquerdo (Ctrl/Cmd + A). Copie-o.
Descrever o que alterar
Diga à IA exatamente o que você deseja. Exemplos que funcionam bem:
- "Aumente o nome da loja e centralize."
- "Adicione uma mensagem de agradecimento em itálico no final."
- "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 direcione para a minha página de devoluções."
- "Adicione o 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 será atualizada para que você possa ver o resultado. Se não ficou como esperado, peça à IA para corrigir — descreva o que deu errado.
Cada clique em Usar Modelo na galeria cria uma nova cópia editável, mantendo o original intacto. 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 marcadores — você não precisa se preocupar com eles. Se quiser conhecer todos os espaços reservados disponíveis, consulte a Referência de Dados do Recibo.
Opção 3 — Editar manualmente
Se você tem conhecimentos básicos de HTML (ou está trabalhando com um desenvolvedor), pode editar o modelo diretamente no editor integrado do aplicativo. O editor possui pré-visualização em tempo real, destaque de sintaxe, seletor de campos com busca, desfazer/refazer e localizar e substituir.
Escolha seu mecanismo de template:
- Modelos HTML — Marcadores no estilo Mustache com
{{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 da impressora.
- Referência de Dados do Recibo — Todos os marcadores que você pode usar, 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 está identificado como Modelo PHP Legado na galeria, e fica ao lado dos novos mecanismos sem lógica e térmico. A integração com WP Overnight também usa o caminho renderizado no servidor porque a API de documentos de terceiros renderiza HTML no servidor. 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ê quiser 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é (ex.: '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 inclusos utilizam essa informação automaticamente; se nenhum rodapé estiver definido, exibem um texto 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 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 ocultar 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, exibindo apenas 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 alterar 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 modelos HTML quanto térmicos. Outros tipos suportados incluem ean13, ean8, upca, pdf417 e tudo que o bwip-js suporta.
Como enviar um modelo diferente para uma impressora específica?
No aplicativo POS, acesse Configurações → Roteamento de Impressão. Você verá cada um dos seus modelos ativos com um menu suspenso de impressora ao lado. Escolha a impressora desejada ou deixe como Automático.
- Automático associa modelos a impressoras automaticamente — modelos térmicos vão para impressoras térmicas, modelos HTML vão para a caixa de diálogo de impressão do sistema.
- Uma impressora específica substitui o modo Automático e sempre envia o modelo 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 mostra a versão antiga após a edição
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 'Nenhum pedido POS encontrado'
Isso só acontece com modelos Legacy PHP, que precisam de um pedido real para gerar a pré-visualização. Processe um único pedido no POS — mesmo uma venda de teste de $0 — e a pré-visualização começará a funcionar.
Modelos Logicless (HTML) e térmicos sempre possuem dados de exemplo como fallback, portanto a pré-visualização funciona normalmente mesmo em uma loja recém-criada.
Fiz uma bagunça — como recomeçar do zero?
Três redes de segurança:
- O editor possui Desfazer (Ctrl/Cmd + Z) para alterações realizadas 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ê começou a partir de um modelo da galeria, clique em Excluir na sua cópia em Seus Modelos e depois clique em Usar Modelo no mesmo cartão da galeria novamente. Você obterá uma cópia nova e intacta.
Quando pedir ajuda
- O editor de modelos não carrega ou as alterações salvas não são mantidas.
- O recibo é impresso 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.
Abra um ticket de suporte e cole o modelo com o qual está trabalhando — isso nos fornece tudo o que precisamos para ajudar.