Saltar al contenido principal

Incidentes

Cuando un empleado llega tarde, falta un día o pide un adelanto de salario, alguien tiene que anotarlo para que el descuento aparezca en su nómina. Aquí se registran y gestionan esos incidentes —llegadas tarde, ausencias, faltas y otras situaciones que generan descuentos—, y el sistema calcula el descuento según el tipo que usted elija.

Listado de incidentes​

Para acceder al listado de incidentes:

  1. Ir a "Nominas".
  2. Seleccionar "Incidentes".

Busqueda y filtros​

El listado muestra todos los incidentes registrados. Se puede buscar por empleado y filtrar por agencia.

Duplicar un incidente​

Cada incidente tiene la opción de "Duplicar", que permite copiar el incidente para el mes siguiente o cualquier otro periodo. Esto es útil para incidentes que se repiten periódicamente (ej. descuentos mensuales fijos).

  1. En el listado, hacer clic en "Duplicar" sobre el incidente deseado.
  2. El sistema copia los datos del incidente original.
  3. Modificar la fecha y otros datos segun corresponda.
  4. Hacer clic en "Guardar".

Crear un incidente​

  1. En el listado de incidentes, hacer clic en "Nuevo".
  2. Completar los campos:
  • Empleado: seleccionar el empleado al que se le registra el incidente.
  • Tipo de incidente: seleccionar el tipo (llegada tarde, ausencia, etc.). El tipo de incidente determina el monto o porcentaje de descuento.
  • Fecha: fecha en que ocurrió el incidente.
  • Cantidad: numero de ocurrencias (ej. cantidad de llegadas tarde en el periodo).
  • Referencia: texto descriptivo para identificar el incidente.
  • Notas: observaciones adicionales.
  1. Hacer clic en "Guardar".

El sistema automaticamente:

  • Calcula el descuento basado en el tipo de incidente (monto fijo, porcentaje o formula).
  • Si el tipo de incidente tiene marcado "Descuento flexible por incidente", el monto del descuento es editable manualmente.
  • Si el tipo de incidente tiene marcado "Descuento como días de tiempo fuera personal", se descuentan los días correspondientes del saldo de tiempo fuera personal del empleado.

Ver detalle de un incidente​

En el listado, hacer clic en el incidente. El detalle muestra:

Detalle de un incidente con datos y descuento calculado

https://app.zauru.com/payroll/incidents/:id
  • ID del incidente.
  • Empleado.
  • Tipo de incidente con su categoría.
  • Fecha.
  • Monto de descuento calculado.
  • Referencia y notas.
  • Informacion de creacion y edicion.

Editar un incidente​

  1. En el detalle del incidente, hacer clic en "Editar".
  2. Modificar los campos necesarios.
  3. Hacer clic en "Guardar".

Borrar un incidente​

En el detalle del incidente, hacer clic en "Borrar". Solo se pueden borrar incidentes que no hayan sido incluidos en una nómina pagada.

Importación masiva de incidentes​

Si al cierre del día tiene una pila de llegadas tarde de toda la cuadrilla, anotarlas una por una no es el mejor uso de su tiempo. Para registrar muchos incidentes a la vez, se puede usar la importación masiva desde un archivo.

  1. Ir a "Nominas".
  2. En el submenú de incidentes, seleccionar "Importar incidentes".
  3. Seleccionar el archivo con los datos de incidentes.
  4. Hacer clic en "Importar".

El sistema procesa el archivo y crea los incidentes correspondientes. Los incidentes importados aparecerán en el listado de incidentes y se aplicarán en la siguiente nómina que incluya al empleado.

Relación con las nóminas​

Cuando se procesa una nómina, el sistema busca los incidentes de cada empleado que estén dentro del rango de fechas de la nómina y aplica los descuentos correspondientes. Los descuentos aparecen como deducciones en el detalle de la nómina del empleado.

Con los incidentes registrados, los descuentos se aplicarán solos cuando se procese la nómina que cubra esas fechas. Si cada periodo maneja muchos incidentes, la importación masiva se convertirá en su mejor aliada para no dejar ninguno fuera.

API (llamadas desde sistemas externos)​

Listar incidentes​

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/payroll/incidents.json

Esto devolverá un JSON similar a este:

[
  {
    "id": 1,
    "zid": 2,
    "date": "2022-09-01",
    "time": "2000-01-01T00:00:00.000Z",
    "employee_id": 3,
    "incident_type_id": 2,
    "incident_type_data": "{:zid=>2, :category=>\"\", :code=>\"\", :name=>\"cobro por adelanto de salario\", :deduction_as_pto_days=>nil, :deduction_amount=>-0.425e3, :deduction_percent=>nil, :flexible_deduction_per_incident=>true, :description=>\"\"}",
    "notes": "compu cuota 10 de 12",
    "pdf": {
      "url": null,
      "thumbnail": {
        "url": null
      }
    },
    "deducted_pto_days": null,
    "deducted_amount": "-425.0",
    "deducted": true,
    "deducted_at": null,
    "creator_id": 4,
    "updater_id": 4,
    "entity_id": 4,
    "created_at": "2021-12-22T22:46:44.763Z",
    "updated_at": "2021-12-22T22:48:00.440Z"
  },
  {
    "id": 5,
    "zid": 6,
    "date": "2022-11-01",
    "time": "2000-01-01T00:00:00.000Z",
    "employee_id": 3,
    "incident_type_id": 2,
    "incident_type_data": "{:zid=>2, :category=>\"\", :code=>\"\", :name=>\"cobro por adelanto de salario\", :deduction_as_pto_days=>nil, :deduction_amount=>-0.425e3, :deduction_percent=>nil, :flexible_deduction_per_incident=>true, :description=>\"\"}",
    "notes": "compu cuota 12 de 12",
    "pdf": {
      "url": null,
      "thumbnail": {
        "url": null
      }
    },
    "deducted_pto_days": null,
    "deducted_amount": "-425.0",
    "deducted": true,
    "deducted_at": null,
    "creator_id": 4,
    "updater_id": null,
    "entity_id": 4,
    "created_at": "2021-12-22T22:47:36.027Z",
    "updated_at": "2021-12-22T22:47:36.027Z"
  }
]

Crear un incidente​

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X POST \
  -d '{
    "incident": {
      "employee_id": "1",
      "incident_type_id": "1",
      "date": "2024-06-15",
      "notes": "Llego 30 minutos tarde"
    }
  }' \
  https://app.zauru.com/payroll/incidents.json

Esto devolverá un JSON similar a este:

{
  "id": "11",
  "zid": "10",
  "date": "2022-09-01",
  "time": "00:00:00",
  "employee_id": "9805",
  "incident_type_id": "10",
  "incident_type_data": "{:zid=>2, :category=>\"\", :code=>\"\", :name=>\"cobro por adelanto de salario\", :deduction_as_pto_days=>nil, :deduction_amou...",
  "notes": "compu cuota 10 de 12",
  "pdf": null,
  "deducted_pto_days": null,
  "deducted_amount": "-425.0",
  "deducted": true,
  "deducted_at": null,
  "creator_id": "2",
  "updater_id": "2",
  "entity_id": "2",
  "created_at": "2021-12-22 22:46:44.763626",
  "updated_at": "2021-12-22 22:48:00.440651"
}

Ver un incidente​

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/payroll/incidents/1.json

Esto devolverá un JSON similar a este:

{
  "id": "11",
  "zid": "10",
  "date": "2022-09-01",
  "time": "00:00:00",
  "employee_id": "9805",
  "incident_type_id": "10",
  "incident_type_data": "{:zid=>2, :category=>\"\", :code=>\"\", :name=>\"cobro por adelanto de salario\", :deduction_as_pto_days=>nil, :deduction_amou...",
  "notes": "compu cuota 10 de 12",
  "pdf": null,
  "deducted_pto_days": null,
  "deducted_amount": "-425.0",
  "deducted": true,
  "deducted_at": null,
  "creator_id": "2",
  "updater_id": "2",
  "entity_id": "2",
  "created_at": "2021-12-22 22:46:44.763626",
  "updated_at": "2021-12-22 22:48:00.440651"
}

Borrar un incidente​

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X DELETE \
  https://app.zauru.com/payroll/incidents/1.json

En caso de exito, retorna un codigo HTTP 204 No Content (sin cuerpo).

Obtener estructura para crear un incidente​

Devuelve el incidente vacío junto con los empleados y tipos de incidente disponibles.

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/payroll/incidents/new.json

Esto devolverá un JSON similar a este:

{
  "incident": {
    "id": null,
    "zid": null,
    "date": "2026-08-05",
    "time": null,
    "employee_id": null,
    "incident_type_id": null,
    "incident_type_data": null,
    "notes": null,
    "pdf": {
      "url": null,
      "thumbnail": {
        "url": null
      }
    },
    "deducted_pto_days": null,
    "deducted_amount": null,
    "deducted": null,
    "deducted_at": null,
    "creator_id": null,
    "updater_id": null,
    "entity_id": 1,
    "created_at": null,
    "updated_at": null
  },
  "employees": [
    {
      "id": 1,
      "zid": 1,
      "id_number": "000",
      "active": true,
      "accountant": true,
      "inventory_controller": true,
      "seller": true,
      "buyer": true,
      "support_agent": true,
      "name": "Empleado Vendedor Senior",
      "identification": "1234567890101",
      "email": "vendedor@ejemplo.com",
      "position": "Gerente General",
      "address": "Calle Ejemplo 123, Zona 10",
      "phone": "5555-0001",
      "birthday": "1990-01-01",
      "started": "2008-01-01",
      "salary": "19533.62",
      "ssn": "123456789012",
      "tin": "12345678",
      "user_id": 1,
      "updater_id": 2,
      "entity_id": 1,
      "agency_id": 3,
      "notes": "",
      "created_at": "2013-01-08T16:54:53.222Z",
      "updated_at": "2026-08-06T04:14:17.486Z",
      "pdf": {
        "url": null,
        "thumbnail": {
          "url": null
        }
      },
      "image": {
        "url": null,
        "standard": {
          "url": null
        },
        "thumbnail": {
          "url": null
        },
        "pos": {
          "url": null
        }
      },
      "ordinary_hourly_rate": 80.27515,
      "daytime_extraordinary_hourly_rate": 80.27515,
      "nighttime_extraordinary_hourly_rate": 120.412726,
      "gender": true,
      "bank_account": "000-0000000-0",
      "bank": "G&T",
      "marital_status": "casado",
      "occupation": "Ingeniero en sistemas",
      "nationality": "Guatemalteco",
      "supervisor_id": null,
      "employee_category_id": null,
      "cost_center_id": null,
      "spouse_name": "",
      "dependents": "",
      "emergency_contact_name": "",
      "emergency_contact_phone": "",
      "education_level": "",
      "driver_license_number": "",
      "additional_worker_id": "1000000001 -1000002- RL1000000003 -1000004-"
    },
    {
      "id": 4,
      "zid": 5,
      "id_number": "002",
      "active": true,
      "accountant": true,
      "inventory_controller": true,
      "seller": true,
      "buyer": false,
      "support_agent": true,
      "name": "Empleado Ejemplo Dos",
      "identification": "2345 67890 0101",
      "email": "empleado@ejemplo.com",
      "position": "Implementador",
      "address": "Avenida Ejemplo 456, Zona 15",
      "phone": "5555-0002",
      "birthday": "1980-08-19",
      "started": "2021-04-01",
      "salary": null,
      "ssn": "987654321",
      "tin": "87654321",
      "user_id": 6,
      "updater_id": 7,
      "entity_id": 1,
      "agency_id": 3,
      "notes": "",
      "created_at": "2014-10-06T16:21:54.296Z",
      "updated_at": "2026-01-15T18:51:30.924Z",
      "pdf": {
        "url": null,
        "thumbnail": {
          "url": null
        }
      },
      "image": {
        "url": null,
        "standard": {
          "url": null
        },
        "thumbnail": {
          "url": null
        },
        "pos": {
          "url": null
        }
      },
      "ordinary_hourly_rate": null,
      "daytime_extraordinary_hourly_rate": null,
      "nighttime_extraordinary_hourly_rate": null,
      "gender": true,
      "bank_account": "",
      "bank": "",
      "marital_status": "",
      "occupation": "",
      "nationality": "",
      "supervisor_id": null,
      "employee_category_id": null,
      "cost_center_id": null,
      "spouse_name": "",
      "dependents": "",
      "emergency_contact_name": "",
      "emergency_contact_phone": "",
      "education_level": "",
      "driver_license_number": "",
      "additional_worker_id": "1000000001 -1000002-"
    }
  ],
  "incident_types_grouped": {
    "": [
      [
        "adelanto de salario",
        4
      ],
      [
        "ajuste de aguinaldo",
        173
      ]
    ],
    "Puntualidad": [
      [
        "Llegada tarde",
        262
      ],
      [
        "Llegada tarde",
        263
      ]
    ]
  }
}

Obtener estructura para editar un incidente​

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/payroll/incidents/1/edit.json

Esto devolverá un JSON similar a este:

{
  "id": "11",
  "zid": "10",
  "date": "2022-09-01",
  "time": "00:00:00",
  "employee_id": "9805",
  "incident_type_id": "10",
  "incident_type_data": "{:zid=>2, :category=>\"\", :code=>\"\", :name=>\"cobro por adelanto de salario\", :deduction_as_pto_days=>nil, :deduction_amou...",
  "notes": "compu cuota 10 de 12",
  "pdf": null,
  "deducted_pto_days": null,
  "deducted_amount": "-425.0",
  "deducted": true,
  "deducted_at": null,
  "creator_id": "2",
  "updater_id": "2",
  "entity_id": "2",
  "created_at": "2021-12-22 22:46:44.763626",
  "updated_at": "2021-12-22 22:48:00.440651"
}

Actualizar un incidente​

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X PUT \
  -d '{
    "incident": {
      "employee_id": "1",
      "incident_type_id": "1",
      "date": "2024-06-15",
      "notes": "Llego 45 minutos tarde"
    }
  }' \
  https://app.zauru.com/payroll/incidents/1.json

Esto devolverá un JSON similar a este:

{
  "id": "11",
  "zid": "10",
  "date": "2022-09-01",
  "time": "00:00:00",
  "employee_id": "9805",
  "incident_type_id": "10",
  "incident_type_data": "{:zid=>2, :category=>\"\", :code=>\"\", :name=>\"cobro por adelanto de salario\", :deduction_as_pto_days=>nil, :deduction_amou...",
  "notes": "compu cuota 10 de 12",
  "pdf": null,
  "deducted_pto_days": null,
  "deducted_amount": "-425.0",
  "deducted": true,
  "deducted_at": null,
  "creator_id": "2",
  "updater_id": "2",
  "entity_id": "2",
  "created_at": "2021-12-22 22:46:44.763626",
  "updated_at": "2021-12-22 22:48:00.440651"
}

¿Le fue útil esta guía?