Imprimir plantillas


Puede habilitar plantillas de impresión en el área de administración Configuración de impresión. Una vez habilitado, puede seleccionar una colección de plantillas de la lista. Observe que la mayoría de las colecciones de plantillas se usan solo en el canal de backoffice para fines de impresión y para otros canales o para adjuntar al correo electrónico se utilizará la colección "predeterminada".

Una vez que habilite las plantillas de impresión, puede crear sus propias plantillas. Puede comenzar copiando una plantilla existente desde cualquiera de las colecciones (recomendadas) o intentarlo desde cero.

Escribe las plantillas usando la notación JSON que necesita la biblioteca MakEPDF mientras usa LiquidJS para la sintaxis de plantilla.

El líquido se mejora con algunas extensiones propietarias de Betterez que harán que algunas cosas sean más fáciles, como mostrar cantidades monetarias y tratar con problemas de multicurrencias.

Navegue a Administración> Impresión> Imprimir plantillas.

print templates admin menu

Puede configurar Imprimir plantillas anulaciones para usar diferentes impresoras para diferentes configuraciones de plantillas de impresión. Esto es útil cuando tiene diferentes impresoras para diferentes tipos de boletos o documentos.

Lista de plantillas

La lista de plantillas mostrará todas las plantillas para la colección de plantillas predefinidas (predeterminada, Zebra, Epson, etc.) y cualquier plantilla personalizada definida a nivel de cuenta.

list of templates

La lista de plantillas mostrará los temaplatos enumerados por relevancia, desde Higer hasta menor relevancia. Esto indicará qué plantilla se utilizará al imprimir un producto o artículo específico.

Las plantillas en las colecciones de plantillas predefinidas no se pueden editar o eliminar, pero se pueden copiar y una vez copiadas se pueden modificar.

Una propiedad importante que se muestra en esta lista es el estado de la plantilla, si el estado de la plantilla es borrador esa plantilla no se usará incluso si es relevancia es más alta que otras plantillas. El estado debe ser publicado para poder usarlo. Puede editar el estado en el editor de plantillas.

Creación de plantillas

Haga clic en el botón Agregar nuevo en la parte superior derecha de la pantalla.

new template

Puede crear plantillas personalizadas para una combinación específica de impresora y producto. Seleccione la impresora, el producto y proporcione un nombre. Una vez creado, podrá comenzar a editar la plantilla y obtener una vista previa de los resultados en el editor de la construcción de plantillas.

template properties

Déle a la plantilla un nombre descriptivo para que pueda encontrarlo fácilmente en la lista de plantillas.

Seleccione el tipo de plantilla.

template properties type

Si selecciona el tipo de "producto", verá dos opciones más.

La familia del producto (requerida) y el producto.

template properties product family

  • Observe que el regreso abierto se muestra aquí como una familia de productos. Mientras que en realidad es un sabor de la familia de reservas, debemos mostrarlo aquí para poder diseñar plantillas específicas utilizadas para imprimir la parte de devolución abierta de ese tipo de reservas.

template properties product

Las segundas opciones que se muestran se llenarán con los productos de la familia seleccionada anterior. Esto le permitirá diseñar plantillas personalizadas para un producto específico.

Esta opción se puede dejar vacía.

template properties channel

Para la opción de canales, si desea usar estas plantillas en todos los canales, déjelo como cualquier otro, o seleccione un canal específico.

template properties consumer

La propiedad del consumidor indica si el tempalte será utilizado por todos los consumidores (cualquiera), solo la impresora (impresora) o cuándo el PDF se envía como un archivo adjunto en un correo electrónico (archivo adjunto).

  • Vea a continuación cómo usar el editor de plantillas

plantillas de copia

Otra forma de crear una nueva plantilla es copiar una existente y modificar sus propiedades y la plantilla según sea necesario.

copy templates

Puede modificar todas las propiedades de una plantilla después de hacer clic en el botón Copiar en la lista y aceptar copiar la plantilla.

modifying copy of template

Una vez guardada, la plantilla se mostrará en la lista como una plantilla "personalizada"

custom template

  • Vea a continuación cómo usar el editor de plantillas

Eliminar plantillas

Puede hacer clic en el icono "Eliminar" en el lado derecho de una plantilla personalizada

custom template

Se mostrará una confirmación, haciendo clic en "Eliminar" eliminará la plantilla.

Esta acción no es reversible

delete template confirmation

Plantillas de pedido

Las plantillas de pedido son un tipo especial de plantillas consideradas meta plantillas.

Esta plantilla tiene un objeto de ítems 'y cada propiedad' en el objeto de elementos se refiere a una plantilla real que debe imprimirse al imprimir el pedido.

El valor en las propiedades debe ser un objeto vacío, excepto la propiedad [de transacción](#transacciones-Condiciones en orden) que es un caso especial, ver más abajo

Por el momento, las propiedades compatibles son:

  "transaction": {}
  "pinpad": {},
  "invoice": {},
  "reservations": {},
  "tickets": {},
  "flexpasses": {},
  "redeemableItems": {},
  "paid_ins": {},
  "parcels": {},
  "gift_certificates": {},
  "refunds: {}

Condiciones de transacción en orden

La propiedad Transaction puede tener un objeto con la propiedad' Condiciones '.

Las reglas de soporte de Condiciones en la forma aceptada por json-rules-ingine

El orden predeterminado tiene las siguientes reglas:

"conditions": {
  "any": [
    {
      "fact": "parcels",
      "operator": "greaterThan",
      "value": 0,
      "path": "$.length"
    },
    {
      "fact": "refunds",
      "operator": "greaterThan",
      "value": 0,
      "path": "$.length"
    },
    {
      "fact": "flexPasses",
      "operator": "greaterThan",
      "value": 0,
      "path": "$.length"
    },
    {
      "fact": "transaction",
      "operator": "greaterThan",
      "value": 0,
      "path": "$.transactionFee"
    },
    {
      "fact": "transaction",
      "operator": "lessThan",
      "value": 0,
      "path": "$.transactionFee"
    },
    {
      "fact": "transaction",
      "operator": "contains",
      "value": "item",
      "path": "$.summary[*].productFamily"
    },
    {
      "fact": "transaction",
      "operator": "contains",
      "value": "loan",
      "path": "$.summary[*].productFamily"
    }
  ]
}

Esto significa que una transacción se imprimirá en un pedido si el pedido contiene al menos un paquete, reembolso o FlexPass.

O cuando el valor transacción.transactiofee no es cero.

O cuando en el resumen de la transacción hay al menos un artículo con la empresa de productos de 'item o' préstamo.

Observe la propiedad Path en las reglas, siguen la sintaxis JSON-PATH.

Editar una plantilla

  • Para orden plantillas ver arriba.

El editor en compuesto de cuatro paneles principales.

templates editor

Los detalles y el panel de datos a la izquierda, el editor y el panel de erros en el centro, y el panel de vista previa y de documentación a la derecha.

Panel de detalles

templates editor details panel

El panel de detalles muestra las propiedades de la plantilla. Observe que algunas propiedades son editables, pero la mayoría no.

Puede cambiar el nombre, el canal y, lo más importante, el estado de la plantilla. Una vez que cambie cualquiera de los valores, asegúrese de hacer clic en Guardar en la esquina superior derecha del editor.

status options

Puede seleccionar borrador o publicado para el estado de la plantilla. Draft Permitirle trabajar en una nueva plantilla sin que el sistema lo use hasta que se cambie a publicado.

version information

En la parte inferior del panel de datos (es posible que deba desplazar el panel para verlo), es la información de la versión de plantilla. Esto muestra la última vez que se modificó la plantilla (podría ser el código o cualquiera de las propiedades) y la versión que está viendo en la ventana del editor. Más sobre versiones y revisiones a continuación.

Panel de datos

data panel empty

Este panel le permite cargar todos los datos que estarán disponibles para la plantilla en función del tipo de plantilla.

default data

Por defecto, los únicos datos se cargarán es el idioma, el canal y el humande. (Este canal no es lo mismo que la propiedad del canal de plantilla, el Humandate proviene de la configuración de la cuenta, igual que el idioma).

data item id

Deberá proporcionar una identificación para el elemento principal de la plantilla como se describe a continuación.

Tipo Familia de productos ID de
Transacción Transacción
voucher voucher
Certificado de regalo Certificado de regalo
SRR Reseervación con SSR
factura factura
Locationclosure Locationclosure
Manifiesto Manifiesto
Orden Orden
Parcelmanifest Parcelmanifest
PassengersManifest PassengersManifest
Balance de arranque Balance de arranque
Producto Reserva Boleto
Producto Boleto Boleto
Producto Paquete Artículo de paquete
Producto Pase flexible Pase flexible
Producto Pagado en Pagado en el artículo
Producto Pagado Artículo pagado
Producto Paquete Artículo canjeable para un paquete
Producto Regreso abierto Artículo redimible para una devolución abierta

Load button

Una vez que ingrese el ID de elemento, puede hacer clic en el botón de carga y el editor intentará cargar la información para el tipo de plantilla en función de la ID.

wrong item id

Si la identificación del artículo es incorrecta, no imprimible o el estado no está disponible (ejemplo, ticket cancelado o cambiado). Verá el error anterior.

data loaded

Si el ID es el correcto, los datos se mostrarán expandidos de forma predeterminada. Los datos mostrados serán diferentes en función del tipo de plantilla en la que está trabajando y representa todos los datos que la plantilla tendrá disponible.

Una vez que se cargan los datos, el panel de vista previa mostrará una vista previa de la plantilla utilizando los datos en este panel.

Tenga en cuenta que en algunos casos puede usar diferentes ID para diferentes elementos que pueden tener diferentes características, incluso si pertenecen al mismo producto y tipo. Por ejemplo: las reservas en la misma cuenta a veces tienen información del asiento y a veces no dependen del horario. Es posible que desee probar cómo se comporta su plantilla con las diferentes reservas.

data collapsed

Puede colapsar los datos para facilitar su vida mientras trabaja en las plantillas y solo centrarse en algunos de los datos a la vez.

editing data

Como se indicó anteriormente, a veces el mismo tipo o producto puede tener datos que son ligeramente diferentes del elemento que seleccionó para probar. Puede "editar" los datos utilizando el botón Editar datos.

Una vez que se editan los datos, el editor recargará la vista previa (ver más abajo).

editing data preview

La edición de datos no está previamente previa y no modifica ninguno de los datos en la cuenta. Recargar el elemento o el editor restablecerá los datos a su estado original.

Panel de editor

El panel del editor funciona con "Monaco", el editor de texto que también impulsa el código Visual Studio.

editor panel

Esto proporciona algunas características agradables como resaltar sintaxis, finalización del código y colapsas de secciones. También presenta un mini mapa a la derecha del editor que puede ayudar al navegar plantillas largas.

Algunos de los errores de sintaxis se pueden ignorar ya que Mónaco tiene dificultades para comprender que estamos trabajando en un archivo JSON que también admite la sintaxis líquida.

Panel de errores

El error o el panel de terminal se asientan debajo del editor.

error panel

Cuando hay un error, mostrará que el código de estado intenta procesar la plantilla y el resultado una vez que la plantilla se procesó con los datos en el panel de datos.

error panel

Puede hacer clic en la flecha en la parte superior del panel Terminal para expandirla para que sea fácil de ver la información. Si tiene cuidado, generalmente puede encontrar el error del código generado al procesar la plantilla.

error panel

Panel de vista previa (no disponible en TemaPltes del tipo de pedido)

El panel de vista previa se cargará cada vez que se modifique la plantilla o los datos se vuelvan a cargar o editaran.

preview panel

Esto permite una retroalimentación muy rápida en la que se ve en tiempo casi real cómo los cambios en la plantilla se reflejarán en el PDF.

Los datos deben cargarse para que funcione la vista previa.

Si hay un error en una plantilla de impresión (y por alguna razón el sistema no puede cargar la plantilla predeterminada), no imprimirá el PDF solicitado (ticket, transacción, factura, etc.). Esto también podría causar que el correo electrónico de confirmación no se envía ya que el sistema no puede producir el PDF adjunto que debe enviar. Si descubre que no puede imprimir o no se está enviando correo electrónico, asegúrese de que sus actualizaciones a las plantillas de impresión no estén lanzando un error. Si es así, corrija la plantilla e intente imprimir o enviar un correo electrónico de confirmación.

Panel de documentación

El panel de documentación es en realidad 3 paneles diferentes para plantillas normales y cambia un poco para las plantillas de pedido.

Pestaña de documentación #####

Para plantillas sin pedidos

docs panel

Esta pestaña tiene documentación sobre las extensiones personalizadas Betterez.

para plantillas de pedido

docs panel

Esta pestaña tiene documentación sobre la estructura necesaria para una plantilla de pedido.

Pestaña Documentos de líquido (no está disponible en TemaPltes del tipo de pedido)

docs panel

Esta pestaña tiene documentación sobre Liquid JS

pestaña MakEpdf (no disponible en TemaPltes del tipo de pedido)

docs panel

Esta pestaña tiene documentación sobre makepdf

Pestaña de probador de reglas (solo disponible para el tipo de pedido)

Puede usar esta pestaña para probar las reglas.

test rules

Crea una regla y escribe algunos datos de maqueta y haga clic en el botón de prueba.

Puede recibir errores si la regla que escribe no sigue el formato adecuado.

test rules errors

test rules errors

Si no tiene datos en la ventana de datos al probar la regla, obtendrá un "Undefined_Fact"

test rules

Si los datos no coinciden con la regla (aquí estamos buscando al menos un elemento en la propiedad de Parcels), obtendrá un resultado "inigualable".

test rules

Si todo funciona, debería ver un resultado "emparejado".

test rules

Guardar y reversiones

save button

Una vez que haga clic en el botón Guardar, se creará una nueva revisión de la plantilla y también se conservará la versión anterior.

save message

Si una plantilla tiene múltiples versiones, se mostrará un botón Rodback además del botón Guardar. Al hacer clic en este botón revertirá la plantilla al punto de guardado anterior.

save message

rollback button

Roolback elimina todo antes del punto de guardado anterior y no hay remojo o botón Rollforward.

específicamente para Plantilla de depósitos de turno parcial Para que la vista previa muestre el recibo específico, debe iniciar sesión como el usuario que desea ver, y el depósito parcial debe ser parte del cambio actualmente abierto para ese usuario. La identificación de pasar a la plantilla sería el integrador del depósito específico. Ex para el primer depósito sería 1. Si obtiene la información a través de API, encontrará el valor en el "PartialDepositorer" de la matriz de depósitos.

Plantilla de impresión en agencias

Puede establecer sus plantillas de impresión en el valor principal y asignarlas a sus agencias para que lo usen. O en orden las palabras dan el acceso (como lo hace con productos, tarifas, etc.) a la plantilla de impresión que desea que usen.

Estos son los pasos a seguir:

  1. En su cuenta principal: vaya a la administración / impresión / editar configuración de impresión y verifique la opción de usar la plantilla de impresión.
  2. En su cuenta principal: cree la plantilla de impresión que desea que la agencia use.
  3. En su cuenta principal: vaya a la administración / red / agencias e ingrese la agencia a la que desea asignarla. Desplácese hacia abajo hasta las opciones de plantilla de impresión y habilite la plantilla de la agencia.
  4. Inicie sesión en la agencia: vaya a la administración / impresión / editar configuración de impresión y verifique la opción de usar la plantilla de impresión.

También puede establecer una plantilla de impresión dentro de la agencia, pero para un mejor control y mantenimiento se recomienda hacerlo desde la cuenta principal.