Referência de dados do recibo
Os modelos HTML sem lógica e os modelos XML térmicos do WCPOS são renderizados a partir da mesma carga útil canônica de recibo. Use caminhos com ponto do Mustache, como {{order.number}}, {{store.name}} e {{totals.total_display}}. Os arrays são renderizados com seções:
{{#lines}}
{{name}} x {{qty}} — {{line_total_display}}
{{/lines}}
O contrato canônico é produzido no servidor pelo construtor de dados de recibo do WCPOS e espelhado pelo renderizador de recibos offline no aplicativo. Os recibos são abertos imediatamente a partir dos dados locais e, quando disponível, são atualizados com a resposta do servidor; portanto, os modelos personalizados devem usar os campos abaixo em vez de métodos de pedido PHP.
Os dados de recibo v1.1 adicionam campos registrados de preço normal, preço de venda antes do cupom e economia para cada linha de produto. Também fornecem totais de economia no nível do pedido, incluindo um valor de Total economizado que combina a economia do preço normal com os descontos do WooCommerce sem alterar os totais ou relatórios do pedido.
O recibo, por seções
Cada parte de um recibo impresso vem de uma seção do contrato de dados. Passe o cursor sobre qualquer um dos lados para ver a correspondência e clique para ir aos campos dessa seção. Todos os exemplos desta página usam o mesmo pedido de exemplo.
store.name · store.address_lines · store.tax_ids · store.logoorder.number · order.created · cashier.name · customer.namelines[] · line_savings · savings_in_discountstotals.* · discounts[] · fees[] · shipping[] · totals.total_savedpayments[]store.personal_notes · store.policies_and_conditions · i18n.thank_you_purchaseTarefas comuns nos modelos
A maioria das alterações de modelo corresponde a uma destas três tarefas. Cada cartão mostra primeiro o resultado impresso e depois a marcação exata, pronta para ser copiada em qualquer modelo HTML sem lógica ou XML térmico. O terceiro cartão mostra um pedido anterior à v1.9 em vez do pedido de exemplo acima.
{{# line_savings }}
<s>{{ line_regular_total_display }}</s>
{{ i18n.savings }}: -{{ line_savings_display }}
{{/ line_savings }}{{# totals.total_saved_complete }}
{{# totals.total_saved }}
{{ i18n.total_saved }}:
{{ totals.total_saved_display }}
{{/ totals.total_saved }}
{{/ totals.total_saved_complete }}{{# line_savings }}
{{^ savings_in_discounts }}
{{ i18n.savings }}: -{{ line_savings_display }}
{{/ savings_in_discounts }}
{{/ line_savings }}Regras de renderização
Campos de moeda
Os campos numéricos de valores monetários são preservados como números, e o renderizador adiciona campos _display adaptados à localidade para a saída do modelo:
| Campo numérico | Campo de exibição |
|---|---|
totals.total | totals.total_display |
lines[].line_total | lines[].line_total_display |
payments[].amount | payments[].amount_display |
tax_summary[].tax_amount | tax_summary[].tax_amount_display |
Prefira campos _display ao imprimir recibos. Use campos numéricos apenas em seções condicionais ou em saídas legíveis por máquina.
Campos compatíveis com a exibição de impostos
Diversos campos têm variantes com e sem impostos, além de um valor de conveniência para exibição. O valor de conveniência segue a configuração da loja para exibição de impostos no carrinho.
| Campo de conveniência | Campo com impostos | Campo sem impostos |
|---|---|---|
lines[].regular_price | lines[].regular_price_incl | lines[].regular_price_excl |
lines[].selling_price | lines[].selling_price_incl | lines[].selling_price_excl |
lines[].unit_savings | lines[].unit_savings_incl | lines[].unit_savings_excl |
lines[].line_regular_total | lines[].line_regular_total_incl | lines[].line_regular_total_excl |
lines[].line_selling_total | lines[].line_selling_total_incl | lines[].line_selling_total_excl |
lines[].line_savings | lines[].line_savings_incl | lines[].line_savings_excl |
lines[].unit_price | lines[].unit_price_incl | lines[].unit_price_excl |
lines[].unit_subtotal | lines[].unit_subtotal_incl | lines[].unit_subtotal_excl |
lines[].line_subtotal | lines[].line_subtotal_incl | lines[].line_subtotal_excl |
lines[].discounts | lines[].discounts_incl | lines[].discounts_excl |
lines[].line_total | lines[].line_total_incl | lines[].line_total_excl |
fees[].total | fees[].total_incl | fees[].total_excl |
shipping[].total | shipping[].total_incl | shipping[].total_excl |
discounts[].total | discounts[].total_incl | discounts[].total_excl |
totals.subtotal | totals.subtotal_incl | totals.subtotal_excl |
totals.discount_total | totals.discount_total_incl | totals.discount_total_excl |
totals.sale_savings_total | totals.sale_savings_total_incl | totals.sale_savings_total_excl |
totals.total_saved | totals.total_saved_incl | totals.total_saved_excl |
totals.total | totals.total_incl | totals.total_excl |
Objetos de data
Os campos de data são objetos com várias variantes pré-formatadas. Isso evita a formatação de datas dentro do Mustache.
| Campo | Descrição |
|---|---|
datetime, date, time | Strings padrão de data/hora |
datetime_short, datetime_long, datetime_full | Formatos combinados que consideram a localidade |
date_short, date_long, date_full | Formatos somente de data que consideram a localidade |
date_ymd, date_dmy, date_mdy | Formatos de data com ordem fixa |
weekday_short, weekday_long | Nomes dos dias da semana |
day, month, month_short, month_long, year | Partes individuais da data |
Objetos de data disponíveis: order.created, order.paid, order.completed, order.printed e refunds[].date. order.printed é atualizado no momento da renderização, o que é útil para reimpressões.
Seções de nível superior
| Seção | Tipo | Descrição |
|---|---|---|
order | objeto | Informações de identificação, status, datas, observação e URL de pagamento do pedido |
store | objeto | Identificação da loja, endereço, dados de contato, IDs fiscais, logo, horário de funcionamento e texto do rodapé |
cashier | objeto | Usuário que processou o pedido |
customer | objeto | Nome de exibição do cliente, endereços e IDs fiscais |
lines | matriz | Itens de linha do produto |
fees | matriz | Linhas de taxas |
shipping | matriz | Linhas de entrega |
discounts | matriz | Linhas de cupons/descontos |
totals | objeto | Totais do pedido, totais de pagamento, resumo de reembolsos e contagens de itens |
tax | objeto | Sinalizadores do modo de exibição de impostos para condicionais de seção |
tax_summary | matriz | Linhas de resumo de impostos por alíquota |
has_tax_summary | booleano | Verificação prática para tax_summary |
payments | matriz | Linhas de pagamento |
refunds | matriz | Registros de reembolso aplicados ao pedido |
fiscal | objeto | Campos de instantâneo fiscal preenchidos por integrações fiscais |
presentation_hints | objeto | Dicas de formatação e renderização |
i18n | objeto | Rótulos traduzidos para modelos incluídos e personalizados |
Relação entre os preços
Uma linha de produto contém vários preços, e os nomes ficam mais claros quando aparecem sobre o próprio valor. Esta é a linha de espresso do pedido de exemplo: um produto com preço normal de US$ 17,00, em promoção por US$ 14,50, com mais 10% de desconto por cupom.
unit_price → 13.05 · line_total → 26.10lines[].discounts → 2.90 nesta linhaunit_savings → 2.50 · line_savings → 5.00totals.sale_savings_total = 5.00totals.discount_total = 5.28totals.total_saved = 10.28Economia e descontos de cupons são conceitos diferentes: a economia compara o preço de venda com o preço normal registrado, enquanto discounts representa o cálculo de cupons do WooCommerce. Os totais e relatórios de pedidos do WooCommerce contêm apenas a parte do cupom. Por isso, total_saved é o valor único voltado ao cliente que combina os dois montantes.
Referência dos campos
A referência completa dos campos está agrupada por seção abaixo. Tudo fica recolhido por padrão — expanda o grupo necessário.
pedido — identidade, status, datas
pedido
| Campo | Tipo | Exemplo / descrição |
|---|---|---|
order.id | número | 1234 |
order.number | cadeia de caracteres | Número do pedido visível ao usuário, por exemplo, "10045" |
order.currency | cadeia de caracteres | Código de moeda ISO, por exemplo, "USD" |
order.customer_note | cadeia de caracteres | Observação do cliente/pedido |
order.wc_status | cadeia de caracteres | Slug bruto do status do WooCommerce, por exemplo, "processing" |
order.status_label | cadeia de caracteres | Rótulo de status localizado, incluindo status personalizados |
order.created_via | cadeia de caracteres | Origem/canal, por exemplo, "woocommerce-pos" |
order.needs_payment | booleano | Se uma seção de pagamento deve ser exibida |
order.payment_url | cadeia de caracteres | URL de pagamento do pedido, quando disponível |
order.created | objeto de data | Data de criação do pedido |
order.paid | objeto de data | Data de pagamento; cadeias de caracteres vazias quando não pago |
order.completed | objeto de data | Data de conclusão; cadeias de caracteres vazias quando incompleto |
order.printed | objeto de data | Carimbo de data e hora de impressão/reimpressão no momento da renderização |
loja — identidade, endereço, contato, horário de funcionamento
loja
| Campo | Tipo | Exemplo / descrição |
|---|---|---|
store.id | número | ID da loja ou ID histórico de lojas excluídas |
store.name | texto | Nome de exibição da loja |
store.address.address_1 | texto | Linha 1 do endereço |
store.address.address_2 | texto | Linha de complemento/unidade |
store.address.city | texto | Cidade/localidade |
store.address.state | texto | Estado/região |
store.address.postcode | texto | CEP |
store.address.country | texto | Código do país ISO |
store.address_lines | matriz | Linhas de endereço pré-formatadas; recomendadas para a maioria dos modelos |
store.tax_ids | matriz | IDs fiscais estruturados da empresa; use um loop em vez de um único ID fiscal |
store.phone | texto | Telefone da loja |
store.email | texto | E-mail da loja |
store.logo | texto/nulo | URL do logotipo da loja ou URI de dados |
store.opening_hours | texto/nulo | Texto compacto de horário de funcionamento |
store.opening_hours_vertical | texto/nulo | Bloco de horário de funcionamento em várias linhas |
store.opening_hours_inline | texto/nulo | Texto de horário de funcionamento separado por vírgulas |
store.opening_hours_notes | texto/nulo | Notas de texto livre sobre o horário de funcionamento |
store.personal_notes | texto/nulo | Rodapé do recibo/nota pessoal |
store.policies_and_conditions | texto/nulo | Texto de reembolso, devoluções ou termos |
store.footer_imprint | texto/nulo | Informações legais no rodapé |
Objetos de ID fiscal
store.tax_ids e customer.tax_ids contêm objetos com a mesma estrutura:
| Campo | Tipo | Descrição |
|---|---|---|
type | texto | Identificador como eu_vat, de_steuernummer, au_abn, br_cpf, us_ein ou other |
value | texto | Valor do ID fiscal a ser impresso |
country | texto/nulo | Código de país ISO, quando conhecido |
label | texto/nulo | Rótulo de exibição localizado, resolvido antes da renderização |
Exemplo:
{{#store.tax_ids}}
{{label}}: {{value}}
{{/store.tax_ids}}
operador de caixa — usuário que processou o pedido
operador de caixa
| Campo | Tipo | Exemplo / descrição |
|---|---|---|
cashier.id | número | ID do usuário do WordPress, 0 quando desconhecido |
cashier.name | texto | Nome de exibição do operador de caixa |
cliente — nome, endereços, IDs fiscais
cliente
| Campo | Tipo | Exemplo / descrição |
|---|---|---|
customer.id | número/null | ID do cliente ou null para convidados |
customer.name | cadeia de caracteres | Nome de exibição do cliente ou rótulo de convidado |
customer.billing_address.* | objeto | Campos de endereço de cobrança do WooCommerce |
customer.shipping_address.* | objeto | Campos de endereço de entrega do WooCommerce |
customer.tax_ids | matriz | IDs fiscais estruturados do cliente registrados no pedido |
As chaves de endereço comuns incluem first_name, last_name, company, address_1, address_2, city, state, postcode, country, email e phone.
itens — itens de linha de produtos
itens
Use um loop com {{#lines}}...{{/lines}}.
| Campo | Tipo | Descrição |
|---|---|---|
key | cadeia de caracteres | Chave estável da linha/ID do item do pedido |
sku | cadeia de caracteres | SKU do produto |
name | cadeia de caracteres | Nome de exibição do produto ou da linha |
qty | número | Quantidade vendida |
qty_refunded | número | Quantidade reembolsada desta linha |
regular_price / _incl / _excl | número/nulo | Preço unitário regular registrado |
selling_price / _incl / _excl | número/null | Preço unitário de venda antes do cupom — o preço registrado no POS quando disponível; caso contrário, derivado do subtotal da linha armazenado |
unit_savings / _incl / _excl | número/nulo | regular_price - selling_price, com mínimo de zero |
line_regular_total / _incl / _excl | número/nulo | Preço regular registrado multiplicado pela quantidade |
line_selling_total / _incl / _excl | número/nulo | Preço de venda antes dos cupons multiplicado pela quantidade |
line_savings / _incl / _excl | número/nulo | Economia total entre o preço regular e o preço de venda desta linha |
savings_in_discounts | booleano | Verdadeiro quando um pedido legado já inclui a mesma economia em discounts |
unit_subtotal / _incl / _excl | número | Valor unitário do WooCommerce antes dos descontos; não use como preço regular |
unit_price / _incl / _excl | número | Valor unitário final após os descontos do WooCommerce |
line_subtotal / _incl / _excl | número | Subtotal da linha no WooCommerce antes dos descontos |
discounts / _incl / _excl | número | Desconto nativo da linha do WooCommerce como valor positivo; normalmente apenas de cupom em pedidos atuais |
line_total / _incl / _excl | número | Total final da linha |
total_refunded | número | Total reembolsado para esta linha como valor positivo |
taxes | matriz | Linhas de imposto por alíquota para esta linha |
meta | matriz | Metadados do item do pedido como pares {key, value} |
attributes | matriz | Atributos do produto/variação como pares {key, value} |
Cada campo monetário tem um correspondente _display formatado, incluindo regular_price_display, selling_price_display, unit_savings_display, line_regular_total_display, line_selling_total_display e line_savings_display. Os campos com impostos incluídos e excluídos também têm variantes _display. Quando um campo de economia anulável é null, seu correspondente _display é totalmente omitido.
Os campos de economia são null quando o pedido não contém dados de preço do POS registrados suficientes. Portanto, os modelos devem envolvê-los em seções Mustache, em vez de presumir que todos os pedidos históricos têm um preço regular.
Exibição do preço normal e da economia
Para um layout de preço unitário, exiba o preço normal registrado, o preço de venda e a economia desta forma:
{{#lines}}
{{#unit_savings}}
<span style="text-decoration: line-through;">{{regular_price_display}}</span>
<span>{{selling_price_display}}</span>
<span>{{i18n.savings}}: -{{unit_savings_display}}</span>
{{/unit_savings}}
{{/lines}}
Use os campos de total da linha quando a quantidade for relevante:
{{#lines}}
{{#line_savings}}
<span style="text-decoration: line-through;">{{line_regular_total_display}}</span>
<span>{{i18n.savings}}: -{{line_savings_display}}</span>
{{/line_savings}}
{{/lines}}
selling_price é o preço antes dos cupons. Use unit_price ou line_total para o valor final após os descontos do WooCommerce.
Pedidos WCPOS mais antigos podem já incluir a redução do preço normal para o preço de venda em discounts. Se o seu modelo personalizado imprimir tanto as economias da linha quanto os descontos da linha, use savings_in_discounts para evitar mostrar a mesma redução duas vezes:
{{#lines}}
{{#line_savings}}
<span style="text-decoration: line-through;">{{line_regular_total_display}}</span>
{{^savings_in_discounts}}
<span>{{i18n.savings}}: -{{line_savings_display}}</span>
{{/savings_in_discounts}}
{{/line_savings}}
{{#discounts}}
<span>{{i18n.discount}}: -{{discounts_display}}</span>
{{/discounts}}
{{/lines}}
Se o modelo não imprimir uma linha de discounts no nível da linha, continue mostrando line_savings mesmo quando savings_in_discounts for verdadeiro. Os modelos incluídos tratam essa distinção automaticamente.
taxas e frete
Taxas e frete
Faça iteração com {{#fees}}...{{/fees}} e {{#shipping}}...{{/shipping}}.
| Campo | Tipo | Descrição |
|---|---|---|
label | cadeia de caracteres | Rótulo da taxa ou nome do método de envio |
method_id | cadeia de caracteres | ID do método de envio (somente envio) |
total / _incl / _excl | número | Totais de exibição, inclusivos e exclusivos |
taxes | matriz | Linhas de impostos por alíquota |
meta | matriz | Pares de metadados {key, value} |
Variantes formatadas: total_display, total_incl_display e total_excl_display.
descontos — linhas de cupons/descontos
descontos
Use um loop com {{#discounts}}...{{/discounts}}.
| Campo | Tipo | Descrição |
|---|---|---|
label | cadeia de caracteres | Descrição do cupom ou código alternativo |
code | cadeia de caracteres | Código do cupom |
total / _incl / _excl | número | Valor do desconto como valor positivo |
Variantes formatadas: total_display, total_incl_display e total_excl_display. Adicione seu próprio sinal de menos ao modelo se quiser que os descontos sejam exibidos como linhas negativas.
totais — totais do pedido, pagamento, reembolso e itens
totais
| Campo | Tipo | Descrição |
|---|---|---|
totals.subtotal / _incl / _excl | número | Subtotal do pedido antes dos descontos |
totals.discount_total / _incl / _excl | número | Total de descontos do pedido como valor positivo |
totals.sale_savings_total / _incl / _excl | número/nulo | Total das economias registradas entre o preço normal e o preço de venda nas linhas de produtos, incluindo vendas de catálogo e alterações de preço no caixa |
totals.total_saved / _incl / _excl | número/nulo | Descontos combinados do WooCommerce e economias no preço normal, com sobreposição legada removida |
totals.total_saved_complete | booleano | Indica se o recibo tem dados de preço registrados suficientes para calcular os totais completos de economia |
totals.tax_total | número | Valor total de impostos |
totals.total / _incl / _excl | número | Total geral do pedido |
totals.paid_total | número | Valor pago/aplicado |
totals.change_total | número | Troco devolvido ao cliente |
totals.refund_total | número | Total reembolsado como valor positivo |
totals.net_total | número | total - refund_total, com mínimo de zero |
totals.total_qty | número | Soma das quantidades dos itens de linha |
totals.line_count | número | Número de linhas de produtos |
As variantes formatadas incluem subtotal_display, discount_total_display, sale_savings_total_display, total_saved_display, tax_total_display, total_display, paid_total_display, change_total_display, refund_total_display e net_total_display, além de variantes inclusivas/exclusivas quando aplicável.
Use total_saved quando quiser um único valor voltado ao cliente para tudo o que foi economizado. Não o calcule somando discount_total e sale_savings_total no modelo: pedidos criados antes da v1.9.0 podem já incluir a economia de preço do POS no total de descontos do WooCommerce. O campo canônico total_saved detecta e remove essa sobreposição.
Os totais de economia são null e total_saved_complete é falso quando alguma linha de produto não tem dados de preço registrados suficientes para um agregado confiável. Proteja a linha com total_saved_complete e use total_saved para ocultar um valor zero:
{{#totals.total_saved_complete}}
{{#totals.total_saved}}
<span>{{i18n.total_saved}}: {{totals.total_saved_display}}</span>
{{/totals.total_saved}}
{{/totals.total_saved_complete}}
Os modelos incluídos que exibem preços usam a mesma estrutura de verificação com as variantes com impostos incluídos (total_saved_incl e total_saved_incl_display) e mostram Total economizado somente quando o valor completo é maior que zero.
tax e tax_summary — proteções de exibição e linhas por alíquota
tax e tax_summary
Use tax para condições do modo de exibição e tax_summary para linhas de alíquotas discriminadas.
| Campo de imposto | Tipo | Descrição |
|---|---|---|
tax.display | cadeia de caracteres | incl ou excl |
tax.display_incl | booleano | Verdadeiro quando os preços são exibidos com impostos incluídos |
tax.display_excl | booleano | Verdadeiro quando os preços são exibidos sem impostos |
tax.breakdown | cadeia de caracteres | hidden, single ou itemized |
tax.breakdown_hidden | booleano | Verdadeiro quando as linhas de imposto devem ser ocultadas |
tax.breakdown_single | booleano | Verdadeiro quando é preferido um único total de impostos |
tax.breakdown_itemized | booleano | Verdadeiro quando são preferidas linhas por alíquota |
has_tax_summary | booleano | Verdadeiro quando tax_summary contém linhas |
Percorra tax_summary com {{#tax_summary}}...{{/tax_summary}}.
| Campo | Tipo | Descrição |
|---|---|---|
code | texto | ID/código da alíquota de imposto |
rate | número/nulo | Percentual da alíquota quando definido |
label | texto | Rótulo da alíquota de imposto |
compound | booleano | Indica se a alíquota é composta |
taxable_amount_excl | número/nulo | Base tributável sem imposto |
tax_amount | número | Imposto recolhido |
taxable_amount_incl | número/nulo | Base tributável com imposto |
Variantes formatadas: taxable_amount_excl_display, tax_amount_display e taxable_amount_incl_display.
payments — linhas de pagamento
pagamentos
Use o loop {{#payments}}...{{/payments}}.
| Campo | Tipo | Descrição |
|---|---|---|
method_id | texto | Identificador do método de pagamento |
method_title | texto | Título de exibição do método de pagamento |
amount | número | Valor aplicado ao pedido |
transaction_id | texto | ID da transação do gateway |
tendered | número | Valor em dinheiro entregue, quando presente |
change | número | Troco devolvido, quando presente |
Variantes formatadas: amount_display, tendered_display e change_display.
refunds — registros de reembolso
reembolsos
Use um loop com {{#refunds}}...{{/refunds}}. Os valores de reembolso são positivos; os modelos definem se devem adicionar um sinal de menos ou renderizar um bloco separado de itens devolvidos.
| Campo | Tipo | Descrição |
|---|---|---|
id | número | ID do registro de reembolso |
date | objeto de data | Data de criação do reembolso |
amount | número | Total do reembolso |
subtotal | número | Subtotal das linhas reembolsadas |
tax_total | número | Imposto reembolsado |
shipping_total | número | Valor do frete reembolsado |
shipping_tax | número | Imposto do frete reembolsado |
reason | cadeia de caracteres | Motivo do reembolso |
refunded_by_id | número/nulo | ID do usuário que emitiu o reembolso |
refunded_by_name | cadeia de caracteres | Nome de exibição do usuário que emitiu o reembolso |
refunded_payment | booleano | Indica se o pagamento foi reembolsado pelo gateway |
destination | cadeia de caracteres | original_method, cash ou manual |
gateway_id | texto | ID do gateway usado para o reembolso |
gateway_title | texto | Título de exibição do gateway |
processing_mode | texto | Modo de processamento do provedor/manual |
lines | matriz | Linhas de produtos reembolsados |
fees | matriz | Linhas de taxas reembolsadas |
shipping | matriz | Linhas de frete reembolsadas |
Os campos da linha de reembolso incluem name, sku, qty, total, total_incl, total_excl, line_total, unit_total e taxes. As linhas de taxas e frete do reembolso usam label, total, total_incl, total_excl e taxes. Variantes de exibição são adicionadas para totais e valores de impostos.
fiscal — instantâneo da integração fiscal
fiscal
Os campos fiscais ficam vazios por padrão e são preenchidos por integrações fiscais ou pelo enriquecimento de instantâneos do WCPOS Pro.
| Campo | Tipo | Descrição |
|---|---|---|
fiscal.immutable_id | texto | Identificador fiscal imutável |
fiscal.receipt_number | cadeia de caracteres | Número do recibo fiscal |
fiscal.sequence | número/nulo | Contador de sequência |
fiscal.hash | cadeia de caracteres | Valor de hash/assinatura |
fiscal.qr_payload | cadeia de caracteres | Carga útil do QR para verificação fiscal |
fiscal.tax_agency_code | cadeia de caracteres | Código da autoridade fiscal |
fiscal.signed_at | cadeia de caracteres | Data e hora da assinatura fiscal |
fiscal.signature_excerpt | cadeia de caracteres | Assinatura truncada para exibição |
fiscal.document_label | cadeia de caracteres | Rótulo do documento, por exemplo, Nota Fiscal |
fiscal.is_reprint | booleano | Se esta renderização é uma reimpressão |
fiscal.reprint_count | número | Número de reimpressões |
fiscal.extra_fields | matriz/objeto | Valores específicos da jurisdição |
presentation_hints — dicas de formatação e renderização
presentation_hints
Esses campos são consumidos principalmente pelo renderizador e pelo formatador. Eles ficam disponíveis para os modelos quando necessário.
| Campo | Tipo | Descrição |
|---|---|---|
presentation_hints.display_tax | cadeia de caracteres | incl, excl, hidden, itemized ou single |
presentation_hints.prices_entered_with_tax | booleano | Se os preços do catálogo incluem impostos |
presentation_hints.rounding_mode | cadeia de caracteres | Configuração de arredondamento de impostos do WooCommerce |
presentation_hints.locale | cadeia de caracteres | Localidade usada para formatação |
presentation_hints.timezone | cadeia de caracteres | Fuso horário do recibo |
presentation_hints.currency_position | cadeia de caracteres | Posição do símbolo da moeda |
presentation_hints.currency_symbol | cadeia de caracteres | Símbolo da moeda |
presentation_hints.price_thousand_separator | cadeia de caracteres | Separador de milhares |
presentation_hints.price_decimal_separator | cadeia de caracteres | Separador decimal |
presentation_hints.price_num_decimals | número | Casas decimais |
presentation_hints.price_display_suffix | cadeia de caracteres | Sufixo de exibição de preço do WooCommerce |
presentation_hints.order_barcode_type | cadeia de caracteres | Tipo de código de barras usado pelos modelos de galeria |
i18n — rótulos traduzidos
i18n
Use rótulos i18n em vez de codificar texto diretamente sempre que possível:
{{i18n.order}} #{{order.number}}
{{i18n.cashier}}: {{cashier.name}}
{{i18n.total}}: {{totals.total_display}}
As chaves comuns incluem order, date, cashier, customer, item, sku, qty, unit_price, regular_price, selling_price, savings, discount, subtotal, total_saved, total, tax, paid, tendered, change, tax_summary, refunded, net_total, customer_note, thank_you_purchase, opening_hours e as chaves de rótulo de ID fiscal, como store_tax_id_label_eu_vat e customer_tax_id_label_other. Chaves adicionais podem ser incluídas por extensões.