# 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[​](#three-ways-to-customise "Link direto para 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[​](#option-1-pick-a-different-template "Link direto para Opção 1 — Escolher um modelo diferente") Este é o caminho mais fácil e atende a maioria das necessidades. 1 #### 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. 2 #### 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. 3 #### 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. Usar Modelo nunca substitui nada 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[​](#the-bundled-templates "Link direto para 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[​](#wp-overnight-invoice-and-packing-slip-templates "Link direto para Modelos de fatura e romaneio do WP Overnight") Se o seu site também utiliza o [PDF Invoices & Packing Slips for WooCommerce](https://wordpress.org/plugins/woocommerce-pdf-invoices-packing-slips/) 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[​](#per-store-assignments "Link direto para Atribuições por loja") Se você tiver mais de uma [loja](/pt-BR/stores/.md) (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. Global vs por loja 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[​](#option-2-ask-ai-to-tweak-it "Link direto para 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. 1 #### 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. 2 #### Colar no ChatGPT ou Claude Abra o [ChatGPT](https://chat.openai.com) ou o [Claude](https://claude.ai). Cole o modelo e escreva o que deseja, em linguagem simples: 3 #### 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. 4 #### 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. Boa prática 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. E as variáveis? 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](/pt-BR/receipts/receipt-data.md). ## Opção 3 — Editar manualmente[​](#option-3-edit-it-by-hand "Link direto para 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](/pt-BR/receipts/html-templates.md)** — Marcadores no estilo Mustache com `{{variable}}`. Renderiza no lado do cliente, funciona offline. **Recomendado para a maioria das lojas.** * **[Modelos Térmicos](/pt-BR/receipts/thermal-templates.md)** — 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](/pt-BR/receipts/receipt-data.md)** — Todos os marcadores que você pode usar, agrupados por seção. Modelos PHP legados 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[​](#common-customisations "Link direto para 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}}{{/store.logo}}` bloco para onde desejar. Como altero o texto do rodapé (ex.: 'Obrigado pela sua compra!')? Duas opções: 1. **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!"*. 2. **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}}`: ```
Family-owned since 1987
``` Em um modelo térmico: ``` Family-owned since 1987 ``` 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 `` elemento no seu modelo e altere o `type` atributo: ``` {{order.number}} {{order.number}} https://example.com/returns?order={{order.number}} ``` A mesma `` sintaxe funciona tanto em modelos HTML quanto térmicos. Outros tipos suportados incluem `ean13`, `ean8`, `upca`, `pdf417` e [tudo que o bwip-js suporta](https://github.com/metafloor/bwip-js/wiki/Supported-Barcode-Types). 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: 1. O editor possui **Desfazer** (Ctrl/Cmd + Z) para alterações realizadas durante a sessão. 2. Cada salvamento cria uma **revisão** no WordPress — abra **Revisões** na tela de edição para comparar e restaurar qualquer versão anterior. 3. 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[​](#when-to-ask-for-help "Link direto para 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](/pt-BR/getting-started/pro-license.md) 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](https://wcpos.com/support) e cole o modelo com o qual está trabalhando — isso nos fornece tudo o que precisamos para ajudar.