Saltar al contenido principal

Forma Libre

Índice​

Introducción​

Este documento explica cómo funciona el método de Forma Libre en CACHICAMO y cómo se utilizan las variables en las plantillas preestablecidas.

La Forma Libre es un método de emisión de documentos fiscales en Venezuela. Estos se presentan en forma de talonarios y son formatos creados por una imprenta autorización del ente regulador.

CACHICAMO proporciona plantillas preestablecidas que han sido diseñadas conforme a los formatos autorizados por el ente regulador. Las variables serán reemplazadas automáticamente por los valores correspondientes cuando se genere el documento, el cual posteriormente debe ser enviado a una imprenta autorizada para su impresión final.

En resumen, las variables son campos especiales dentro de la plantilla que serán reemplazados automáticamente por los valores reales cuando se utilice la plantilla. Este documento explica cómo utilizar esas variables en la plantilla para que puedas personalizar tu documento según tus necesidades.

Cómo Funciona la Plantilla​

  1. Plantillas Preestablecidas: CACHICAMO proporciona plantillas en formato DOCX que han sido diseñadas y aprobadas conforme a los formatos autorizados por el ente regulador. Estas plantillas no pueden ser modificadas por el cliente.

  2. Selección de Plantilla: En el sistema CACHICAMO, puedes seleccionar la plantilla de forma libre apropiada para el tipo de documento que deseas generar (factura, nota de crédito, etc.).

  3. Generación del Documento: El sistema toma la plantilla seleccionada y reemplaza automáticamente las variables con los datos reales de la transacción.

  4. Descarga del Documento: Una vez generado, puedes descargar el documento completado.

  5. Impresión por Imprenta Autorizada: Los documentos generados deben ser impresos inmediatamente en un documento forma libre emitido por una imprenta autorizada por el ente regulador, cumpliendo con la providencia SNAT/2011/0071.

Cómo Usar las Variables​

Las variables son elementos especiales de texto dentro del archivo DOCX que se reemplazarán automáticamente por los valores reales cuando se genere un documento. Las variables están delimitadas por llaves {} y, en algunos casos, pueden estar dentro de bucles que permiten generar una lista de elementos (como productos o pagos).

¿Cómo funciona el reemplazo de las variables?​

Cuando se genera un documento, el sistema toma el archivo DOCX y reemplaza cada variable por el valor correspondiente. Por ejemplo, la variable {customer_name} será reemplazada por el nombre del cliente, {document_number} será reemplazada por el número del documento, etc.

Ejemplo:
Si el nombre del cliente es "Juan Pérez", el sistema reemplazará {customer_name} por "Juan Pérez".

Lista de Variables Disponibles​

A continuación se muestra una lista de las variables disponibles que puedes usar en la plantilla:

Información del Cliente​

  • {customer_name}: Nombre del cliente.
  • {customer_dni}: R.I.F./C.I./Identificación Fiscal del cliente.
  • {customer_address}: Dirección del cliente.
  • {customer_phone}: Teléfono del cliente.
  • {customer_email}: Correo electrónico del cliente.

Información del Documento​

  • {document_date}: Fecha del documento.
  • {document_number}: Número de la factura.
  • {invoice_number}: Número de la factura afectada (Para notas de crédito y notas de débito).
  • {invoice_date}: Fecha de la factura afectada (Para notas de crédito y notas de débito).

Detalles de los Productos​

  • {#products}: Marca el inicio de un grupo de productos (se usa para crear listas de productos).
    • {name}: Nombre del producto.
    • {unit_price}: Precio unitario del producto.
    • {quantity}: Cantidad del producto.
    • {total}: Total por producto (cantidad * precio unitario).
  • {/}: Marca el final del grupo.

Ejemplo: {#products}{name} {unit_price} {quantity} {total}{/}: Esto indica que la información del producto se repetirá para cada producto que se agregue a la factura.

Impuestos​

  • {#taxes}: Marca el inicio de un grupo de impuestos.
    • {name}: Nombre del impuesto.
    • {taxable_amount}: Base imponible del impuesto.
    • {amount}: Monto del impuesto.
  • {/}: Marca el final del grupo.

Ejemplo: {#taxes}{name} {taxable_amount} {amount}{/}: Similar a los productos, esto repetirá la información de cada impuesto.

Forma de Pago​

  • {#payments}: Marca el inicio de un grupo de pagos (útil cuando hay más de una forma de pago).
    • {name}: Nombre del método de pago.
    • {amount}: Monto pagado con ese método.
  • {/}: Marca el final del grupo.

Ejemplo: {#payments}{name} {amount}{/}: Se repite para cada método de pago.

Totales​

  • {document_subtotal}: Subtotal de la factura antes de impuestos.
  • {document_total_taxes}: Total de los impuestos aplicados.
  • {document_total_taxes_retained}: Total de los impuestos retenidos.
  • {document_total}: Total de la factura (incluyendo impuestos).

Ejemplos de Variables en el Documento​

Ejemplos en tamaño media carta:

Ejemplos en tamaño carta: