# Services

https://docs.wisecp.com/de/services

Keep every product and service you have sold in one list, so you can reach the right account, read its state at a glance and act on it without opening the order it came from.

## Opening the Screen

Open **Orders › Services** from the side menu: `{admin}/services`. The counter beside the menu entry is not the list size: it counts the services still **Pending Approval** or **In Progress**.

The screen reads and acts, it does not create: a service is born from an order ([Creating an Order](https://docs.wisecp.com/en/creating-an-order)). Staff without a services privilege never reach it.

## What Is on the Screen

| Area | What it holds | When it appears |
| --- | --- | --- |
| Options bar | Apply to Selected, Product Group, Service Status, Advanced Filter | Under the title; on mobile behind **Show Options**. |
| Advanced filter | Product, search, date and requirement groups | Opens with its button, or already open when the address has a filter. |
| Table strip | **Show Records**, search box, download icon | Above the rows; the icon needs the export privilege. |
| List | Client, Product/Service, Price, Renewed, Next Due, Status, row menu | Always; the checkbox column needs the order operation privilege. |

### The Options Bar

**Product Group** lists Domain plus every product group in the system and **Service Status** the seven states; both apply at once. **Apply to Selected** shows only for staff who may operate on services and applies Activate, Suspend, Cancel or Delete to the ticked rows, emptying itself once fired. **Advanced Filter** opens the panel below and counts the fields filled in it.

The **search box** matches the service name, client name, company, e-mail, domain, hostname and IP address.

### The Advanced Filter Panel

The panel holds four bordered groups, product, search, date and requirement, whose fields are listed below. Every field narrows the list as it changes and is written into the address, so the view can be shared; closing the panel clears them all and the full list returns.

Date fields open a calendar range with a symbol button that switches the comparison (Equals, On or After, After, On or Before, Before, Exclude Date), and **Quantity** carries the same button without Exclude Date. **Requirement Value** is printed only while the list is served page by page from the server, which happens once the installation holds more than five hundred services in total. A filter in the address does not change that decision.

### The List Columns and the Row Menu

The checkbox marks a row for the bulk action; the header box takes the whole page. **Client** links to the client record for staff allowed to open client records, prints the name as plain text for everyone else, carries the company name underneath and adds a notebook button for admin notes or a shield for a blacklisted client. **Product/Service** links to the service detail page with the domain or IP under the name, plus WHOIS and intoDNS buttons on domain and hosting rows or an IP lookup button elsewhere, and chips for a service created or renewed today.

**Price** carries the amount, the cycle underneath and a quantity above one as a badge. **Renewed** is the last renewal date, and a service never renewed shows its creation date there. **Next Due** is the next payment date, or a short dash when there is none. **Status** is the state badge, and Pending Approval, In Progress and Suspended rows carry a faint tint.

Rows open ordered by state, newest first inside each, and Price, Renewed, Next Due and Status re-sort from their headers. Each row ends with a three dot button holding **View** and **Delete**; Delete is dropped for staff without the order operation privilege.

### Downloading the List

The download icon at the right of the table strip offers **CSV**, **JSON** and **XML**. The file carries the current filters, search and sorting but not the paging, so it holds the whole filtered set, plus the columns the screen does not print: the service number the list keeps hidden, client email, quantity, currency, creation date, module and order number.

## Filter Fields

- **Product Group**: Optional, empty by default. Domain plus the system's product groups.
- **Service Status**: Optional, empty by default. Narrows the list to one state.
- **Product/Service**: Optional. Searches the catalogue and pins the list to one product.
- **Billing Cycle**: Optional, All by default. The cycle stored on the service.
- **Payment Method**: Optional, All by default. The method on the service, not on its invoices.
- **Server**: Optional, All by default. Grouped by module; None finds unplaced services.
- **Service ID**: Optional. One numeric id, matched exactly.
- **Domain/Hostname**: Optional. Part of the service name, its domain or its hostname.
- **Quantity**: Optional, a floor by default: quantity at or above the number typed.
- **IP Address**: Optional. Part of the address on the service.
- **Client**: Optional. Searches clients and returns all they own.
- **Created Date Range**: Optional. Calendar range over the set-up date.
- **Renewal Date Range**: Optional. Calendar range over the last renewal date.
- **Due Date Range**: Optional. Calendar range over the next due date.
- **Requirement**: Optional. Grouped by category, uncategorised ones last.
- **Requirement Value**: Optional, and only in the page by page mode. Part of the answer.

## Tasks

### Narrowing the list down to one client or one date

1. In the options bar under the page title, choose a value in **Product Group** or **Service Status**; on a narrow screen open **Show Options** first.
2. For anything finer, click **Advanced Filter** in the same bar and fill the field you need, for example **Client** or **Due Date Range**.
3. The list narrows immediately, the button counts the advanced fields you filled, and the address carries the filter, so the view can be shared.
4. To go back, click **Advanced Filter** again: closing the panel clears every field in it and the full list returns.

### Changing the state of several services at once

1. Tick the checkbox at the start of each row you want, or the box in the column header to take the whole page.
2. In the options bar, pick **Activate**, **Suspend** or **Cancel** from the **Apply to Selected** list. A confirmation window opens.
3. Check the **Apply on API** switch there: it appears only when a selected service is bound to a module, while it is on the command goes to the server too, and with it off only the record in the panel changes. Suspending or cancelling more than one service also asks for your administrator password.
4. Press **Activate**, **Suspend** or **Cancel** at the bottom of the window. One service changes at once; several turn the window into a progress bar ending on a **Completed** button, after which the list reloads.

### Deleting a service

1. Open the three dot menu at the end of the row and choose **Delete**. For several at once, tick their checkboxes and choose **Delete** from the **Apply to Selected** list.
2. Read back the service and client name in the confirmation window, or the count for a selection, then decide on **Apply on API**: with it on, the account is terminated on the server too.
3. Type your administrator password when you are deleting more than one service; a single deletion does not ask for it.
4. Press **Delete** at the bottom of the window. A single row disappears straight away; a selection is walked through in the progress window and the list reloads.

## Things to Watch

> **Deletion cannot be undone**
> 
> Deleting removes the service and its related records, and with **Apply on API** left on it also terminates the account on the server. Cancel instead if you only mean to stop the billing.

> **A bulk run stops where it fails**
> 
> Services are processed one after another. If one fails the run halts there and the button turns into **Retry**, while everything already done stays done, so read the message first.

## Required Privileges

Opening the list needs either `SERVICES_LOOK` or `SERVICES_OPERATION`. The bulk actions and the deletion run under `SERVICES_OPERATION`, so staff holding only the read privilege can filter, sort and open services but cannot change them. The client name in the list is a link only for staff holding `USERS_LOOK`; without it the name is printed as plain text.

## Related Articles

- [Service Detail Overview](https://docs.wisecp.com/en/service-detail-overview)
- [Service Addons](https://docs.wisecp.com/en/service-addons)
- [Cancellation Requests](https://docs.wisecp.com/en/cancellation-requests)
- [Upgrades and Downgrades](https://docs.wisecp.com/en/upgrades-and-downgrades)
- [Orders](https://docs.wisecp.com/en/orders)