# Recibos

O WCPOS inclui um sistema completo de modelos para recibos, faturas, recibos de presente, listas de embalagem, pedidos de cozinha e muito mais — tudo gerenciado em **WP Admin → POS → Modelos**.

Quer apenas alterar seu recibo?

Comece em **[Personalize seu recibo](/pt-BR/receipts/customise.md)**. O guia apresenta as três maneiras mais simples de fazer isso — escolher outro modelo incluído, pedir à IA para ajustar um modelo ou editar manualmente.

## Mecanismos de modelo[​](#template-engines "Link direto para Mecanismos de modelo")

O WCPOS oferece suporte a três mecanismos de modelo. O mecanismo é escolhido quando um modelo é criado ou ao clicar em **Usar modelo** em um cartão da galeria e **não pode ser alterado depois** — crie um novo modelo se quiser trocar de mecanismo.

#### HTML sem lógica (recomendado)

Estilo Mustache `{{variable}}` espaços reservados dentro de HTML simples. Renderiza no lado do cliente, portanto os recibos **funcionam offline**. Use para impressão pelo navegador e recibos em PDF.

#### XML térmico

Modelos XML que produzem uma pré-visualização na tela e **comandos ESC/POS** para impressoras térmicas de recibos. O mesmo modelo, duas saídas. Use para Epson, Star e outras impressoras térmicas.

#### PHP legado

Modelos PHP no lado do servidor que usam funções do WooCommerce. Mantidos para compatibilidade retroativa com `yourtheme/woocommerce-pos/receipt.php` substituições. Exige uma conexão com o servidor para renderizar.

## Galeria de modelos[​](#template-gallery "Link direto para Galeria de modelos")

A galeria inclui modelos prontos que podem ser usados como estão ou personalizados. Filtre por **categoria** (Recibo, Fatura, Recibo de presente, Comanda de cozinha, Cotação / Pedido de compra), **formato** (HTML / ESC/POS) e **direção** (LTR / RTL); visualize com os dados reais da sua loja. O rodapé de cada cartão tem um link **Visualizar** e um botão principal **Usar modelo** — clicar em Usar modelo cria uma cópia editável em *Seus modelos*.

### Modelos HTML[​](#html-templates "Link direto para Modelos HTML")

Para impressão pelo navegador e recibos em PDF. Renderizam no lado do cliente, portanto funcionam offline.

#### Recibo padrão

**HTML** · Recibo padrão — logotipo, identidade da loja, itens, totais, pagamento.

#### Recibo padrão (RTL)

**HTML · RTL** · Versão equivalente da direita para a esquerda para árabe, hebraico, persa e urdu.

#### Mínimo / moderno

**HTML** · Os mesmos elementos essenciais do Padrão, organizados 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 de página inteira em A4/Carta, com painel opcional "Como pagar" para pedidos não pagos.

#### Romaneio de embalagem

**HTML** · Complemento para armazém — itens + quantidades, enviar para, sem preços.

#### Cotação / Estimativa

**HTML** · Documento de pré-venda com preços e termos — sem seção de pagamento.

#### Recibo estreito

**HTML** · Recibo monoespaçado para papel estreito ou impressoras térmicas compatíveis com HTML.

### Modelos térmicos (ESC/POS)[​](#thermal-esc-pos-templates "Link direto para Modelos térmicos (ESC/POS)")

Para Epson, Star e outras impressoras térmicas de recibos.

#### Recibo térmico simples (58mm)

**Thermal · 58mm** · Layout térmico 58mm limpo.

#### Recibo térmico simples (80mm)

**Thermal · 80mm** · Layout térmico 80mm limpo — o mais comum.

#### Recibo térmico simples 80mm (RTL)

**Térmico · 80mm · RTL** · Equivalente RTL para 80mm. Requer uma impressora com uma página de código árabe (CP864 / Windows-1256).

#### Recibo térmico detalhado (58mm)

**Térmico · 58mm** · 58mm completo — endereços, detalhamento de impostos, reembolsos, pagamentos, termos, código de barras.

#### Recibo térmico detalhado (80mm)

**Térmico · 80mm** · 80mm completo — endereços, detalhamento de impostos, reembolsos, pagamentos, termos, código de barras.

#### Comanda de cozinha

**Térmico** · Apenas itens, fonte grande, sem preços — para estações de preparo.

### Modelos de documentos de terceiros[​](#third-party-document-templates "Link direto para Modelos de documentos de terceiros")

Se **PDF Invoices & Packing Slips for WooCommerce** da WP Overnight estiver ativo, o WCPOS também exibe **Fatura (WP Overnight)** e **Nota de embalagem (WP Overnight)** na lista de modelos de recibo. Esses modelos HTML renderizados no servidor delegam à API de documentos da WP Overnight, reutilizando a numeração de faturas e notas de embalagem, o layout, a identidade visual, os campos legais/fiscais e as personalizações de modelo configuradas nesse plugin.

Eles ficam disponíveis apenas enquanto o plugin WP Overnight estiver ativo e exigem uma conexão com o servidor para renderizar. Use os modelos HTML ou térmicos incluídos no WCPOS quando for necessária impressão offline.

### Exibição adaptável de impostos[​](#adaptive-tax-display "Link direto para Exibição adaptável de impostos")

A maioria dos modelos incluídos (Standard, Standard RTL, Minimal/Modern, Narrow, Fatura, Orçamento, variantes Thermal Simple) **se adapta automaticamente à sua configuração de exibição de impostos do WooCommerce**:

* **Lojas com impostos inclusos** (UE/Reino Unido/AU) veem preços brutos com uma linha "Imposto incluído".
* **Lojas sem impostos inclusos** (EUA/CA) veem preços líquidos com o imposto adicionado como uma linha separada.
* O total geral sempre mostra o valor bruto realmente cobrado.

A família **Detalhada** é uma nota fiscal formal e sempre discrimina os impostos com linhas sem impostos inclusos e uma decomposição explícita, independentemente da configuração da loja.

## Como funciona[​](#how-it-works "Link direto para Como funciona")

1. **Adicione um modelo** — clique em **Usar modelo** em um cartão da galeria ou crie o seu do zero.
2. **Personalize-o** usando o editor no aplicativo com visualização ao vivo, ou cole-o no ChatGPT / Claude e peça as alterações desejadas.
3. **Ative-o** — acione o botão **Ativo** em *Seus modelos*. Todo modelo de recibo ativo aparece no menu suspenso da tela de recibo no caixa.
4. **Imprima ou exiba** — os recibos abrem após a finalização da venda com opções para imprimir, enviar por e-mail ou visualizar na tela.

Os modelos são renderizados com base em uma [carga de dados de recibo](/pt-BR/receipts/receipt-data.md) padronizada, com seções para informações da loja, itens de linha, totais, impostos, pagamentos, reembolsos e mais. Todos os campos de moeda incluem variantes `_display` pré-formatadas (por exemplo, `$29.99` em vez de `29.99`).

## Recursos Pro[​](#pro-features "Link direto para Recursos Pro")

Com o [WCPOS Pro](/pt-BR/getting-started/pro-license.md), cada loja pode ter suas próprias atribuições de modelos, identidade visual (logotipo, endereço, dados de contato) e ordem dos modelos — útil para operações com várias localizações, em que cada loja imprime seu próprio papel timbrado.

## Nesta seção[​](#in-this-section "Link direto para Nesta seção")

[Personalize Seu ReciboA maneira mais fácil de alterar a aparência do seu recibo no WCPOS — escolha um modelo diferente, peça à IA para ajustá-lo ou edite manualmente.](/pt-BR/receipts/customise.md)

[Modelos HTMLCrie e personalize modelos HTML de recibo sem lógica usando espaços reservados no estilo Mustache.](/pt-BR/receipts/html-templates.md)

[Modelos TérmicosCrie modelos de recibos baseados em XML para impressoras térmicas ESC/POS com suporte a Epson e Star.](/pt-BR/receipts/thermal-templates.md)

[Dados do ReciboReferência completa do contrato de dados canônico disponível nos modelos de recibo do WCPOS.](/pt-BR/receipts/receipt-data.md)

[Impressão na NuvemImprima recibos do WCPOS em impressoras que não estão conectadas ao caixa — Star Online, Star CloudPRNT, Epson Server Direct Print e PrintNode.](/pt-BR/receipts/cloud-printing.md)

[RecibosImprima e envie recibos por e-mail no WCPOS, incluindo a configuração da impressora e as opções de personalização de recibos.](/pt-BR/receipts/at-checkout.md)