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 Comision

Reglas de Comisiones

Las reglas de comisiones le indican a CifraHQ exactamente cuanto gana cada vendedor cuando se contabiliza una factura: por producto, cliente, grupo de Productos o grupo de Clientes. Una vez configuradas, las comisiones se rastrean automaticamente; sin hojas de calculo ni calculos manuales. Cada factura contabilizada actualiza el saldo acumulado del vendedor.

Donde encontrarlas

Vaya a Datos Maestros > Ventas > Reglas de Comisiones.

Pagina de Reglas de Comision en CifraHQ.

Lista de Reglas de Comision, como los vendedores ganan comisiones por venta.

Como crear una Regla de Comisiones

  1. Haga clic en Nuevo. La regla recibe su Código (CR-...) al guardarla; usted no escribe uno.
  2. Si quiere, escriba una Descripción, el nombre con el que reconocerá la regla (por ejemplo, "Comida de perros a Clientes mayoristas").
  3. Responda tres preguntas. Cada una es una sola elección y solo aparece el campo que corresponde a su elección, así que una regla no puede contradecirse:
    • 1. ¿Quién gana la comisión? - Cualquiera, o Un vendedor (un usuario de CifraHQ).
    • 2. ¿Qué Productos? - exactamente una de estas opciones: Todos los Productos, Un producto, Subcategoría, Categoría o Un grupo de Productos. Al elegir una subcategoría también se guarda su categoría.
    • 3. ¿Qué Clientes? - Todos, Un cliente o Un grupo de Clientes.
  4. Ingrese la Comisión %, de 0 a 100 - el porcentaje del monto de la línea de factura que gana el vendedor. Una regla con 0% se permite a propósito: cuando es la regla más específica que corresponde a una venta, no se paga nada y evita que las reglas más generales paguen por esas ventas.
  5. Establezca Comienza y Termina si la regla es por tiempo limitado (por ejemplo, un incentivo promocional). Ambas son fechas en la zona horaria de su empresa y ambos días están incluidos: una regla que Termina el 31 de diciembre aplica durante todo el 31 de diciembre. La regla se juzga con el día en que se registra la factura (o el pago final). 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.
  6. Lea el cuadro Esta regla dice, que escribe la regla con palabras sencillas, y haga clic en Guardar.

Guardar permanece desactivado hasta que todas las preguntas tengan respuesta, y el motivo se escribe junto al botón. Las elecciones de vendedor, Productos y Clientes son independientes: una regla puede combinar un vendedor con un producto y un cliente.

Reglas guardadas antes de la nueva ventana

Las reglas antiguas podían nombrar dos maneras de elegir Productos (por ejemplo un producto y un grupo de Productos) o un cliente y un grupo de Clientes a la vez. Una regla así puede no aplicarse nunca, sin avisar. Al abrirla, la ventana muestra un aviso amarillo y la pregunta sin respuesta, sin nada elegido, y lista lo que está guardado. No se pierde nada hasta que elija una opción y guarde: puede probar cada opción antes. Una subcategoría guardada junto con su propia categoría no es un problema y se abre normalmente. Las mismas combinaciones se rechazan al guardar la regla, con un mensaje que dice qué quitar.

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.

Como se acumulan las comisiones

Para cada linea de factura, CifraHQ elige una regla: la regla activa mas especifica que coincide con la venta. Los porcentajes nunca se suman. Una regla gana a otra en el primero de estos campos que una define y la otra no: Vendedor, Producto, Subcategoria, Categoria, Grupo de Productos, Cliente, Grupo de Clientes. Por ejemplo, una regla para un producto gana a una regla para su subcategoria, que a su vez gana a una regla para su categoria. Si dos reglas son igual de especificas, gana la de codigo mayor.

La comision se agrega al Saldo de Comisiones del vendedor cada vez que ocurre un evento de comision. El evento que dispara la acumulacion se controla con la Configuracion Calculo de Comisiones en Configuracion > Configuracion de Negocio > Operaciones de Negocio > Ventas.

Configuracion Cuando se acreditan las comisiones
Factura Pagada (predeterminado) Cuando se contabiliza un pago contra la factura. Las comisiones se acumulan solo sobre ingresos efectivamente cobrados.
Factura Contabilizada Cuando se contabiliza la factura. Las comisiones se acumulan de inmediato sin importar si el cliente ha pagado.

Elija Factura Pagada cuando desee que los vendedores ganen solo sobre el efectivo que realmente se ha cobrado. Elija Factura Contabilizada cuando la practica de su empresa sea reconocer la venta en el momento de la facturacion.

Después de cambiar de Factura Pagada a Factura Contabilizada, actualice las comisiones de las Facturas contabilizadas antes del cambio desde la lista de Facturas (vea Facturas).

Las notas de crédito y el crédito reducen la comisión

  • Una nota de crédito siempre reduce la comisión de la factura que acredita.

    • Si se registra después de que la comisión se ganó, retira su parte.
    • Con Factura Pagada, una nota de crédito registrada antes de que se pague la factura reduce lo que gana el pago.
    • Una factura acreditada por completo no gana nada.
  • El crédito de una nota de crédito o memo de crédito nunca genera comisión cuando paga una factura. El dinero de un anticipo del cliente sí la genera.

    Ejemplo: una factura de 1,000 con una nota de crédito de 200, pagada con ese crédito de 200 y 800 de dinero en banco, gana comisión sobre 800.

    Para un cliente que ha hecho anticipos, CifraHQ todavía no puede distinguir el crédito de anticipos del crédito de Devoluciones. Los pagos con crédito de esos Clientes siguen generando comisión como antes.

Una segunda Configuracion en el mismo lugar, Commission Sales Person Source, decide quien gana la comision y como se lista:

Configuracion Quien la gana Se lista por
SalesOrder (predeterminado) El vendedor de la orden de venta Orden de venta
Invoice El vendedor de la factura; si la factura no tiene, el de la orden de venta Factura

Cada factura lleva el vendedor de su orden de venta, y un administrador puede agregar uno que falte en una factura registrada, asi que con Invoice la pestana Comisiones muestra cada comision junto a la factura que la genero.

Cada acumulacion escribe una fila de Transaccion de Comision en el libro de comisiones del vendedor: fecha, referencia (la linea de OV o la linea de factura, segun la Configuracion anterior), porcentaje aplicado y el saldo corriente despues del registro. Haga clic en Abrir libro completo en la pestana Comisiones para ver el historial completo.

Pagar comisiones

CifraHQ ofrece dos rutas de pago segun si el vendedor esta inscrito en nomina:

Ruta 1 - Empleado inscrito en nomina (recomendado)

Si el vendedor es tambien un empleado con contrato de nomina activo, pague sus comisiones a traves de la corrida de nomina para que las bases de prestaciones de CSS, ISR y Decimo se calculen correctamente:

  1. Abra la corrida de nomina del periodo correspondiente (Nomina > Periodos > [Periodo] > Corrida).
  2. Haga clic en Importar Comisiones en el encabezado de la corrida.
  3. CifraHQ muestra todos los vendedores-Empleados con saldos de comisiones abiertos. Seleccione los que desea incluir.
  4. Haga clic en Importar N lineas. CifraHQ crea una linea de concepto COMISION por cada empleado seleccionado y pone en cero su saldo.
  5. Ejecute Calcular normalmente. El motor agrega la comision a la base salarial cotizable para CSS, ISR, Decimo y demas calculos de prestaciones.

El dialogo de Importar Comisiones solo esta disponible en corridas en borrador. Una vez que se cierra un periodo, los saldos ya no se pueden importar en el.

Ruta 2 - Contratista o vendedor sin nomina

Si el vendedor no esta inscrito en nomina (contratista independiente, representante solo por comision):

  1. Vaya a Configuracion > Usuarios > [Vendedor] > pestana Comisiones.
  2. Haga clic en Pagar.
  3. Ingrese el monto y seleccione la cuenta bancaria desde donde se pagara.
  4. Guarde. CifraHQ crea un registro de Gasto y reduce el saldo del vendedor por el monto pagado.

El boton Pagar utiliza la cuenta de Comisiones por Pagar configurada en Configuracion de Cuentas. Asegurese de que esta cuenta este mapeada antes de realizar su primer pago.

Ver el libro de transacciones

Cada acumulacion, pago, reasignacion e importacion de nomina queda registrada en el libro de comisiones del vendedor. Para verlo:

  • Desde el detalle del usuario: vaya a Configuracion > Usuarios > [Vendedor] > pestana Comisiones y desplacese hasta la seccion Transacciones, o haga clic en Abrir libro completo para la pagina independiente.
  • Desde la pagina independiente: navegue directamente a /settings/users/{id}/transactions.

Cada fila muestra: Fecha, Tipo de referencia (LineaOV, Gasto, Reasignacion, Nomina), Enlace de referencia (clic para ir al documento fuente), Monto, Saldo Corriente y Comentarios.

Reasignar saldos de comisiones

Si un vendedor se va o transfiere sus cuentas a otro representante, puede mover su saldo abierto al nuevo representante:

  1. Vaya a Configuracion > Usuarios > [Vendedor] > pestana Comisiones.
  2. Haga clic en Reasignar.
  3. Seleccione el vendedor destino del menu desplegable.
  4. Opcionalmente marque Tambien reasignar reglas de comisiones abiertas para mover las reglas activas (no vencidas) al nuevo representante.
  5. Guarde. CifraHQ escribe dos entradas en el libro: un debito en el origen y un credito en el destino, y actualiza ambos saldos de forma atomica.

Consejos

  • Los vendedores se asignan a los Clientes en la pagina de detalle del cliente. Cuando se contabilizan las Facturas de ese cliente, CifraHQ busca automaticamente las reglas de comisiones del vendedor asignado; no se requiere ningun paso manual.
  • Un vendedor puede tener multiples reglas (por ejemplo, 5% en una categoria, 8% en un producto premium de esa categoria). En cada linea gana solo la regla mas especifica, asi que el producto premium paga 8%, no 13%.
  • Use reglas con fecha limite para ejecutar incentivos por tiempo limitado; sin tener que ajustar las tasas manualmente despues.
  • El saldo actual del vendedor aparece en la columna Saldo de la lista de Usuarios (/settings/users) y en la pagina de detalle del usuario.
  • 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.

Relacionado: Clientes · Usuarios · Reglas de Precio · Ordenes de Venta · Facturas · Periodos y Corridas

¿Te resultó útil esta página?