Calculadora de pago por horas

El algoritmo es totalmente determinista, así que las mismas entradas producen siempre el mismo JSON para demos de nómina, bots de RR. Una tarifa horaria negativa se rechaza con un error claro invalid_input, porque un salario negativo no describe un cálculo válido de bruto.

Entradas: horas trabajadas, tarifa horaria, multiplicador extra y umbral opcional

Los recuentos de horas negativos, los multiplicadores negativos y los umbrales negativos también se rechazan para que un cambio accidental de signo falle de forma ruidosa en lugar de inventar negativos absurdos en un recibo. Toda la validación ocurre antes de cualquier matemática monetaria, así que las peticiones incorrectas nunca producen filas de pago a medias. Usted envía el total de horas, no una división previa de regulares frente a extra: la calculadora realiza esa división a partir del umbral que eligió o del valor por omisión de cuarenta. Envíe un cuerpo JSON con tres campos obligatorios y un corte opcional. hours_worked es el tiempo total en el reloj del periodo de pago, como número finito no negativo o cadena numérica; se aceptan los alias hours, hrs, total_hours y weekly_hours cuando su cliente ya nombra el campo de otra forma. hourly_rate es el salario base por hora como número finito no negativo o cadena numérica; los alias rate, wage, hourly y pay_rate se mapean al mismo valor para que los constructores de formularios conserven etiquetas familiares. overtime_multiplier es la prima expresada como múltiplo de la tarifa base —por ejemplo 1.5 significa tiempo y medio y 2 significa doble tiempo—, no un porcentaje del salario; los alias multiplier, ot_multiplier, ot_rate y premium se mapean al mismo campo. overtime_threshold es opcional y vale cuarenta horas por omisión, el techo semanal habitual de tiempo normal; los alias threshold, ot_threshold, regular_limit y cutoff le permiten nombrar una regla diaria de ocho horas o un tope semanal local sin cambiar el resto del contrato. Las tarifas horarias negativas fallan la validación con invalid_input porque no describen una nómina normal. Tarifas, totales de horas, multiplicadores o umbrales extremadamente grandes se limitan para que la matemática del Worker isolate permanezca acotada. Faltar cualquiera de los campos obligatorios falla con invalid_input nombrando la clave ausente.

Cómo se calculan las horas extra, el pago extra y el bruto

Las fórmulas centrales son las que la gente ya usa a mano en una hoja de tiempo, salvo que la división de horas extra se hace por usted. El bruto es la suma de esas dos líneas. Los productos intermedios usan aritmética de coma flotante ordinaria; después cada campo monetario se redondea half-up a dos decimales para que los resultados parezcan moneda en un recibo y no fracciones binarias largas. Ejemplo: una tarifa de veinte, cuarenta y ocho horas trabajadas, un multiplicador de 1.5 y el umbral por omisión de cuarenta produce cuarenta horas regulares, ocho extra, ochocientos de pago regular, doscientos cuarenta de extra, una tarifa extra efectiva de treinta y un bruto de mil cuarenta tras el redondeo. Si las horas permanecen en o por debajo del umbral, las horas extra y el pago extra son cero y el bruto es simplemente tarifa por horas. La misma matemática para toda jurisdicción es un alcance de producto intencional: tablas legales, reglas del séptimo día y retención fiscal serían intenciones de búsqueda y contratos distintos. Las horas regulares equivalen al menor entre hours_worked y overtime_threshold. Las horas extra equivalen al mayor entre hours_worked menos el umbral y cero. El pago regular es igual a hourly_rate por las horas regulares. El pago extra es igual a hourly_rate por overtime_multiplier por las horas extra. La respuesta también devuelve ot_hourly_rate como hourly_rate por el multiplicador para que las interfaces muestren el salario efectivo de extra junto a la tarifa base. La respuesta hace eco de la tarifa horaria normalizada, hours_worked, overtime_threshold y overtime_multiplier, y luego devuelve horas regulares, horas extra, ot_hourly_rate, regular_pay, overtime_pay y gross_pay, más currency_decimals igual a dos y method igual a hours_pay_gross para un ramificado estable del cliente. Entradas idénticas siempre producen JSON idéntico porque la ruta es aritmética pura sin red, sin semilla aleatoria y sin reloj de pared.

Uso de la API, precios, flujos de trabajo y límites prácticos

Use la API prepago cuando un bot de RR. HH., un panel de freelancing, un portal de personal o un ayudante de hojas de tiempo necesite un contrato KIT estable a $0.002 por ítem exitoso; los fallos de validación nunca consumen saldo tras el rechazo del motor. Los autores que envían SDK pueden mapear regular_pay, overtime_pay y gross_pay directamente a interfaces de recibo y mensajes de estimación. Cuando cite el precio de la API en el texto del producto, use el marcador de catálogo $0.002 para que las páginas publicadas se mantengan alineadas con el piso de precio en vivo.