Crear empleado
Crea un empleado con su identidad, condiciones laborales, sueldo y condiciones de nómina, cuenta bancaria y correo para recibos. Un RFC ya asignado a un empleado de la organización devuelve 409 conflict; consulta y actualiza el empleado existente mediante employeeId. Guardar nunca exige que esté listo para nómina; la respuesta lo informa.
- Ruta
POST /v1/employees- Autorización
- Permiso requerido: `employees:manage`.
- Entornos
- Producción y prueba
- Idempotencia
- Requerida para reintentos seguros.
Listar empleados GET
Lista empleados de nómina con los controles documentados de búsqueda y paginación, limitados a la organización.
Obtener empleado GET
Devuelve un empleado de nómina de la organización, los campos de perfil que usan las operaciones de nómina relacionadas y payrollReadiness: lo que aún impide que exac calcule y timbre su nómina ordinaria. Un empleado con recibos individuales queda fuera de esa nómina y no reporta pendientes para ella. Un pendiente last_receipt_deductions_missing indica que el último recibo del empleado descontó conceptos (un crédito Infonavit, por ejemplo) de tipos que payroll.fixedDeductions no tiene; lastReceiptDeductions los lista por periodo de pago: agrégalos a payroll.fixedDeductions o envía payroll.lastReceiptDeductionsDismissed en true para decidir no aplicarlos. Un recibo más reciente vuelve a preguntar.