Skip to main content

Project data

Reference for all fields of a project in the tabs General, Plan, Customer and Invoicing, and Address.

Written by Benny Hahn

In the project dialog, you maintain the master data of a project. The dialog is organised into several tabs that together form the complete project master data. This article walks you through each tab and explains per field what it is for, which values are allowed, and under which conditions it appears.

Note: The project dialog comprises the tabs General, Plan, Customer & Invoice, and Address. If a machine-readable invoice format (XRechnung or ZUGFeRD) is stored for the assigned customer, the additional tab XRechnung appears. Which tabs and fields are visible depends on the product line and the licensed modules.

The further sub-areas of a project, such as project team members, tasks, project plan, and price tables, are not part of this dialog and are described in the article Project administration. All project reports are found in the article Project reports. The editing workflow from creation to deletion is described in the article Creating, editing and deleting projects.

General

The General tab contains the organisational base data of the project. You assign these fields first when creating, and they appear afterwards in the project overview, in the selection lists of recording, and in the reports.

Abbreviation

The Abbreviation is the project number and the unique identifier of the project. It is the only mandatory field in the entire dialog and serves three purposes:

  • It identifies the project uniquely across the company and allows any combination of letters and digits.

  • It serves as a stable reference in invoicing, reports, and exports as well as a linking key to connected third-party systems.

  • It is shown in full in all selection lists of recording and should therefore be chosen short and descriptive.

Note: If a sequential project-number format is activated under Administration > Projects > Settings, ZEP automatically suggests the next free number via the Next free no. link right at the field. The configuration of the number range is described in the article Projects – Administration.

Note: If a project is linked to a CRM system, the abbreviation serves as the shared key of both systems and is then read-only so that the reference between ZEP and the CRM stays stable. The integration is described in the articles HubSpot and Salesforce.

Description

In the Description field, you store the detailed plain-text name of the project with up to 255 characters. It appears in all lists, reports, receipts, and invoices, and can be adjusted at any time without affecting existing references.

In the selection lists of project time and receipt recording, the description is shown together with the abbreviation: the abbreviation in full, the description abbreviated for space reasons. This way, the description makes the concise abbreviation more meaningful for employees and eases the selection of the right project.

Tip: Include the customer or the order in the description so that the project can be found again immediately in long lists even after several years.

Run time

The Run time defines the start and end date of the project. An empty end date means unlimited duration. Start and end date additionally serve as a filter criterion in project planning and appear on reports and invoices.

Note: If the booking or display date lies outside the run time, the project does not appear in the selection lists of recording and is not bookable, regardless of the status. This is a frequent reason why a project seems to be missing: in reports and views, projects are only offered for the set period. In this case, first check the start and end date as well as the chosen report period.

Status

The Status shows the current project status from the selection list. It directly controls the bookability: only projects with a status configured as bookable are offered in the selection lists of time and receipt recording. When creating a new project, the first status defined in the master data is preset. The full status list with order and bookability is maintained by administrators under Administration > Projects > Project status.

Note: A non-bookable status (for example Closed) hides the project from recording without changing the historical data. If a project is unexpectedly not bookable or missing in a view, check the status first besides the run time. How you create statuses and configure their bookability is described in the article Projects – Administration.

Department

The Department assigns the project to an organisational unit. It controls the visibility for department managers and is the basis for the department reports under Reports > Departments. Project planning can be filtered by this criterion, which supports decentralised organisations in steering per location.

Note: The Department field is only available with the add-on module Locations & departments.

Categories

Via Categories, you optionally assign one or several classifications to the project, for example a separation into consulting, implementation, or support projects. Categories serve as a filter in the project overview and as a grouping in the reports. The available categories are created by administrators; the procedure is described in the article Projects – Administration.

Keywords

Keywords offer an additional, freely selectable classification alongside the categories, for example for industries or technology stacks. They appear as a filter in the project overview and as a grouping in reports. Creating the keyword master data and the setting that also lets project leads add their own keywords is described in the article Projects – Administration.

Color

With the Color, you assign an identifying colour to the project. ZEP uses it to colour the project time bookings of this project in the calendar and time-recording views, so that bookings of different projects can be distinguished quickly at a glance. The assignment is optional and changeable at any time.

Remark

The Remark is a free notes area with simple text formatting. It appears exclusively in the project detail view and in no external document. Useful for internal hints for the project lead or the accounting team, for example on special conditions, agreements, or a reference to the contract.

Additional attributes

Below the remark, the freely configurable additional attributes appear, provided your company has defined any. This way, project-individual additional information can be captured in a structured way and then used as a dedicated column in the project overview. How administrators create additional attributes with field type and behaviour is described in the article Projects – Administration.

Plan

The Plan tab bundles the target values of the project. Via them, the later plan-actual comparison takes place in the reports Project status (plan) and Overall status (plan). For flat-rate billing, the plan values additionally serve as the amount to be invoiced.

Note: The Plan tab is included in ZEP Professional and is added in ZEP Compact via the add-on module Project Planning. The pure plan-price fields (total rates, receipts, travel flat rates) are available exclusively in ZEP Professional.

Planned hours

Under Planned hours, you store the hour budget of the overall project. Two ways are possible:

  • Fixed: via the checkbox Planned hours fixed, you specify a fixed value for the overall project.

  • Dynamic (dyn): you plan at task level; ZEP aggregates the task values and shows the result in italics with the suffix (dyn).

If more hours are planned below than specified above, ZEP points out a planning difference. The planned hours are then the comparison value against the actually booked actual hours.

Note: The dynamic planning arises automatically from the project hierarchy. If you leave the field Planned hours fixed empty and assign plan values at task level (with the add-on module Ticketing System additionally at ticket and subtask level), ZEP aggregates these values upwards and shows the result on the project in italics with the suffix (dyn). This way you plan bottom-up: the total planned hours result from the sum of the partial plans. If you instead set a fixed value, this remains decisive, and ZEP warns of a planning difference as soon as the subordinate values exceed it.

Actual hours and billable actual hours

The fields Actual hours and Bill. actual hrs are pure display values and are not maintained manually. Actual hours shows all hours booked on the project, Bill. actual hrs only the hours booked as billable. Both compare the current booking status against the planned budget.

Prevent overbooking

With Prevent overbooking, you control whether more hours may be booked than planned. The following levels are available, each optionally with or without travel times:

  • No: it is not prevented that more than the planned hours are recorded.

  • Only billable times: ZEP blocks as soon as the billable actual hours exceed the planned hours.

  • Billable and non-billable times: ZEP blocks as soon as the total actual hours exceed the planned hours.

Additionally, you can set an overbooking limit per day, that is a maximum number of hours per day, provided an overbooking limit is active at project level at all.

Warning: If a time booking exceeds the plan figures, saving fails and the time is not saved. The person recording sees the message "This time cannot be booked, since thereby the planned hours of the project/task were exceeded." In addition, ZEP automatically notifies by e-mail, in this order:

  • the project lead with budget responsibility of the project,

  • alternatively the project lead without budget responsibility,

  • alternatively the department management of the project (with the add-on module Locations and departments),

  • alternatively all administrators.

Note: So that employees can see their remaining margin, administrators activate the display of planned hours during time recording. Employees then call up the current plan and actual figures via the info icon next to the task. The corresponding setting is described in the article Projects – Administration.

Notification when a percentage of planned hours has been reached

Here you define per project whether and when the project lead with budget responsibility is notified once the booked actual hours reach a certain percentage of the planned hours. Depending on the configuration, only the hours booked as billable or all hours are counted. Three settings are available:

  • Default setting: the percentage thresholds stored globally in administration apply.

  • No e-mail: no notification is sent for this project.

  • Special setting: you define up to three own percentage thresholds, for example 70, 90, and 100 percent as a staged early-warning system.

The check runs on every time booking at task and at project level; per threshold, up to two e-mails can therefore be triggered. The prerequisite is that planned hours are stored for the project or the task. If ZEP finds no project lead with budget responsibility, the same fallback chain as for overbooking applies (project lead without budget responsibility, then department management, then administrators).

Note: The global thresholds and the default behaviour of this notification are defined centrally by administrators. The corresponding setting is described in the article Projects – Administration.

Plan Total rates

The Plan Total rates are the planned billable revenue from working time, calculated from planned hours times hourly rate, or, for flat-rate projects, the agreed flat price for the working time. The value can be assigned fixed for the overall project or dynamically per task. For a discount, you enter a minus sign directly before the amount.

The Plan Total rates are the target value for the revenue comparison: ZEP compares them against the actually achieved revenue in the reports Project status (plan) and Overall status (plan). For flat-rate projects, they are at the same time the amount to be invoiced for the working time. As with the planned hours, ZEP shows a value aggregated from the tasks in italics with the suffix (dyn).

Planned receipts, mileage and travel flat rates

In these fields, you plan the billable additional costs of the project:

  • Receipts and mileage allowance: planned amount for expenses and travel costs, plannable fixed for the overall project or per task.

  • Travel flat rates: planned amount for subsistence costs and flat-rate arrival costs, calculated only once for the overall project.

These plan values, too, feed into the reports Project status (plan) and Overall status (plan) and serve the target-actual comparison of the additional costs. For flat-rate projects, together with the Plan Total rates they form the total flat price (total rates plus receipts and mileage plus travel flat rates).

Customer & Invoice

The Customer & Invoice tab bundles the commercial fields of the project: the customer assignment, the addresses for invoicing, and the billing logic.

Note: The Customer & Invoice tab is available in ZEP Compact and ZEP Professional; it does not appear in ZEP Clock. Individual fields are additionally unlocked by the add-on modules Invoicing, Revenue and costs, or the area Export for Accounting and are marked at the respective field.

Customer

Via Customer, you assign the project to a client or mark it as an internal project without customer assignment. From the assignment, the invoice address, tax rate, and price logic are pre-filled. A later change is possible but can overwrite existing pre-fills; with running invoicing transactions, caution is advised. If invoicing to multiple customers is active, the primary customer is shown here. The master data of the selectable customers is maintained in customer management; creating them is described in the article Creating, editing and deleting customers.

Note: The choice between an internal and an external project has far-reaching consequences for the available fields:

  • External project (with customer): invoice and delivery address, customer contact person, price logic, and the invoicing fields are available, and the project can be billed.

  • Internal project (without customer): the customer- and invoicing-related fields are omitted. Internal projects are generally not billable and serve internal time recording, for example for leave, internal meetings, or training.

Customer contact person

The Customer contact person is selected from the list of all contact persons of the assigned customer. When the project is invoiced, this person is preset as the invoice recipient. You do not maintain new contact persons here, but directly at the customer record in customer management, from where the list is fed.

Customer order

In the optional Customer order field, you store an order or project name under which the project is known at the customer. This value appears on the project revenue and customer revenue reports as well as on the invoice, so that your customer can more easily assign the invoice to their own order.

Order number and job number

The fields Order number and Job number hold the customer-side reference numbers of the project. Both are available as configurable columns in the project overview and can be printed on the invoice, which eases the assignment in the ordering process of larger customers.

Revenue account

Via the Revenue account, you assign the project revenue to a bookkeeping account for the handover to the external accounting. This enables a separate revenue analysis by business field or result unit. Per revenue account, the revenues can then be filtered specifically in the accounting export and handed over to the finance system.

Note: The Revenue account field only appears when the area Export for Accounting is active and a customer is assigned to the project. The revenue accounts are maintained by administrators in the collection Export for Accounting.

Invoice address and delivery address

The Invoice address and the Delivery address are taken over from the customer data by default (selection - Customer invoice address - or - Customer delivery address -). Only if the invoices of this project are to go to a different address do you select another address from the customer address list. The addresses themselves are maintained in customer management.

Note: The fields Invoice address and Delivery address appear with the add-on module Invoicing. The address of an individual invoice can be adjusted independently at any time during billing.

Allow invoicing to multiple customers

With the option Allow invoicing to multiple customers, you assign several customers to a project, for example for consortia or shared orders. The primary customer remains the main contact, the additional customers are billed proportionally. The management of the assigned customers then takes place in the billing settings sub-area of the project.

Note: The option Allow invoicing to multiple customers is available with the add-on module Invoicing. As soon as several customers are assigned to the project, the setting can no longer be withdrawn.

Language and currency

The Language controls which texts, for example invoice texts, are used automatically for this project. The Currency is applied in invoicing and in the reports; receipts in other currencies are automatically converted into the project currency, and the project price tables are understood in this currency. Both values are pre-filled from the customer and can be overridden per project.

Cost Center and Cost Unit

Cost Center and Cost Unit assign the project to the internal cost accounting and are used in the export to the external accounting. You select the Cost Center from the master data, the cost unit is captured as a number or free text depending on the configuration.

Note: The fields Cost Center and Cost Unit only appear with the active area Export for Accounting and when the setting Cost centre per project is activated there. Otherwise the values are derived per department or employee.

Type of accounting

The Type of accounting is the standard billing logic for all tasks of the project and controls which further fields appear in the tab. It determines whether a price list is needed and how billable actual hours, receipts, and travel costs are billed.

The following types of accounting are available:

  • Fixed price: the flat price is entered under Plan Total rates, a price list is not needed. Suitable for fixed-price orders with a pre-agreed amount.

  • Expenditure at hourly rates: the project needs a price list with hourly rates. The billable actual hours are billed according to the project price list, plus the billable amount of the booked receipts. Mileage, subsistence costs, and arrival flat rates are considered according to the chosen billing format.

  • Expenditure at daily rates: the project needs a price list with daily rates. The billable actual hours are converted into daily rates via the stored daily-rate shares and billed according to the project price list. Optionally, you enter the number of offered daily rates, provided the tasks are not billed individually.

Example: If the customer pays the working time at a flat rate but the travel by effort, you create the project by effort and add a task Travel onto which only travel costs and travel receipts are booked. Conversely, a flat-rate project can also be run when all tasks are recorded by effort.

Account for tasks separately

With the checkbox Account for tasks separately, you bill the tasks of a project separately with their own amounts each, instead of collectively for the overall project. This is useful for mixed projects in which individual tasks have a billing type that differs from the project, for example a flat-rate conception followed by effort-based implementations.

Warning: As soon as an invoice item has been created for a task, the setting Account for tasks separately can no longer be changed. First delete the relevant invoice item if you need to switch the billing logic afterwards.

By default, all tasks have the billing type like project, and the project is billed as a whole. As soon as at least one task has a deviating billing type or you activate this option, the overall billing is composed of the individual task billings. The following applies:

  • Each task billing contains the amounts for total rates, receipts, and mileage.

  • Subsistence costs and arrival flat rates are calculated only once for the overall project, not per task.

  • For billing by daily rate, the daily rate is determined exclusively from the hours booked on this one task.

Example: If 6 hours are booked on task 1 and 6 hours on task 2 on one day, individual billing results in 0.75 plus 0.75 daily rates. Without individual billing, the project counts one full daily rate in total (with the example rule: up to 6 hours 0.75 daily rates, more than 6 hours one full daily rate).

Note: If billing is by daily rate and the tasks are not billed individually, an employee can book hours on several tasks with different price groups on one day. The price group for that day is then taken from the task on which the most hours were booked; in case of a tie, the price group with the higher daily rate applies.

Daily rates offered

The field Daily rates offered appears for billing by daily rate, provided the tasks are not billed individually. Here you enter the number of planned or offered daily rates. The value is considered in the report Project status (plan) as a planned comparison value for the overall project.

If the tasks are billed individually, no entry is possible here; you then store the offered daily rates per task. This way, the planned daily-rate scope stays correctly assigned to the respective task even in mixed projects.

Address

The Address tab holds the geographic details of the project as well as a hyperlink to an external resource. These fields are optional and serve documentation and quick navigation, for example to a linked CRM record or a contract document.

Country and federal state

In the fields Country and Federal state, you optionally capture the geographic reference of the project. The entry is useful especially where projects are run across several locations or countries and are to be classified geographically in reports or travel-cost contexts.

URL

In the URL field, you store any hyperlink for the project, for example to a Salesforce opportunity, a contract document, or a project room. In the project overview, the link is shown as an icon; a click on it opens the stored address, the tooltip shows the full URL.

XRechnung

The XRechnung tab appears exclusively when a machine-readable invoice format (XRechnung or ZUGFeRD) is stored for the assigned customer. It holds the mandatory details required for electronic invoicing to public-sector clients as well as to many corporate customers. The following fields are available:

  • Project reference and Contract reference for assigning the invoice at the recipient.

  • Allocation number and Object number for public tenders and construction projects.

  • Paymentterms for the stored payment terms as well as a free text field for additional details.

Since these details are part of the electronic invoice format, you should maintain them completely before the first XRechnung is generated for the project.

Note: The XRechnung tab requires the add-on module Invoicing and only appears when XRechnung or ZUGFeRD is activated for the assigned customer. The setup of the electronic invoice format is described in the articles Project Settings – Invoicing and Machine-Readable Invoice Formats.

Did this answer your question?