Pular para o conteúdo principal
Versão: 1.x

Recibos

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

Quer apenas alterar o recibo?

Comece em Personalize seu recibo. Ela explica as três maneiras mais fáceis de fazer isso — escolher um modelo incluído diferente, pedir à IA para ajustar um modelo ou editá-lo manualmente.

Mecanismos de modelo

O WCPOS oferece suporte a três mecanismos de modelo. O mecanismo é escolhido ao criar um modelo ou 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)

No estilo Mustache {{variable}} placeholders dentro de HTML simples. Renderiza no cliente, portanto os recibos funcionam offline. Use para impressão no navegador e recibos em PDF.

XML térmico

Modelos XML que produzem tanto uma pré-visualização na tela quanto comandos ESC/POS para impressoras térmicas de recibos. Mesmo modelo, dois resultados. Use para impressoras térmicas Epson, Star e outras.

PHP legado

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

A galeria inclui modelos prontos para usar como estão ou personalizar. Filtre por categoria (Recibo, Fatura, Recibo de presente, Comanda de cozinha, Orçamento / Pedido de compra), formato (HTML / ESC/POS) e direção (LTR / RTL); visualize com os dados reais da 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

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

Recibo padrão

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

Recibo padrão (RTL)

HTML · RTL · Equivalente da direita para a esquerda para árabe, hebraico, persa e urdu.

Minimal / Moderno

HTML · Os mesmos elementos essenciais do padrão, compactados em menos espaço vertical.

Recibo detalhado

HTML · Fatura fiscal completa — coluna SKU, preço unitário, detalhamento de impostos por alíquota, endereços.

Recibo de presente

HTML · Apenas itens, com 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.

Lista de embalagem

HTML · Complemento para armazém — 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 em monoespaçado para papel estreito ou impressoras térmicas compatíveis com HTML.

Modelos térmicos (ESC/POS)

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

Recibo térmico simples (58mm)

Térmico · 58mm · Layout térmico limpo de 58mm.

Recibo térmico simples (80mm)

Térmico · 80mm · Layout térmico limpo de 80mm — o mais comum.

Recibo térmico simples 80mm (RTL)

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

Recibo térmico detalhado (58mm)

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

Recibo térmico detalhado (80mm)

Térmico · 80mm · Modelo completo de 80mm — inclui endereços, detalhamento de impostos, reembolsos, pagamentos, termos e 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

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

Eles estão disponíveis somente enquanto o plugin WP Overnight estiver ativo e exigem uma conexão com o servidor para serem renderizados. Use os modelos HTML ou térmicos incluídos no WCPOS quando for necessária impressão off-line.

Exibição adaptativa de impostos

A maioria dos modelos incluídos (Padrão, Padrão RTL, Mínimo/Moderno, Estreito, Fatura, Orçamento e variantes Térmico simples) se adapta automaticamente à configuração de exibição de impostos do WooCommerce:

  • Lojas com impostos incluídos (UE/RU/AU) exibem preços brutos com uma linha "Imposto incluído".
  • Lojas sem impostos incluídos (EUA/CA) exibem preços líquidos com o imposto adicionado como uma linha separada.
  • O total geral sempre mostra o valor bruto efetivamente cobrado.

A família Detalhada é uma fatura fiscal formal e sempre discrimina os impostos com linhas sem impostos incluídos e um detalhamento explícito, independentemente da configuração da loja.

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 solicite as modificações desejadas.
  3. Ative-o — alterne o botão Ativo em Seus modelos. Cada modelo de recibo ativo aparece no menu suspenso da tela de recibos no caixa.
  4. Imprima ou exiba — os recibos abrem após a finalização da compra, com opções para imprimir, enviar por e-mail ou visualizar na tela. Seus modelos também funcionam além do caixa: os clientes da loja on-line podem baixar recibos em Minha conta renderizados com o mesmo design.

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

Recursos Pro

Com o WCPOS Pro, cada loja pode ter suas próprias atribuições de modelos, identidade visual (logotipo, endereço e dados de contato) e ordenação de modelos — útil para operações com vários locais, nas quais cada loja imprime seu próprio cabeçalho.

Nesta seção