Skip to main content

Projects – Administration

In Administration under Projects, you define settings, activities, statuses, mail templates, categories, keywords and additional attributes for your projects.

Written by Gideon Weller

In Administration under Projects, you define the foundations of your project work in ZEP: defaults, visibility, permissions, activities, statuses, mail templates, categories, keywords and additional attributes.

Which sub-menu items are visible depends on the active add-on modules. Each section indicates its availability as a note.

Note: The Projects box is available in ZEP Compact and ZEP Professional. In ZEP Clock it is not visible, since there is no project-related administration there. All sub-menu items (Settings, Activities, Project Status, Task Status, Mail Templates, Categories, Keywords, Additional Attributes, Task Additional Attributes) are generally visible. Individual settings within the sub-menu items only appear when the relevant add-on modules are active — the module dependency is indicated as a note in each section.

Settings

The sub-menu Settings consolidates all system-wide defaults for project work: planned-hours warning, display options in the task and project info-popover, permissions, billing defaults, display-name formats, signature block, email to project employees, project-number sequence and project-plan visibility.

Notification when a percentage of Planned hours has been reached

You globally define the percentage of Planned hours at which ZEP sends an email to the project manager with budget responsibility. Optionally, only billable hours are counted toward the threshold.

Note: Threshold emails require the Project Planning add-on module.

Global default

Via the radio selection Percent for escalation mail to project manager you choose between two modes:

  • Do not send email — no warning mail is generated system-wide.

  • Define plan warning — you enter up to three percentage thresholds (for example 80 %, 90 %, 100 %). As soon as a time entry exceeds one of these values, ZEP sends a notification to the project management.

If only one value is entered, only one email is sent. Up to three different thresholds can therefore be defined.

Only consider billable hours

With the billable only checkbox you limit the threshold logic to billable-booked hours. Internal or non-billable hours then do not count toward the threshold. Use case: only billable hours should affect the budget limit.

Per-project override

You can override the global thresholds at the individual project under Data & Plan. Three options are available per project:

  • Like Administration — the global thresholds apply unchanged (default for new projects).

  • No email — no warning mails are sent for this project, even if defined globally.

  • Own values — you enter three project-specific percentages that apply only to this project.

Prerequisites for sending

For ZEP to generate a warning email, several conditions must be met:

  • Planned hours are stored on the project or task level.

  • A project manager with budget responsibility is assigned to the project.

  • An email address is maintained for the project manager in employee administration.

If no project manager with budget responsibility can be determined, all project managers without budget responsibility are informed. If there are no project managers either, with active module Departments the department managers are notified. If this also fails, the emails are sent to all administrators.

Each time entry is checked against the percentage of Planned hours on task or project level. Up to two emails can be sent per booking: one related to the booked task (or its parent task) and one related to the overall project.

Display in the info-popover of tasks

Eight checkboxes control which detail information appears in the info-popover of a task. Employees open the popover via the i-icon in the task selection of time tracking.

Show planned and Actual hours

When active, the task info-popover is extended by the stored Planned hours. The task table then contains the following columns:

  • Planned — the Planned hours stored for the task.

  • Actual — all hours booked on the task so far.

  • Planned-Actual — difference between the two values.

  • Actual (billable) — billable hours booked so far.

  • Planned-Actual (billable) — difference between planned and billable-booked hours.

Note: Planned-Actual hours require the Project Planning add-on module. Without this module the setting is called Show Actual hours during time tracking and only displays the Actual hours.

Show only bookable tasks

When active, employees only see tasks with a bookable status whose run-time lies in the recording period. Use case: reducing the selection list in projects with many tasks.

Show only own tasks

Hides all tasks to which the logged-in person is not assigned as a task employee. Use case: personal view in large projects with clear task assignment.

Remarks of tasks

Activates the display of the task remark in the info-popover. Use case: contextual information such as briefing notes is visible directly during booking.

Start and end date of tasks

Displays the planned start and end date of the task in the info-popover. Use case: employees see the planned time-frame before booking.

Tickets and subtasks

Displays linked tickets and sub-tasks of the task in the info-popover. Use case: support-oriented teams with customer tickets as drivers of task planning.

Note: Tickets and subtasks require the Ticketing System add-on module.

Task team members including e-mail

Activates the display of all employees assigned to the task with their email addresses stored in ZEP. Use case: quick contact from within the time tracking.

Display in the info-popover of projects

Three checkboxes control which detail information appears in the info-popover of a project.

Remark for selected project

Shows the project remark in the info-popover. Use case: overview of project context directly from the time tracking.

Accounting type for selected project

Displays the billing type (fixed price, time and material, internal) in the info-popover. Use case: quick information whether bookings are billable.

All project team members for the selected project including e-mail

Activates the display of all project employees with their function (e.g. project manager) and their email address. Use case: stakeholder list for project coordination.

Permissions

Three checkboxes control extended action rights for users with the role User with additional rights or Controller as well as project managers.

Users with additional authorizations/controller may create projects

When active, users with the role User with additional rights or Controller can create projects themselves — a right otherwise reserved for administrators. Use case: decentralized project creation in larger organizations.

Project manager may add keywords outside of master data

Allows project managers to create their own keywords within a project and assign them, without opening the master-data area. New keywords are added directly to the keyword master.

Administrator/department manager may add keywords outside of master data

Same logic for administrators and department managers (with module Departments). Use case: quick keyword maintenance during running project work.

Internal projects are generally non-billable

Projects without customer assignment are internal projects. Since you cannot invoice them to a customer, it is reasonable to book only non-billable hours on them.

If this setting is active:

  • When creating new internal projects the billable default is automatically set to non-billable, not changeable by employees. This default cannot be changed at the individual project.

  • The reports Project Sales Volume and Time Report are not offered for internal projects, as they are based on billable hours.

  • If an internal project still contains billable hours (e.g. because a customer was previously assigned), these are visible in Project Time Report, Project Status Plan, Project Status Time, Project Status Revenue and in the overall-status reports and must be rebooked manually if needed.

No automatic rebooking between internal and external projects takes place.

Display-name formats

You determine how projects and tasks are displayed in selection lists and reports. There are four independent settings for internal and external views:

  • Display name for projects in report table columns — applies to internal views (for example project time reports, project status).

  • External display name for projects — applies to external views (for example invoices, printed time reports).

  • Display name for tasks — applies to internal views in task selection lists and task reports.

  • External display name for tasks — applies to external views in which tasks are shown to customers (for example invoice appendix).

Each setting offers three formats:

  • Abbreviation — only the project or task number.

  • Description — only the plain-text name.

  • Short form (Description) — number plus plain-text name in parentheses, ideal for unambiguous identification.

Preset signature block on project hours report

Determines whether the Time Report by default includes a signature block when printed. Use case: printed hour reports with a signature field for customer approval, without users having to enable the option manually before each print. The default can still be changed at the individual print job.

Email to project employees

In a project under Project employees you can send collective emails via the link Send email to project employees. Two settings control the behavior:

Send email in project language

When active, the email is sent in the project language (set in the project under Format > Billing settings). Otherwise the ZEP language (Administration > My Company > General) is used.

Send email via Undisclosed Recipients (BCC)

When active, only the sender is listed in the To field; all other recipients are placed in the BCC field and do not see each other. Otherwise all recipients are listed openly in the To field. Use case: data protection for collective emails to external project employees.

Use project number range

You define how project numbers are generated automatically. The number consists of a prefix, a sequential counter and a suffix.

Prefix

Static start of every project number. You combine fixed characters with the following placeholders:

  • %YYYY% — year of the current date (for example 2026).

  • %YY% — last two year digits of the current date.

  • %MM% — month of the current date.

  • %DD% — day of the current date.

Length

Number of digits of the sequential counter between prefix and suffix. The number is padded with leading zeros if needed (a length of 4 leads to numbers such as 0001, 0002, and so on).

Suffix

Static end of every project number. The same placeholders as in the prefix can be used (%YYYY%, %YY%, %MM%, %DD%).

Project-plan visibility for project employees

Controls whether project employees see the Project plan menu item and which detail values are displayed to them. When active, all employees see the Projects tab with the projects assigned to them and the corresponding project plan.

When visibility is enabled, three sub-options can additionally be set:

Note: Project-plan visibility requires the Project Planning add-on module.

Show planned hours

Makes the stored Planned hours visible in the project plan. Without this option, employees see the plan itself but no target numbers.

Show planned amounts

Makes the stored Planned amounts (in the project currency) visible in the project plan. Use case: financial transparency at project-management level.

Show actual hours

Makes the Actual hours booked so far visible in the project plan. Use case: up-to-the-day progress view for project employees.

Activities

Activities are labels for different work types independent of the project. Each time entry references one activity. Via the price tables you can store specific hourly rates per activity (from ZEP Compact with the Revenue & Costs add-on module). Distinguishing activities supports later reporting.

Note: Do not define too many activities — it confuses users when booking. A long list of items that rarely appear in reports is less useful than an additional activity called Other.

Abbreviation and description

Each activity has an Abbreviation as a technical key and a Description as a speaking plain text. Both fields are mandatory. The abbreviation appears in reports and exports, while the description is what employees see in the booking dialog of the time recording.

Multi-language description

You maintain the description in several languages. In the Description field click on the respective language flag and enter the translation. ZEP supports seven languages: German, English, French, Spanish, Polish, Slovak and Turkish. Depending on the language of the employee or project, the matching description is displayed.

Not relevant for working time

You mark an activity as not relevant for working time. A typical example is on-call duty — it is recorded but does not count as regular working time. For such activities the following applies:

  • It does not count toward overtime — requires the Absences & Overtime module.

  • It does not cause Total Rates Internal.

  • It may overlap in time with another activity.

  • It counts as a break in the work break regulation.

  • It does not generate subsistence costs (VMA), not even for project billing.

  • It can be billed to the customer — that is, booked billable or non-billable. Booked billable with duration 0 it still appears in the project revenue and invoice appendix.

Warning: Once project times have been booked on an activity with these properties, the properties cannot be undone. The booked times must be deleted first.

Non-billable hours stay visible

You mark an activity so that non-billable bookings remain visible in reports. A typical example is goodwill — work performed that is not invoiced but should remain transparent to the customer.

Properties:

  • Can be booked billable and non-billable.

  • Appears in Time Report, Project Sales Volume and on the Invoice Appendix, even when booked non-billable — then with price 0.00.

  • A billable-booked goodwill activity can be priced with a specific hourly rate.

  • Can be combined with other options (travel activity, not relevant for working time).

In daily-rate projects, activities marked as goodwill only contribute to the daily-rate share when booked billable. Non-billable bookings still generate a daily-rate share, which appears in the time report and is shown in project revenue and invoice appendix with price 0.00.

DATEV wage type

You store a wage type per activity, which is used in the wage export. This way, bookings can be automatically assigned to the correct wage type in the payroll system, eliminating manual rework.

Note: The wage type entry appears when the DATEV payroll interface (DATEV LODAS or DATEV Lohn und Gehalt) is active. In ZEP Clock and ZEP Compact the DATEV interface is booked as an add-on module. In ZEP Professional the add-on module Export for Accounting must be licensed.

Travel activity

A special case is the travel activity (typical short form: re). It defines start and end of business trips. Together with the stored work location, ZEP automatically calculates the subsistence costs for travel-expense accounting — unless you set the field Calculation method for subsistence costs to no calculation.

Via Change Travel Activity you define which of your activities is the travel activity. Through the checkboxes may overlap with other activities and not relevant for working time you determine whether travel time counts as working time in your organization.

For a travel activity the following applies:

  • It is not relevant for working time — not included in overtime (module Absences & Overtime).

  • It does not cause Total Rates Internal.

  • It may overlap with another activity and counts as a break in the work break regulation.

  • It generates subsistence costs (VMA).

  • It can be booked billable or non-billable and is invoiced even when overlapping with another time entry.

Warning: Once project times have been booked on a travel activity, the properties listed above cannot be undone. The booked times must be deleted first.

Note: The function Change Travel Activity is available from ZEP Compact as soon as the Travel Expense Management add-on module is active. In ZEP Clock the Projects box in the administration is not visible.

Activities and tasks

Besides activities, work can be structured by tasks. The choice between activity and task follows these criteria:

A work step is an activity if …

  • … it is very general and not bound to a specific project or project type.

  • … a report across all projects would be interesting — for example, because you pay employees a special hourly rate for it, receive a special rate from the customer, or the time is not paid by the customer (travel time, overhead).

  • … it is relevant in most projects and is in practice booked well and consistently by employees.

A task, in contrast …

  • … is rather specific and tied to a particular project or project type.

  • … is a project phase or a manageable work package.

  • … enables a detailed effort estimation (planned times, planned costs).

Project status

In the sub-menu Project status you define the status values a project can go through.

Create status

You create a new status with Abbreviation and Description. You can maintain the description in multiple languages (German / English / French / Spanish). Optionally, you assign a color to the status, which is shown in the project table. Use case: visual recognition of typical workflow phases such as Requested, In Progress, Completed.

Sequence

You move statuses up or down via the arrow icons. The sorting determines the display in selection lists throughout the application. A newly created status is always appended at the end — move it to the desired position afterwards. A newly created or copied project always starts in the first status of the list.

Bookability

Per status you indicate whether it is bookable. Only projects assigned to a bookable status appear in the project-time and expense entry selection lists. Bookable statuses are displayed in bold in the table. Use case: effectively exclude completed or locked project phases from time tracking without deleting the status itself.

Filter

The project status can be used as a filter criterion in project reports and project planning. This lets you narrow reports to specific workflow phases (e.g. only active projects) and prevents completed or archived projects from distorting the numbers.

Task Status

In the sub-menu Task status you define the status values a task can go through.

Create status

You create a task status with Abbreviation and Description. The description can be maintained in multiple languages. Optionally, you assign a color shown in the task table. Use case: representing the working state of individual work packages (To Do, In Review, Accepted) independently of the overall project status.

Sequence

Order and moving work analogously to the project status via the arrow icons. A well thought-out sequence helps project managers and employees find the right next value when booking or changing status.

Bookability

The bookability of a task behaves analogously to the description for the project status: only bookable task statuses accept time bookings. Bookable statuses are displayed in bold in the table.

Filter

The task status can be used as a filter criterion in task reports and project planning. Practical example: in project planning you hide all already accepted tasks to highlight the remaining work still to be planned.

Mail Templates

In the sub-menu Mail templates you adapt the standardized texts of emails sent from ZEP — for example the project mail templates for To all project employees or To a single project employee.

Use of the templates

Per template you define subject and body of the email. The templates are used automatically for each matching dispatch event, so you do not have to formulate manually for each email. For some templates you can additionally store CC and BCC recipients.

Placeholders

You use general placeholders to dynamically insert project and employee data into the text. The placeholder Actual hours (%ISTSTUNDEN%) always returns the current billable-booked Actual hours of the project — not the total hours.

File attachment

You can attach files to each template that are sent along with every dispatch — for example terms and conditions, privacy notes, or instructions. Limits: maximum 5 files of 20 MB each, in total a maximum of 50 MB.

Test send

You can send each mail template as a test email (preview) to your own address. In the Test send (to your own email address) column click the flag of the desired language — available are German, English, French, Spanish, Polish, Slovak and Turkish. This lets you verify content and formatting in every maintained language before productive use.

Categories

In the sub-menu Categories you define categories to which you can assign your projects. This categorization serves as a search and selection criterion in reports.

Abbreviation and description

Each category has a Abbreviation as a technical key and a Description as a speaking plain text. You can maintain the description in seven languages (German, English, French, Spanish, Polish, Slovak, Turkish), so that users and reports each see the matching name.

Keywords

In the sub-menu Keywords you maintain a shared keyword world for projects, customers and other data objects. Entering keywords helps you use the search function to find and open projects more quickly.

Abbreviation and description

Each keyword has an Abbreviation as a technical key and a Description. A central place for maintenance prevents sprawl due to differently spelled variants and ensures that keyword-filtered reports deliver consistent results across the whole tenant.

Maintenance outside of master data

Via the two permission checkboxes Project manager may add keywords and Administrator/department manager may add keywords (in the Settings sub-menu) you allow keywords to be added directly within a project — the new entries are automatically added to the keyword master.

Additional attributes

In the sub-menu Additional attributes you define individual fields for projects. A project additional attribute is an extra input field that appears on the data page of every project and can be maintained through the entry mask — suitable for classifications ZEP does not provide by default.

Fields when creating a project additional attribute

When creating a project additional attribute, you maintain the following data:

  • Name — technical name of the attribute, also used to read and set the attribute via the SOAP interface.

  • Description — multi-language label shown in the project entry mask.

  • Remark — internal remark to describe the attribute.

  • Type — data type of the attribute. Available types: text, yes/no, number, decimal, percent, date, URL, email, selection list, employee selection.

Data types with special behavior

  • Selection list — you define one or more options that are then offered on the project as single or multiple selection.

  • Employee selection — this type allows users to pick an existing employee and assign them to the project.

Use of project additional attributes

Project additional attributes are displayed on the data page of the project and can be edited in edit mode. They are also available in the following places:

  • In project administration views via configurable columns.

  • As placeholders on invoices — the project value is inserted via the popup.

  • As a document variable in the letterhead — the attribute is available under its name as a document variable.

  • Via SOAP in the <attribute> section.

Additional attributes for tasks

In the sub-menu Task additional attributes you define individual attributes on the task level. The field logic matches that of project additional attributes — the attributes apply per task in the task entry mask.

Fields when creating

You maintain the same fields as for the project additional attributes:

  • Name — technical name (also usable via SOAP).

  • Description — multi-language label for the entry mask.

  • Remark — internal remark for description.

  • Type — data type (text, yes/no, number, decimal, percent, date, URL, email, selection list, employee selection).

Use case: detail data points on the task level such as order numbers, cost centers or sub-classifications that are not maintained on the project level.

Connections to other modules

Settings in the project administration affect many other areas:

  • Time Recording — activities and task statuses control what can be booked and on what.

  • Invoicing — non-billable activities and internal projects are evaluated accordingly in invoicing.

  • Project planning — Planned hours, thresholds and visibilities require this module.

  • Travel expense accounting — travel activities feed into travel-cost reports.

  • Ticketing System — tickets and sub-tasks can be booked onto projects and tasks.

  • Absences & Overtime — the property not relevant for working time affects the overtime calculation.

  • Export for Accounting — wage type per activity controls the wage-export file.

  • Revenue & Costs — activities allow specific hourly rates per activity.

Did this answer your question?