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, romaneios, pedidos de cozinha e muito mais — tudo gerenciado em WP Admin → POS → Modelos.

Só precisa alterar o recibo?

Comece em Personalize seu recibo. A página explica as três formas mais simples de fazer isso — escolher outro modelo incluído, pedir à IA para ajustar um modelo ou editar 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)

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 tanto uma prévia na tela quanto 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 usando funções do WooCommerce. Mantidos para compatibilidade retroativa com os yourtheme/woocommerce-pos/receipt.php existentes. Requer uma conexão com o servidor para renderizar.

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, Orçamento / Pedido de compra), formato (HTML / ESC/POS) e direção (LTR / RTL); visualize uma prévia com os dados reais da sua loja. O rodapé de cada cartão tem um link Prévia e um botão principal Usar modelo — clicar em Usar modelo cria uma cópia editável em Seus modelos.

ModeloMecanismoDescrição
Recibo padrãoHTMLRecibo padrão — logotipo, identidade da loja, itens, totais, pagamento
Recibo padrão (RTL)HTMLContraparte da direita para a esquerda para árabe, hebraico, persa, urdu
Minimalista / ModernoHTMLOs mesmos elementos essenciais do Padrão, compactados em menos espaço vertical
Recibo detalhadoHTMLFatura fiscal completa — coluna de SKU, preço unitário, detalhamento de impostos por alíquota, endereços
Recibo de presenteHTMLApenas itens, preços ocultos. Inclui mensagem de presente e política de devolução
FaturaHTMLFatura de página inteira em A4/Carta com painel opcional "Como pagar" para pedidos não pagos
RomaneioHTMLComplemento para o depósito — itens + quantidades, destinatário, sem preços
Cotação / EstimativaHTMLDocumento de pré-venda com preços e termos — sem seção de pagamento
Recibo estreitoHTMLRecibo monoespaçado para papel estreito ou impressoras térmicas compatíveis com HTML
Recibo térmico simples (58mm)TérmicoLayout térmico limpo de 58mm
Recibo térmico simples (80mm)TérmicoLayout térmico limpo de 80mm — o mais comum
Recibo térmico simples 80mm (RTL)TérmicoVersão RTL correspondente para 80mm. Requer uma impressora com página de código árabe (CP864 / Windows-1256)
Recibo térmico detalhado (58mm)Térmico58mm completo — endereços, detalhamento de impostos, reembolsos, pagamentos, termos, código de barras
Recibo térmico detalhado (80mm)Térmico80mm completo — endereços, detalhamento de impostos, reembolsos, pagamentos, termos, código de barras
Comanda de cozinhaTérmicoApenas itens, fonte grande, sem preços — para estações de preparo

Modelos de documentos de terceiros

Se PDF Invoices & Packing Slips for WooCommerce da WP Overnight estiver ativo, o WCPOS também exibirá Fatura (WP Overnight) e Romaneio 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, o layout, a identidade visual, os campos legais/fiscais e as personalizações de modelo de faturas e romaneios de embalagem configurados 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ário imprimir offline.

Exibição adaptativa de impostos

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

  • Lojas com impostos inclusos (UE/Reino Unido/Austrália) exibem preços brutos com uma linha "Imposto incluído".
  • Lojas com impostos não inclusos (EUA/Canadá) exibem preços líquidos com o imposto adicionado em uma linha separada.
  • O total geral sempre mostra o valor bruto efetivamente cobrado.

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

Como funciona

  1. Adicionar 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 pré-visualização ao vivo, ou cole-o no ChatGPT / Claude e peça as alterações desejadas.
  3. Ative-o — habilite 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 são abertos após a finalização da compra, 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 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, dados de contato) e ordenação de modelos — útil para operações com várias unidades em que cada loja imprime seu próprio cabeçalho.

Nesta seção