Saltar al contenido
P4 Software P4 Software / cifraHQ

Agrega esta documentación a Claude

Hazle preguntas a Claude sobre esta documentación. Claude lee las páginas publicadas y te enlaza a ellas. Copia esta dirección:

https://p4-software.opendocs.page/mcp

En claude.ai o Claude Desktop: abre Configuración, luego Conectores, elige Agregar conector personalizado y pega la dirección.

En Claude Code, ejecuta:

claude mcp add --transport http docs https://p4-software.opendocs.page/mcp

Reglas de Bonificacion

Reglas de Bonificación

La costumbre panameña de "venda 12, entregue 13" (o "venda 24, entregue 26") está en todas partes en el mayoreo, y hasta ahora significaba ajustar las líneas a mano. Las Reglas de Bonificación codifican esa lógica de mercancía gratis una sola vez para que CifraHQ agregue las unidades libres automáticamente en cada cotización, orden de venta y factura. El cliente paga solo lo que compró, el impuesto se cobra solo sobre las unidades pagadas, y la línea gratis fluye por toda la cadena de entrega y facturación sin un solo paso manual.

Dónde encontrarlas

Vaya a Datos Maestros > Ventas > Reglas de Bonificación.

Cómo crear una Regla de Bonificación

  1. Haga clic en Nuevo. El código se asigna automáticamente al guardar, así que no hay un campo de Código.
  2. Escriba una Descripción, por ejemplo "Venda 12 lleve 13". El código es solo un número, así que la descripción es lo que le permite reconocer la regla en la lista.
  3. ¿Qué recibe el cliente? Escriba El cliente compra (unidades) y Y recibe gratis (unidades). Ambos son números enteros de 1 o más, en unidades sueltas (no cajas ni paquetes). Debajo de las dos casillas CifraHQ escribe un ejemplo, por ejemplo "Por cada 12 unidades que compre, recibe 1 unidad gratis, solo en múltiplos completos. Si compra 11: ninguna gratis. Si compra 12: 1 gratis. Si compra 24: 2 gratis. Si compra 25: 2 gratis." Si escribe "1,200" se lee como 1200; un número con decimales o letras se rechaza con un mensaje debajo de la casilla.
  4. ¿Qué Productos? Elija Todos los Productos, Un producto o Un grupo de Productos. Solo se muestra la lista que corresponde a su elección. Si elige un producto y este viene en una caja cuyo tamaño divide exactamente lo que el cliente compra, CifraHQ agrega una nota como "Este producto viene en caja de 12. Esta regla significa: pida 1 caja, pague 12 y reciba 13."
  5. ¿Quién la recibe? Elija Todos, Un cliente o Un grupo de Clientes. De nuevo solo se muestra la lista que corresponde.
  6. Opcionalmente establezca Comienza (opcional) y Termina (opcional) para hacerla una promoción por tiempo limitado (deje ambas vacías para una regla siempre activa; ambas son fechas en la zona horaria de su empresa y ambos días están incluidos, así que una regla que Termina el 31 de diciembre aplica durante todo el 31 de diciembre), y use el botón Estado para dejar la regla en Activo o ponerla en Pausado (una regla pausada nunca se aplica). La fecha Termina no puede ser anterior a la fecha Comienza (el mismo día para ambas está permitido): si lo es, Guardar queda desactivado y el motivo se escribe junto al botón.
  7. Lea el cuadro Esta regla dice: repite la regla en palabras sencillas, por ejemplo "Para todos los Clientes, con cualquier producto: por cada 12 unidades que compre, recibe 1 unidad gratis." Luego haga clic en Guardar.

Guardar permanece desactivado hasta que la regla esté completa, y el motivo se escribe junto al botón (por ejemplo "Escriba cuántas unidades gratis recibe el cliente para poder guardar.").

Una regla puede nombrar un producto o un grupo de Productos, y un cliente o un grupo de Clientes, nunca ambos: la ventana solo permite elegir uno de cada uno, y el servidor rechaza una regla que nombre ambos. Si varias reglas encajan en una línea de venta, solo se usa la más específica: primero el producto, luego el cliente, luego el grupo de Productos y luego el grupo de Clientes.

Reglas guardadas antes de esta ventana

Una regla antigua puede nombrar a la vez un producto y un grupo de Productos, o a la vez un cliente y un grupo de Clientes. Al abrirla, un mensaje ámbar dice que "necesita un cambio" (o "necesita cambios") antes de poder guardarse, la pregunta afectada se abre sin nada elegido, y una línea muestra lo que está guardado, por ejemplo "Actualmente guardada con el cliente Distribuidora Norte S.A. y el grupo de Clientes Mayoristas. No se pierde nada hasta que elija y guarde." Nada cambia hasta que elija una opción y guarde; el resto de la regla se abre exactamente como se guardó. Si elige Todos o Todos los Productos, la línea dice "Al guardar se quitan los dos." Mientras tanto, la regla sigue funcionando.

Una regla guardada para un cliente que después se fusionó con otro sigue mostrando a ese cliente en su casilla Cliente, con la etiqueta "(fusionado)", así que editar la descripción, las fechas o el estado nunca amplía la regla a todos los Clientes. Un cliente fusionado no se ofrece al elegir un cliente para una regla nueva.

Las reglas guardadas antes del 15 de noviembre de 2026 con la convención anterior (Termina = el día siguiente al último día de venta) ahora también aplican en ese día final: revíselas y retroceda la fecha Termina un día si hace falta.

Una regla existente cuya fecha Termina es anterior a su fecha Comienza sigue apareciendo en la lista y sigue abriéndose, pero no se puede guardar ningún cambio hasta corregir una de las fechas: la ventana muestra el motivo junto a Guardar, y la API también rechaza la regla. Esto no abre el mensaje ámbar, que es solo para una pregunta que nombra ambos lados.

Las cantidades son siempre unidades

Las dos cantidades se guardan y se muestran en unidades sueltas. Una regla que antes se ingresó como "1 Caja x18" ahora se abre como 18 unidades; la regla en sí no cambió. La ventana ya no convierte cajas ni paquetes por usted, así que escriba el número de unidades sueltas (la nota de la caja debajo del ejemplo le dice qué significa eso en cajas).

Cómo se aplican las reglas

Cuando se agrega un producto con regla a una cotización, orden de venta o factura, CifraHQ agrega una segunda línea marcada Bonificación con las unidades gratis, calculada automáticamente:

  • Unidades gratis = el número entero de múltiplos de compra por la cantidad gratis. Compre 12 lleve 1: vender 12 da 1 gratis, vender 24 da 2 gratis, vender 25 sigue dando 2.
  • La línea de bonificación se mantiene sincronizada: cambie la cantidad vendida y la cantidad gratis se actualiza con ella. Baje del umbral y la línea de bonificación desaparece.
  • Elimine la línea vendida y su línea de bonificación se elimina automáticamente. La línea de bonificación no se edita a mano; si no la quiere, elimínela.
  • Cuando coinciden varias reglas, gana la más específica: una regla vinculada a un producto y cliente específicos supera a una regla de grupo o general.
  • En Productos vendidos por empaque, las unidades gratis se entregan como un empaque completo cuando el premio se divide justo en uno (compre una caja, lleve una caja gratis); cuando el premio es menor que un empaque completo, CifraHQ lo entrega como unidades sueltas en lugar de redondearlo a cero - así el cliente siempre recibe la unidad gratis que la regla promete, sin importar en qué tamaño de caja haya comprado.

Detectando un "casi le llega"

Cuando se agrega a una cotización, orden de venta o factura un producto que tiene una regla de bonificación activa, pero la cantidad ingresada todavía no alcanza el siguiente múltiplo de compra, aparece un pequeño ícono ámbar junto al campo de Cantidad de la línea. Al pasar el mouse sobre él, CifraHQ le dice exactamente cuántas unidades más se necesitan para ganar la unidad gratis - por ejemplo, "Agregar 1 unidad más para 1 unidad gratis (Compre 12, Lleve 1)". Así, un cliente nunca se queda a una sola unidad de una bonificación que nadie notó.

Este aviso se calcula al momento, sobre la cantidad actual de la línea; no es necesario guardar nada para verlo, y desaparece solo en cuanto la cantidad alcanza el umbral.

En la factura y los impuestos

Las unidades gratis aparecen en su propia línea al 100% de descuento, así que el total de la línea es 0.00. Al cliente se le cobra solo por las unidades que compró, y el ITBMS se cobra solo sobre las unidades pagadas: la unidad gratis queda fuera de la base imponible, que es el trato que la DGI espera para una bonificación. La línea gratis se arrastra por toda la cadena: la bodega despacha las 13 unidades, la factura cobra 12 y muestra 13, y las Facturas electrónicas son aceptadas por la DGI con la unidad gratis en cero.

Consejos

  • Use el alcance por Grupo de Productos o Grupo de Clientes para promociones amplias ("cualquier cliente mayorista, cualquier producto de esta línea"), y reglas específicas de Producto + Cliente para un acuerdo negociado puntual.
  • Las reglas por tiempo limitado son ideales para impulsos de temporada: establezca las fechas de Inicio y Fin y la regla se activa y vence sola (el día Final es el último día en que aplica).
  • El premio es el mismo producto que se compra. Los premios de producto diferente ("compre 24 sodas, lleve un vaso gratis") llegarán en una versión posterior.
  • Si crea o cambia reglas por la API, envíe las fechas Comienza y Termina como fechas simples (yyyy-MM-dd, por ejemplo 2026-12-31). Un valor con desfase de zona horaria se convierte a la hora del servidor antes de guardarse y puede caer en el día siguiente.

Antes de empezar

Las Reglas de Bonificación están apagadas hasta que un administrador las habilite para su empresa. Un administrador debe encender la configuración de Reglas de Bonificación y asegurarse de que la cuenta de Gasto por Descuento de Ventas esté configurada, para que la línea gratis se contabilice correctamente. Una vez hecho esto, cualquier regla que cree surte efecto de inmediato.


Relacionado: Productos · Clientes · Reglas de Precios · Paquetes de Productos · Cotizaciones · Órdenes de Venta · Facturas

¿Te resultó útil esta página?