Ir al contenido principal
Versión: 2.x

Plantillas HTML

Administración de WordPress: las plantillas HTML se editan en WP Admin → POS → Templates.

Cambie el texto o el diseño de un recibo editando una plantilla HTML: un recibo con el diseño de una página web, con {{placeholders}} donde van los datos del pedido. Si prefiere cambiar a otro recibo prediseñado, consulte Personalice su recibo.

¿HTML o térmica?

Use HTML para imprimir desde el navegador, generar PDF, crear facturas A4 e imprimir en impresoras que admitan páginas web. Para una impresora de recibos que acepte comandos ESC/POS, use una plantilla térmica. HTML es el motor que recomendamos para la mayoría de las tiendas. El POS rellena la plantilla HTML en el propio dispositivo, por lo que permite previsualizarla e imprimirla incluso cuando se pierde la conexión con la tienda.

Ir directamente a: Escribir una plantilla · Sintaxis · Patrones habituales · Si algo sale mal

Escribir una plantilla​

No empiece desde una página en blanco: copie una plantilla de la galería y edite la copia.

  1. En la Galería de plantillas, pulse Usar plantilla en la tarjeta que más se acerque a lo que busca. Obtendrá su propia copia en Sus plantillas; el original de la galería se conserva tal cual.

  2. Abra su copia. Campos enumera todos los marcadores de posición: busque el que necesite y pulse Insertar, sin tener que recordar los nombres. Vista previa rellena la plantilla con Datos de ejemplo o con uno de sus pedidos del POS mientras escribe.

  3. Cambie lo que necesite. Por ejemplo, para añadir una línea sobre devoluciones a su copia de Recibo estándar, busque {{i18n.thank_you_purchase}} cerca del final. La siguiente etiqueta </div> cierra el pie de página. Copie estas líneas después de esa etiqueta </div>:

    <div style="text-align: center;">
    Returns within 30 days
    with this receipt.
    </div>

    El texto escrito se imprime exactamente como se ha introducido, en un solo idioma. Aplique los estilos a cada elemento (style="…"), como en este ejemplo, y no en un bloque <style> : consulte Los estilos pueden desaparecer al imprimir.

  4. Pulse Actualizar. Todos los recibos impresos con su copia mostrarán el cambio, como la línea sobre devoluciones debajo del mensaje del pie de página.

  5. En Sus plantillas, habilite Activa para que el POS ofrezca la plantilla en la caja.

    Hacer que esta sea la primera plantilla en la caja

    La caja muestra las plantillas activas en el orden de Sus plantillas y empieza cada venta con la primera. Suba la suya arrastrando el control ≡ de su fila o mediante los botones ↑ y ↓ de la columna Acciones. Una tienda con su propia lista de plantillas mantiene su propio orden. Consulte Qué ven los cajeros en la caja.

  6. Compruébela en el POS antes de utilizarla en la caja: consulte Comprobarla en el POS.

Comprobarla en el POS​

La vista previa del editor tolera errores que el POS no admite, por lo que una plantilla solo está lista cuando se ve correctamente en la caja.

Para echar un vistazo rápido al diseño, no hace falta una venta: añada un artículo al carrito, pulse ⋮ junto a Pagar y luego Imprimir. Se abrirán el selector de plantilla y la vista previa del pedido del carrito. Las plantillas HTML se pueden previsualizar allí incluso antes de que el pedido llegue a la tienda; la Plantilla PHP heredada le pide que sincronice primero el pedido.

Antes de utilizarla en la caja, compruebe todos los importes con una venta real:

  1. Registre un pedido similar a los que más suele tramitar: una línea con descuento, un producto con impuestos y un pago en efectivo con cambio.
  2. En la pantalla de pago completado, elija su plantilla en Plantilla.
  3. Revise la vista previa: nombres, precios, descuento, líneas de impuestos, efectivo entregado y cambio.
  4. Imprímala como se hará en la caja, con Imprimir recibo o Descargar PDF, y compruebe también el papel o el archivo. Los estilos pueden desaparecer al imprimir.

La pantalla de pago completado, con el Recibo estándar de la galería seleccionado:

La pantalla de pago completado tras una venta en efectivo con la plantilla HTML Recibo estándar seleccionada: el cambio y el importe pagado, los selectores de Plantilla e Impresora, la vista previa del recibo rellenado con sus controles de zoom y los botones Enviar recibo por correo electrónico, Descargar PDF, Imprimir recibo y Nueva venta
  1. Cambio — lo que se debe devolver. En un recibo, corresponde a {{change_display}} dentro de {{#payments}}.
  2. Pagado con — el importe y la forma de pago: {{amount_display}} y {{method_title}} en un recibo.
  3. Plantilla — elija aquí su plantilla. Solo se muestran las plantillas activas; la selección se aplica a esta venta. Consulte Personalice su recibo.
  4. Impresora — dónde se imprime. Consulte Imprimir el recibo.
  5. Vista previa — su plantilla, rellenada por el POS con los datos de esta venta: el recibo tal como se imprimirá. − y + ajustan el zoom.
  6. Imprimir recibo — lo imprime en la impresora indicada arriba.
  7. Enviar recibo por correo electrónico — lo envía al cliente.
  8. Nueva venta — un carrito vacío para el siguiente cliente.

Descargar PDF, junto a Enviar recibo por correo electrónico, hace que la tienda genere el recibo como PDF, por lo que necesita conexión. Más información sobre esta pantalla: Recibos al pagar.

Conserve el original

Cada vez que pulsa Usar plantilla se crea una copia nueva. Mientras hace pruebas, cree dos copias (Recibo v1, Recibo v2) y alterne entre ellas en la caja.

Sintaxis​

Los marcadores de posición usan Mustache, un pequeño lenguaje de plantillas. No tiene lógica propia. Hace tres cosas: rellena un valor, repite un bloque por cada elemento de una lista y muestra u oculta un bloque.

Variables​

Ponga el nombre de un campo entre llaves dobles:

<h1>{{store.name}}</h1>
<p>Order #{{order.number}}</p>
<p>Total: {{totals.total_display}}</p>

Un campo que termina en _display contiene el importe ya formateado para su tienda ($12.50 en lugar de 12.5). La Referencia de datos del recibo enumera todos los campos.

Escape de caracteres​

{{field}} imprime el valor como texto sin formato: un < en el nombre de un producto se muestra como <, nunca como HTML. Con tres llaves, {{{field}}}, se imprime como HTML. Ese HTML también se depura antes de imprimirse (consulte Estilos), por lo que un campo nunca puede añadir un script.

Secciones (bucles y condicionales)​

{{#section}}...{{/section}} repite el bloque por cada elemento de una lista o lo muestra una vez cuando el valor está presente.

Ejemplo: una fila por línea de artículo
{{#lines}}
<div class="line-item">
<span>{{name}} × {{qty}}</span>
<span>{{line_total_display}}</span>
</div>
{{/lines}}

Dentro de una sección, un nombre se busca primero en el elemento actual y luego fuera de él. Por eso {{i18n.tendered}} funciona dentro de {{#payments}}. {{.}} es el propio elemento actual en una lista de texto sin formato como store.address_lines.

Secciones invertidas​

{{^section}}...{{/section}} muestra el bloque cuando el valor falta, está vacío o es false o 0.

Ejemplo: nombre del cliente o «Compra como invitado»
{{#customer.id}}
<p>Customer: {{customer.name}}</p>
{{/customer.id}}
{{^customer.id}}
<p>Guest checkout</p>
{{/customer.id}}

Etiquetas localizadas​

{{i18n.key}} imprime una etiqueta en el idioma de su tienda, por lo que una misma plantilla sirve para todas las tiendas.

Ejemplo: una etiqueta Subtotal traducida
<th>{{i18n.subtotal}}</th>
<td>{{totals.subtotal_display}}</td>

Las etiquetas siguen el idioma de WordPress de la tienda, no el idioma que el cajero haya elegido en la aplicación. Todas las claves figuran en la referencia de i18n.

Qué no admite el POS
  • Plantillas parciales ({{> name}}) no imprimen nada en el POS. Incluya todo en una sola plantilla.
  • Lambdas (funciones en lugar de valores) no son posibles: los datos del recibo solo contienen valores simples.
  • Comentarios ({{! a note }}) y delimitadores modificados ({{=<% %>=}}) funcionan como en cualquier plantilla Mustache.

Patrones habituales​

Encabezado de la tienda​

store.address_lines contiene la dirección ya dividida en líneas. Recórrala con un bucle en lugar de unir los campos de dirección manualmente.

Ejemplo: logotipo, nombre, dirección, teléfono e identificadores fiscales
<div style="text-align: center;">
{{#store.logo}}<img src="{{store.logo}}" alt="{{store.name}}" style="max-width: 200px;" />{{/store.logo}}
<h1 style="margin: 8px 0;">{{store.name}}</h1>
{{#store.address_lines}}<div>{{.}}</div>{{/store.address_lines}}
{{#store.phone}}<div>{{store.phone}}</div>{{/store.phone}}
{{#store.tax_ids}}<div>{{label}}: {{value}}</div>{{/store.tax_ids}}
</div>

El logotipo procede de los ajustes de la tienda, no de la plantilla. Consulte Personalice su recibo.

Líneas de artículos con descuentos​

El campo discounts de una línea es el descuento como número positivo, o 0 si no lo hay. Mustache considera 0 un valor vacío, por lo que {{#discounts}}...{{/discounts}} solo muestra el bloque en una línea con descuento.

Ejemplo: cada línea con su descuento
{{#lines}}
<div class="line-item" style="display: flex; justify-content: space-between;">
<div>
<div>{{name}} × {{qty}}</div>
{{#discounts}}
<div style="font-size: 0.9em;">
<s>{{line_subtotal_display}}</s> −{{discounts_display}}
</div>
{{/discounts}}
</div>
<div>{{line_total_display}}</div>
</div>
{{/lines}}

line_subtotal_display es el importe de la línea antes de los descuentos y line_total_display, después. Para los precios rebajados y el ahorro, consulte Mostrar el precio normal y el ahorro.

Resumen de impuestos​

tax_summary tiene una fila por tipo impositivo. rate es un porcentaje, como 10. Puede estar vacío (un tipo del 0% o un recibo impreso sin conexión), por lo que la condición {{#rate}} evita que aparezca (%) sin ningún valor en el recibo.

Ejemplo: una fila por tipo impositivo
{{#tax_summary}}
<div class="tax-line" style="display: flex; justify-content: space-between;">
<span>{{label}}{{#rate}} ({{rate}}%){{/rate}}</span>
<span>{{tax_amount_display}}</span>
</div>
{{/tax_summary}}

Detalles del pago​

¿Se ha impreso antes de que el pedido llegue a la tienda, por ejemplo, sin conexión? El recibo omite el efectivo recibido y el cambio. Vuelva a imprimirlo cuando se sincronice el pedido. La pantalla de pago completado muestra el cambio en ambos casos.

El motivo y un ejemplo con el efectivo entregado y el cambio

El propio POS calcula el Cambio de la pantalla de pago completado. Los campos tendered y change del recibo proceden de la tienda, por lo que están vacíos hasta que se sincroniza el pedido y se omite el bloque {{#tendered}}.

{{#payments}}
<div class="payment" style="display: flex; justify-content: space-between;">
<span>{{method_title}}</span>
<span>{{amount_display}}</span>
</div>
{{#tendered}}
<div style="display: flex; justify-content: space-between;">
<span>{{i18n.tendered}}</span><span>{{tendered_display}}</span>
</div>
<div style="display: flex; justify-content: space-between;">
<span>{{i18n.change}}</span><span>{{change_display}}</span>
</div>
{{/tendered}}
{{/payments}}

Códigos de barras y códigos QR​

Use los mismos elementos que en las plantillas térmicas. El valor va dentro del elemento y el POS dibuja el código en su lugar.

Ejemplo: Code 128, EAN-13 y un código QR
<!-- Code 128 barcode of the order number -->
<barcode type="code128" height="40">{{order.number}}</barcode>

<!-- EAN-13 of each product, when your SKUs are EAN numbers -->
{{#lines}}<barcode type="ean13" height="30">{{sku}}</barcode>{{/lines}}

<!-- QR code: size sets how big, 4 by default -->
{{#order.payment_url}}<qrcode size="4">{{order.payment_url}}</qrcode>{{/order.payment_url}}
  • Especifique siempre type. Si no lo hace, el POS dibuja un Code 128 y el PDF de la tienda, un código QR.
  • Para los números de pedido, use Code 128. Use EAN-13 solo cuando el SKU sea un código de producto EAN válido.
Tipos de códigos de barras, tamaños de QR y tipos mediante marcadores de posición
  • Elija entre estos tipos: code128, code39, code93, ean13, ean8, upca, upce, codabar, itf y qrcode. El POS puede dibujar otros tipos de bwip-js, como pdf417, pero la vista previa del editor y el PDF los dibujan como Code 128.

  • Use <qrcode size="…"> para los códigos QR. <barcode type="qrcode"> (o qr) también dibuja uno, pero el POS calcula su tamaño a partir de height y el PDF a partir de size, por lo que no coinciden.

  • type puede ser un marcador de posición, porque los marcadores de posición se rellenan antes de dibujar los códigos:

    <barcode type="{{presentation_hints.order_barcode_type}}">{{order.number}}</barcode>

Si el valor no corresponde al tipo, el POS muestra un bloque Error de código de barras o Error de código QR con el valor dentro. Corrija el valor o elija un tipo que lo admita. El PDF imprime únicamente el valor.

Estilos​

Aplique los estilos a cada elemento en línea, con un atributo style="…", como hacen las plantillas de la galería:

<div style="font-family: monospace; font-size: 12px; max-width: 300px; margin: 0 auto;">
<div style="text-align: center; margin-bottom: 16px;">
<strong style="font-size: 16px;">{{store.name}}</strong>
</div>
<div style="display: flex; justify-content: space-between; font-weight: 700; border-top: 1px solid black; padding-top: 8px;">
<span>{{i18n.total}}</span>
<span>{{totals.total_display}}</span>
</div>
</div>
Los estilos pueden desaparecer al imprimir

Un bloque <style> se ve bien en la vista previa del editor de plantillas porque el editor muestra el HTML tal como está escrito. El PDF de la tienda y las aplicaciones móviles eliminan los bloques <style> antes de imprimir, por lo que el mismo recibo sale sin estilos en esos casos. Mantenga todos los estilos en línea.

¿Qué HTML se elimina?

El recibo se depura antes de imprimirse, por lo que una plantilla nunca puede ejecutar código. Los scripts, las etiquetas <link> y <meta> y los atributos on… se eliminan independientemente de dónde se imprima. El PDF de la tienda elimina los bloques <style> , <head> y las demás etiquetas de nivel de documento; las aplicaciones móviles también eliminan los bloques <style> .

Diseñado para blanco y negro

Los recibos suelen imprimirse en impresoras térmicas o láser en blanco y negro. Use el grosor de la letra, los espacios en blanco, el tamaño del texto y las líneas horizontales para marcar la jerarquía en lugar de rellenos de color. Los fondos de color y el texto gris desaparecen o se imprimen como semitonos poco definidos.

¿Necesita el aspecto del papel térmico sin una impresora térmica?

Pulse Usar plantilla en la tarjeta Recibo estrecho de la galería. Es un diseño monoespaciado de 72 mm de ancho que se imprime con nitidez desde el navegador, en impresoras que imprimen páginas web (dispositivos Sunmi e iMin) y en papel estándar. Para una impresora que recibe comandos ESC/POS directamente, use un Recibo térmico sencillo (58mm u 80mm).

Buenas prácticas​

  • Use campos _display para los importes: incluyen el formato de moneda de su tienda.
  • Use etiquetas {{i18n.*}} en lugar de texto escrito directamente para que la plantilla funcione en el idioma de cada tienda.
  • Incluya los campos opcionales dentro de secciones, {{#field}}...{{/field}}, para que no se imprima nada cuando estén vacíos.
  • Parta de una plantilla de la galería en lugar de una página en blanco.
  • Compruébela en el POS con un pedido real que incluya un descuento, una línea de impuestos y un pago en efectivo antes de utilizarla en la caja.

Si algo sale mal​

Los estilos se ven en el editor, pero no en el recibo. Aplíquelos en línea. Consulte Los estilos pueden desaparecer al imprimir.

Un campo no imprime nada. Compruebe su nombre en la Referencia de datos del recibo; un campo mal escrito o desconocido se imprime vacío, sin ningún error. Dentro de una sección, el nombre se busca primero en el elemento actual.

El recibo muestra un bloque de error de código de barras. El valor no corresponde al tipo de código de barras. Consulte Códigos de barras y códigos QR.

Faltan el efectivo entregado y el cambio en el recibo. Se imprimió sin conexión, antes de que el pedido llegara a la tienda; la pantalla de pago completado sí mostraba el cambio. Vuelva a imprimirlo cuando el pedido se haya sincronizado. Consulte Modo sin conexión.

La plantilla no aparece en la lista Plantilla de la caja. No está Activa o una tienda tiene su propia lista de plantillas. Consulte Personalice su recibo.

La vista previa del editor indica «Error al renderizar la plantilla». Una sección no está cerrada o una etiqueta de cierre no coincide con la de apertura. Cada {{#x}} y {{^x}} necesita su propio {{/x}}.