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

Modelos

O WCPOS inclui um sistema completo de modelos para recibos, faturas, recibos de presente, romaneios de envio, comandas de cozinha e mais — todos gerenciados em WP Admin → POS → Modelos.

Quer apenas alterar seu recibo?

Comece em Personalize seu recibo. Ele apresenta as três maneiras mais fáceis de fazer isso — escolher um modelo incluso diferente, pedir à IA para ajustá-lo ou editar manualmente.

Mecanismos de modelo

O WCPOS suporta três mecanismos de modelo. O mecanismo é escolhido ao criar um modelo ou ao clicar em Usar modelo em um cartão da galeria, e não pode ser alterado posteriormente — inicie um novo modelo se quiser trocar de mecanismo.

HTML sem lógica (recomendado)

Estilo Mustache {{variable}} placeholders dentro de HTML simples. Renderiza no lado do cliente, então 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, duas saídas. Use para impressoras térmicas Epson, Star e outras.

PHP Legado

Modelos PHP renderizados no servidor usando funções do WooCommerce. Mantidos para compatibilidade com yourtheme/woocommerce-pos/receipt.php substituições existentes. Requer 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, Nota Fiscal, Recibo de Presente, Comanda de Cozinha, Orçamento / Ordem 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 de Pré-visualização e um botão principal Usar Modelo — clicar em Usar Modelo cria uma cópia editável em Seus Modelos.

ModeloMotorDescrição
Recibo PadrãoHTMLRecibo padrão — logo, identidade da loja, itens, totais, pagamento
Recibo Padrão (RTL)HTMLVersão da direita para a esquerda para árabe, hebraico, persa e urdu
Minimalista / ModernoHTMLMesmas informações essenciais do Padrão, em menos espaço vertical
Recibo DetalhadoHTMLNota fiscal completa — coluna de SKU, preço unitário, discriminação de impostos por alíquota, endereços
Recibo de PresenteHTMLSomente itens, sem preços. Inclui mensagem de presente e política de devolução
FaturaHTMLFatura em página inteira A4/Carta com painel opcional "Como pagar" para pedidos não pagos
RomaneioHTMLDocumento para o depósito — itens + quantidades, endereço de entrega, sem preços
Orçamento / EstimativaHTMLDocumento pré-venda com preços e condições — 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 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, discriminação de impostos, reembolsos, pagamentos, condições, 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 o PDF Invoices & Packing Slips for WooCommerce da WP Overnight estiver ativo, o WCPOS também exibe Invoice (WP Overnight) e Packing Slip (WP Overnight) na lista de modelos de recibo. Esses modelos HTML renderizados no servidor delegam para a API de documentos da WP Overnight, reutilizando a numeração de faturas e guias de remessa, o layout, a identidade visual, os campos legais/fiscais e as personalizações de modelo configuradas nesse plugin.

Eles estão disponíveis apenas enquanto o plugin WP Overnight estiver ativo e requerem 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 (Standard, Standard RTL, Minimal/Modern, Narrow, Invoice, Quote, variantes Thermal Simple) se adapta automaticamente à configuração de exibição de impostos do WooCommerce:

  • Lojas com impostos inclusos (UE/Reino Unido/AU) exibem preços brutos com uma linha "Impostos inclusos".
  • Lojas com impostos exclusos (EUA/CA) exibem preços líquidos com o imposto adicionado como uma linha separada.
  • O total geral sempre exibe o valor bruto efetivamente cobrado.

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

Como funciona

  1. Adicionar um modelo — clique em Usar Modelo em um card da galeria, ou crie o seu do zero.
  2. Personalizar usando o editor integrado com pré-visualização ao vivo, ou cole no ChatGPT / Claude e solicite as alterações desejadas.
  3. Ativar — alterne o botão Ativo em Seus Modelos. Cada modelo de recibo ativo aparece no menu suspenso da tela de recibos no caixa.
  4. Imprimir ou exibir — os recibos são abertos após o checkout com opções para imprimir, enviar por e-mail ou visualizar na tela.

Os modelos são renderizados com base em um payload de dados de recibo padronizado, 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

Com o WCPOS Pro, cada loja pode ter suas próprias atribuições de modelo, identidade visual (logotipo, endereço, dados de contato) e ordenação de modelos — útil para operações com múltiplas localidades onde cada estabelecimento imprime seu próprio cabeçalho.

Nesta seção